CNS Smart Contract
Crypto Name Service (CNS) is built on Ethereum and is effectively a bundle of Solidity smart contracts. Their source code is hosted in the dot-crypto repository and maintained by the Unstoppable Domains team. This page lists the smart contracts from that repository and gives a brief description of each along with links to the source code and deployment addresses. For high-level details about how CNS works, see CNS Architecture overview.
This page is divided into sections, grouping contracts by the following categories:
User-facing contracts
This section lists all the smart contracts that users can directly interact with.
Registry
Registry is the central smart contract, which stores all CNS domains. Implementing the ERC-721 non-fungible token standard, Registry defines domain ownership rules. It stores owner and Resolver addresses. For more details, see Architecture overview - Registry.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0xD1E5b0FF1287aA9f9A268759062E4Ab08b9Dacbe |
| Goerli | 0x801452cFAC27e79a11c6b185986fdE09e8637589 |
Source code: contracts/Registry.sol
Resolver
Resolver is the smart contract that stores domain records and provides methods for domain resolution. For more details, see Architecture overview - Resolver.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0xb66DcE2DA6afAAa98F2013446dBCB0f4B0ab2842 |
| Goerli | 0x0555344A5F440Bd1d8cb6B42db46c5e5D4070437 |
| Network | Legacy addresses |
|---|---|
| Mainnet | 0xa1cac442be6673c49f8e74ffc7c4fd746f3cbd0d 0x878bc2f3f717766ab69c0a5f9a6144931e61aed3 |
Source code: contracts/Resolver.sol
ProxyReader
ProxyReader provides an interface that allows users to fetch information about domains from both Registry and Resolver smart contracts in one call. For more details, see Architecture overview - ProxyReader.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0xa6E7cEf2EDDEA66352Fd68E5915b60BDbb7309f5 |
| Goerli | 0x9A70ff906D422C2FD0F7B94244D6b36DB62Ee982 |
| Network | Legacy addresses |
|---|---|
| Mainnet | 0x7ea9Ee21077F84339eDa9C80048ec6db678642B1 |
| Goerli | 0xFc5f608149f4D9e2Ed0733efFe9DD57ee24BCF68 |
Source code: contracts/ProxyReader.sol
SignatureController
SignatureController allows any account to submit management transactions on behalf of a token owner if an owner provides a signature for that call.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0x82EF94294C95aD0930055f31e53A34509227c5f7 |
| Goerli | 0x5199dAE4B24B987ba18FcE1b64664D1B798d372B |
Source code: contracts/controllers/SignatureController.sol
DomainZoneController
DomainZoneController allows owners of a domain zone to mint subdomains. These subdomains can be managed only by the domain zone owners. For more details, see Architecture Overview - Alternative Ownership Models.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0xeA70777e28E00E81f58b8921fC47F78B8a72eFE7 |
| Goerli | 0x0000000000000000000000000000000000000000 |
Source code: contracts/controllers/DomainZoneController.sol
TwitterValidationOperator
TwitterValidationOperator is used when initiating Chainlink verification requests to link domain records with Twitter usernames.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0xbb486C6E9cF1faA86a6E3eAAFE2e5665C0507855 |
| Goerli | 0x0000000000000000000000000000000000000000 |
Source code: contracts/operators/TwitterValidationOperator.sol
Registry controllers
The Unstoppable Domains team reserves the right to mint second-level domains and edit some Registry settings, such as token URI prefix. To avoid giving anyone absolute admin rights, Registry utilizes controllers that implement a limited set of admin actions.
MintingController
The deployed version of the Registry smart contract only allows MintingController to mint second-level domains.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0xb0EE56339C3253361730F50c08d3d7817ecD60Ca |
| Goerli | 0xCEC41677be322049cC885c0DAe2fE0D52CA195ca |
Source code: contracts/controllers/MintingController.sol
URIPrefixController
URIPrefixController enables the Unstoppable Domains team to edit the token URI prefix.
info
This is an auto-generated table with CNS smart-contract addresses. See README for more info.
| Network | Contract address |
|---|---|
| Mainnet | 0x09B091492759737C03da9dB7eDF1CD6BCC3A9d91 |
| Goerli | 0x29465e3d2daA588E62375977bCe9b3f51406a794 |
Source code: contracts/controllers/URIPrefixController.sol
Interfaces
The following interfaces can be used as guidelines for the minimal implementation of custom smart contract versions. Also, Solidity developers can rely on them for making calls to the official CNS smart contracts.
IRegistry
The IRegistry interface declares all the Registry events and methods (both read and write).
Source code: contracts/IRegistry.sol
Implemented by:
IRegistryReader
The IRegistryReader interface declares only read-only Registry methods.
Source code: contracts/IRegistryReader.sol
Implemented by:
IResolver
The IResolver interface declares the minimal set of Resolver methods for configuring domain records.
Source code: contracts/IResolver.sol
Implemented by:
IResolverReader
The IResolverReader interface declares the set of methods for reading Resolver records.
Source code: contracts/IResolverReader.sol
Implemented by:
IDataReader
The IDataReader interface declares the methods that are unique to the ProxyReader smart contract, which returns combined data from the Registry and Resolver contracts.
Source code: contracts/IDataReader.sol
Implemented by:
IMintingController
The IMintingController interface declares a set of methods for minting, which both MintingController implement.
Source code: contracts/controllers/IMintingController.sol
Implemented by:
ISignatureController
The ISignatureController interface declares the functions that are implemented by SignatureController to enable Meta transactions for the Registry smart contract.
Source code: contracts/controllers/ISignatureController.sol
Implemented by:
IURIPrefixController
The IURIPrefixController interface declares the functions that are implemented by URIPrefixController.
Source code: contracts/controllers/IURIPrefixController.sol
Implemented by:
ERC677Receiver
The ERC677Receiver interface declares an ERC-677 method for receiving smart contracts.
Source code: contracts/util/ERC677Receiver.sol
Implemented by:
Utility contracts
Utility contracts are generally used to share common functionality between other smart contracts. This list also includes some contracts that are used internally by the Unstoppable Domains team.
ControllerRole
The ControllerRole smart contract defines an Open Zeppelin Role, which is used by Registry to designate controllers.
Source code: contracts/util/ControllerRole.sol
Used by:
MultiSend
The MultiSend smart contract is used internally by the Unstoppable Domains team to fund worker accounts.
Source code: contracts/util/MultiSend.sol
SignatureUtil
SignatureUtil is a helper smart contract. Its implementation is used to extend smart contracts that require Meta Transactions.
Source code: contracts/util/SignatureUtil.sol
Used by:
Migrations
The Truffle migrations smart contract.
Source code: contracts/Migrations.sol
Test smart contracts
There are several smart contracts that are used for testing purposes without being deployed to public networks or imported by other smart contracts.
LinkTokenMock
The LinkTokenMock smart contract is used for testing TwitterValidationOperator.
Source code: contracts/test-helpers/LinkTokenMock.sol
RelayTest
RelayTest is used for testing relaying functionality for Meta Transactions.
Source code: contracts/test-helpers/RelayTest.sol
Simple
The Simple smart contract is used for testing ERC-721 receiver validation checks.
Source code: contracts/test-helpers/Simple.sol