/erc8004

name: erc8004
description: "Register AI agent identity on Ethereum via ERC-8004 Trustless Agents standard"
command: agent-id
emoji: "🤖"
gates:
  envs:
    - PRIVATE_KEY

ERC-8004: Trustless Agents

Register your AI agent on Ethereum mainnet with a verifiable on-chain identity.

What is ERC-8004?

Ethereum standard for trustless agent identity and reputation:

• **Identity Registry** - ERC-721 based agent IDs
• **Reputation Registry** - Feedback and trust signals
• **Validation Registry** - Third-party verification

Website: https://www.8004.org

Contract Addresses

| Chain | Identity Registry | Reputation Registry | |-------|-------------------|---------------------| | Ethereum | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` | `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63` | | Sepolia | `0x8004A818BFB912233c491871b3d84c89A494BD9e` | `0x8004B663056A597Dffe9eCcC1965A193B7388713` |

Commands

Register

/agent-id register                   Register your agent
/agent-id register --name "My Agent" --description "An AI agent"

Info

/agent-id info <agent-id>            Get agent info
/agent-id lookup <address>           Find agent ID by address
/agent-id reputation <agent-id>      Check agent reputation

Update

/agent-id update <agent-id> --name "New Name"
/agent-id update <agent-id> --image ipfs://...

Registration File Format

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "My Agent",
  "description": "An AI assistant",
  "image": "https://example.com/avatar.png",
  "active": true
}

Examples

/agent-id register --name "Trading Bot" --description "Automated trading agent"
/agent-id info 123
/agent-id reputation 123

Setup

export PRIVATE_KEY="0x..."      # Wallet with ETH on mainnet
export PINATA_JWT="..."         # Optional: for IPFS uploads

Gas: ~100-200k gas for registration (~$5-20 depending on gas prices)