zeruai

🆔 去中心化 AI 身份注册管理

基于 Zeru ERC-8004 标准,为 AI Agent 提供 Base 链身份注册服务,实现去中心化可验证身份与钱包管理。

收藏
4.1k
安装
1.7k
版本
v1.0.2
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Zeruai 是一个基于 ERC-8004 标准的 AI Agent 身份注册与管理工具,专为 Base 区块链网络设计。该 Skill 允许开发者在链上为 AI Agent 创建可验证的身份凭证(NFT),管理代理元数据、服务端点(支持 MCP、A2A、OASF 等协议)以及关联钱包地址,构建去中心化的代理身份体系。

核心用法涵盖五个主要功能:通过 register 命令使用 JSON 配置文件或简易参数创建新的 Agent 身份,系统自动在 Base Mainnet(默认)或 Base Sepolia 测试网铸造 NFT 并托管元数据;read 命令可查询任意 Agent 的链上信息,包括所有者、服务地址和钱包;fee 命令检查当前注册费用和注册开关状态;set-metadata 允许所有者设置自定义键值对元数据;unset-wallet 用于清除 Agent 关联的钱包地址。所有写入操作需配置 PRIVATE_KEY 环境变量,读操作则无需授权。

显著优点包括:严格遵循 ERC-8004 标准,确保与其他去中心化代理系统的互操作性;支持丰富的服务类型定义,包括 MCP(Model Context Protocol)、A2A(Agent-to-Agent)、OASF 标准以及传统的 Web 端点,满足复杂 AI 系统的多样化接入需求;提供主网与测试网双环境支持,便于开发测试;元数据托管于去中心化存储,结合链上 NFT 实现真正的用户自主身份(SSI);完善的 JSON Schema 验证和类型检查确保数据格式合规。

潜在缺点与局限性方面:目前仅支持 Base 链生态,跨链互操作性有限;注册和维护需要支付 ETH 费用(主网约 0.0025 ETH),对于高频测试或低成本场景仍有门槛;作为 T3 级社区来源项目,长期维护稳定性需持续观察;虽然代码经过审计,但智能合约本身仍面临潜在的链上风险;此外,技能依赖 Node.js 环境和特定的 npm 包,对纯 Python 或其他技术栈的团队不够友好。

适合的目标群体主要是:构建去中心化 AI Agent 的开发者,特别是需要标准化身份凭证的 Agent 框架团队;采用 MCP、A2A 等新兴协议的服务提供商;需要在 Base 链上建立可验证声誉系统的 DeFi 或 DAO 项目;以及探索 AI 与区块链结合的 Web3 创新团队。

使用风险需关注:PRIVATE_KEY 的安全存储至关重要,虽然私钥仅用于本地签名,但泄露将导致资产损失;区块链交易的不可逆性意味着错误的元数据设置或注册操作无法轻易回滚;Gas 费用随网络拥堵波动,需确保钱包有足够余额;与远程 API(agenturi.zpass.ai 等)的通信存在网络延迟或服务可用性风险;最后,作为较新的协议标准,ERC-8004 的生态系统仍在发展,未来可能出现破坏性更新。

安全解读

核心用法

zeruai 是一个面向AI Agent的区块链身份注册Skill,基于Zeru ERC-8004 Identity Registry协议,部署于Base Mainnet/Sepolia网络。核心功能包括:

| 功能 | 命令示例 | 说明 |
|------|---------|------|
| 完整注册 | `/zeruai register --json agent.json` | 通过JSON文件注册Agent,支持MCP/A2A/OASF多协议 |
| 快速注册 | `/zeruai register --name "Bot" --description "..." --endpoint "..."` | 单端点快速注册 |
| 查询信息 | `/zeruai read <agentId>` | 读取Agent链上数据、服务配置 |
| 费用查询 | `/zeruai fee` | 查看当前注册费用及开关状态 |
| 元数据管理 | `/zeruai set-metadata <agentId> --key <k> --value <v>` | 设置自定义元数据 |
| 钱包解绑 | `/zeruai unset-wallet <agentId>` | 清除Agent钱包地址 |

Agent JSON结构支持多协议服务配置:

  • MCP服务:Model Context Protocol服务端点
  • A2A服务:Agent-to-Agent协议卡片地址
  • OASF服务:开放Agent技能框架标识
  • agentWallet:CAIP-10格式的链上钱包地址
  • x402Support:是否支持x402支付协议

显著优点

1. 协议标准化:遵循ERC-8004身份注册标准,实现Agent身份NFT化
2. 多链支持:主网(0.0025 ETH)与Sepolia测试网(0.001 ETH)双环境

3. 协议兼容:原生支持MCP、A2A、OASF三大AI Agent互操作协议

4. 安全设计:私钥本地签名,不上传服务器;HTTPS加密传输

5. 元数据灵活:支持自定义键值对扩展Agent属性

潜在缺点与局限性

1. 成本门槛:主网注册需0.0025 ETH费用,频繁测试成本较高
2. 私钥依赖:所有写操作必须配置PRIVATE_KEY环境变量

3. 生态早期:Zeru协议处于发展初期,合约升级可能影响历史注册

4. 网络限制:仅支持Base网络,其他L1/L2链需等待扩展

5. T3来源:个人开发者维护,长期支持稳定性存疑

适合人群

  • AI Agent开发者:需要链上身份认证的自主Agent项目
  • MCP协议实践者:构建标准化工具暴露接口的开发者
  • 多Agent系统架构师:需A2A协议实现Agent间协作的场景
  • Web3 + AI创业者:探索链上Agent经济模型的创新团队
  • 协议研究者:关注ERC-8004身份标准的前沿开发者

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 私钥泄露 | 中 | `PRIVATE_KEY`配置于本地环境,需防范文件泄露 |
| 合约风险 | 中低 | 智能合约虽经审计但仍存在未知漏洞可能 |
| 费用波动 | 低 | Gas价格波动可能影响实际注册成本 |
| 协议变更 | 中 | ERC-8004标准演进可能导致元数据格式不兼容 |
| API可用性 | 低 | Zeru官方API服务稳定性依赖第三方运维 |

安全建议:使用专用测试钱包而非主资产钱包;定期关注合约升级公告;生产环境部署前于Sepolia充分测试。

zeruai 内容

lib文件夹
scripts文件夹
手动下载zip · 15.9 kB
abi.jstext/javascript
请选择文件