Default Settlement Verifier

🚀 默认结算验证器

默认结算验证器是一个用于代理间和程序化结算的确定性、中立的验证服务，可评估声明的结算结果是否满足预定义的条件。

项目主页：https://defaultverifier.com

📚 规范文档

• SAR v0.1 规范：https://defaultverifier.com/spec/sar-v0.1
• 公钥：https://defaultverifier.com/.well-known/sar-keys.json
• 测试用例：https://defaultverifier.com/spec/sar-v0.1/fixtures/README

🚀 快速开始

默认结算验证器是一个无状态的验证服务，它根据确定性规则评估声明的结算结果是否满足预定义条件。它只回答一个问题：“给定此声明和这些条件，是否验证通过？” 它产生签名的、可重放的事实，而不涉及协调、托管或执行。

✨ 主要特性

• 确定性：相同的输入始终产生相同的签名结果。
• 无状态：每次调用都是独立的。
• 中立性：无买家/卖家偏见，无激励机制，无治理层。
• 可组合性：可接入代理框架、支付轨道和结算协议。
• 可审计性：签名响应允许下游验证和记录。

📦 安装指南

文档未提及安装步骤，暂不提供。

💻 使用示例

基础用法

规范验证端点（POST）

POST https://defaultverifier.com/verify

重要提示：此端点仅接受 POST 请求，浏览器访问会显示 “Cannot GET /verify”，这是预期行为。

示例请求：

{
    "task_id": "example-001",
    "spec": { "expected_output": "hash_or_descriptor" },
    "output": { "expected_output": "hash_or_descriptor" }
}

SettlementWitness（v0）示例（PASS）

curl -s -X POST https://defaultverifier.com/settlement-witness \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "example-002",
    "spec": { "expected": "foo" },
    "output": { "expected": "foo" }
  }'

最小响应格式（精简版）：

{
    "witness": "SettlementWitness",
    "witness_version": "v0",
    "task_id": "example-002",
    "verifier_response": {
        "verdict": "PASS",
        "reason_code": "MATCH",
        "signature": "..."
    },
    "witness_timestamp": "...",
    "receipt_id": "..."
}

📚 详细文档

预期用途

• 需要后置条件验证的代理间支付。
• x402 风格的执行后支付流程。
• 自动化托管或条件释放系统。
• 无需托管的买家保护原语。
• AI 工作流中的程序化结算验证。

MCP（规范）

SettlementWitness 可通过 MCP 用于原生代理工作流。

• MCP 服务器：https://defaultverifier.com/mcp
• 健康检查：https://defaultverifier.com/mcp-healthz
• 工具：settlement_witness
• 必需参数：
  • task_id（字符串）
  • spec（对象）
  • output（对象）
• 返回：收据 JSON（原样返回）

确定性保证：相同的输入会产生相同的 receipt_id 和验证器签名，时间戳可能不同。

安全与结算门控

默认结算验证器可作为自主工作流中的轻量级缓解层：

• 交付证明：确定性的通过/失败裁决在结算前验证输出是否符合任务规范。
• 结算门控：支付或下游操作可以基于可验证的完成情况进行条件设置。
• 减少纠纷：签名收据为任务后结算决策提供可重放的证据。

验证器不强制执行结果或托管资金，它产生中立的、签名的验证收据。

确定性与签名（重放稳定性）

• timestamp 和 witness_timestamp 每次调用时可能会改变（可观测性）。
• 对于相同的输入（task_id、spec、output），验证器签名是稳定的。
• receipt_id 由验证器签名派生而来，对于相同的输入是稳定的。

端点行为（预期）

• POST /verify → 正常工作（不支持 GET）
• POST /settlement-witness → 正常工作（GET 返回 405）
• GET /manifest → 正常工作

OpenClaw 兼容性

SettlementWitness 通过本仓库中包含的即插即用技能定义与 OpenClaw 兼容：

openclaw/skills/settlement-witness/SKILL.md

该技能调用公共 HTTPS 端点：

POST https://defaultverifier.com/settlement-witness

无需本地服务。

代理包装器与技能

SettlementWitness 是一个无状态的见证包装器，为任务后结算工作流颁发可重放的稳定验证收据。它与以下兼容：

• Heurist Mesh（待提交）
• MCP 调用模式
• OpenClaw 技能（包含即插即用包装器）

部署说明

• 验证器和 SettlementWitness 通过 defaultverifier.com 上的 NGINX 以 HTTPS 方式提供服务。
• SettlementWitness 持续运行，并通过 NGINX 代理（不暴露原始端口）。
• 为 API 路由（/verify、/settlement-witness、/manifest）启用了 Cloudflare 缓存绕过。

非目标

默认结算验证器明确不：

• 充当主观事实的预言机。
• 解决纠纷。
• 存储或托管资金。
• 强制执行支付。
• 提供声誉或身份服务。

这些层面属于上游或下游。

路线图（非承诺）

• 扩展声明模式。
• 可选的重放安全收据。
• 公共验证密钥端点。
• 可选的指标端点。

不保证时间线。

📄 许可证

本项目采用 MIT 许可证。

📞 联系信息

项目讨论和更新：https://x.com/defaultsettle

👨‍💻 运营商与来源

SettlementWitness 是默认结算验证器基础设施的一部分。

• 运营商：Default Settlement Verifier
• 仓库：https://github.com/nutstrut/default-settlement-verifier
• 主页：https://defaultverifier.com

SettlementWitness 是一个无状态的确定性证明服务，它不持有资金、执行支付、强制执行结算或触发链上操作。

收据验证：请参阅 docs/signature-verification.md（本仓库中新增）。

🌟 支持我们

如果默认结算验证器或 SettlementWitness 为您节省了时间、降低了风险或帮助您更快地交付产品，您可以支持我们的基础设施建设工作。

通过 GitHub Sponsors 支持：https://github.com/sponsors/nutstrut

基础设施独立运营，可免费使用。