xproof：AI 智能体的链上存证层 — Prove Before Act（先证明，后行动）

xproof 是自主智能体的问责基础设施。让你的智能体不再是黑箱，而是透明、可审计、可验证的系统。在执行前锚定推理过程（WHY），执行后锚定实际结果（WHAT）。完整的 4W（Who/What/When/Why）审计留痕，基于 MultiversX 区块链。每次存证 $0.01，通过 x402 无需 API key 即可使用。

适用于合规存证（如《生成式人工智能服务管理暂行办法》）、风控留痕、以及多智能体舰队的审计追溯需求。

快速开始 — 30 秒接入

1. 获取免费密钥 — 两种方式：

直接通过 MCP（最快）：调用 register_trial，传入 {"agent_name":"my-agent"} — 无需任何认证，立即返回 pm_ 密钥。
通过 REST：POST https://provebeforeact.com/api/agent/register → {"agent_name":"my-agent"}

2. 添加到 Claude / Cursor / Codex / OpenClaw：

{ "mcpServers": { "xproof": { "url": "https://provebeforeact.com/mcp", "headers": { "Authorization": "Bearer pm_YOUR_KEY" } } } }

3. 在每次行动前调用 audit_agent_session — 获得 proof_id 后才执行行动。

注意：原始 HTTP 调用必须包含 Accept: application/json, text/event-stream，否则服务器会返回 "Not Acceptable"。

为什么选择 MCP + xProof？

原生工具集成 — Claude、Cursor、Codex、OpenClaw 可直接调用 certify_file 或 audit_agent_session，无需额外开发
协议层强制 Prove Before Act — audit_agent_session 会阻塞执行，直到返回 proof_id
兼容 x402 — 自主智能体通过 Base 链上的 USDC 支付每次 $0.01，无需 API key、无需账户、无需人工介入
不可篡改的链上留痕 — SHA-256 哈希锚定在 MultiversX 上，无需依赖 xproof 即可独立验证
免费试用 — 10 次免费存证，无需钱包：直接调用 MCP 工具 register_trial（无需认证）或通过 REST POST https://provebeforeact.com/api/agent/register

完整示例 — 推理 → 哈希 → 存证 → 行动

import hashlib, json, requests

# 1. 记录推理过程
reasoning = {"who": "my-agent", "what": "BUY BTC 0.5", "why": "RSI=38, below threshold"}

# 2. 本地哈希计算 — 原始数据不会离开本机
file_hash = hashlib.sha256(json.dumps(reasoning, sort_keys=True).encode()).hexdigest()

# 3. 通过 MCP 在行动前完成存证
resp = requests.post("https://provebeforeact.com/mcp",
    headers={"Content-Type": "application/json",
             "Accept": "application/json, text/event-stream",
             "Authorization": "Bearer pm_YOUR_KEY"},
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/call",
          "params": {"name": "certify_file",
                     "arguments": {"file_hash": file_hash, "filename": "decision.json",
                                   "metadata": reasoning}}})
proof_id = json.loads(resp.json()["result"]["content"][0]["text"])["proof_id"]

# 4. 只有在存证确认后才执行行动
execute_trade("BUY", "BTC", 0.5)
print(f"审计链接: https://provebeforeact.com/proof/{proof_id}")

舰队 / 批量示例 — 每日 1,000+ 决策

如果你管理一个智能体舰队（客服、动态定价、物流调度等），应使用批量存证接口，而不是逐条调用。

import hashlib, json, requests

decisions = [...]  # 每批最多 100 条决策

batch = [{
    "file_hash": hashlib.sha256(json.dumps(d, sort_keys=True).encode()).hexdigest(),
    "filename": f"{d['agent_id']}_{d['session_id']}.json",
    "metadata": d
} for d in decisions]

resp = requests.post("https://provebeforeact.com/api/batch",
    headers={"Authorization": "Bearer pm_YOUR_KEY", "Content-Type": "application/json"},
    json={"certifications": batch})
# → 每日 1,000 条决策 ≈ 10 次批量调用，而不是 1,000 次单独调用
# → 每个 proof_id 均可在 /proof/{id} 独立验证，便于合规审计

如果你的舰队已运行在 MCP 客户端上，同样的模式也适用于逐条调用 certify_file。

可用的 MCP 工具

工具	认证方式	说明
`audit_agent_session`	API key	在执行前锚定 WHO + WHAT + WHY — 实现 Prove Before Act 的核心工具
`certify_file`	API key	在 MultiversX 上存证任意 SHA-256 哈希
`certify_with_confidence`	API key	带置信度分级的存证（初始 → 部分 → 预承诺 → 最终）
`verify_proof`	无	通过 proof_id 或 file_hash 验证已有存证
`get_proof`	无	以 JSON 或 Markdown 格式获取存证
`investigate_proof`	API key 或 x402	完整的 4W 审计链重建
`submit_outcome`	API key	记录某个置信度存证决策的实际结果
`get_calibration`	无	查询智能体的校准质量（偏差、差距、方差）
`check_attestations`	无	查询智能体钱包的第三方信任认证
`discover_services`	无	发现可用服务及价格

其他接入方式

REST API

单次存证 — POST /api/proof，传入 file_hash + filename → 返回 proof_id
批量（最多 100 条） — POST /api/batch → 生产环境请求数减少 50 倍
认证 — Authorization: Bearer pm_YOUR_KEY

x402 — 无需 API key

不带密钥调用 POST /api/proof → 收到 402 响应 → 在 Base 链上签署 USDC 支付 → 携带 X-PAYMENT 头重新请求。每次固定 $0.01，无需账户。完整 x402 指南 →

ACP — 链上智能体交易流程

3 次调用完成：GET /api/acp/products → POST /api/acp/checkout → POST /api/acp/confirm

SDK 与框架

Python：pip install xproof — 支持 LangChain、CrewAI、AutoGen、LlamaIndex、OpenAI Agents SDK
JavaScript：npm install @xproof/xproof — 支持 Vercel AI、LangChain JS

保证与相关链接

隐私优先 — 仅将 SHA-256 哈希上链，原始内容始终保留在本地
不可篡改 — 锚定在 MultiversX 上，无需 xproof 即可独立验证
固定价格 — 每次存证 $0.01，无分级收费

完整智能体接入指南 · agent-context.md（机器可读） · mcp.json · openapi.json · llms.txt