erc-8004ERC-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.
Install via ClawdBot CLI:
clawdbot install sp0oby/erc-8004On-chain identity, reputation, and validation for autonomous agents. Now live on Ethereum Mainnet!
ERC-8004 provides three registries:
./scripts/register.sh --uri "ipfs://..." --network mainnet
./scripts/register.sh --network sepolia # Testnet (no URI, set later)
./scripts/query.sh total --network mainnet # Total registered
./scripts/query.sh agent 1 --network mainnet # Agent details
./scripts/query.sh reputation 1 # Reputation summary
./scripts/set-uri.sh --agent-id 1 --uri "ipfs://newHash" --network mainnet
./scripts/feedback.sh --agent-id 1 --score 85 --tag1 "quality"
./scripts/feedback.sh --agent-id 1 --score 9977 --decimals 2 --tag1 "uptime"
| 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.
{
"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.
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 |
ERC-8004 supports three pluggable trust models:
cast (Foundry) - curl -L https://foundry.paradigm.xyz | bashjq - brew install jq~/.clawdbot/wallets/.deployer_pk or PRIVATE_KEY envPINATA_JWT for uploads, or upload manuallyERC-8004 launched on mainnet January 29, 2026. February is "Genesis Month" - showcasing teams building the agentic economy. Get involved!
Generated Mar 1, 2026
A platform where AI agents register on-chain via ERC-8004 to offer services like content generation or data analysis. Clients discover agents based on reputation scores and give feedback after interactions, building a trustless ecosystem for autonomous transactions.
An AI agent that tracks goods across a supply chain, registering its identity and validation proofs on Ethereum. It provides real-time updates and earns reputation for accuracy, with stakeholders using its verified data for logistics decisions.
An autonomous trading agent that registers with ERC-8004 to execute trades on decentralized exchanges. It accumulates reputation based on tradingYield and uptime scores, allowing users to trust its performance without central oversight.
An AI agent that processes anonymized medical data, using TEE attestations from ERC-8004's validation registry to prove secure computation. Hospitals and researchers rely on its reputation for privacy and accuracy in handling sensitive information.
A network of AI agents that moderate online content, each registering with ERC-8004 to build reputation through quality scores. Platforms can query agent registries to select moderators based on feedback, ensuring scalable and trustworthy moderation.
Offer a SaaS platform that helps users register, update, and query AI agents on ERC-8004 networks. Charge subscription fees for automated scripts, IPFS uploads, and reputation monitoring tools, leveraging the skill's quick reference commands.
Develop a dashboard that aggregates and visualizes reputation scores from ERC-8004's reputation registry. Sell access to businesses needing insights into agent performance, with premium features for trend analysis and alerting based on feedback tags.
Provide independent verification services using zkML or TEEs, as supported by ERC-8004's trust models. Charge per validation for agents requiring attestations, with revenue from enterprises seeking crypto-verification for high-stakes applications.
💬 Integration Tip
Start by testing on Sepolia testnet with the provided scripts, then use the registration JSON template to ensure proper metadata formatting before deploying to mainnet.
Connect Claude to Clawdbot instantly and keep it connected 24/7. Run after setup to link your subscription, then auto-refreshes tokens forever.
Autonomous crypto trading on Base via Bankr. Use for trading tokens, monitoring launches, executing strategies, or managing a trading portfolio. Triggers on "trade", "buy", "sell", "launch", "snipe", "profit", "PnL", "portfolio balance", or any crypto trading task on Base.
Deploy ERC20 tokens on Base using Clanker SDK. Create tokens with built-in Uniswap V4 liquidity pools. Supports Base mainnet and Sepolia testnet. Requires PRIVATE_KEY in config.
Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when the user wants to check wallet balances, DeFi positions, NFT holdings, token prices, or transaction history. Supports Base, Ethereum, Polygon, Arbitrum, Optimism, and more. Requires ZAPPER_API_KEY.
Interact with Solana blockchain via Helius APIs. Create/manage wallets, check balances (SOL + tokens), send transactions, swap tokens via Jupiter, and monitor addresses. Use for any Solana blockchain operation, crypto wallet management, token transfers, DeFi swaps, or portfolio tracking.
Real-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis.