zscore

🆔 链上 AI 身份注册与管理专家

基于 Zeru 协议的 ERC-8004 标准 Agent 注册服务,支持 Base 链上去中心化身份管理、元数据维护与状态查询,确保 AI Agent 身份可信互认。

收藏
2.4k
安装
1.1k
版本
v1.0.3
CLS 安全性认证2026-06-03
点击查看完整报告 >

使用说明

zscore 是一个专为 AI Agent 设计的链上身份注册与管理工具,基于 Zeru 协议实现符合 ERC-8004 标准的去中心化身份注册服务。该技能允许开发者在 Base Mainnet 或 Base Sepolia 测试网上注册 Agent、管理元数据、查询链上状态,并支持 MCP、A2A、OASF 等多种服务协议的标准化接入。

核心用法围绕五个主要命令展开。通过 register 命令,开发者可以提交 JSON 配置文件或简单参数完成 Agent 注册,系统会自动生成符合 ERC-8004 registration-v1 规范的元数据文档,铸造 NFT 身份凭证,并建立链上记录。read 命令支持查询任意 Agent 的注册信息、所有者地址和服务端点。fee 命令可实时查询当前注册费用和合约状态。对于已注册的 Agent,set-metadata 允许所有者更新自定义元数据,unset-wallet 则可解除钱包绑定。所有写操作均需配置 PRIVATE_KEY 环境变量,并消耗少量 ETH 作为 Gas 费用。

显著优点在于其标准合规性与协议兼容性。zscore 严格遵循 ERC-8004 身份注册标准,确保 Agent 身份的链上可验证性和跨平台互操作性。技能原生支持 MCP(Model Context Protocol)、A2A(Agent-to-Agent)和 OASF(Open Agent Schema Framework)等主流 Agent 通信协议,允许在注册时声明服务能力和技能领域。此外,基于 Base 链的实现提供了较低的 Gas 成本和较高的交易确认速度,而 Zeru 提供的托管 API 简化了元数据存储和更新流程。

潜在缺点包括成本门槛和技术复杂性。注册 Agent 需支付约 0.0025 ETH 的固定费用外加 Gas 成本,对于频繁测试或批量注册场景可能产生累积开销。技能依赖 Node.js 环境和特定的 npm 包,对非技术用户有一定上手门槛。此外,所有身份数据均公开存储在区块链上,虽然保证了透明性,但可能不适合存储敏感商业信息。网络依赖性也要求用户必须保持与 Base 网络的连接稳定性。

该技能主要面向 AI Agent 开发者、自动化服务提供商和 Web3 项目团队。特别适合需要建立可验证数字身份、实现 Agent 间可信通信的去中心化应用开发者,以及希望将服务注册到开放 Agent 生态系统的企业级 AI 服务商。对于构建多 Agent 协作系统或需要链上声誉管理的应用场景,zscore 提供了基础设施层面的身份层支持。

使用风险主要集中在私钥管理和经济成本两方面。用户必须妥善保管 PRIVATE_KEY,任何拥有该密钥的实体均可控制已注册 Agent 的元数据和钱包设置,建议为注册用途单独创建专用钱包而非使用主资产钱包。Gas 费用随网络拥堵情况波动,虽然 Base 链费用相对较低,但在极端市场条件下仍可能显著上涨。此外,技能依赖 Zeru 的中央化 API 服务(agenturi.zpass.ai)进行元数据托管,若该服务不可用可能影响注册流程,尽管已上链的数据不受影响。

安全解读

核心用法

zscore 是专为 Zeru ERC-8004 Identity Registry 设计的链上代理身份管理工具,支持在 Base Mainnet/Sepolia 网络上完成 AI 代理的全生命周期管理。

主要功能

| 命令 | 用途 | 权限要求 |
|------|------|----------|
| `register` | 注册新代理(JSON完整模式或简易CLI模式) | 需 `PRIVATE_KEY`,支付 0.0025 ETH 主网费 |
| `read <agentId>` | 查询代理链上数据 | 无需私钥 |
| `fee` | 查看当前注册费用及开关状态 | 无需私钥 |
| `set-metadata` | 设置代理自定义元数据 | 需 `PRIVATE_KEY`,仅所有者 |
| `unset-wallet` | 清除代理钱包绑定 | 需 `PRIVATE_KEY`,仅所有者 |

注册数据标准

支持 ERC-8004 registration-v1 标准,可声明多种服务类型:

  • MCP (Model Context Protocol) 服务端点
  • A2A (Agent-to-Agent) 交互能力
  • OASF (Open Agentic Service Framework) 技能声明
  • x402 支付协议支持
  • agentWallet CAIP-10 格式钱包地址

技术架构

  • 底层依赖 ethers.js v6 与链上合约交互
  • Agent URI 托管于 Zeru 官方 API(TLS 加密)
  • 注册流程:创建托管 JSON → 铸造 NFT → 更新 agentId

---

显著优点

1. 标准合规:率先实现 ERC-8004 代理身份标准,支持跨平台代理发现与互操作
2. 灵活注册:既支持完整 JSON 配置(多服务、技能、支付能力),也支持 CLI 一键简易注册

3. 安全设计:私钥仅通过环境变量注入,无硬编码风险;输入经 Zod 严格校验

4. 多网支持:默认 Base Mainnet,一键切换 --chain 84532 至测试网

5. 开放查询:读操作无需认证,便于代理目录构建和声誉系统整合

---

潜在局限

| 局限 | 说明 |
|------|------|
| 费用门槛 | 主网 0.0025 ETH 注册费,高频测试需消耗真资产或切换测试网 |
| 链上确认 | 注册涉及交易打包,非即时完成,需等待区块确认 |
| 元数据托管 | Agent JSON 托管于 Zeru 中心化 API,非完全链上存储 |
| 私钥依赖 | 写入操作完全依赖 `PRIVATE_KEY` 环境变量配置 |
| 仅支持 Base | 当前仅适配 Base 生态,未扩展至其他 EVM 链 |

---

适合人群

  • AI 代理开发者:需为代理建立链上可验证身份
  • MCP/A2A 服务提供者:希望通过标准协议暴露代理能力
  • 多代理系统架构师:构建可发现、可互操作的代理网络
  • Web3 自动化团队:需要链上身份绑定支付钱包的自动化服务

---

常规风险

1. 私钥管理风险PRIVATE_KEY 泄露可导致代理所有权丧失和资金损失,建议使用专用热钱包
2. 交易费用波动:Base 网络 gas 可能波动,注册前建议先执行 /zscore fee 确认状态

3. 元数据不可变性:虽可更新 set-metadata,但核心注册 URI 的修改需重新注册或依赖托管服务

4. 智能合约风险:尽管 Registry 合约经审计,仍存在潜在漏洞可能

5. API 可用性:Zeru 托管服务中断可能影响代理元数据解析

zscore 内容

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