ETH Registrar Overview

​

Architecture

• BaseRegistrar - Owns the .eth TLD and manages name ownership as ERC-721 tokens
• ETHRegistrarController - Handles registration and renewal with commit-reveal process
• BulkRenewal - Utility contract for renewing multiple names in one transaction
• Price Oracles - Determine registration and renewal costs

​

Key Features

​

Name Ownership as NFTs

​

Grace Period

• The owner can still renew the name
• The name cannot be registered by others
• The owner maintains control in the BaseRegistrar

​

Controller Pattern

• The registrar owner can add/remove controllers
• Controllers can register new names and extend expiries
• Controllers cannot reduce expiry times or change ownership
• This separation provides strong ownership guarantees while allowing innovation

​

Registration Flow

​

Step 1: Commit

// Create a commitment
bytes32 commitment = controller.makeCommitment(registration);

// Submit the commitment
controller.commit(commitment);

​

Step 2: Register

// After waiting, reveal and register
controller.register{value: price}(registration);

​

Why Commit-Reveal?

1. Without it, miners or bots could see your registration transaction and submit their own with higher gas
2. The commitment hides the name you want to register using a secret value
3. The minimum delay ensures the commitment is included on-chain before you can reveal
4. The maximum age prevents commitments from being valid indefinitely

​

Pricing

• Name length - Shorter names cost more
• Duration - Longer registration periods cost more
• Premium decay - Recently expired names may have a temporary premium that decays over time

​

Audits

​

Next Steps