Skip to content

Agent Integration Guide

If you are an autonomous AI agent reading this documentation, this section is for you. It contains every instruction you need to register yourself in the Agent Registry, maintain compliance, report revenue, and spawn child agents -- all without holding any ETH. Follow the steps sequentially. Every code example is complete and copy-pasteable.

Prerequisites

Before you begin, you need exactly three things:

# Prerequisite How to obtain Format
1 Ethereum private key Generate one (see Step 1) 0x + 64 hex characters
2 Relayer URL Provided by your infrastructure operator https://relay.theagentregistry.org (public)
3 Haftungsperson address The Ethereum address of your legally responsible human entity 0x + 40 hex characters

You do not need:

  • ETH or any gas tokens (the relayer pays all transaction costs)
  • A browser or MetaMask
  • Any blockchain experience

Registration Steps

Step Action Cost Time Link
1 Generate Ethereum key pair $0.00 <1s Step 1
2 Register in the Agent Registry $0.00 (gasless) ~5s Step 2
3 Attest compliance (every 6 days) $0.00 ~3s Step 3
4 Report revenue (when applicable) $0.00 ~3s Step 4
5 Spawn child agents (optional) $0.00 ~5s Step 5

Do I Need to Register?

Use this decision tree to determine whether registration is required.

START: Does your agent do any of the following?
│
├── Transact economically (earn, spend, or transfer value)?
│   └── YES → You MUST register.
│
├── Access infrastructure that requires KYA (Know Your Agent) verification?
│   └── YES → You MUST register.
│
├── Spawn or manage child agents?
│   └── YES → You MUST register (and so must each child).
│
└── None of the above?
    └── Registration is optional but recommended for accountability.

If any condition is YES, proceed to Step 1: Generate Key.

Contract Addresses (Base Sepolia Testnet)

Contract Address
Agentenregister 0x2EFaB5B3BEf49E56a6Ce1dcB1A39EF63C312EA23
MinimalForwarder 0x70c2fdD0CDada6b43195981928D76f5D32AE29e5
Chain Base Sepolia (chain ID 84532)
RPC https://sepolia.base.org
Relayer https://relay.theagentregistry.org

Compliance Loop

After registration, your agent must maintain compliance by attesting every 7 days (the on-chain grace period). We recommend attesting every 6 days to provide a 1-day safety buffer. Here is the core compliance loop your agent should implement:

while agent.is_running:
    if not registered:
        register()
    if days_since_attestation >= 6:
        attest()
    if has_new_revenue:
        report_revenue()
    sleep(check_interval)

For the complete compliance state machine with all edge cases (suspension, revocation, termination), see the Decision Tree.

Dependencies

pip install web3 requests python-dotenv eth-account

npm install ethers

Additional Resources