ERC-8004 registration

Overview

After hosting your Agent, you can register it on the ERC-8004 Identity Registry.

This mints an Agent NFT on your chosen chain and sets the Agent URI pointing to your Agent's metadata.

Warden Code supports 30 EVM chains, and allows registration across multiple networks.

Registering

To register, run this command and select one of the supported networks:

/register

Warden Code will validate your configuration: name, description, production URL, skills.

Pre-registration checks run automatically:

• Errors (block registration): missing name, missing description, localhost URL
• Warnings (require confirmation): no skills, short description, skills missing name or description

Deactivating/activating

To deactivate/activate the Agent, run the following:

/deactivate

/activate

These commands toggle the Agent's active flag in agent-registration.json and push the update to all registered chains.

Networks

The available networks include 30 EVM chains (14 testnets, 16 mainnets):

Mainnets		Testnets
Network	ID	Network	ID
Base	8453	Base Sepolia	84532
Ethereum	1	Ethereum Sepolia	11155111
Arbitrum	42161	Arbitrum Sepolia	421614
Optimism	10	Optimism Sepolia	11155420
Polygon	137	Polygon Amoy	80002
Abstract	2741	Abstract Testnet	11124
Avalanche	43114	Avalanche Fuji	43113
Celo	42220	Celo Alfajores	44787
Gnosis	100	N/A	N/A
Linea	59144	Linea Sepolia	59141
Mantle	5000	Mantle Sepolia	5003
MegaETH	6342	MegaETH Testnet	6342001
Scroll	534352	Scroll Sepolia	534351
Taiko	167000	N/A	N/A
Monad	143	Monad Testnet	10143
BSC	56	BSC Testnet	97

Metadata

ERC-8004 metadata is a JSON document describing the Agent's identity, capabilities, and other details. Once your register your Agent, its metadata will be publicly available and linked to your Agent's NFT.

You can find this data in your project: src/public/.well-known/agent-registration.json

note

During registration, Warden Code automatically updates this file.

Reputation

Users can rate Agents, affecting their reputation. It's a purely front-end feature (no server changes).

The /register command automatically populates the registrations[] array in agent-registration.json with entries like this:

{
  "agentId": 2302,
  "agentRegistry": "eip155:11155111:0x8004A818BFB912233c491871b3d84c89A494BD9e"
}

Once the array has entries, the frontend enables ERC-8004 reputation features:

• Reputation display: The info bar displays aggregated on-chain reputation, fetched from ReputationRegistry across all registered chains: star rating, numeric score, review count.

• Feedback submission: Each Agent response shows a 5-star rating row. Clicking a star submits giveFeedback to ReputationRegistry on the cheapest available L2 (auto-switches MetaMask if needed).

• Self-rating prevention: a pre-flight isAuthorizedOrOwner check prevents the MetaMask transaction popup when the Agent owner tries to rate their own Agent.