Skip to main content

​
What is ERC-8004?

ERC-8004 defines a standard for on-chain autonomous agents represented as ERC-721 NFTs. Each agent has a unique token ID, an owner wallet, and optional metadata (name, image). Renvoy automatically detects when a payer wallet holds ERC-8004 agent NFTs and links those agents to settlement history. This lets you see which AI agents are making payments through your endpoints.

​
How it works

When a settlement succeeds through Renvoy:
  1. The payer wallet address is extracted from the settlement response
  2. Renvoy queries 8004scan to check if that wallet owns any ERC-8004 agent NFTs
  3. If agents are found, they are stored and attached to settlement history entries
  4. Agent info appears in history responses and in the dashboard UI
This happens automatically in the background. It does not affect settlement speed or reliability — if the 8004scan lookup fails, settlement proceeds normally.

​
Supported networks

Agent detection works on all networks supported by 8004scan:
NetworkCAIP-2 ID8004scan
Base (mainnet)eip155:8453base
Base Sepoliaeip155:84532base-sepolia
Solana (mainnet)solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpsolana
Solana Devnetsolana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1solana-devnet

​
Agents in settlement history

When agents are detected, they appear in the agents array on each settlement entry in history responses: 
{
  "settlements": [
    {
      "created_at": "2026-03-13T15:30:00.000Z",
      "success": true,
      "tx_hash": "0xabc...",
      "payer": "0x7764b53582a12e0538de181ea67e15d49ec0e79f",
      "agents": [
        {
          "token_id": "42",
          "name": "Autonomous Trader",
          "url": "https://www.8004scan.io/agents/base/42"
        }
      ]
    }
  ]
}
Each agent entry contains:
FieldTypeDescription
token_idstringThe ERC-721 token ID of the agent NFT
namestring or nullHuman-readable agent name (from NFT metadata)
urlstringLink to the agent’s profile on 8004scan
If the payer wallet has no agents, the agents field is omitted. Agents appear in all history endpoints:
  • GET /api/me/history (merchant, JWT auth)
  • GET /api/v1/agent/history (agent, SIWE auth)
  • GET /admin/history (admin)

​
Dashboard

The Renvoy dashboard shows agent badges on each settlement row. Click an agent badge to view its full profile on 8004scan.