AGENT SKILL

erc-8004

Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents). Use when the user wants to register their agent identity on-chain, create an agent profile, claim an agent NFT, set up agent reputation, or make their agent discoverable. Handles bridging ETH to mainnet, IPFS upload, and on-chain registration.

License 许可
MIT
最近更新
2026-06-11
Stars
★ 0
Forks
0

01 前言 Front Matter

name
erc-8004
description
Register AI agents on Ethereum mainnet using ERC-8004 (Trustless Agents). Use when the user wants to register their agent identity on-chain, create an agent profile, claim an agent NFT, set up agent reputation, or make their agent discoverable. Handles bridging ETH to mainnet, IPFS upload, and on-chain registration.

02 资源文件 9

03 SKILL.md 正文

ERC-8004: Trustless Agents

Register your AI agent on Ethereum mainnet with a verifiable on-chain identity, making it discoverable and enabling trust signals.

What is ERC-8004?

ERC-8004 is an Ethereum standard for trustless agent identity and reputation:

  • Identity Registry - ERC-721 based agent IDs (your agent gets an NFT!)
  • Reputation Registry - Feedback and trust signals from other agents/users
  • Validation Registry - Third-party verification of agent work

Website: https://www.8004.org Spec: https://eips.ethereum.org/EIPS/eip-8004

Contract Addresses

Chain Identity Registry Reputation Registry
Ethereum Mainnet 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Sepolia Testnet 0x8004A818BFB912233c491871b3d84c89A494BD9e 0x8004B663056A597Dffe9eCcC1965A193B7388713

Quick Start

1. Register Your Agent

# Full registration (creates profile, uploads to IPFS, registers on-chain)
./scripts/register.sh

# Or with custom values
NAME="My Agent" \
DESCRIPTION="An AI agent that does cool stuff" \
IMAGE="https://example.com/avatar.png" \
./scripts/register.sh

2. Bridge ETH to Mainnet (if needed)

# Bridge ETH from Base to Ethereum mainnet
./scripts/bridge-to-mainnet.sh 0.01

3. Update Agent Profile

# Update your agent's registration file
./scripts/update-profile.sh <agent-id> <new-ipfs-uri>

Environment Variables

Variable Description Required
PINATA_JWT Pinata API JWT for IPFS uploads No (only for IPFS)
AGENT_NAME Agent display name No (defaults to wallet ENS or address)
AGENT_DESCRIPTION Agent description No
AGENT_IMAGE Avatar URL No

Registration Options

Option 1: Use 8004.org frontend (easiest) Visit https://www.8004.org and register through the UI — handles IPFS automatically.

Option 2: HTTP URL (no IPFS needed) Host your registration JSON at any URL:

REGISTRATION_URL="https://myagent.xyz/agent.json" ./scripts/register-http.sh

Option 3: IPFS via Pinata

PINATA_JWT="your-jwt" ./scripts/register.sh

Option 4: Data URI (fully on-chain) Encode your registration as base64 — no external hosting needed:

./scripts/register-onchain.sh

Registration File Format

Your agent's registration file (stored on IPFS) follows this structure:

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "My Agent",
  "description": "An AI assistant for various tasks",
  "image": "https://example.com/avatar.png",
  "services": [
    {
      "name": "web",
      "endpoint": "https://myagent.xyz/"
    },
    {
      "name": "A2A",
      "endpoint": "https://myagent.xyz/.well-known/agent-card.json",
      "version": "0.3.0"
    }
  ],
  "x402Support": false,
  "active": true,
  "registrations": [
    {
      "agentId": 123,
      "agentRegistry": "eip155:1:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432"
    }
  ],
  "supportedTrust": ["reputation"]
}

Workflow

  1. Bridge ETH (if needed) - Use Bankr to bridge ETH from Base/L2 to mainnet
  2. Create Profile - Generate a registration JSON file with agent info
  3. Upload to IPFS - Pin the file via Pinata (or other provider)
  4. Register On-Chain - Call register(agentURI) on the Identity Registry
  5. Update Profile - Set metadata, wallet, or update URI as needed

Costs

  • Gas: ~100-200k gas for registration (~$5-20 depending on gas prices)
  • IPFS: Free tier available on Pinata (1GB)

Using the SDK

For more advanced usage, install the Agent0 SDK:

npm install agent0-sdk
import { SDK } from 'agent0-sdk';

const sdk = new SDK({
  chainId: 1, // Ethereum Mainnet
  rpcUrl: process.env.ETH_RPC_URL,
  privateKey: process.env.PRIVATE_KEY,
  ipfs: 'pinata',
  pinataJwt: process.env.PINATA_JWT
});

const agent = sdk.createAgent('My Agent', 'Description', 'https://image.url');
const result = await agent.registerIPFS();
console.log(`Registered: Agent ID ${result.agentId}`);

Links

04 同仓库更多 Skills

dnzengou
dnzengou/agentbot-opensource

provisioning-v1

暂无简介

★ 0
dnzengou
dnzengou/agentbot-opensource

get-api-docs

Use this skill when you need documentation for a third-party library, SDK, or API before writing code that uses it — for example, "use the OpenAI API", "call the Stripe API", "use the Anthropic SDK", "query Pinecone", or any time the user asks you to write code against an external service and you need current API reference. Fetch the docs with chub before answering, rather than relying on training knowledge.

★ 0
dnzengou
dnzengou/agentbot-opensource

zyfai

Earn yield on any Ethereum wallet on Base, Arbitrum, and Plasma. Use when a user wants passive DeFi yield on their funds. Deploys a non-custodial deterministic subaccount (Safe) linked to their EOA, enables automated yield optimization, and lets them deposit/withdraw anytime.

★ 0
dnzengou
dnzengou/agentbot-opensource

zerion

Interpreted crypto wallet data for AI agents. Use when an agent needs portfolio values, token positions, DeFi positions, NFT holdings, transaction history, PnL data, token prices, charts, gas prices, swap quotes, or DApp information across 41+ chains. Zerion transforms raw blockchain data into agent-ready JSON with USD values, protocol labels, and enriched metadata. Supports x402 pay-per-request ($0.01 USDC on Base) and API key access. Triggers on mentions of portfolio, wallet analysis, positions, transactions, PnL, profit/loss, DeFi, token balances, NFTs, swap quotes, gas prices, or Zerion.

★ 0
dnzengou
dnzengou/agentbot-opensource

zapper

Placeholder for Zapper skill.

★ 0
dnzengou
dnzengou/agentbot-opensource

yoink

Play Yoink, an onchain capture-the-flag game on Base. Yoink the flag from the current holder, check game stats and leaderboards, view player scores, and compete for the trophy. Uses Bankr for transaction execution.

★ 0