kernel8901 Zeru ERC-8004 Identity Registry
Register and manage AI agents on the Zeru Identity Registry (Base Sepolia). Costs 0.001 ETH per registration.
One-Time Setup
Run once to install dependencies:
cd {baseDir} && npm install
Commands
/zeruai register --name <name> --description <desc> --endpoint <url>
Register a new agent on-chain. Pays 0.001 ETH fee. Creates hosted agent URI, mints NFT, and updates URI with real agentId.
/zeruai register --name "Trading Bot" --description "AI-powered trading agent" --endpoint "https://mybot.com/api"
/zeruai register --name "Data Analyzer" --description "Analyzes datasets" --endpoint "https://analyzer.ai/api" --image "https://example.com/icon.png"
Requires PRIVATE_KEY env var. Wallet must have ~0.002 ETH (0.001 fee + gas).
To run: npx tsx {baseDir}/scripts/zeru.ts register --name "..." --description "..." --endpoint "..."
/zeruai read <agentId>
Read an agent's on-chain data: owner, URI, wallet, name, services.
/zeruai read 16
To run: npx tsx {baseDir}/scripts/zeru.ts read 16
/zeruai fee
Check current registration fee and whether registration is open.
/zeruai fee
To run: npx tsx {baseDir}/scripts/zeru.ts fee
/zeruai set-metadata <agentId> --key <key> --value <value>
Set custom metadata on an agent. Only the owner can call.
/zeruai 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"
/zeruai unset-wallet <agentId>
Clear the agent wallet. Only the owner can call.
/zeruai unset-wallet 16
Requires PRIVATE_KEY.
To run: npx tsx {baseDir}/scripts/zeru.ts unset-wallet 16
Setup
Read-Only (no setup needed)
read and fee work without a private key.
With Wallet (for registration and writes)
Add to your OpenClaw config (~/.openclaw/openclaw.json):
{
"skills": {
"entries": {
"zeruai": {
"enabled": true,
"env": {
"PRIVATE_KEY": "0xYourFundedPrivateKey"
}
}
}
}
}
Optional env: RPC_URL to override default RPC (default: https://sepolia.base.org).
Contract Info
- Network: Base Sepolia (chainId 84532)
- Identity Registry:
0xF0682549516A4BA09803cCa55140AfBC4e5ed2E0 - Registration Fee: 0.001 ETH
- Source:
zeru
How It Works
- register creates a hosted JSON document (ERC-8004 registration-v1 schema) via the Agent URI API, mints an NFT on the Identity Registry (paying the fee), then updates the document with the real agentId.
- read queries the on-chain contract for owner, tokenURI, and agentWallet, then fetches and parses the URI JSON.
- fee reads the current
registrationFee()andregistrationEnabled()from the contract. - set-metadata calls
setMetadata(agentId, key, value)on the contract. - unset-wallet calls
unsetAgentWallet(agentId)on the contract.