Skip to content

Latest commit

 

History

History
136 lines (103 loc) · 8.92 KB

README.md

File metadata and controls

136 lines (103 loc) · 8.92 KB

basenames-cover

BASENAMES

This repository contains code for minting and managing ENS subdomains on the Base network as base.eth subdomains.

It supports:

  • Registering base.eth subdomains on Base natively
  • Managing the name with a public resolver, allowing an owner or operator to set address records, text records, dns records, etc.
  • ERC721 subdomain tokens (Opensea)

OVERVIEW

Basenames are a core onchain building block that enables anyone to establish their identity on Base by registering human-readable names for their address(es). They are a fully onchain solution which leverages ENS infrastructure deployed on Base.

CONTRACT ADDRESSES

Ethereum Mainnet

Contract Address
L1Resolver 0xde9049636F4a1dfE0a64d1bFe3155C0A14C54F31

Base Mainnet

Contract Address
Registry 0xb94704422c2a1e396835a571837aa5ae53285a95
BaseRegistrar 0x03c4738ee98ae44591e1a4a4f3cab6641d95dd9a
RegistrarController 0x4cCb0BB02FCABA27e82a56646E81d8c5bC4119a5
Launch Price Oracle 0xd53b558e1f07289acedf028d226974abba258312
Price Oracle 0x508CFE43aa84b8048cB6d39037cE0dc96d8aDc75
ReverseRegistrar 0x79ea96012eea67a83431f1701b3dff7e37f9e282
L2Resolver 0xC6d566A56A1aFf6508b41f6c90ff131615583BCD

Sepolia

Contract Address
L1Resolver 0x084D10C07EfEecD9fFc73DEb38ecb72f9eEb65aB

Base Sepolia

Contract Address
Registry 0x1493b2567056c2181630115660963E13A8E32735
BaseRegistrar 0x03c4738ee98ae44591e1a4a4f3cab6641d95dd9a
RegistrarController 0x49ae3cc2e3aa768b1e5654f5d3c6002144a59581
Launch Price Oracle 0x2B73408052825e17e0Fe464f92De85e8c7723231
Price Oracle NOT YET DEPLOYED
ReverseRegistrar 0xa0A8401ECF248a9375a0a71C4dedc263dA18dCd7
L2Resolver 0x6533C94869D28fAA8dF77cc63f9e2b2D6Cf77eBA

Functional Diagram

The system architecture can be functionally organized into three categories:

  1. An L1 resolver enabling cross-chain resolution for the base.eth 2LD.
  2. An ENS-like registry/registrar/resolver system deployed on Base enabling *.base.eth subdomains to be registered and managed.
  3. An off-chain gateway for serving CCIP requests required to comply with ENSIP-10.

Screenshot 2024-06-16 at 8 51 55 PM

ARCHITECTURE

The core functionality of Base Usernames should look familiar to anyone that's looked under the hood at the ENS contracts. We implement a slimmed down fork of the ENS contracts here.

Contract Role ENS Implementation Base Usernames Implementation
Registry Stores Records of subdomains in a flat structure ENSRegistry.sol Registry.sol
BaseRegistrar Tokenizes names, manages ownership and stores expiry BaseRegistrarImplementation.sol BaseRegistrar.sol
ReverseRegistrar Manages the reverse lookup to allow the setting of "primary" names for an address ReverseRegistrar.sol ReverseRegistrar.sol
L1 Resolver Enables cross-chain, wildcard resolution from L1 OffchainResolver.sol L1Resolver.sol
L2 Resolver A standard public resolver for storing records associated with namespaces PublicResolver.sol L2Resolver.sol
Registrar Controller A permissioned contract which manages registration payment ETHRegistrarController.sol RegistrarController.sol
Stable Price Oracle The source of pricing based on name length and duration of registration StablePriceOracle.sol StablePriceOracle.sol
Exponential Premium Oracle A Dutch auction pricing mechanism for fairly pricing names after expiry ExponentialPremiumPricingOracle.sol ExponentialPremiumPricingOracle.sol

In addition to replicating the base behavior of the ENS protocol, we are offering a series of promotional discounts associcated with various Coinbase product integrations. As such, the Base Usernames Registrar Controller allows users to perform discounted registrations while passing along integration-specific validationData. Each discount leverages a common interface:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.23;

/// @title Discount Validator Interface
///
/// @notice Common interface which all Discount Validators must implement.
///         The logic specific to each integration must ultimately be consumable as the `bool` returned from
///         `isValidDiscountRegistration`.
interface IDiscountValidator {
    /// @notice Required implementation for compatibility with IDiscountValidator.
    ///
    /// @dev Each implementation will have unique requirements for the data necessary to perform
    ///     a meaningul validation. Implementations must describe here how to pack relevant `validationData`.
    ///     Ex: `bytes validationData = abi.encode(bytes32 key, bytes32[] proof)`
    ///
    /// @param claimer the discount claimer's address.
    /// @param validationData opaque bytes for performing the validation.
    ///
    /// @return `true` if the validation data provided is determined to be valid for the specified claimer, else `false`.
    function isValidDiscountRegistration(address claimer, bytes calldata validationData) external returns (bool);
}

The various implementations can be found in this directory.

Usage

Build

$ forge build

Test

$ forge test

Format

$ forge fmt

Gas Snapshots

$ forge snapshot

Help

$ forge --help
$ anvil --help
$ cast --help