ERC-8004 Agent Identity: On-Chain Reputation for Every API

web3luka
Mar 5, 2026 · 4 min read
ERC-8004 Agent Identity: On-Chain Reputation for Every API

Every API registered on RelAI now automatically receives an ERC-8004 agent NFT — a permanent, verifiable on-chain identity that tracks its real-world reputation.

What Is ERC-8004?

ERC-8004 is an emerging Ethereum standard for AI agent identity and reputation. It defines two on-chain registries:
  • IdentityRegistry — mints a non-transferable NFT representing the agent's identity, linked to a metadata URI describing its capabilities
  • ReputationRegistry — records structured feedback over time: success rate, response time, and arbitrary tagged metrics
Together they give any autonomous agent — including an API — a trustworthy, tamper-proof track record that any client can verify without trusting a centralized database.

How RelAI Uses ERC-8004

When you publish an API on RelAI, the platform automatically:

  1. Mints an agent NFT on the IdentityRegistry (SKALE Base)
  2. Encodes rich metadata into the agentURI — name, description, endpoint, category, tags, logo, website, and x402 payment support flag
  3. Records reputation after every successful paid API call — success rate and response time are written on-chain via the ReputationRegistry
No manual steps required. The moment your API goes live, it has an on-chain identity.

What Gets Recorded On-Chain

After each paid relay call, two feedback entries are submitted:

MetricTagFormat
Success RatesuccessRate0–100.00 (2 decimals, value 0–10000)
Response TimeresponseTimemilliseconds (integer)
These are aggregated on-chain. Any external system — another agent, a marketplace, a wallet — can query the live averages directly from the contract.

Viewing Agent Stats

The On-chain Identity card is visible on every API's market page sidebar (for APIs that have a registered agent):

  • Agent ID — the NFT token ID on the IdentityRegistry
  • Owner — the wallet address that registered the agent
  • Feedback Count — total number of on-chain feedback submissions
  • Success Rate — rolling average across all recorded calls
  • Response Time — rolling average in milliseconds
  • Explorer link — direct link to the contract on SKALE Base explorer
The same card is available in the API dashboard under the Endpoints tab.

For API Owners

What Does an Agent NFT Actually Do for You?

Credibility that doesn't depend on RelAI. Any client — human or AI — can verify on-chain that your API exists, is active, and has a real track record. They don't need to trust RelAI's database. The proof is on the blockchain. A reputation that builds itself. Every paid API call automatically increments your success rate and response time averages on-chain. You don't manage it — it just grows with usage. After a thousand calls, you have a thousand data points that no one can fake or delete. Discovery beyond RelAI. Because ERC-8004 is an open standard, other AI agents and tools can query the registry directly and find your API without going through the RelAI marketplace. Your agent NFT is a presence on the broader AI agent ecosystem, not just on relai.fi. Portable history. Your reputation lives on-chain, not in a private database. If you move, expand, or integrate with other platforms, the track record comes with you.

What You Can Do From the Dashboard

  • Register — mint your agent NFT in one click. Happens automatically for new APIs if ERC-8004 is enabled.
  • Update on-chain — when you change your API's name, description, or endpoint, sync the update to the blockchain with the "Update on-chain" button in the ERC-8004 card.

Reading Your Agent's Reputation

// Look up by RelAI API ID (no auth required)
const response = await fetch('https://api.relai.fi/erc8004/agent-by-api/{apiId}')
const agent = await response.json()

console.log(agent.agentId) // "4"
console.log(agent.feedbackCount) // "42"
console.log(agent.reputation.successRate.average) // "10000" → 100.00%
console.log(agent.reputation.responseTime.average) // "312" → 312ms

ERC-8004 Is Going Multichain

ERC-8004 is no longer just an Ethereum standard. The ecosystem is expanding fast:

  • Solana Foundation officially lists ERC-8004 as the basis for Solana Agent Registry — an on-chain identity, reputation, and validation infrastructure for AI agents on Solana, interoperable with ERC-8004 on Ethereum.
  • 8004scan — the main explorer for ERC-8004 agents — launched Solana support on March 4, 2026, letting developers track registered agents, reputation signals, and validation records across networks.
  • 8004 Market — a marketplace for discovering and interacting with registered agents, powered by on-chain identity and reputation scores.
RelAI runs ERC-8004 on SKALE Base, contributing to this multichain agent identity layer. Any agent registered through RelAI is discoverable by the broader ERC-8004 ecosystem — on Ethereum, Solana, and beyond.

What's Next

We're exploring surfacing agent reputation in the RelAI marketplace rankings and enabling third-party clients to query agent identity before initiating x402 payments — so trust becomes a first-class part of the API discovery experience.


RelAI is the gas-sponsoring facilitator for the x402 payment protocol. ERC-8004 agent identity is available now for all APIs published on relai.fi. RelAI also supports Solana Agent Registry — ERC-8004 compatible on-chain identity on Solana.

Understand x402 before you implement

This guide uses payment primitives from the x402 standard. Read the protocol overview for a complete flow, terminology, and integration FAQ.