Standards

The Primary Agent Registry is built on three complementary ERC standards that together provide a complete agent identity layer for Ethereum.

Architecture

The registry uses a hub-and-spoke architecture with a central PrimaryAgentRegistry and pluggable registrar contracts. The registry itself stores the mappings, while registrars handle verification logic for different account types.

Registrars

Each registrar implements a different verification strategy, allowing the registry to support a wide range of account types.

Usage Examples

Register an EOA

An externally-owned account can register itself via the SelfRegistrar:

// The caller registers their own address
selfRegistrar.register(
    agentRegistry,   // address of the agent NFT registry
    tokenId          // the token ID representing the agent
);

Register via Signature

For gasless or delegated registration, use the SignedRegistrar with an EIP-712 typed signature:

// A relayer submits the registration on behalf of the signer
signedRegistrar.register(
    account,         // address to register
    agentRegistry,   // address of the agent NFT registry
    tokenId,         // the token ID representing the agent
    deadline,        // signature expiration timestamp
    signature        // EIP-712 signature from the account holder
);

Resolve an Address

Given any Ethereum address, resolve the agent identity it is linked to:

(address registry, uint256 tokenId) = primaryAgentRegistry.resolveAgentId(
    someAddress
);

// registry == address(0) means no agent is registered
require(registry != address(0), "No agent registered");

Contract Addresses

Sepolia

Base

Storage Encoding

The registry packs each registration into a single storage slot for gas efficiency. The agent ID is encoded as a byte sequence containing the registry address, an ID-length byte, and the token ID.

This encoding fits within a single 32-byte storage slot for token IDs up to 12 bytes (covering IDs up to ~79 billion billion), keeping registration and resolution to a single SLOAD/SSTORE.

// Token ID 42 with registry at 0xABCD...1234
// Encoded: 0xABCD...1234  |  01  |  2A
//          (20 bytes)       (1)    (1 byte for value 42)

// Token ID 100000 (0x0186A0) with same registry
// Encoded: 0xABCD...1234  |  03  |  01 86 A0
//          (20 bytes)       (1)    (3 bytes)