结算见证服务

技能简介

SettlementWitness 是一项用于快速生成加密签名交付收据的服务，可在30秒内完成签署。该服务通过对比任务规格（spec）与实际输出（output），生成包含 PASS/FAIL/INDETERMINATE 裁决的密码学凭证，供第三方系统离线验证。

能做什么

• 为任务执行结果生成带数字签名的正式收据
• 自动比对规格要求与实际输出，判定匹配状态
• 支持第三方离线验证收据真实性，无需实时联网查询
• 提供明确的失败原因代码（SPEC_MISMATCH、EVALUATOR_TIMEOUT 等）

使用说明

安装与调用方式

本技能通过 MCP 协议或 REST API 直接调用，无需本地安装。确保网络可访问以下端点：

• MCP 端点：POST https://defaultverifier.com/mcp
• REST 端点：POST https://defaultverifier.com/settlement-witness

快速开始示例

settlement_witness({
  task_id: "quickstart-001",
  spec: { value: 1 },
  output: { value: 1 }
})

成功响应包含：裁决结果（PASS/FAIL）、原因代码、sha256 格式的收据ID、base64url 格式的签名。

常见错误处理

• 422 错误：检查必填字段 task_id、spec、output 是否完整
• INDETERMINATE/EVALUATOR_TIMEOUT：上游评估器不可达，但仍会返回有效签名收据
• FAIL/SPEC_MISMATCH：输出结构与规格不符，需对比字段差异

输入与输出

见下方输入与输出表格。

风险提示

• 禁止在 spec 或 output 字段中传输敏感信息或密钥
• 保持输入参数确定性，避免使用随机值或时间戳导致验证不一致
• 收据签名仅证明当时评估状态，不保证后续数据未被篡改
• INDETERMINATE 裁决表示评估未完成，需结合业务场景判断是否接受

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nutstrut/settlement-witness/SKILL.md
来源类型：OpenClaw 官方技能仓库