Skip to content

ENSIP-25: AI Agent Registry ENS Name Verification#61

Merged
adraffy merged 9 commits intoensdomains:masterfrom
nxt3d:ensip-25
Feb 18, 2026
Merged

ENSIP-25: AI Agent Registry ENS Name Verification#61
adraffy merged 9 commits intoensdomains:masterfrom
nxt3d:ensip-25

Conversation

@nxt3d
Copy link
Contributor

@nxt3d nxt3d commented Jan 3, 2026

Summary

This PR adds ENSIP-25, which defines a standardized method for verifying ENS names associated with AI agent registries using text records. The specification enables bidirectional verification between AI agent registries and their corresponding ENS names, and provides a direct lookup method for efficient verification without iteration.

Key Features

  • Text records with ERC-8127 format: Uses human-readable text records with the ERC-8127 Token Identifier format (<agentId>@<registry>)
  • Prioritized keys: Supports agent-registry and agent-registry: N (where N = 1, 2, 3, ...) for multiple registry entries with explicit priority order
  • Direct verification: Adds verify-agent-registry: <agentId>@<registry> parameterized key for direct lookup without iterating over lists
  • ERC-7930 addresses: Encodes registry addresses using ERC-7930 interoperable address format (chain + address)
  • Multi-registry support: Allows an agent to be registered in multiple registries across different chains

Specification Details

  • Record keys: agent-registry (highest priority) and agent-registry: N using ERC-8119 format for structured keys
  • Record values: ERC-8127 Token Identifier format: <agentId>@<registry> (e.g., 167@0x00010000010114...)
  • Direct verification key: verify-agent-registry: <agentId>@<registry> with any non-empty value
  • Verification flows:
    • Registry-to-ENS: Verify agent's claimed ENS name (via list or direct lookup)
    • ENS-to-Registry: Discover and verify agent IDs associated with an ENS name

References

  • ERC-7930: Interoperable Addresses
  • ERC-8119: Parameterized Storage Keys
  • ERC-8127: Human Readable Token Identifiers
  • ERC-8004: AI Agent Registry standard

nxt3d added 6 commits November 5, 2025 15:36
This ENSIP defines a standardized method for verifying ENS names associated
with AI Agent registries using text records with the format
"agent-registry:<ERC-7930 based chain ID>".

Key features:
- Enables bidirectional verification between AI agent registries and ENS names
- Supports multichain agents using ERC-7930 based chain ID format
- Uses CAIP-350 address format with EIP-55 checksumming for Ethereum
- Defines both registry-to-ENS and ENS-to-registry verification flows
- Allows single ENS name to reference multiple agent registries across chains
- Includes examples for Ethereum, Polygon, Avalanche, and Solana
- Change double quotes to backticks for format specification in Abstract
- Update verification method to use 'ERC-7930 based chain ID' consistently
Major changes:
- Switch from text records to ENSIP-24 data() records
- Use prioritized keys: agent-registry and agent-registry: N (N = 1, 2, 3, ...)
- Store full ERC-7930 address (chain + address) in record value
- Require minimum 5 keys to check (agent-registry through agent-registry: 4)
- Add TOON format attribution for key structure
- Update examples with ERC-7930 spec-compliant bytes
- Clarify discovery vs verification flows
- Change from ENSIP-24 data() records to text records for human readability
- Use ERC-8127 Token Identifier format (<agentId>@<registry>) for values
- Add verify-agent-registry parameterized key for direct lookup without iteration
- Add raffy.eth as contributor
@estmcmxci
Copy link

Is there a reference implementation or demo available that shows this working end-to-end?

@nxt3d
Copy link
Contributor Author

nxt3d commented Jan 31, 2026

Is there a reference implementation or demo available that shows this working end-to-end?

https://github.com/unruggable-labs/agent0-ts/tree/feat/add-verifyENSName

We have a PR ready to go for Agent0. We also made a small addition to ENSIP-25 and will update this code to use it as well.

@adraffy adraffy merged commit 6fd7c35 into ensdomains:master Feb 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants