The SNS Subdomain Registrar is a smart contract repository that provides functionalities for subdomain registration.

Program ID

• Mainnet program ID 2KkyPzjaAYaz2ojQZ9P3xYakLd96B5UH6a2isLaZ4Cgs

Design

The SNS Subdomain Registrar allows .sol domain owners to establish a subdomain registrar, referred to as "registrar". Each registrar is a Program Derived Account (PDA) of the smart contract tasked with managing subdomain issuance. Upon the creation of a registrar, ownership of the .sol domain is transferred to the registrar's account to facilitate subdomain management. The creator of the registrar is required to define several parameters during its setup:

• Price Schedule: This outlines the cost for registering subdomains, which varies based on the length of the subdomain.
• Admin Authority: Identifies the individual or entity with permissions to modify the registrar's settings.
• NFT Mint: For scenarios where subdomain issuance is restricted to holders of specific NFT collections, the admin must specify a cap on the number of subdomains per NFT.
• Revocation Rights: Determines whether the admin has the authority to revoke previously issued subdomains.

To reclaim the .sol domain and dissolve the registrar, it is mandatory to delete all associated subdomains.

Subdomain issuance is monitored through SubRecord accounts, which track each subdomain. In cases where issuance is limited to NFT holders, MintRecord accounts are used to keep a count of subdomains issued per NFT, ensuring adherence to the specified limits.

Example

// Creating a registrar

const domain = "awesome.sol"; // Domain name
const domainOwner = new PublicKey("..."); // Domain owner
const feePayer = new PublicKey("..."); // Fee payer
const tokenMint = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"); // Token mint used for payments e.g USDC
const admin = new PublicKey("..."); // Admin authority of the registrar
const feeAccount = getAssociatedTokenAddressSync(mint, admin); // Token account used to receive funds
const allowRevoke = false; // Whether to allow admin authority to revoke subdomains

const schedule = [
  new Schedule({ price: BigInt(".."), length: BigInt(1) }),
  new Schedule({ price: BigInt(".."), length: BigInt(2) }),
  new Schedule({ price: BigInt(".."), length: BigInt(3) }),
  // ...
];

const ix = await createRegistrar(
  domain,
  domainOwner,
  feePayer,
  tokenMint,
  admin,
  schedule,
  feeAccount,
  null, // Non NFT Gated case
  null, // Non NFT Gated case
  allowRevoke
);

Reproducible build

A reproducible build script (build.sh) can be used to build the program using docker

Security

For security disclosures or to report a bug, please visit ImmuneFi for more information on our bug bounty program.