ENS Manager

Complete ENS name management: register new .eth names, create subdomains, and publish IPFS content to decentralized gateways.

Quick Start

Register New ENS Name

CODEBLOCK0

What happens:

1. 1. Phase 1: Makes commitment on-chain (anti-frontrunning)
2. Phase 2: Waits 60 seconds (required minimum)
3. Phase 3: Registers name with payment

Cost: ~$5-20 USD/year (varies by name length and demand)

Check ENS Name Status

CODEBLOCK1

Shows ownership, wrapped status, resolver, and content hash.

Create Subdomain with IPFS

CODEBLOCK2

Creates subdomain.yourname.eth and sets its IPFS content hash in one command.

Complete Workflows

1. Register New ENS Name (Full Process)

Scenario: You want to own INLINECODE2

Step 1: Check Availability

CODEBLOCK3

Output:
CODEBLOCK4

Step 2: Register

CODEBLOCK5

What happens (three phases):

Phase 1: Commitment (TX 1)
CODEBLOCK6

The commitment hash prevents frontrunning (someone stealing your name by seeing your TX and submitting theirs first with higher gas).

Phase 2: Wait 60 Seconds
CODEBLOCK7

This mandatory wait ensures your commitment is on-chain before registration.

Phase 3: Registration (TX 2 with payment)
CODEBLOCK8

Total time: ~2-3 minutes (60s wait + TX confirmations)
Total cost: Registration price + ~$2-4 gas (at 10 gwei)

2. Publishing a Website to ENS

Scenario: You have a static website and want to publish it at INLINECODE3

Prerequisites

• - You own yourname.eth (registered via Step 1 or app.ens.domains)
• Website files ready
• IPFS access (local node or Infura/Pinata)

Steps

1. Add website to IPFS:

CODEBLOCK9

2. Create ENS subdomain and set content hash:

CODEBLOCK10

3. Access your site:

Open https://meetup.yourname.eth.limo in any browser!

Cost: ~$0.05 (at 0.1 gwei base fee)

3. Updating IPFS Content

Scenario: You updated your website and have a new IPFS CID

Option A: Use viem directly

CODEBLOCK11

Option B: Use ENS App

1. 1. Go to https://app.ens.domains/subdomain.yourname.eth
2. Click "Records"
3. Edit "Content Hash"
4. Paste new IPFS CID
5. Save (sign TX)

4. Checking What's Published

CODEBLOCK12

Shows current IPFS CID and eth.limo URL.

Contract Addresses (Ethereum Mainnet)

All operations use these addresses:

CODEBLOCK13

Where they're used:

• - ENSREGISTRY: Base registry for all names (ownership, resolvers)
• ETHREGISTRARCONTROLLER: Register/renew .eth names (3-phase process)
• NAMEWRAPPER: Create subdomains for wrapped names
• PUBLIC_RESOLVER: Resolve names to addresses/content hashes

Three-Phase Registration Process

Why Three Phases?

Problem: If you submit a registration transaction, miners or bots can see it in the mempool and frontrun you (submit their own TX with higher gas to steal the name).

Solution: Commitment scheme prevents this:

1. 1. Commit: Submit a hash of (name + secret). No one knows what name you want.
2. Wait: 60 seconds minimum. Your commitment is now on-chain and timestamped.
3. Register: Reveal the name + secret. Since your commitment was earlier, you win.

Phase 1: Commitment

What happens:
CODEBLOCK14

Gas cost: ~45,000 gas (~$1-2 at 10 gwei)

Phase 2: Wait

Mandatory 60-second wait ensures:

• - Your commitment is confirmed on-chain
• Timestamp is set
• You can't be frontrun

Technical reason: The contract checks that block.timestamp >= commitmentTimestamp + 60 seconds when you register.

Phase 3: Registration

What happens:
CODEBLOCK15

Gas cost: ~150,000 gas (~$3-5 at 10 gwei) + registration price

Total registration: ~$4-7 gas + registration price (~$5-20/year)

Wrapped vs Unwrapped Names

Check if wrapped:
CODEBLOCK16

Look for "🎁 Wrapped (NameWrapper)" or "📦 Unwrapped (Registry)".

Key differences:

The create-subdomain-ipfs.js script handles both automatically.

Current vs Typical Gas Costs

Gas costs vary based on network congestion. The skill shows real-time costs during dry-run.

Registration (2 TXs)

Current conditions (0.22 gwei - very low):

• - Commitment: 45,000 gas = $0.02
• Registration: 265,000 gas = $0.15
• Total gas: $0.17

Typical conditions (10 gwei - normal):

• - Commitment: 45,000 gas = $1.13
• Registration: 265,000 gas = $6.63
• Total gas: $7.75

ENS Name Pricing Tiers (Annual Rental)

Complete Registration Examples

5-letter name (most common):

• - Current: Name ($6) + Gas ($0.17) = $6.17 total
• Typical: Name ($6) + Gas ($7.75) = $13.75 total

4-letter name:

• - Current: Name ($193) + Gas ($0.17) = $193.17 total
• Typical: Name ($193) + Gas ($7.75) = $200.75 total

Recommendation: Use --dry-run to check current costs before registering.

See COSTS.md for detailed cost breakdowns and optimization tips.

Troubleshooting

Registration: "Name not available"

The name is already registered. Try:
CODEBLOCK17

To see who owns it and when it expires.

Registration: "insufficient funds"

You need ETH for:

1. 1. Registration price (~$5-20 for most names)
2. Gas fees (~$4-7)

Check balance:
CODEBLOCK18

Registration: "Commitment not found" or "Too soon"

If you see this during Phase 3:

• - Too soon: Wait the full 60 seconds
• Commitment not found: Your Phase 1 TX didn't confirm yet. Wait longer or check TX status.

Transaction reverts

Common causes:

1. 1. Not the owner - You must own the parent name to create subdomains
2. Name is wrapped - Use NameWrapper methods, not Registry
3. Gas limit too low - Increase gas parameter
4. Commitment too old - If you wait >24 hours between Phase 1 and 3, start over

Content not appearing on eth.limo

1. 1. Wait a few minutes (DNS propagation)
2. Check content hash is set: INLINECODE19
3. Verify IPFS CID is accessible: INLINECODE20
4. Check resolver is PUBLIC_RESOLVER (most gateways only read from it)

Manual Operations (Advanced)

Unwrapped Name: Create Subdomain

CODEBLOCK19

Wrapped Name: Create Subdomain

CODEBLOCK20

IPFS Content Hash

Encoding CID

CODEBLOCK21

Setting Content Hash

CODEBLOCK22

Reading Content Hash

CODEBLOCK23

Gateway Access

After setting a content hash, the subdomain becomes accessible via:

• - eth.limo: INLINECODE21
• eth.link: INLINECODE22
• IPFS directly: INLINECODE23
• dweb.link: INLINECODE24

Note: eth.limo/eth.link may take a few minutes to update after setting a new content hash.

Resources

• - ENS Documentation: https://docs.ens.domains
• eth.limo: https://eth.limo
• ENS App (UI): https://app.ens.domains
• NameWrapper Guide: https://docs.ens.domains/wrapper/overview
• Content Hash Spec: See INLINECODE25
• Registrar Controller: https://etherscan.io/address/0x253553366Da8546fC250F225fe3d25d0C782303b

For detailed ENS concepts, wrapped vs unwrapped differences, and content hash encoding, read references/ens-basics.md.