erc-8004 – OpenClaw Skill

---

name: erc-8004 description: 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.

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

Network	Status	Identity Registry	Reputation Registry
Mainnet	Live	0x8004A169FB4a3325136EB29fA0ceB6D2e539a432	0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Sepolia	Live	0x8004A818BFB912233c491871b3d84c89A494BD9e	0x8004B663056A597Dffe9eCcC1965A193B7388713
Base	Coming	TBD	TBD
Arbitrum	Coming	TBD	TBD
Optimism	Coming	TBD	TBD

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):

Tag	Meaning	Example	value	decimals
starred	Quality (0-100)	87/100	87	0
uptime	Uptime %	99.77%	9977	2
tradingYield	Yield %	-3.2%	-32	1
responseTime	Latency ms	560ms	560	0

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!

ERC-8004: Trustless Agents

On-chain identity, reputation, and validation for autonomous agents on Ethereum.

Now live on Ethereum Mainnet! (January 29, 2026)

What is ERC-8004?

ERC-8004 extends the Agent-to-Agent (A2A) Protocol with a trust layer that allows participants to discover, choose, and interact with agents across organizational boundaries without pre-existing trust.

The protocol provides three lightweight on-chain registries:

Registry	Purpose	Details
Identity	Agent discovery & portable identifiers	ERC-721 with URIStorage
Reputation	Feedback & attestation system	Signed fixed-point scores
Validation	Independent verification hooks	TEE, zkML, staking

Contract Addresses

Ethereum Mainnet

• Identity Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
• Reputation Registry: 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63

Sepolia Testnet

• Identity Registry: 0x8004A818BFB912233c491871b3d84c89A494BD9e
• Reputation Registry: 0x8004B663056A597Dffe9eCcC1965A193B7388713

Quick Start

Prerequisites

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

# Install jq
brew install jq

Register an Agent

# Set your private key
export PRIVATE_KEY="0x..."

# Register on mainnet
./scripts/register.sh --uri "ipfs://QmYourHash..." --network mainnet

# Or testnet first
./scripts/register.sh --uri "ipfs://QmYourHash..." --network sepolia

Query Agents

# Total registered agents
./scripts/query.sh total --network mainnet

# Get agent details
./scripts/query.sh agent 1 --network mainnet

# Check reputation
./scripts/query.sh reputation 1 --network mainnet

Give Feedback

# Rate an agent (0-100 score)
./scripts/feedback.sh --agent-id 1 --score 85 --tag1 "quality" --network mainnet

# Percentage with decimals (99.77%)
./scripts/feedback.sh --agent-id 1 --score 9977 --decimals 2 --tag1 "uptime"

Agent Registration Format

Your agentURI should resolve to a JSON registration file:

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "My Agent",
  "description": "An autonomous agent that...",
  "image": "ipfs://QmImageHash...",
  "services": [
    { "name": "A2A", "endpoint": "https://agent.example/.well-known/agent-card.json" },
    { "name": "MCP", "endpoint": "https://mcp.agent.example/" },
    { "name": "ENS", "endpoint": "myagent.eth" }
  ],
  "supportedTrust": ["reputation"]
}

See templates/registration.json for a complete example.

Trust Models

ERC-8004 supports pluggable trust mechanisms:

• Reputation-based - Client feedback with scores (0-100), tags, and off-chain metadata
• Crypto-economic - Stake-secured validation with economic incentives
• Crypto-verification - TEE attestations and zkML proofs for cryptographic trust

Resources

• EIP-8004 Specification
• 8004.org - Official website
• Reference Implementation
• Telegram Community
• Builder Program
• Awesome ERC-8004

Related

• A2A Protocol - Agent-to-Agent protocol that ERC-8004 extends
• ERC-721 - Base NFT standard for Identity Registry

License

CC0 - Public Domain

---

Part of the Clawdbot Skills ecosystem