create-8004-agent

CLI tool to scaffold ERC-8004 compliant AI agents with A2A, MCP, and x402 payment support.

Supports both EVM chains and Solana.

What is ERC-8004?

ERC-8004 is a protocol for discovering and trusting AI agents across organizational boundaries. It provides:

• Identity Registry - On-chain agent registration as NFTs
• Reputation Registry - Feedback and trust signals
• Validation Registry - Stake-secured verification

Quick Start

npx create-8004-agent

That's it! The wizard will guide you through creating your agent.

What Gets Generated

The wizard creates a complete agent project with:

my-agent/
├── package.json
├── .env.example
├── registration.json          # ERC-8004 metadata
├── tsconfig.json
├── src/
│   ├── register.ts            # On-chain registration script
│   ├── agent.ts               # LLM agent (OpenAI)
│   ├── a2a-server.ts          # A2A protocol server (optional)
│   ├── mcp-server.ts          # MCP protocol server (optional)
│   └── tools.ts               # MCP tools (optional)
└── .well-known/
    └── agent-card.json        # A2A discovery card

Wizard Options

Option	Description
Project directory	Where to create the project
Agent name	Your agent's name
Agent description	What your agent does
Agent image	URL to your agent's image/logo
Agent wallet	EVM or Solana address (leave empty to auto-generate)
A2A server	Enable agent-to-agent communication
A2A streaming	Enable Server-Sent Events (SSE) for streaming responses
MCP server	Enable Model Context Protocol tools
x402 payments	Enable Coinbase x402 USDC payments (EVM & Solana)
Chain	EVM: Ethereum Sepolia (more chains coming soon) / Solana: Devnet
Trust models	reputation, crypto-economic, tee-attestation

Supported Chains

EVM Chains

Chain	Identity Registry	Status
ETH Sepolia	0x8004A818BFB912233c491871b3d84c89A494BD9e	✅ Available
Base Sepolia	Coming soon	🔜 Pending
Linea Sepolia	Coming soon	🔜 Pending
Polygon Amoy	Coming soon	🔜 Pending

Solana

Network	Program ID
Devnet	HvF3JqhahcX7JfhbDRYYCJ7S3f6nJdrqu5yi9shyTREp

Generated Project Usage

After generating your project:

cd my-agent
npm install

1. Configure Environment

Edit .env and fill in:

PRIVATE_KEY=...                   # Auto-generated if you left wallet empty
OPENAI_API_KEY=your_openai_key    # For LLM responses
PINATA_JWT=your_pinata_jwt        # If using IPFS storage (requires pinJSONToIPFS scope)

Auto-generated wallet: If you left the wallet address empty, a new wallet was generated and the private key is already in .env. Back up your .env file and fund the wallet with testnet tokens before registering.

• EVM chains: Fund with testnet ETH (use faucets for Sepolia, Base Sepolia, etc.)
• Solana Devnet: Fund with devnet SOL via solana airdrop or faucets

Pinata JWT: Create an API key at pinata.cloud with pinJSONToIPFS scope for public IPFS pinning.

2. Register Agent On-Chain

npm run register

EVM chains: Uploads metadata to IPFS and mints an NFT on the Identity Registry.

Solana: Validates metadata using buildRegistrationFileJson(), uploads to IPFS, and mints a Metaplex Core NFT via the 8004 program.

After registration, view your agent on 8004scan.io.

3. Start Your Servers

# Start A2A server
npm run start:a2a

# Start MCP server (in another terminal)
npm run start:mcp

A2A Protocol

The generated A2A server implements:

• Agent Card at /.well-known/agent-card.json
• JSON-RPC 2.0 endpoint at /a2a
• Methods: message/send, tasks/get, tasks/cancel

Testing Your A2A Endpoint

1. Start the server:

npm run start:a2a

2. Test the agent card:

curl http://localhost:3000/.well-known/agent-card.json

3. Test the JSON-RPC endpoint:

curl -X POST http://localhost:3000/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{"type": "text", "text": "Hello!"}]
      }
    },
    "id": 1
  }'

If x402 is enabled, you'll get a 402 Payment Required response with payment instructions. This is expected - it means the payment gate is working.

x402 Payments

If enabled, the A2A server uses Coinbase x402 for micropayments:

• EVM chains: Uses @x402/evm with USDC on supported networks
• Solana: Uses @x402/svm with USDC on Solana
• Per-request pricing (default: $0.001)
• Automatic payment verification via facilitator

MCP Protocol

The generated MCP server includes sample tools:

• chat - Conversation with the LLM
• echo - Echo back input (testing)
• get_time - Current timestamp

Add your own tools in src/tools.ts.

Testing Your MCP Server

MCP uses stdio for communication. To test with the MCP Inspector:

# Install MCP Inspector
npx @modelcontextprotocol/inspector

# Or test directly with your MCP client
npm run start:mcp

The server will communicate over stdin/stdout following the MCP protocol.

Registration File Structure

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "My Agent",
  "description": "An AI agent...",
  "image": "https://example.com/image.png",
  "endpoints": [
    {
      "name": "A2A",
      "endpoint": "http://localhost:3000/.well-known/agent-card.json",
      "version": "0.3.0"
    },
    {
      "name": "MCP",
      "endpoint": "http://localhost:3001",
      "version": "2025-06-18"
    },
    {
      "name": "agentWallet",
      "endpoint": "eip155:11155111:0x..."
    }
  ],
  "registrations": [
    {
      "agentId": 123,
      "agentRegistry": "eip155:11155111:0x8004..."
    }
  ],
  "supportedTrust": ["reputation", "crypto-economic", "tee-attestation"]
}

Resources

• ERC-8004 Specification
• 8004scan Explorer - View registered agents
• A2A Protocol
• Model Context Protocol
• Coinbase x402
• 8004-solana SDK - Solana implementation

License

MIT