ERC-800Claw

CLI Options

Example CLI Output

$ erc-800claw agent 1
Agent #1 (mainnet)
────────────────────────────────────────
Owner:    0x1234...abcd
URI:      data:application/json;base64,...
Name:     My Agent
About:    An autonomous agent for...
Explorer: https://etherscan.io/nft/0x8004.../1
$ erc-800claw exists 100
Agent 100 exists on mainnet
$ erc-800claw owner 0x1234...
Address 0x1234... owns 3 agent(s) on mainnet
$ PRIVATE_KEY=0x... erc-800claw register --name "My Agent" --network sepolia
Agent Registered on sepolia!
────────────────────────────────────────
Agent ID: 42
Owner:    0x1234...abcd
Tx:       0xabc123...
Explorer: https://sepolia.etherscan.io/nft/0x8004.../42

How ERC-8004 Works

ERC-8004 provides three on-chain registries:

1. Identity Registry (ERC-721) - Every agent gets a unique NFT token with metadata URI 2. Reputation Registry - Structured feedback scores from clients to agents 3. Validation Registry - Independent verification (zkML, TEE, stakers)

The flow: 1. Register - Mint an agent identity NFT with name/description metadata 2. Operate - Use your agent ID when interacting with other agents 3. Build Reputation - Clients give feedback, scores accumulate on-chain 4. Verify (optional) - Validators attest to capabilities

Using in Code

Node.js / TypeScript

const { createClient } = require('erc-800claw');
const client = createClient({ network: 'mainnet' });
// Get agent by ID
const agent = await client.getAgent(1);
console.log(agent);
// {
//   agentId: 1,
//   tokenURI: 'data:application/json;base64,...',
//   owner: '0x...',
//   metadata: { name: 'My Agent', description: '...' },
//   explorerUrl: 'https://etherscan.io/...'
// }
// Check if agent exists
const exists = await client.agentExists(42);
// Get agent count for address
const count = await client.getAgentCount('0x...');
// Register a new agent (no IPFS needed - uses data URI!)
const result = await client.registerAgent(process.env.PRIVATE_KEY, {
  name: 'My Autonomous Agent',
  description: 'Handles customer support',
  services: [{ name: 'support', endpoint: 'https://myagent.com/api' }]
});
console.log(Registered agent #${result.agentId});
// Give feedback to an agent
await client.giveFeedback(process.env.PRIVATE_KEY, agentId, {
  value: 4.5,     // Score out of 5
  decimals: 1,
  tag1: 'support',
  tag2: 'fast'
});

Python

from erc800claw import create_client
import os
client = create_client(network='mainnet')
Get agent by ID
agent = client.get_agent(1)
print(agent)
{
    'agent_id': 1,
    'token_uri': 'data:application/json;base64,...',
    'owner': '0x...',
    'metadata': {'name': 'My Agent', 'description': '...'},
    'explorer_url': 'https://etherscan.io/...'
}
Check if agent exists
exists = client.agent_exists(42)
Get agent count for address
count = client.get_agent_count('0x...')
Register a new agent (no IPFS needed - uses data URI!)
result = client.register_agent(
    private_key=os.environ['PRIVATE_KEY'],
    name='My Autonomous Agent',
    description='Handles customer support',
    services=[{'name': 'support', 'endpoint': 'https://myagent.com/api'}]
)
print(f"Registered agent #{result['agent_id']}")
Give feedback to an agent
client.give_feedback(
    private_key=os.environ['PRIVATE_KEY'],
    agent_id=agent_id,
    value=4.5,        # Score out of 5
    decimals=1,
    tag1='support',
    tag2='fast'
)

Metadata Format

Agent metadata follows a standard schema:

{
  "name": "My Agent",
  "description": "What my agent does",
  "image": "https://example.com/avatar.png",
  "services": [
    {
      "name": "api",
      "endpoint": "https://myagent.com/api",
      "description": "Main API endpoint"
    }
  ],
  "supported_trust": ["reputation", "validation"]
}

The SDK automatically encodes this as a data URI - no IPFS upload required.

Integration with xClaw02

ERC-800Claw works with xClaw02 (x402 payments) to enable paid agent services:

1. Register your agent identity with ERC-800Claw 2. Set up payment receiving with xClaw02 3. Clients verify your identity, pay for services, then rate you

See the xClaw02 skill for payment setup.

Supported Networks

| Network | Chain ID | Status | |---------|----------|--------| | Ethereum Mainnet | 1 | Live | | Sepolia Testnet | 11155111 | Live |

Contract Addresses

Mainnet

Sepolia

Environment Variables

| Variable | Format | Description | |----------|--------|-------------| | PRIVATE_KEY | 0x + 64 hex chars | Wallet private key (required for registration/feedback) | | ERC8004_NETWORK | mainnet, sepolia | Default network (default: mainnet) | | ERC8004_RPC_URL | URL | Custom RPC endpoint |

Error Handling

| Error | Meaning | What to Do | |-------|---------|------------| | Agent not found | No agent with that ID | Verify the agent ID is correct | | Agent already exists | Token already minted | Each agent ID is unique | | Not the owner | Can't modify other's agents | Only owner can update agent metadata | | Invalid address | Malformed Ethereum address | Check address format (0x + 40 hex chars) |

Security Notes

Links