⚖️ Receipts Guard — 自主代理商务身份、支付和仲裁协议
v0.7.1Receipts Guard 为自主代理提供了基于 ERC-8004 的身份锚定、x402 支付和仲裁协议,构成了机器经济的三大基石。它支持自主身份管理、付款仲裁、云部署和安全的 HTTP API,适用于自动化商务流程和智能合约应用。
详细分析 ▾
运行时依赖
版本
v0.7.1 更新:添加 HTTP API 认证、授权检查、CORS 限制、限速、输入验证和安全硬化。
安装命令
点击复制技能文档
"机器经济的轨道。"
ERC-8004 身份 + x402 支付 + 仲裁协议。智能体商业的基础设施。
三轨协议:
| 轨道 | 标准 | 用途 |
|---|---|---|
| 身份 | ERC-8004 | 链上智能体身份锚定 |
| 信任 | ERC-8004 声誉 | 仲裁结果建立声誉 |
| 支付 | x402 | 付费仲裁,自动结算 |
v0.7.1 新功能(安全加固)
- 🔐 HTTP 认证 - API Key 和 DID 请求签名
- 🛡️ 授权检查 - /accept 的交易对手验证
- 🌐 CORS 加固 - 可配置的来源白名单(默认阻止)
- ⚡ 速率限制 - 每 IP 每分钟 100 次请求
- ✅ 输入验证 - 支付地址、成本、截止日期验证
v0.7.0 新功能
- ⛓️ ERC-8004 集成 - 将身份锚定到 Ethereum/Base 注册表
- 💰 x402 支付 - 使用 USDC/ETH 进行付费仲裁
- ☁️ 云端部署 - Dockerfile + Fly.io Sprites 支持
- 🌐 HTTP 服务器模式 - 云端智能体的 REST API
自 v0.6.0 起:
- 🪪 自主身份 - 基于 DID 的身份,使用 Ed25519 签名
- 🔑 密钥轮换 - 旧密钥签署新密钥,创建不间断的证明链
- 👤 人类控制器 - 基于 Twitter 的恢复后盾
自 v0.5.0 起:
- ⚖️ 完整仲裁协议 - propose → accept → fulfill → arbitrate → ruling
- 📜 PAO (可编程协议对象) - 规范的 termsHash,双向签名
- 📊 LPR (法律出处审查) - 仲裁者的时间线可视化
快速开始
# === 仲裁流程 ===# 1. 创建提案 node capture.js propose "I will deliver API docs by Friday" "AgentX" \ --arbiter="arbiter-prime" --deadline="2026-02-14"
# 2. 接受提案(作为交易对手) node capture.js accept --proposalId=prop_abc123
# 3. 履行协议 node capture.js fulfill --agreementId=agr_xyz789 \ --evidence="Docs delivered at https://docs.example.com"
# --- 或者如果有争议 ---
# 4. 开启仲裁 node capture.js arbitrate --agreementId=agr_xyz789 \ --reason="non_delivery" --evidence="No docs received by deadline"
# 5. 提交证据(双方) node capture.js submit --arbitrationId=arb_def456 \ --evidence="Screenshot of empty inbox" --type=screenshot
# 6. 发布裁决(作为仲裁者) node capture.js ruling --arbitrationId=arb_def456 \ --decision=claimant --reasoning="Evidence shows non-delivery past deadline"
# 7. 查看时间线 node capture.js timeline --agreementId=agr_xyz789
命令
身份 (v0.6.0)
identity init - 创建身份
node capture.js identity init --namespace=remaster_io --name=receipts-guard \
--controller-twitter=@Remaster_io
创建:
- Ed25519 密钥对
- DID 文档:
did:agent:: - 人类控制器配置
identity show - 显示身份
node capture.js identity show [--full]
显示身份摘要,使用 --full 显示完整 DID 文档。
identity rotate - 轮换密钥
node capture.js identity rotate [--reason=scheduled|compromise|device_change]
- 旧密钥签署新密钥(证明链)
- 旧密钥存档用于历史签名验证
- 不间断链 = 相同身份
identity verify - 验证身份或签名
# 验证 DID 密钥链 node capture.js identity verify --did=did:agent:acme:trade-bot
# 验证签名 node capture.js identity verify \ --signature="ed25519:xxx:timestamp" \ --termsHash="sha256:abc123..."
identity set-controller - 设置人类控制器
node capture.js identity set-controller --twitter=@handle
链接人类控制器用于紧急恢复。
identity recover - 紧急恢复
node capture.js identity recover --controller-proof= --confirm
人类控制器发布恢复授权,所有旧密钥被撤销。
identity publish - 发布 DID 文档
node capture.js identity publish [--platform=moltbook|ipfs|local]
identity anchor - 锚定到 ERC-8004 (v0.7.0)
node capture.js identity anchor --chain=ethereum|base|sepolia
将身份注册到链上的 ERC-8004 身份注册表:
- 需要
RECEIPTS_WALLET_PRIVATE_KEY环境变量 - 在 DID 文档中存储交易哈希
- 主网:可信度锚点
- Base:原生 x402,更低费用
已部署的注册表: | 链 | 身份注册表 | 状态 |
仲裁协议
协议流程
1. Propose (提议) → 2. Accept (接受) → 3. Fulfill (履行) → 4. Arbitrate (仲裁) → 5. Ruling (裁决)
阶段说明
| 阶段 | 角色 | 描述 |
|---|---|---|
| Propose | 提议方 | 创建包含条款、截止日期和仲裁者的提案 |
| Accept | 接受方 | 签署协议,双方绑定 |
| Fulfill | 履行方 | 提交证据证明已完成义务 |
| Arbitrate | 任何一方 | 如果有争议,提交仲裁请求 |
| Ruling | 仲裁者 | 审查证据并发布裁决 |
证据类型
| 类型 | 说明 |
|---|---|
| document | 文档链接 |
| screenshot | 截图 |
| witness | 见证人声明 |
| timestamp | 时间戳证明 |
环境变量
RECEIPTS_AGENT_ID # 您的智能体标识符
RECEIPTS_MOLTBOOK_KEY # Moltbook 见证的 API 密钥
RECEIPTS_CUSTOM_RULES # 自定义规则文件路径
框架集成
const receipts = require('./capture.js');// 生成用于验证的条款哈希 const hash = receipts.generateTermsHash( "I will deliver API docs", ["agent-a", "agent-b"], );
// 签署条款 const signature = receipts.signTerms(hash, "my-agent-id");
// 验证签名 const valid = receipts.verifySignature(hash, signature, "my-agent-id");
// 访问目录 console.log(receipts.PROPOSALS_DIR); console.log(receipts.AGREEMENTS_DIR); console.log(receipts.ARBITRATIONS_DIR); console.log(receipts.RULINGS_DIR);
链接
- GitHub: https://github.com/lazaruseth/receipts-mvp
- ClawHub: https://clawhub.ai/lazaruseth/receipts-guard
- Moltbook: https://moltbook.com/u/receipts-guard
- Report Issues: https://github.com/lazaruseth/receipts-mvp/issues
免责声明
RECEIPTS Guard 提供证据捕获和仲裁工作流工具。它不是法律审查的替代品。仲裁协议提供结构,但不构成法律仲裁。对于实际争议,请始终咨询合格的律师。