This is a fork of ens contracts that allows you to register your name once and own it forever without the need for renewals.
For documentation of the ENS system, see docs.ens.domains.
This repo doubles as an npm package with the compiled JSON contracts
import {
BaseRegistrar,
BaseRegistrarImplementation,
ENS,
ENSRegistry,
ENSRegistryWithFallback,
ETHRegistrarController,
FIFSRegistrar,
PriceOracle,
PublicResolver,
Resolver,
ReverseRegistrar,
StablePriceOracle,
TestRegistrar
} from '@imperviousinc/forever-contracts'// Registry
import 'imperviousinc-forever-contracts/contracts/registry/ENS.sol';
import 'imperviousinc-forever-contracts/contracts/registry/ENSRegistry.sol';
import 'imperviousinc-forever-contracts/contracts/registry/ENSRegistryWithFallback.sol';
import 'imperviousinc-forever-contracts/contracts/registry/ReverseRegistrar.sol';
import 'imperviousinc-forever-contracts/contracts/registry/TestRegistrar.sol';
// EthRegistrar
import 'imperviousinc-forever-contracts/contracts/ethregistrar/BaseRegistrar.sol';
import 'imperviousinc-forever-contracts/contracts/ethregistrar/BaseRegistrarImplementation.sol';
import 'imperviousinc-forever-contracts/contracts/ethregistrar/BaseRegistrar.sol';
import 'imperviousinc-forever-contracts/contracts/ethregistrar/ETHRegistrarController.sol';
import 'imperviousinc-forever-contracts/contracts/ethregistrar/PriceOracle.sol';
import 'imperviousinc-forever-contracts/contracts/ethregistrar/StablePriceOracle.sol';
// Resolvers
import 'imperviousinc-forever-contracts/contracts/resolvers/PublicResolver.sol';
import 'imperviousinc-forever-contracts/contracts/resolvers/Resolver.sol';
If your environment does not have compiler, you can access to the raw hardhat artifacts files at node_modules/@imperviousinc/forever-contracts/artifacts/contracts/${modName}/${contractName}.sol/${contractName}.json
The ENS registry is the core contract that lies at the heart of ENS resolution. All ENS lookups start by querying the registry. The registry maintains a list of domains, recording the owner, resolver, and TTL for each, and allows the owner of a domain to make changes to that data. It also includes some generic registrars.
Interface of the ENS Registry.
Implementation of the ENS Registry, the central contract used to look up resolvers and owners for domains.
The new impelmentation of the ENS Registry after the 2020 ENS Registry Migration.
Implementation of a simple first-in-first-served registrar, which issues (sub-)domains to the first account to request them.
Implementation of the reverse registrar responsible for managing reverse resolution via the .addr.reverse special-purpose TLD.
Implementation of the .test registrar facilitates easy testing of ENS on the Ethereum test networks. Currently deployed on Ropsten network, it provides functionality to instantly claim a domain for test purposes, which expires 28 days after it was claimed.
Implements an ENS registrar intended for the .eth TLD.
These contracts were audited by ConsenSys dilligence; the audit report is available here.
BaseRegistrar is the contract that owns the TLD in the ENS registry. This contract implements a minimal set of functionality:
- The owner of the registrar may add and remove controllers.
- Controllers may register new domains. They can not change the ownership of existing domains.
- Name owners may transfer ownership to another address.
- Name owners may reclaim ownership in the ENS registry if they have lost it.
- Owners of names in the interim registrar may transfer them to the new registrar, during the 1 year transition period. When they do so, their deposit is returned to them in its entirety.
This separation of concerns provides name owners strong guarantees over continued ownership of their existing names, while still permitting innovation and change in the way names are registered via the controller mechanism.
EthRegistrarController is the first implementation of a registration controller for the new registrar. This contract implements the following functionality:
- The owner of the registrar may set a price oracle contract, which determines the cost of registrations based on the name.
- The owner of the registrar may withdraw any collected funds to their account.
- Users can register new names using a commit/reveal process and by paying the appropriate registration fee.
The commit/reveal process is used to avoid frontrunning, and operates as follows:
- A user commits to a hash, the preimage of which contains the name to be registered and a secret value.
- After a minimum delay period and before the commitment expires, the user calls the register function with the name to register and the secret value from the commitment. If a valid commitment is found and the other preconditions are met, the name is registered.
The minimum delay and expiry for commitments exist to prevent miners or other users from effectively frontrunnig registrations.
SimplePriceOracle is a trivial implementation of the pricing oracle for the EthRegistrarController that always returns a fixed price per domain per year, determined by the contract owner.
StablePriceOracle is a price oracle implementation that allows the contract owner to specify pricing based on the length of a name, and uses a fiat currency oracle to set a fixed price in fiat per name.
Resolver implements a general-purpose ENS resolver that is suitable for most standard ENS use-cases. The public resolver permits updates to ENS records by the owner of the corresponding name.
PublicResolver includes the following profiles that implements different EIPs.
─ ABIResolver = EIP 205 - ABI support (ABI()).
─ AddrResolver = EIP 137 - Contract address interface. EIP 2304 - Multicoin support (addr()).
─ ContentHashResolver = EIP 1577 - Content hash support (contenthash()).
─ InterfaceResolver = EIP 165 - Interface Detection (supportsInterface()).
─ NameResolver = EIP 181 - Reverse resolution (name()).
─ PubkeyResolver = EIP 619 - SECP256k1 public keys (pubkey()).
─ TextResolver = EIP 634 - Text records (text()).
─ DNSResolver = Experimental support is available for hosting DNS domains on the Ethereum blockchain via ENS. The more detail is on the old ENS doc.
git clone https://github.com/imperviousinc/forever-contracts.git
cd forever-contracts
yarn
Create a .env file and add the following variables:
DEPLOYER_KEY=
INFURA_ID=
ETHERSCAN_API_KEY=
Deploy the contracts:
npx hardhat --network goerli deploy
Finalize deployment: updates ens registry and connects the controller and public resolver to the registrar.
npx hardhat --network goerli deploy --tags FinalizeInitial
add the new controller
npx hardhat --network goerli deploy --tags FinalizeForeverController
Submit contract code to verify with etherscan (optional)
npx hardhat --network goerli etherscan-verify --license MIT --sleep
yarn test
yarn pub