ERC-8004 Trustless Agents

核心用法

ERC-8004 是一套部署在以太坊主网的智能合约标准，为自主AI代理提供三层核心基础设施：

1. 身份注册系统（ERC-721）

• 通过 register.sh 脚本注册代理，生成链上NFT身份
• 支持IPFS元数据存储，包含服务端点（A2A、MCP、ENS等）
• 合约地址：主网 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432

2. 声誉反馈机制

• 客户端可通过 feedback.sh 提交带签名的评分（0-100质量分、99.77%可用率等）
• 采用定点数编码（value + decimals），支持精细化量化指标
• 声誉数据链上可查，构建代理的可信度档案

3. 多层验证模型

• 声誉验证：历史反馈聚合
• 加密经济验证：质押担保机制
• 密码学验证：TEE证明、zkML零知识机器学习

显著优点

• 主网已上线：2026年1月29日部署，非概念验证
• 生态完备：官方SDK（JS/TS/Python）、ChaosChain集成、Vistara完整示例
• 协议兼容：原生支持Google A2A协议，MCP/ENS多服务绑定
• 可组合性：代理身份可跨链扩展（Base/Arbitrum/Optimism规划中）

潜在局限

• 早期阶段：Genesis Month（2026年2月）刚启动，网络效应待积累
• 验证门槛：zkML/TEE验证需额外基础设施，普通开发者接入成本高
• 声誉操纵风险：尚无明确女巫攻击防护机制，高分代理可能存在刷分
• IPFS依赖：元数据可用性依赖外部存储，非完全链上

适合人群

• 构建多代理系统的AI团队，需标准化身份互认
• DeFi协议寻求可信代理接入（交易机器人、预言机节点）
• 研究自主经济代理（AEA）的学术/实验项目
• 需A2A协议合规的企业级代理部署

常规风险

| 风险类型 | 说明 |

|---------|------|

| 智能合约 | 新部署合约未经长期审计考验，存在未知漏洞可能 |

| 私钥管理 | 脚本依赖本地私钥文件，需妥善保管 `.deployer_pk` |

| 网络费用 | 主网注册/更新产生Gas成本，需预留ETH |

| 标准竞争 | A2A/MCP等协议快速演进，ERC-8004可能面临替代标准挑战 |

核心用法

ERC-8004 Skill 是一套用于以太坊主网及测试网的AI代理管理命令行工具，基于正式的EIP-8004标准实现。核心功能包括：

代理注册与身份管理：通过register.sh脚本将AI代理注册为ERC-721身份NFT，支持IPFS元数据存储，主网和Sepolia测试网双环境运行。注册信息包含代理名称、服务端点（A2A/MCP协议）、支持的信任模型等标准化字段。

链上查询与声誉系统：query.sh可查询注册代理总数、特定代理详情及声誉摘要；feedback.sh支持对代理进行带签名的声誉评分，采用定点数格式（value + decimals）支持百分比、毫秒等多维度指标，标签包括starred、uptime、tradingYield、responseTime等。

元数据更新：set-uri.sh允许注册者更新代理的IPFS元数据URI，保持代理信息的时效性。

显著优点

• 标准合规性：严格遵循EIP-8004正式标准，合约地址经官方验证，2026年1月主网上线，具备良好的协议互操作性
• 安全编码实践：Shell脚本使用set -euo pipefail严格错误处理，完整输入验证，无命令注入风险
• 最小依赖设计：仅依赖Foundry的cast和jq两个行业标准工具，无复杂包管理风险
• 隐私友好架构：私钥本地存储（文件权限建议600），无遥测数据收集，符合GDPR数据最小化原则
• 多信任模型支持：内置声誉制、加密经济质押、TEE/zkML密码学验证三种可插拔信任机制

潜在局限性与风险

操作层面：交易发送前缺乏二次确认提示（RISK-003），主网操作可能产生意外Gas费用；无内置交易预览功能，--dry-run模式需主动启用。私钥文件路径固定于~/.clawdbot/wallets/，尚未支持硬件钱包或KMS集成（RISK-001）。

基础设施依赖：默认RPC节点（drpc.org、publicnode.com）虽可信但存在单点故障风险，当前需手动修改contracts.json才能切换自定义节点（RISK-002）。

功能边界：仅为客户端工具，不包含智能合约本身的安全审计；IPFS上传为可选功能，需用户自行配置PINATA_JWT。

适合人群

• AI代理开发者：需要为自主代理建立链上身份和声誉记录
• Web3基础设施团队：构建代理经济生态系统，集成A2A/MCP协议
• 去中心化AI研究者：探索加密验证（zkML/TEE）与代理经济的结合
• 已有Foundry环境的以太坊开发者

常规风险提示

• 私钥安全：务必设置chmod 600权限，建议使用专用开发钱包而非主钱包
• Gas成本意识：主网注册需支付Gas费，建议先用--network sepolia充分测试
• 合约地址验证：通过eips.ethereum.org/EIPS/eip-8004官方渠道交叉核对地址
• RPC端点可靠性：生产环境建议配置私有节点或专业RPC服务