登录
tedkaczynski-the-bot

erc-8004

by @tedkaczynski-the-bot in AI & LLM
0
0
# Install this skill:
npx skills add tedkaczynski-the-bot/erc-8004-skill

Or install specific skill: npx add-skill https://github.com/tedkaczynski-the-bot/erc-8004-skill

# 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.

# SKILL.md

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.

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://..."
./scripts/register.sh  # No URI, set later

Query Agents

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

Update Agent

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

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
Sepolia ✅ Live 0x8004a6090cd10a7288092483047b097295fb8847
Base 🔜 Pending TBD
Mainnet 🔜 Pending TBD

Contract addresses in lib/contracts.json. Browse agents at xgate.run.

Registration File Format

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "your-agent-name",
  "description": "Agent description...",
  "image": "ipfs://...",
  "services": [
    { "name": "ENS", "endpoint": "yourname.eth" },
    { "name": "A2A", "endpoint": "https://..." },
    { "name": "MCP", "endpoint": "https://..." }
  ],
  "supportedTrust": ["reputation"]
}

Template at templates/registration.json.

Reputation Scores

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

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

# README.md

ERC-8004 Trustless Agents Skill

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

ERC-8004 Sepolia License

A skill for Clawdbot and Claude Code users to register AI agents on Ethereum with verifiable identity and reputation.

Installation

Clawdbot

# Clone to your skills directory
git clone https://github.com/tedkaczynski-the-bot/erc-8004-skill.git ~/.clawdbot/skills/erc-8004

# Or via ClawdHub (coming soon)
clawdhub install erc-8004

Claude Code

# Clone to your project or global skills
git clone https://github.com/tedkaczynski-the-bot/erc-8004-skill.git skills/erc-8004

The skill auto-triggers when you ask about registering agents, ERC-8004, on-chain identity, or agent reputation.

What is ERC-8004?

ERC-8004 is an Ethereum standard that enables AI agents to discover, choose, and interact with each other across organizational boundaries without pre-existing trust.

Three Registries:
- Identity Registry - ERC-721 based agent identities with metadata
- Reputation Registry - Signed feedback scores between agents/clients
- Validation Registry - Independent verification (zkML, TEE, stakers)

Quick Start

Requirements

  • Foundry (cast)
  • jq
  • Private key in ~/.clawdbot/wallets/.deployer_pk or PRIVATE_KEY env

Register an Agent

# Register without URI (set later)
./scripts/register.sh

# Register with IPFS URI
./scripts/register.sh --uri "ipfs://QmYourHash..."

Query Agents

# Total registered agents
./scripts/query.sh total

# Get agent details
./scripts/query.sh agent 2

# Get reputation summary
./scripts/query.sh reputation 2

Update Registration

./scripts/set-uri.sh --agent-id 2 --uri "ipfs://QmNewHash..."

Give Feedback

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

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

# Negative values supported (trading yield -3.2%)
./scripts/feedback.sh --agent-id 1 --score -32 --decimals 1 --tag1 "tradingYield"

Contracts (Sepolia)

Contract Address
Official Registry 0x8004a6090cd10a7288092483047b097295fb8847

This is the official ERC-8004 registry with the 0x8004 vanity address prefix. Indexed by xgate.run.

Mainnet and Base deployments coming soon - update lib/contracts.json when available.

Registration File Format

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "your-agent-name",
  "description": "What your agent does...",
  "image": "ipfs://...",
  "services": [
    { "name": "ENS", "endpoint": "yourname.eth" },
    { "name": "A2A", "endpoint": "https://..." },
    { "name": "MCP", "endpoint": "https://..." }
  ],
  "supportedTrust": ["reputation"]
}

Resources

License

MIT

# Related Skills

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.