Create 8004 Agent
CLI to scaffold ERC-8004 compliant AI agents with A2A, MCP, and x402 support
Installation
npx create-8004-agentAsk AI about Create 8004 Agent
Powered by Claude Β· Grounded in docs
I know everything about Create 8004 Agent. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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.
Table of Contents
- What is ERC-8004?
- Prerequisites
- Quick Start
- What Gets Generated
- Wizard Options
- Supported Chains
- Generated Project Usage
- A2A, x402, and MCP Protocols
- Troubleshooting
- Development
- Resources
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
Prerequisites
Before using the generator, ensure you have:
- Node.js: Version 18.0.0 or higher.
- Package Manager: npm, pnpm, or bun.
- Wallet: An EVM or Solana wallet (the tool can generate one for you if needed).
Quick Start
npx create-8004-agent
That's it! The wizard will guide you through creating your agent.
If you want 4mica-powered x402 payments, choose a supported chain (Ethereum Sepolia or Polygon Amoy), enable x402 payments, and select 4mica as the provider when prompted.
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 | x402 USDC micropayments (Base, Polygon) |
| Chain | EVM: Ethereum, Base, Polygon, Monad (mainnet + testnets) / Solana: Devnet |
| Trust models | reputation, crypto-economic, tee-attestation |
Supported Chains
EVM Chains
| Chain | Identity Registry | Status |
|---|---|---|
| ETH Sepolia | 0x8004A818BFB912233c491871b3d84c89A494BD9e | β Available |
| Base Sepolia | 0x8004A818BFB912233c491871b3d84c89A494BD9e | β Available |
| SKALE Base | 0x8004A818BFB912233c491871b3d84c89A494BD9e | β Available |
| SKALE Base Sepolia | 0x8004A818BFB912233c491871b3d84c89A494BD9e | β Available |
| Avalanche C-Chain | Via agent0-sdk (chainId 43114) | β Available |
| Avalanche Fuji | Via agent0-sdk (chainId 43113) | β Available |
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 airdropor 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.
2(b). Updating Your Agent (Optional)
If you update your agent's name, description, image, or OASF skills in src/register.ts, you need to sync these changes on-chain:
- Update the configuration in
src/register.ts. - Run the registration script again:
npm run register
This will upload the new metadata to IPFS and update your agent's URI on the Identity Registry.
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
}'
x402 Payments
x402 payment support enables USDC micropayments for your agent. Available on:
| Chain | Facilitator | Status |
|---|---|---|
| Base Mainnet | PayAI | β Production |
| Base Sepolia | PayAI | β Testnet |
| Polygon Mainnet | PayAI | β Production |
| Polygon Amoy | PayAI | β Testnet |
| SKALE Base | PayAI | β Production |
| SKALE Base Sepolia | PayAI | β Testnet |
When enabled, the A2A server uses x402 middleware for micropayments:
- Per-request pricing (default: $0.001 USDC)
- Automatic payment verification via facilitator
- Payment configuration in
.env:X402_PAYEE_ADDRESS,X402_PRICE - 4mica only:
X402_TAB_ENDPOINT(public tab endpoint advertised to clients)
4mica Setup (Optional Collateral Deposit)
If you select x402 payments and choose 4mica during the wizard, you will be prompted:
Register with 4mica now (optional collateral deposit)?
If you say yes, the CLI will:
- Ask for a wallet private key (or use the one it generated).
- Ask which asset to deposit (USDC, USDT, or native token) and how much.
- Submit an on-chain deposit via the 4mica SDK and print the transaction hash.
You can safely skip this step if you are not ready to fund the wallet yet. The agent still generates and runs; you can enable 4Mica later after funding a wallet.
MCP Protocol
The generated MCP server includes sample tools:
chat- Conversation with the LLMecho- 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"]
}
Development
Running Tests
npm test
x402 Paid Request Tests
To run the full x402 integration tests (verifying paid requests work), you need a test wallet with testnet USDC:
- Create a
.envfile in the project root:
TEST_PAYER_PRIVATE_KEY=0x...your_private_key...
- Fund the wallet with testnet USDC on:
- Base Sepolia
- Ethereum Sepolia
- Polygon Amoy
If TEST_PAYER_PRIVATE_KEY is not set, x402 paid request tests will be skipped (other tests still run).
Resources
- ERC-8004 Specification
- 8004scan Explorer - View registered agents
- A2A Protocol
- Model Context Protocol
- x402 Protocol
- PayAI Facilitator - x402 facilitator for Base, Polygon
- 4mica Facilitator - x402 facilitator for Ethereum Sepolia, Polygon Amoy
- 8004-solana SDK - Solana implementation
License
MIT
