zscoreRegister agents on the Zeru ERC-8004 Identity Registry, manage wallets and metadata, and read on-chain state. Use when an agent needs to register on-chain, check fees, read agent info, set metadata, or manage agent wallets on Base Mainnet or Base Sepolia.
Install via ClawdBot CLI:
clawdbot install elitex45/zscoreRegister and manage AI agents on the Zeru Identity Registry. Defaults to Base Mainnet (0.0025 ETH fee). Use --chain 84532 for Base Sepolia testnet.
Run once to install dependencies:
cd {baseDir} && npm installWhen registering an agent, you provide a JSON file describing the agent. The SDK auto-fills type, registrations, and defaults for x402Support/active/image if omitted.
Minimal JSON (just name + description + one service):
{
"name": "My AI Agent",
"description": "A helpful AI agent that does X",
"services": [
{ "name": "web", "endpoint": "https://myagent.example.com" }
]
}Full JSON (MCP + A2A + OASF + x402 payments):
{
"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"]
}All fields:
| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| name | string | Yes | — | Agent name (1–256 chars) |
| description | string | Yes | — | What the agent does (max 2048 chars) |
| image | string | No | placeholder | Avatar URL (HTTPS, IPFS, or Arweave) |
| services | array | Yes | — | Service endpoints (1–64 items, see below) |
| x402Support | boolean | No | false | Supports x402 payment protocol |
| active | boolean | No | true | Agent is actively accepting requests |
| supportedTrust | string[] | No | — | Trust models: "reputation", "crypto-economic", "tee-attestation", "ERC-8004" |
| owner | string | No | signer address | Owner 0x address (auto-set from PRIVATE_KEY) |
Service types:
| name | endpoint | Extra fields |
|--------|-----------|--------------|
| "web" | Website URL | — |
| "MCP" | MCP server URL | version, mcpTools[], mcpPrompts[], mcpResources[], capabilities[] |
| "A2A" | Agent card URL (/.well-known/agent-card.json) | version, a2aSkills[] |
| "OASF" | OASF repo URL | version, skills[], domains[] |
| "agentWallet" | CAIP-10 address (eip155:{chainId}:{address}) | — |
| "ENS" | ENS name (e.g. myagent.eth) | — |
| "email" | Email address | — |
| custom | Any URL | description |
/zscore register --json Register a new agent using a full JSON file (recommended). Creates hosted agent URI, mints NFT on-chain, and updates URI with the real agentId.
/zscore register --json agent.json
/zscore register --json agent.json --chain 84532Steps to register:
agent.json)npx tsx {baseDir}/scripts/zeru.ts register --json agent.jsonThe SDK automatically adds type, registrations (with agentId: 0 placeholder), and defaults for missing optional fields. After minting, it updates the document with the real agentId.
/zscore register --name --description --endpoint Simple registration (single API endpoint only). For richer agents, use --json instead.
/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 84532Requires PRIVATE_KEY env var. Wallet must have fee + gas (e.g. ~0.003 ETH on mainnet).
To run: npx tsx {baseDir}/scripts/zeru.ts register --name "..." --description "..." --endpoint "..."
/zscore read Read an agent's on-chain data: owner, URI, wallet, name, services.
/zscore read 16To run: npx tsx {baseDir}/scripts/zeru.ts read 16
/zscore feeCheck current registration fee and whether registration is open.
/zscore feeTo run: npx tsx {baseDir}/scripts/zeru.ts fee
/zscore set-metadata --key --value Set custom metadata on an agent. Only the owner can call.
/zscore set-metadata 16 --key "category" --value "trading"Requires PRIVATE_KEY.
To run: npx tsx {baseDir}/scripts/zeru.ts set-metadata 16 --key "category" --value "trading"
/zscore unset-wallet Clear the agent wallet. Only the owner can call.
/zscore unset-wallet 16Requires PRIVATE_KEY.
To run: npx tsx {baseDir}/scripts/zeru.ts unset-wallet 16
read and fee work without a private key.
Add to your OpenClaw config (~/.openclaw/openclaw.json):
{
"skills": {
"entries": {
"zscore": {
"enabled": true,
"env": {
"PRIVATE_KEY": "0xYourFundedPrivateKey"
}
}
}
}
}Optional env:
RPC_URL — override default RPCCHAIN_ID — override chain (default: 8453 for Base Mainnet, use 84532 for Base Sepolia)0xFfE9395fa761e52DBC077a2e7Fd84f77e8abCc410x187d72a58b3BF4De6432958fc36CE569Fb15C2370xF0682549516A4BA09803cCa55140AfBC4e5ed2E00xaAC7557475023AEB581ECc8bD6886d1742382421zeruregistrationFee() and registrationEnabled() from the contract.setMetadata(agentId, key, value) on the contract.unsetAgentWallet(agentId) on the contract.Generated Mar 1, 2026
An AI agent developer registers their agent on the Zeru Identity Registry to list it in a marketplace for discoverability and trust. They provide a detailed JSON with MCP, A2A, and OASF services to showcase capabilities, enabling users to verify on-chain ownership and service endpoints. This ensures transparency and interoperability across platforms.
A company deploys an AI agent for blockchain data analysis, registering it with x402 payment support to enable microtransactions for services. They use the full JSON structure to include multiple service types like MCP for tools and agentWallet for receiving payments, ensuring seamless integration with enterprise workflows and compliance.
A developer tests their AI agent on Base Sepolia testnet using the --chain flag to avoid mainnet fees, validating registration, metadata updates, and wallet management. They simulate real-world scenarios like setting custom metadata and checking fees, ensuring the agent functions correctly before deploying to production.
An organization registers multiple AI agents with supportedTrust fields like reputation and ERC-8004 to build verifiable trust models. They use the read command to monitor on-chain data and set-metadata to add categories or tags, enhancing agent credibility and enabling cross-platform verification for users.
Developers offer AI agents with specialized services like MCP tools or A2A skills, charging subscription fees via x402 payments enabled in registration. Revenue is generated through recurring payments for access to agent capabilities, with on-chain registration providing proof of ownership and service authenticity.
A platform hosts a marketplace for AI agents, charging listing fees for registration on the Zeru Registry and taking commissions on transactions facilitated through agent services. Revenue comes from fees paid by developers to register agents and from a percentage of payments processed via agent wallets.
Agency provides consulting to businesses for registering and managing AI agents, including JSON structuring, metadata setup, and wallet integration. Revenue is generated through service fees for setup, customization, and ongoing support, leveraging the skill's commands for efficient deployment.
💬 Integration Tip
Ensure PRIVATE_KEY is securely stored and use testnet for initial trials to minimize costs and errors before mainnet deployment.
Connect Claude to Clawdbot instantly and keep it connected 24/7. Run after setup to link your subscription, then auto-refreshes tokens forever.
ERC-8004 Trustless Agents - Register, discover, and build reputation for AI agents on Ethereum. Use when registering agents on-chain, querying agent registries, giving/receiving reputation feedback, or interacting with the AI agent trust layer.
Autonomous crypto trading on Base via Bankr. Use for trading tokens, monitoring launches, executing strategies, or managing a trading portfolio. Triggers on "trade", "buy", "sell", "launch", "snipe", "profit", "PnL", "portfolio balance", or any crypto trading task on Base.
Deploy ERC20 tokens on Base using Clanker SDK. Create tokens with built-in Uniswap V4 liquidity pools. Supports Base mainnet and Sepolia testnet. Requires PRIVATE_KEY in config.
Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when the user wants to check wallet balances, DeFi positions, NFT holdings, token prices, or transaction history. Supports Base, Ethereum, Polygon, Arbitrum, Optimism, and more. Requires ZAPPER_API_KEY.
Interact with Solana blockchain via Helius APIs. Create/manage wallets, check balances (SOL + tokens), send transactions, swap tokens via Jupiter, and monitor addresses. Use for any Solana blockchain operation, crypto wallet management, token transfers, DeFi swaps, or portfolio tracking.