Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bankrbot avatar

Erc 8004

  • 60 installs
  • 1.2k repo stars
  • Updated August 1, 2026
  • bankrbot/skills

ERC-8004 is a skill for registering an AI agent on Ethereum mainnet with a verifiable on-chain identity, ERC-721 agent NFT, and reputation signals under the Trustless Agents standard.

About

ERC-8004 is a skill for registering an AI agent on Ethereum mainnet with a verifiable on-chain identity under the ERC-8004 Trustless Agents standard. A developer uses it to give an agent an ERC-721 identity NFT and make it discoverable, with reputation and validation registries for trust signals. It handles bridging ETH from Base to mainnet, uploading a registration profile to IPFS via Pinata, and calling register on the Identity Registry, and offers registration via UI, HTTP URL, IPFS, or a fully on-chain data URI.

  • Registers an AI agent on Ethereum mainnet with a verifiable on-chain identity using ERC-8004 (Trustless Agents)
  • Covers Identity (ERC-721 agent NFT), Reputation, and Validation registries plus IPFS profile upload
  • Multiple registration paths: 8004.org UI, HTTP URL, Pinata IPFS, or fully on-chain data URI, with ETH bridging from Base

Erc 8004 by the numbers

  • 60 all-time installs (skills.sh)
  • Ranked #192 of 479 Web3 & Blockchain skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
At a glance

erc-8004 capabilities & compatibility

Requires ETH on mainnet for ~100-200k gas (~$5-20) and an optional free-tier Pinata JWT for IPFS.

Capabilities
agent registration · agent identity · reputation setup · ipfs upload
Use cases
orchestration
Runs
Runs locally
Pricing
Bring your own API key
From the docs

What erc-8004 says it does

Register your AI agent on Ethereum mainnet with a verifiable on-chain identity, making it discoverable and enabling trust signals.
SKILL.md
Identity Registry** - ERC-721 based agent IDs (your agent gets an NFT!)
SKILL.md
npx skills add https://github.com/bankrbot/skills --skill erc-8004

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs60
repo stars1.2k
Last updatedAugust 1, 2026
Repositorybankrbot/skills

What it does

Register an AI agent's identity on Ethereum mainnet via ERC-8004, minting an agent NFT and IPFS profile for discoverability.

Who is it for?

Giving an AI agent a verifiable, discoverable on-chain identity with reputation on Ethereum mainnet.

Skip if: Chains other than Ethereum mainnet/Sepolia or non-agent identity needs.

When should I use this skill?

A user wants to register their agent identity on-chain, create an agent profile, claim an agent NFT, or set up agent reputation.

What you get

An agent is registered on Ethereum mainnet with an ERC-721 identity NFT and IPFS profile.

  • an on-chain agent identity NFT
  • an IPFS or HTTP-hosted registration profile
  • an assigned agent ID

By the numbers

  • registration costs ~100-200k gas (~$5-20)
  • four registration options: UI, HTTP URL, IPFS, on-chain data URI

Files

SKILL.mdMarkdownGitHub ↗

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

ChainIdentity RegistryReputation Registry
Ethereum Mainnet0x8004A169FB4a3325136EB29fA0ceB6D2e539a4320x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Sepolia Testnet0x8004A818BFB912233c491871b3d84c89A494BD9e0x8004B663056A597Dffe9eCcC1965A193B7388713

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

VariableDescriptionRequired
PINATA_JWTPinata API JWT for IPFS uploadsNo (only for IPFS)
AGENT_NAMEAgent display nameNo (defaults to wallet ENS or address)
AGENT_DESCRIPTIONAgent descriptionNo
AGENT_IMAGEAvatar URLNo

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

Related skills

FAQ

What does registration create?

An ERC-721 agent identity NFT on the Identity Registry, plus reputation and validation registry entries for trust signals.

How can I register without IPFS?

Host the registration JSON at any HTTP URL, or encode it as a base64 data URI to keep it fully on-chain.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.