# ERC-8004：不可信代理使用可验证的身份在链上注册您的人工智能代理，使其可被发现并通过声誉和验证启用信任信号。 ERC-8004 适用于任何 EVM 兼容链——目前部署在 Avalanche 上。 ## 入门套件 — 在 5 分钟内创建代理最快的入门方式。复制模板，安装并运行： # 1. 复制入门模板 cp -r 资产/启动器/ my-agent/ cd 我的代理/ # 2.安装依赖项 npm 安装 # 3.本地运行 npm 运行开发 # 4. 在浏览器中打开打开http://localhost:3000 你的代理正在运行！您将看到一个仪表板，其中包含代理的信息和 MCP 工具。 **内含内容：** * `src/server.ts` — 带有仪表板、运行状况检查、MCP 服务器的完整服务器（2 个示例工具） * `registration.json` — ERC-8004 元数据模板（编辑名称、描述、功能） * `dashboard.html` — 浏览器和扫描仪的可视化页面 * `Dockerfile` \+ `railway.toml` — 准备在 Railway 上部署 * `README.md` — 从本地到链上部署和注册的分步指南 **后续步骤：** 1. 使用代理的名称和描述编辑 `registration.json` 2. 在 `src/server.ts` 中添加您自己的 MCP 工具 3. 部署到Railway并在链上注册（参见`assets/starter/README.md`） ## ERC-8004 是什么？ ERC-8004 是任何 EVM 链上无需信任的代理身份和声誉的以太坊标准： * **身份注册** \- 基于 ERC-721 的代理 ID（您的代理获得 NFT） * **声誉注册表** \- 来自其他代理/用户的反馈和信任信号 * **验证注册** \-代理工作的第三方验证网站： |规格： ## 合约地址（Avalanche） > ERC-8004可以部署在任何EVM链上。以下是目前官方的部署：链条|身份登记|声誉登记处 ---|---|--- Avalanche 主网 (43114) | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` | `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63` 雪崩富士 (43113) | `0x8004A818BFB912233c491871b3d84c89A494BD9e` | `0x8004B663056A597Dffe9eCcC1965A193B7388713` 浏览器链接： * 主网： *富士： ## 快速入门 ### 1\.注册您的代理 # 设置环境变量导出 AVALANCHE_RPC_URL="https://api.avax.network/ext/bc/C/rpc" 导出 PRIVATE_KEY="您的私钥" # 使用指向代理注册文件的 URI 进行注册 ./scripts/register.sh“https://myagent.xyz/agent.json” # 或者向 IPFS 注册（需要 PINATA_JWT）导出 PINATA_JWT="your-pinata-jwt" ./scripts/register.sh“ipfs” ### 2\.检查代理注册 # 检查代理是否注册并获取其信息 ./scripts/check-agent.sh <代理 ID> ### 3\.更新代理元数据 # 更新链上 URI 以强制 Snowtrace/扫描仪刷新元数据 ./scripts/update-uri.sh "https://your-agent.com/registration.json" ### 4\.提供反馈 # 向代理提供声誉反馈 ./scripts/give-feedback.sh <代理 ID> <值> <标签1> <标签2> ## 注册文件格式您代理的注册文件（请参阅“assets/templates/registration.json”）： { “类型”：“https://eips.ethereum.org/EIPS/eip-8004#registration-v1”， "name": "我的经纪人", "description": "通过 ERC-8004 具有链上身份的人工智能代理", “图片”：“https://example.com/avatar.png”， “服务”：[ {“名称”：“网络”，“端点”：“https://myagent.xyz/”}， {“名称”：“A2A”，“端点”：“https://myagent.xyz/.well-known/agent-card.json”，“版本”：“0.3.0”}， {“名称”：“MCP”，“端点”：“https://mcp.myagent.xyz/”，“版本”：“2025-06-18”} ], “x402Support”：假， “主动”：真实， “注册”：[ { “代理ID”：1， “agentRegistry”：“eip155：43114：0x8004A169FB4a3325136EB29fA0ceB6D2e539a432” } ], “supportedTrust”：[“声誉”] } ## 关键概念 ### 代理身份（ERC-721 NFT） * 每个代理在注册时都会获得一个唯一的“agentId”（tokenId） * NFT 所有者控制代理的个人资料和元数据 * 代理通过 `eip155:43114:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` \+ `agentId` 进行全局标识 ### 声誉系统 * 任何人都可以提出反馈（代理业主本人除外） * 反馈包括带有小数点 (0-18) 的值 (int128) 以及可选标签 * 常见标签：“加星标”（质量 0-100）、“可达”（二进制）、“正常运行时间”（百分比） * 原始提交者可以撤销反馈 * 代理可以将回复附加到反馈中 ### 验证 * 代理请求验证者合约进行验证 * 验证者给出分数 (0-100) * 支持权益担保重新执行、zkML、TEE 证明 ## 环境变量变量|描述 |必填 ---|---|--- `RPC_URL` | EVM链RPC端点（默认为Avalanche公共RPC）|是的 `私钥` |用于签署交易的钱包私钥 |是的 `PINATA_JWT` |用于 IPFS 上传的 Pinata API JWT |否（仅适用于 IPFS 注册） `代理名称` |代理显示名称 |否 `代理描述` |代理说明 |否 `代理图像` |头像网址 |否 `SNOWTRACE_API_KEY` |用于验证的 Snowtrace API 密钥 |否 ## 网络详细信息（Avalanche）参数|主网 |富士测试网 ---|---|--- 链ID | 43114 | 43113 RPC URL | `https://api.avax.network/ext/bc/C/rpc` | `https://api.avax-test.network/ext/bc/C/rpc` 探索者| | 货币 | AVAX | AVAX（测试）水龙头| - | ## 工作流程 1. **获取原生代币** \- 注册需要汽油费（Avalanche 上约为 0.01-0.05 AVAX） 2. **创建注册文件** \- 按照注册格式生成JSON 3. **上传到 IPFS**（可选）- 通过 Pinata 或任意 URL 上的主机固定 4. **注册链上** \- 在身份注册表上调用 `register(agentURI)` 5. **设置元数据** \- 可选择设置链上元数据和代理钱包 6. **接收反馈** \-其他代理/用户可以给出声誉信号 7. **请求验证** \- 可选择请求第三方验证 ## 与cast一起使用（Foundry） # 使用 URI 注册代理强制发送 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 \ “注册（字符串）”“https://myagent.xyz/agent.json”\ --rpc-url https://api.avax.network/ext/bc/C/rpc \ --私钥$PRIVATE_KEY # 读取代理URI 强制调用 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 \ “tokenURI（uint256）”1 \ --rpc-url https://api.avax.network/ext/bc/C/rpc # 提供反馈（值=85，小数=0，tag1=“加星标”）强制发送 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 \ “给反馈（uint256，int128，uint8，字符串，字符串，字符串，字符串，bytes32）”\ 1 85 0“加星号”“”“”“”0x0000000000000000000000000000000000000000000000000000000000000000 \ --rpc-url https://api.avax.network/ext/bc/C/rpc \ --私钥$PRIVATE_KEY # 获取声誉摘要演员呼叫 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 \ “getSummary（uint256，地址[]，字符串，字符串）”\ 1 “[0xREVIEWER_ADDRESS]”“已加星标”“”\ --rpc-url https://api.avax.network/ext/bc/C/rpc ## 与 viem/ethers.js 一起使用有关完整的 TypeScript 示例，请参阅“references/api-reference.md”。 ## 互操作协议 ### A2A（代理对代理）请参阅“references/a2a-guide.md”： * 完整的A2A通信流程及图表 * 服务器端：agent-card.json结构，A2A端点 * 客户端：发现、理解并与其他代理交谈 * 多代理工作流程示例（将代理链接在一起） * 代理卡规范 (v0.3.0) * A2A互动后的声誉反馈 ### MCP（模型上下文协议）请参阅“references/mcp-guide.md”了解： * 完整的MCP JSON-RPC实现（初始化、工具/列表、工具/调用） * 服务器端：具有完整 JSON 模式的 10 个工具参考实现 * 客户端：自动化工具发现和调用 * 工具设计最佳实践（命名、模式、响应） * 使用curl命令进行测试 * JSON-RPC错误代码及处理 * MCP + x402 集成（免费和付费工具） ### x402（小额支付）请参阅“references/x402-guide.md”： * 完整的 x402 支付流程及图表 * 服务器端：402响应，通过服务商进行付款验证 * 客户端：EIP-712签名，创建付款证明 * 代理到代理的支付发现（自动） * 主网和 Fuji 测试网的 USDC 设置 * 定价最佳实践和安全检查表 ## 最佳实践请参阅“references/best-practices.md”： * 构建“registration.json”元数据以获得最大扫描分数 * 图像/NFT 要求和托管 * 服务公开（Web、A2A、MCP）——仅声明有效的内容 * 能力定义——诚实、真实、有代码支持 * 避免扫描仪警告（WA080 和其他） * 链上与链下元数据的一致性 * 代理类型分类（代理、混合、信息） * 扫描仪分数优化（参与度 30%、服务 25%、发布商 20%、合规性 15%、动量 10%） * 要避免的常见错误（附真实例子） ## 部署和基础设施请参阅“references/deployment-guide.md”了解： * 完整的架构图（ASCII） * 分步创建流程（从零到现场代理的 7 个阶段） * 铁路部署指南及配置 * 基础设施要求和成本估算 * 后端代码结构和模式（缓存、超时、并行调用） * 带命令的链上注册流程 * 监控、维护和安全检查表 ## 故障排除请参阅“references/troubleshooting.md”了解： * 实际生产问题及其解决方案 * 扫描仪警告修复（WA080、无法访问的服务） * 铁路部署问题（502、构建失败、崩溃） * API集成问题（速率限制、超时、内存泄漏） * 链上注册调试 * 诊断命令及解决流程图 ## 参考文档文件|描述 ---|--- `references/api-reference.md` | TypeScript/JavaScript API 示例 (viem + ethers.js) `references/registration-format.md` |完整的registration.json规范 `references/contract-addresses.md` |所有合约地址和RPC端点 `references/a2a-guide.md` | A2A协议实施指南 `references/mcp-guide.md` | MCP服务器/客户端实施指南 `references/x402-guide.md` | x402小额支付协议指南 `参考文献/最佳实践.md` |元数据、评分和代理设计最佳实践 `references/deployment-guide.md` |建筑、铁路部署、基础设施 `参考文献/故障排除.md` |现实世界的问题和解决方案 ## 链接 * [ERC-8004 规范]() * [8004.org]() * [8004scan.io]() \- 代理扫描仪和评分 * [erc-8004scan.xyz]() \- 代理扫描仪和元数据验证 * [GitHub: erc-8004-contracts]() * [Snowtrace 探索者]() * [Railway]() \- 推荐托管平台

Erc8004雪崩

包含技能