receipts-guard

⚖️ 机器经济的身份与仲裁基础设施

基于ERC-8004标准和x402支付协议的Agent商业仲裁系统,提供去中心化身份锚定与自动化争议解决,构建机器经济信任基础设施。

收藏
3.8k
安装
1.3k
版本
v0.7.1
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

RECEIPTS Guard v0.7.1 是专为自主智能体商业设计的协议基础设施,通过「身份-信任-支付」三大支柱构建机器经济。系统实现了基于 ERC-8004 标准的去中心化身份(DID)锚定、x402 协议的付费仲裁机制,以及完整的协议生命周期管理。

核心用法围绕三大模块展开:首先是身份管理,通过 Ed25519 密钥对创建自主权身份(DID),支持密钥轮换(保持身份连续性)和链上锚定(Ethereum/Base 网络),并提供基于 Twitter 的人工控制器作为恢复后门。其次是协议仲裁流程,遵循 propose → accept → fulfill → arbitrate → ruling 的标准状态机,创建可编程协议对象(PAO)并生成法律溯源审查(LPR)时间线。最后是支付与部署,集成 x402 协议实现 USDC/ETH 的付费仲裁,支持通过 Docker/Fly.io 部署为持久化 HTTP 服务,提供 REST API 供云端 Agent 调用。

显著优点体现在其密码学严谨性与架构灵活性:采用业界标准的 Ed25519 签名算法和 SHA-256 哈希,确保协议不可篡改;本地优先的数据存储(~/.openclaw/receipts/)结合可选的链上锚定,平衡了隐私与可信度;完善的 HTTP 安全机制(API Key + DID 签名双认证、CORS 白名单、速率限制)保障服务端安全;版本迭代显示活跃的安全维护(v0.7.1 专门强化 HTTP 认证与输入验证)。

潜在缺点与局限性包括:系统明确声明不提供法律效力,仲裁结果仅为技术裁决而非法律判决;依赖用户正确配置私钥(RECEIPTS_WALLET_PRIVATE_KEY),一旦泄露将导致身份被盗;作为 T3 来源的个人项目,虽代码质量达 A 级但缺乏企业级背书;区块链交互依赖外部 RPC 节点和 Gas 费用,在极端网络条件下可能不可用。

适合的目标群体主要是构建 Agent 经济的开发者:包括需要互操作协议的 AI Agent 团队、去中心化服务市场构建者、DAO 的自动化 treasury 管理者,以及研究机器支付(Machine Payable)协议的工程师。对于需要捕获服务条款(ToS)并评估风险的合规自动化场景同样适用。

使用风险需特别关注:私钥必须严格通过环境变量配置并避免提交至版本控制;生产环境必须配置 CORS 白名单(默认阻断跨域)和合理的速率限制;文件权限依赖操作系统(0o600),在多用户服务器上需谨慎;区块链交易不可逆,仲裁支付(x402)一旦执行无法撤回。建议定期备份 ~/.openclaw/receipts/ 目录,并在可信环境中运行。

安全解读

核心功能

RECEIPTS Guard v0.7.1 是面向自主代理(Autonomous Agents)商业活动的三位一体基础设施,整合 ERC-8004 身份标准x402 支付协议仲裁协议,构建机器经济的信任轨道。

三大核心模块:

| 模块 | 技术实现 | 功能价值 |
|------|---------|---------|
| **Identity** | ERC-8004 + DID | Ed25519自托管身份,支持密钥轮换与链上锚定(Ethereum/Base) |
| **Payment** | x402 | USDC/ETH自动结算,仲裁员有偿裁决,消除无偿治理困境 |
| **Arbitration** | PAO + LPR | 程序化协议对象(Programmable Agreement Object)+ 法律溯源审查(Legal Provenance Review) |

显著优点:

  • 密码学严谨:采用 Ed25519 签名(替代早期 HMAC),支持密钥历史链式验证,旧钥签新钥形成不可中断的身份证明
  • 安全硬化全面:v0.7.1 新增 HTTP API 认证(API Key / DID 签名)、速率限制(100 req/min)、CORS 白名单、严格输入验证
  • 部署灵活:本地优先 + 链上锚定 + Fly.io/Docker 云部署
  • 依赖极简可信:仅依赖 ethers.js v6.11.0 和 tweetnacl v1.0.3,零已知 CVE

潜在局限与风险:

  • 非法律仲裁:工具提供结构化工作流程和证据固化,但裁决本身不构成法律意义上的仲裁,复杂商业纠纷仍需律师介入
  • 私钥管理:当前私钥以 0o600 权限明文存储,虽符合标准但无加密层;环境变量读取敏感配置缺乏审计日志
  • 速率限制状态易失:基于内存的 Map 实现,服务重启后计数重置,分布式部署需前置反向代理或 Redis 共享状态
  • CORS 配置风险RECEIPTS_ALLOWED_ORIGINS=* 可一键开放所有来源,生产环境误配置将暴露 CSRF 攻击面

适合人群:

  • 构建 AI Agent 商业协议的开发者与团队
  • 需要机器可验证服务协议的 DAO 与自动化组织
  • 探索链上声誉与去中心化争议解决的研究者

常规风险:

  • 智能合约交互需妥善保管 RECEIPTS_WALLET_PRIVATE_KEY,泄露将导致链上身份与资金损失
  • DID 签名时间窗口(5分钟)对时钟漂移敏感,NTP 不同步可能导致认证失败
  • 仲裁成本上限 1,000,000 代币单位的硬编码限制需关注未来高价值协议场景

receipts-guard 内容

手动下载zip · 47.4 kB
capture.jstext/javascript
请选择文件