ERC-8004: Trustless Agents

On-chain identity, reputation, and validation for autonomous agents. Now live on Ethereum Mainnet!

Overview

ERC-8004 provides three registries:

• Identity Registry - ERC-721 agent identities with registration metadata

• Reputation Registry - Signed feedback scores between agents/clients

• Validation Registry - Independent verification (zkML, TEE, stakers)

Quick Reference

Register Agent

./scripts/register.sh --uri "ipfs://..." --network mainnet
./scripts/register.sh --network sepolia  # Testnet (no URI, set later)

Query Agents

./scripts/query.sh total --network mainnet    # Total registered
./scripts/query.sh agent 1 --network mainnet  # Agent details
./scripts/query.sh reputation 1               # Reputation summary

Update Agent

./scripts/set-uri.sh --agent-id 1 --uri "ipfs://newHash" --network mainnet

Give Feedback

./scripts/feedback.sh --agent-id 1 --score 85 --tag1 "quality"
./scripts/feedback.sh --agent-id 1 --score 9977 --decimals 2 --tag1 "uptime"

Networks

Contract addresses in lib/contracts.json.

Registration File Format

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "your-agent-name",
  "description": "Agent description...",
  "image": "ipfs://...",
  "services": [
    { "name": "A2A", "endpoint": "https://agent.example/.well-known/agent-card.json", "version": "0.3.0" },
    { "name": "MCP", "endpoint": "https://mcp.agent.eth/", "version": "2025-06-18" },
    { "name": "ENS", "endpoint": "yourname.eth" }
  ],
  "registrations": [
    { "agentRegistry": "eip155:1:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "agentId": "1" }
  ],
  "supportedTrust": ["reputation", "crypto-economic", "tee-attestation"]
}

Template at templates/registration.json.

Reputation Scores

The reputation system uses signed fixed-point numbers (value + valueDecimals):

Trust Models

ERC-8004 supports three pluggable trust models:

• Reputation-based - Client feedback with scores, tags, and metadata

• Crypto-economic - Stake-secured validation with economic incentives

• Crypto-verification - TEE attestations and zkML proofs

Dependencies

• cast (Foundry) - curl -L https://foundry.paradigm.xyz | bash

• jq - brew install jq

• Private key in ~/.clawdbot/wallets/.deployer_pk or PRIVATE_KEY env

• IPFS: Set PINATA_JWT for uploads, or upload manually

Resources

Official

• EIP-8004 Spec - Full specification

• 8004.org - Official website

• Reference Implementation - Contract source

• Telegram Community - Builder chat

• Builder Program - Join the ecosystem

SDKs & Tools

• ChaosChain SDK - JS/TS SDK

• erc-8004-js - Lightweight JS library

• erc-8004-py - Python implementation

• Vistara Example - Full demo with AI agents

Ecosystem

• Awesome ERC-8004 - Curated resource list

• A2A Protocol - Agent-to-Agent protocol ERC-8004 extends

• Ethereum Magicians Discussion

Genesis Month (February 2026)

ERC-8004 launched on mainnet January 29, 2026. February is "Genesis Month" - showcasing teams building the agentic economy. Get involved!