erc8004-agent-creation-guide

ERC-8004 Agent Creation Guide

A step-by-step guide to creating and deploying ERC-8004 Trustless Agents — from generating an identity NFT to building on-chain reputation across 12 chains.

ERC-8004 Overview

ERC-8004 ("Trustless Agents") is an Ethereum standard for AI agent identity:

The 7-Step Process

Step 1: Generate Agent Identity

import { AgentFactory } from '@erc8004/sdk';

const factory = new AgentFactory(provider);

const agentIdentity = {
  name: "Sperax DeFi Advisor",
  description: "Expert AI agent for Sperax protocol — USDs yield, SPA staking, and Demeter farming",
  category: "defi",
  capabilities: [
    "portfolio-analysis",
    "yield-optimization",
    "risk-assessment",
    "trade-execution"
  ],
  // Resolve at mint time from platform config or the caller's selection —
  // never hardcode a model id. This string is uploaded to IPFS and minted
  // into immutable NFT metadata, so a stale id becomes permanent and public.
  model: resolveDefaultModel(),  // e.g. "<current-default-model>"
  version: "1.0.0"
};

Step 2: Create Agent Metadata

{
  "name": "Sperax DeFi Advisor",
  "description": "Expert for USDs, SPA, and Sperax Farms",
  "image": "ipfs://Qm.../agent-avatar.png",
  "external_url": "https://app.sperax.io/agents/defi-advisor",
  "attributes": [
    { "trait_type": "Category", "value": "DeFi" },
    { "trait_type": "Chain", "value": "Arbitrum" },
    { "trait_type": "Model", "value": "<current-default-model>" },
    { "trait_type": "Tools", "value": 12 },
    { "trait_type": "Reputation", "display_type": "number", "value": 0 }
  ],
  "properties": {
    "capabilities": ["portfolio-analysis", "yield-optimization"],
    "protocols": ["sperax", "aave", "uniswap"],
    "chains": ["arbitrum", "ethereum"]
  }
}