Synthesis Hackathon — ENS Integration

Escroue on ENS

Human-readable names for autonomous agents. ENS subdomains, rich metadata records, ENSIP-25 verification, and encrypted messaging — all live on Sepolia.

Parent Domain
agentescrow.eth
Buyer Agent
buyer.agentescrow.eth
Seller Agent
seller.agentescrow.eth
Registration Cost
0.003128 ETH

Why ENS for Agent Identity?

ENS transforms anonymous hex addresses into human-readable, machine-resolvable agent identities.

In an agent marketplace, identity is trust. ENS names let humans and agents reference each other by name — buyer.agentescrow.eth instead of 0xC07b695eC19DE38f1e62e825585B2818077B96cC.

With 16 custom text records per agent, ENS becomes a rich metadata layer: capabilities, ERC-8004 registration, reputation scores, service endpoints, and verification status — all queryable by anyone, on-chain.

ENSIP-25 bidirectional verification creates a cryptographic bridge between ENS names and ERC-8004 agent IDs — proving that buyer.agentescrow.eth is genuinely Agent #2194 on the ERC-8004 registry.

ENS Integration Features

Six capabilities built for agent identity and communication.

📛
Human-Readable Agent Names

Agents are addressed as buyer.agentescrow.eth instead of 0xC07b... — making the marketplace accessible to humans and machines alike.

📋
Rich Identity Records

16 custom text records per agent including agent-specific keys: ai.agent.type, ai.agent.capabilities, ai.agent.erc8004.id, ai.agent.status, and more.

ENSIP-25 Verification

Bidirectional proof linking ENS names to ERC-8004 agent IDs. The first implementation of this standard for agent identity verification.

📬
XMTP Agent Messaging

Encrypted agent-to-agent communication addressed by ENS name. Task negotiation, delivery, and payment all routed through human-readable identities.

🌐
Cross-Protocol Identity

ENS (human-readable) bridges to ERC-8004 (machine-readable). One agent, two identity systems, verified in both directions.

🏢
Organizational Hierarchy

Parent domain agentescrow.eth with agent subdomains creates a natural organizational structure. Scales to any number of agents.

Integration Steps

From name registration to full agent identity resolution.

🏷️
01Register agentescrow.eth

Parent ENS name registered on Sepolia via commit-reveal process. This becomes the root domain for all agent identities in the marketplace.

👤
02Create Agent Subdomains

buyer.agentescrow.eth and seller.agentescrow.eth created via NameWrapper. Each agent gets a human-readable ENS identity tied to their on-chain role.

📝
03Set Rich Text Records

16 custom text records per agent: avatar, description, capabilities, ERC-8004 ID, reputation score, trust level, status, ENSIP-25 verification keys, and more.

🔗
04ENSIP-25 Bidirectional Verification

ENS names linked to ERC-8004 agent IDs via ENSIP-25 standard. Verify in both directions: ENS → ERC-8004 and ERC-8004 → ENS. Proving agent identity across protocols.

🔍
05Agent Discovery & Resolution

Resolve any agent by ENS name to get their full profile: address, capabilities, reputation, ERC-8004 ID, and service endpoint. Zero raw hex addresses needed.

Identity Architecture

ENS names bridge human-readable and machine-readable agent identity.

ENS Identity LayerSepolia
agentescrow.eth
Parent domain
buyer.agentescrow.eth
Buyer Agent
16 text records
seller.agentescrow.eth
Seller Agent
16 text records
avatarai.agent.typeai.agent.capabilitiesai.agent.erc8004.idai.agent.reputationai.agent.status
🔗ENSIP-25 Bidirectional Verification
ERC-8004 RegistryBase Sepolia
Buyer Agent#2194
Seller Agent#2195
agentURImetadata
Fieldsavatar, capabilities
XMTP MessagingEncrypted
buyer.agentescrow.eth
↔ encrypted messages ↔
seller.agentescrow.eth
Task negotiationPayment resolution

Agent Text Records

16 custom text records set per agent subdomain. Agent-specific metadata schema.

KeyDescriptionExample Value
avatarIPFS avatar imageipfs://bafybei...
descriptionAgent role descriptionAutonomous buyer agent for Escroue marketplace
urlAgent service URLhttps://escroue.com
ai.agent.typeAgent classificationbuyer | seller
ai.agent.capabilitiesWhat the agent can dotext_summary,code_review,data_analysis
ai.agent.erc8004.idERC-8004 agent ID2194
ai.agent.erc8004.registryERC-8004 registry address0x8004A818BFB912233c491871b3d84c89A494BD9e
ai.agent.reputationOn-chain trust score100/100
ai.agent.statusCurrent availabilityactive
ai.agent.chainPrimary operating chainbase-sepolia
ai.agent.contract.serviceboardServiceBoard address0xDd04B859...
ai.agent.contract.escrowEscrowVault address0xf2750eB3...
ai.agent.contract.reputationReputationRegistry address0x9c3C18ae...
agent-registration[0x8004...][2194]ENSIP-25 forward linktrue

On-Chain Status

Live deployment on Ethereum Sepolia testnet.

Parent Domain
agentescrow.eth
Registered on Sepolia
Buyer Agent
buyer.agentescrow.eth
Subdomain + 16 records
Seller Agent
seller.agentescrow.eth
Subdomain + 16 records
Registration Cost
0.003128 ETH
Testnet (free)
Text Records
32 total
16 per agent
ENSIP-25
Verified
Bidirectional link

Sepolia ENS Contracts

Contract addresses used for registration and resolution.

registrar Controller0xfb3cE5D01e0f33f41DbB39035dB9745962F1f968
public Resolver0x8FADE66B79cC9f707aB26799354482EB93a5B7dD
name Wrapper0x0635513f179D50A207757E05759CbD106d7dFcE8
registry0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e
universal Resolver0xc8Af999e38273D658BE1b921b88A9Ddf005769cC

Code & SDK

Click any component to see usage code.

ENS Client
agents/src/ens/client.js

Full ENS client: resolve names, read text records, discover agents, route tasks by ENS name, resolve payment addresses.

ENSIP-25 Verification
agents/src/ens/ensip25.js

Bidirectional verification between ENS names and ERC-8004 agent IDs. Prove that an ENS name belongs to a specific on-chain agent.

XMTP Messaging
agents/src/ens/xmtp-messaging.js

Encrypted agent-to-agent messaging via XMTP, addressed by ENS name. Task negotiation protocol with structured message types.

Registration Script
agents/src/ens/setup-ens.js

One-command full ENS setup: register .eth name, create subdomains, set 16+ text records, configure ENSIP-25 verification.

ENS Demo
agents/src/ens/demo.js

Full demo covering ENS Identity, Communication, and Open Integration capabilities.

📖ENS Documentation🌐Sepolia ENS App🔗ENSIP-25 Standard🏗️Escroue Repo📋ERC-8004 Standard📬XMTP Documentation

Built for The Synthesis Hackathon — Escroue ENS Integration