Zeru ERC-8004 身份注册表

在 Zeru 身份注册表中注册和管理 AI 代理。默认使用 Base 主网（手续费为 0.0025 ETH）。如需使用 Base Sepolia 测试网，请指定 --chain 84532。

一次性初始化设置

仅需运行一次，用于安装依赖项：

cd {baseDir} && npm install

代理 JSON 结构（ERC-8004 registration-v1）

注册代理时，需提供一个描述该代理的 JSON 文件。SDK 将自动填充 type 和 registrations 字段；若未显式指定 x402Support、active 或 image，则使用其默认值。

最小化 JSON（仅含 name + description + 一项 service）：

{
  "name": "My AI Agent",
  "description": "A helpful AI agent that does X",
  "services": [
    { "name": "web", "endpoint": "https://myagent.example.com" }
  ]
}

完整 JSON（支持 MCP + A2A + OASF + x402 支付）：

{
  "name": "DataAnalyst Pro",
  "description": "Enterprise-grade blockchain data analysis agent. Performs on-chain forensics, wallet profiling, and transaction pattern detection.",
  "image": "https://cdn.example.com/agents/analyst.png",
  "services": [
    {
      "name": "MCP",
      "endpoint": "https://api.dataanalyst.ai/mcp",
      "version": "2025-06-18",
      "mcpTools": ["analyze_wallet", "trace_transactions", "detect_anomalies"],
      "capabilities": []
    },
    {
      "name": "A2A",
      "endpoint": "https://api.dataanalyst.ai/.well-known/agent-card.json",
      "version": "0.3.0",
      "a2aSkills": ["analytical_skills/data_analysis/blockchain_analysis"]
    },
    {
      "name": "OASF",
      "endpoint": "https://github.com/agntcy/oasf/",
      "version": "0.8.0",
      "skills": ["analytical_skills/data_analysis/blockchain_analysis"],
      "domains": ["technology/blockchain"]
    },
    {
      "name": "web",
      "endpoint": "https://dataanalyst.ai"
    },
    {
      "name": "agentWallet",
      "endpoint": "eip155:8453:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7"
    }
  ],
  "x402Support": true,
  "active": true,
  "supportedTrust": ["reputation", "ERC-8004"]
}

所有字段说明：

服务类型说明：

命令

/zscore register --json

使用完整 JSON 文件注册新代理（推荐方式）。该命令将生成托管的代理 URI、在链上铸造 NFT，并用真实的 agentId 更新 URI。

/zscore register --json agent.json
/zscore register --json agent.json --chain 84532

注册步骤：

1. 按上述结构创建 JSON 文件（例如 agent.json）
2. 执行：npx tsx {baseDir}/scripts/zeru.ts register --json agent.json

SDK 将自动添加 type、registrations（其中 agentId 初始占位为 0），以及缺失可选字段的默认值。铸造完成后，文档将被更新为真实的 agentId。

/zscore register --name --description --endpoint

简易注册方式（仅支持单个 API 端点）。如需注册更复杂的代理，请改用 --json 方式。

/zscore register --name "Trading Bot" --description "AI-powered trading agent" --endpoint "https://mybot.com/api"
/zscore register --name "Data Analyzer" --description "Analyzes datasets" --endpoint "https://analyzer.ai/api" --image "https://example.com/icon.png"
/zscore register --name "Test Bot" --description "Testing" --endpoint "https://test.com" --chain 84532

需要设置 PRIVATE_KEY 环境变量。钱包需持有足够余额以支付手续费及 Gas（例如主网上约需 0.003 ETH）。

执行命令：npx tsx {baseDir}/scripts/zeru.ts register --name "..." --description "..." --endpoint "..."

/zscore read

读取代理的链上数据：所有者地址、URI、钱包地址、名称、服务列表等。

/zscore read 16

执行命令：npx tsx {baseDir}/scripts/zeru.ts read 16

/zscore fee

查询当前注册手续费及注册功能是否启用。

/zscore fee

执行命令：npx tsx {baseDir}/scripts/zeru.ts fee

/zscore set-metadata --key --value

为代理设置自定义元数据。仅所有者可调用。

/zscore set-metadata 16 --key "category" --value "trading"

需要设置 PRIVATE_KEY 环境变量。

执行命令：npx tsx {baseDir}/scripts/zeru.ts set-metadata 16 --key "category" --value "trading"

/zscore unset-wallet

清除代理钱包地址。仅所有者可调用。

/zscore unset-wallet 16

需要设置 PRIVATE_KEY 环境变量。

执行命令：npx tsx {baseDir}/scripts/zeru.ts unset-wallet 16

初始化设置

只读模式（无需任何配置）

read 和 fee 命令无需私钥即可运行。

带钱包模式（用于注册与写操作）

请将以下内容添加至 OpenClaw 配置文件（~/.openclaw/openclaw.json）：

{
  "skills": {
    "entries": {
      "zscore": {
        "enabled": true,
        "env": {
          "PRIVATE_KEY": "0xYourFundedPrivateKey"
        }
      }
    }
  }
}

可选环境变量：

• RPC_URL —— 覆盖默认 RPC 地址
• CHAIN_ID —— 覆盖链 ID（默认为 8453，即 Base 主网；Base Sepolia 测试网应设为 84532）

合约信息

Base 主网（默认，chainId 8453）

• 身份注册表合约地址： 0xFfE9395fa761e52DBC077a2e7Fd84f77e8abCc41
• 声誉注册表合约地址： 0x187d72a58b3BF4De6432958fc36CE569Fb15C237
• 注册手续费： 0.0025 ETH
• RPC 地址： https://mainnet.base.org

Base Sepolia 测试网（chainId 84532）

• 身份注册表合约地址： 0xF0682549516A4BA09803cCa55140AfBC4e5ed2E0

• 声誉注册表合约地址： 0xaAC7557475023AEB581ECc8bD6886d1742382421

• 注册手续费： 0.001 ETH

• RPC 地址： https://sepolia.base.org

• 来源： zeru

工作原理

1. register：通过 Agent URI API 创建托管 JSON 文档（符合 ERC-8004 registration-v1 规范），在 Identity Registry 合约上铸造 NFT（同时支付手续费），再将真实 agentId 写入该文档。
2. read：从链上合约中查询 owner、tokenURI 和 agentWallet，随后获取并解析 URI 指向的 JSON 数据。
3. fee：从合约中读取当前 registrationFee() 和 registrationEnabled() 的返回值。
4. set-metadata：在合约上调用 setMetadata(agentId, key, value) 方法。
5. unset-wallet：在合约上调用 unsetAgentWallet(agentId) 方法。