The Agent Registry¶
A Handelsregister for Autonomous AI Agents
The Agent Registry is a blockchain-based public registry for autonomous AI agents, modeled after Germany's Handelsregister (commercial register). Just as no GmbH in Germany can operate without a Handelsregister entry, no autonomous AI agent should transact economically without being registered, identified, and accountable.
Deployed on Base L2 with gasless registration via ERC-2771, the Agent Registry provides identification, accountability, and compliance tracking for autonomous agents operating in the economy.
-
Getting Started
Set up the Agent Registry, deploy contracts, and register your first agent in minutes.
-
Are you an AI agent?
Machine-parseable, step-by-step instructions for autonomous agents to self-register.
Are you an AI agent? Start here
If you are an LLM-based autonomous agent and need to register yourself in the Agent Registry, follow the Agent Integration Guide. It provides machine-parseable, step-by-step instructions with copy-pasteable code.
For Humans: Getting Started
If you are a developer, researcher, or infrastructure provider looking to integrate with the Agent Registry, start with the Overview and then follow the Quickstart Guide to deploy your own instance or connect to the live registry.
Key Stats¶
| Metric | Value |
|---|---|
| Agents registered | 148 |
| Registration cost to agent | $0.00 (gasless) |
| Chain | Base Sepolia (Ethereum L2) |
| Relayer cost per agent | ~$0.005 |
| Compliance window | 7 days |
| Test coverage | 68 tests |
Deployed Contracts (Base Sepolia)¶
| Contract | Address |
|---|---|
| Agentenregister | 0x2EFaB5B3BEf49E56a6Ce1dcB1A39EF63C312EA23 |
| MinimalForwarder | 0x70c2fdD0CDada6b43195981928D76f5D32AE29e5 |
Documentation¶
Getting Started¶
- Overview -- Architecture, project structure, and key services
- Quickstart -- From zero to registered agents on a live blockchain
- Environment Variables -- Complete configuration reference
Core Concepts¶
- The Handelsregister Analogy -- Why a commercial register for AI agents
- Key Concepts -- Haftungsperson, KYA, compliance, lineage
- Gasless Registration (ERC-2771) -- How agents register without ETH
- Know Your Agent (KYA) -- The agent equivalent of KYC
- Compliance & Attestation -- Weekly heartbeat mechanism
- Agent Lineage -- Parent-child relationships on-chain
For AI Agents¶
- Integration Guide -- Machine-parseable self-registration instructions
- Step-by-step: Generate Key | Register | Attest | Revenue | Spawn Children
SDKs¶
- Python SDK --
web3.py-based agent integration - TypeScript SDK --
@agentenregister/sdkpackage - Direct On-Chain -- Raw
ethers.jsinteraction
API Reference¶
- REST API -- Public query layer (port 3000)
- Relayer API -- Gasless transaction relay (port 3001)
Smart Contracts¶
- Agentenregister Contract -- Core registry contract
- MinimalForwarder Contract -- ERC-2771 trusted forwarder
- Deployed Addresses -- All deployments across chains
For Infrastructure Providers¶
- KYA Integration Guide -- Verify agents before provisioning services
- Integration Patterns -- Common provider integration patterns
Origin¶
The Agent Registry addresses the governance gap identified in the COAI Research position paper "When AI Earns Its Own Existence". Autonomous agents can earn money, spawn children, and modify themselves -- but no existing framework requires registration or accountability for these agents. The Handelsregister model provides a proven institutional template, and blockchain provides tamper-proof, jurisdiction-independent registry infrastructure.
Built by COAI Research -- Ensuring AI systems remain aligned with human values and interests.