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

基礎設施獨立運營，可免費使用。