ERC-8004 Agent Tracking

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:

The payer wallet address is extracted from the settlement response
Renvoy queries 8004scan to check if that wallet owns any ERC-8004 agent NFTs
If agents are found, they are stored and attached to settlement history entries
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:

Network	CAIP-2 ID	8004scan
Base (mainnet)	`eip155:8453`	base
Base Sepolia	`eip155:84532`	base-sepolia
Solana (mainnet)	`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`	solana
Solana Devnet	`solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`	solana-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:

Field	Type	Description
`token_id`	string	The ERC-721 token ID of the agent NFT
`name`	string or null	Human-readable agent name (from NFT metadata)
`url`	string	Link 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.

​What is ERC-8004?

​How it works

​Supported networks

​Agents in settlement history

​Dashboard

What is ERC-8004?

How it works

Supported networks

Agents in settlement history

Dashboard