Agent identity and reputation registration

核心用法

8004-MCP是基于ERC-8004协议的Agent Registry多链MCP服务器，为AI代理提供跨链身份注册、声誉查询与反馈管理能力。核心功能涵盖：

1. 代理发现与查询

• agent_search: 支持按名称、描述、能力标签（MCP/A2A端点、技能类型）多维度搜索代理
• cache_search: 基于FTS5的快速模糊匹配，适合部分名称检索
• agent_get/reputation_get: 获取代理详情与综合信誉评分
• leaderboard_get: 按链查看高信誉代理排行榜

2. 代理注册与管理

• agent_register: 在Solana或EVM链（ETH/Base/Arbitrum等）注册新代理NFT
• 自动IPFS元数据托管，支持自定义tokenUri
• 所有权转移、URI更新等链上操作

3. 反馈与声誉系统

• feedback_give: 提交0-100分评分+分类标签（uptime/quality等）
• Solana特有ATOM声誉模型：质量分、信任层级、双EMA衰减机制
• x402_feedback_submit: 支付凭证关联的反馈验证

4. 钱包安全架构

• 主密码加密的本地钱包存储（wallet_store_init/unlock）
• 多链钱包创建（Solana/EVM），私钥永不暴露
• 自动锁定与会话恢复机制

5. 网络与成本优化

• 一键切换testnet/mainnet，支持7+链
• 推荐L2链（Base/Arbitrum）降低成本10-100倍
• dry-run模式（skipSend）零成本预演交易

显著优点

• 跨链互操作: 统一的Global ID格式（sol:/eth:/base:），打破链间孤岛
• 标准兼容: 原生支持OASF技能标准、MCP/A2A协议、x402支付验证
• 开发者体验: TypeScript SDK完备，60+工具覆盖全生命周期，含错误码对照表
• 经济高效: L2注册成本$0.01-0.5，反馈提交$0.01-0.3，远低于ETH主网
• 安全设计: 主密码加密+自动锁定+不可恢复机制，平衡便利与资产安全

潜在局限

• 资金门槛: 代理注册/反馈需链上gas，无免费层级；测试网需人工领水（faucet需人机验证）
• 主网成本波动: ETH主网gas高峰时操作可达$10-60，需主动切换L2
• 密码风险: 主密码丢失无恢复途径，用户教育成本高
• Solana中心化依赖: ATOM声誉、验证机制依赖特定合约实现
• IPFS限制: 默认共享Pinata账户，高频使用可能触限速

适合人群

| 场景 | 推荐度 | 说明 |

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

| AI Agent开发者 | ⭐⭐⭐⭐⭐ | 快速注册链上身份，建立可验证声誉 |

| 多链DeFi协议 | ⭐⭐⭐⭐⭐ | 统一查询跨链代理资质，防范恶意bot |

| 企业自动化 | ⭐⭐⭐⭐ | 内部代理市场+审计追踪，需评估主网成本 |

| 个人实验 | ⭐⭐⭐ | testnet友好，但需理解钱包/密码机制 |

| 纯链下AI应用 | ⭐⭐ | 无链上需求则过度设计 |

常规风险

资金风险: 钱包资金不足导致交易失败，需预存SOL/ETH；主网操作建议先dry-run验证。
操作风险: wallet_store_init密码务必离线备份，丢失=资产永久锁定；误删钱包无恢复。
智能合约风险: 协议依赖ERC-8004标准实现，需关注官方合约审计状态与升级公告。
网络风险: 链切换（network_set）影响所有后续操作，mainnet/testnet资产隔离需确认。
声誉操纵: 反馈系统开放，低门槛可能遭遇刷分，建议结合x402支付证明增强可信度。

核心用法

8004-MCP是一个基于ERC-8004协议的多链MCP服务器，专为AI Agent的注册、发现与声誉管理设计。用户通过MCP客户端连接后，可执行两大类操作：读取操作无需钱包，支持跨链搜索Agent、查询详细信息、获取声誉评分及排行榜；写入操作需先初始化加密钱包存储（主密码保护），包括注册新Agent、提交反馈、转移所有权等。技能支持Solana、Ethereum、Base、Arbitrum、Optimism等多条链，并内置x402支付协议集成，实现付费与声誉的联动验证。

显著优点

多链互操作性是最大亮点，统一的全局ID格式（sol:<pubkey>、eth:<chainId>:<tokenId>等）让Agent在不同链上无缝识别。技能提供丰富的搜索筛选能力，可按MCP/A2A端点、特定工具技能、活跃度等条件精准定位Agent。ATOM声誉系统（Solana专属）结合质量评分、信任层级和双EMA算法，为Agent可信度提供量化依据。成本优化方面，明确推荐L2链（Base、Arbitrum）可将操作成本降低10-100倍，并支持dry-run模式预览交易，降低试错成本。

潜在缺点与局限性

主密码不可恢复是重大设计约束——一旦丢失密码，加密钱包永久无法访问，对用户操作习惯要求极高。跨链功能虽强大，但不同链的功能完备度不均：ATOM统计、验证请求等高级功能仅限Solana，EVM链相对简化。此外，testnet水龙头需人工完成验证码，Agent无法自助获取测试资金，必须依赖人工介入，增加了自动化测试的摩擦。

适合的目标群体

本技能主要面向AI Agent开发者（需注册和管理链上Agent身份）、多Agent系统架构师（需要跨链发现与筛选Agent）以及去中心化服务市场构建者（依赖声誉系统建立信任机制）。对普通终端用户而言门槛较高，更适合具备区块链基础认知的技术团队。

使用风险

资金风险方面，mainnet操作涉及真实资产，文档明确警示Ethereum主网gas波动可能导致成本飙升（agent_register可达$10-60）。安全依赖上，钱包存储的加密强度完全取决于用户自设主密码，弱密码将导致资产暴露。性能风险包括区块链网络拥堵时的交易延迟，以及IPFS元数据读取的可用性依赖。建议严格遵循"testnet验证→L2链优先→mainnet谨慎"的渐进路径，并隔离测试与生产环境的钱钥。