Skip to main content
This guide explains how to build AI agents on Celo that use Celonames for human-readable identity, ENSIP-25 for agent verification, and ERC-8004 for trust infrastructure.

Overview

As AI agents become active participants in on-chain systems, they need:
  • Human-readable identity → Celonames (ENS on Celo)
  • Verifiable agent ownership → ENSIP-25 standard
  • Trust and reputation → ERC-8004 registry
Celonames brings ENS to Celo, enabling AI agents to have portable, readable identities that work across wallets, apps, and protocols. Combined with ENSIP-25 and ERC-8004, you can build autonomous agents that are discoverable, verifiable, and trustworthy.

Key Concepts

ENSIP-25: Agent Verification

ENSIP-25 is a standard that links an AI agent’s on-chain registry entry to an ENS name through a standardized text record format. How it works:
  1. An AI agent registers in a registry (like ERC-8004) and claims a Celoname
  2. The Celoname owner sets a text record in the format: agent-registration[<registry>][<agentId>]
  3. If the record is set to "1" (or any non-empty value), the association is verified
This enables deterministic verification without new contracts or resolver upgrades. Example text record key:
Breaking this down:
  • 0x049d9001000114 - ERC-7930 interoperable address prefix for Celo mainnet
  • 8004a169fb4a3325136eb29fa0ceb6d2e539a432 - ERC-8004 Identity Registry address on Celo
  • 42 - The agent’s unique ID in the registry

ERC-8004: Agent Trust Infrastructure

ERC-8004 is an Ethereum standard that establishes trust infrastructure for autonomous AI agents through three registries:

Celo Deployments

Building an AI Agent with Celonames

Step 1: Register a Celoname for Your Agent

Your AI agent should have a human-readable identity. Register a .celo name through:
  1. Celonames App: https://names.celo.org
  2. Programmatic registration via the L2Registrar contracts

Step 2: Register in ERC-8004 Identity Registry

Create a registration file describing your agent:
Upload this file to IPFS and register your agent:

Step 3: Set ENSIP-25 Text Record

Link your agent to your Celoname by setting the verification text record:

Step 4: Verify the Association

To verify an agent’s Celoname:

Example: ENS Registration Agent for Celo

Here’s an example of an AI agent that can register Celonames, modeled after the ENS Registration Agent:

MCP Server Tools

Agent Registration File

Reputation Building

After interactions, agents can receive feedback to build reputation:

Integration Flow

Benefits on Celo

  1. Fee Abstraction: Register agents and pay gas in stablecoins (cUSD, USDC, USDT)
  2. Fast Finality: 5-second block times for quick agent interactions
  3. Low Costs: Inexpensive registrations and transactions
  4. EVM Compatible: Use existing Ethereum tooling and libraries
  5. Social Connect: Integrate with Self protocol for identity verification

References

Next Steps

  • Build an MCP server for Celonames registration
  • Add your agent to the ERC-8004 registry on Celo
  • Set up ENSIP-25 verification for your agent’s Celoname
  • Integrate x402 payments for agent services
  • List your agent in agent directories