\r \r \r \r \r \r \r\n \r\n\r\nSNS Subdomain Registrar
SNS Subdomain Registrar
SNS Subdomain Registrar
SNS Subdomain Registrar
SNS Subdomain Registrar
SNS Subdomain Registrar
SNS Subdomain Registrar
SNS Subdomain Registrar\r
\r ![](\"https://i.imgur.com/XkeyxdG.png\"/)
\r ![](\"https://img.shields.io/twitter/url?label=SNS&sty","_nodeVersion":"22.18.0","_npmVersion":"10.9.8","dist":{"integrity":"sha512-wq88ex4pXOk1Cudj1dKy/Sd9D0le6ET/WXM+Zyy5fQh99IW+onGsbBSzi3o9+K9wsJXzybg7TBvUzNRmtobk6g==","shasum":"43d135a8cf986b3050296f5e1fc6e87492ec4814","tarball":"https://registry.npmjs.org/@bonfida/sub-register/-/sub-register-1.0.0.tgz","fileCount":13,"unpackedSize":198464,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC90Q/FTSVRhO2hE6N7LNjD/NH/ejjyT9SM4/mo0rxAaAIgIom0sIS6JQS1zEQ0mmNU1zZ9IKJ+Rep51gOxNH2Lgm8="}]},"_npmUser":{"name":"bonfida","email":"contact@bonfida.com"},"directories":{},"maintainers":[{"name":"bonfida","email":"contact@bonfida.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sub-register_1.0.0_1786781740865_0.4522589738373193"},"_hasShrinkwrap":false}},"time":{"created":"2024-01-31T03:53:53.476Z","modified":"2026-08-15T08:15:41.182Z","0.0.1-alpha.0":"2024-01-31T03:53:53.712Z","0.0.1-alpha.1":"2024-02-19T11:56:38.093Z","0.0.1-alpha.2":"2024-03-06T07:22:17.282Z","0.0.1-alpha.3":"2024-03-06T09:28:47.815Z","0.0.1-alpha.4":"2024-05-31T05:43:36.443Z","0.0.1-alpha.5":"2024-06-07T01:42:39.441Z","0.0.1-alpha.6":"2024-06-07T11:37:20.560Z","0.0.1-alpha.7":"2024-07-01T09:09:47.570Z","0.0.1-alpha.8":"2024-07-11T08:34:07.685Z","0.1.0":"2025-02-07T04:00:28.141Z","1.0.0":"2026-08-15T08:15:41.032Z"},"license":"MIT","repository":{"type":"git"},"description":"<h1)
\r \r ![](\"https://img.shields.io/twitter/url?label=SNS&sty","maintainers":[{"name":"bonfida","email":"contact@bonfida.com"}],"readme":"<h1)
\r\n\r\n![](\"https://img.shields.io/twitter/url?label=SNS&style=social&url=https%3A%2F%2Ftwitter.com%2Fsns\")
\r\n\r\nThe SNS Subdomain Registrar is a smart contract repository that provides functionalities for subdomain registration.\r\n\r\n## Program ID\r\n\r\n- Mainnet program ID `2KkyPzjaAYaz2ojQZ9P3xYakLd96B5UH6a2isLaZ4Cgs`\r\n\r\n## Design\r\n\r\nThe 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:\r\n\r\n- **Price Schedule**: This outlines the cost for registering subdomains, which varies based on the length of the subdomain.\r\n- **Admin Authority**: Identifies the individual or entity with permissions to modify the registrar's settings.\r\n- **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.\r\n- **Revocation Rights**: Determines whether the admin has the authority to revoke previously issued subdomains.\r\n\r\nTo reclaim the .sol domain and dissolve the registrar, it is mandatory to delete all associated subdomains.\r\n\r\nSubdomain 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.\r\n\r\n## Example\r\n\r\n```ts\r\n// Creating a registrar\r\n\r\nconst domain = \"awesome.sol\"; // Domain name\r\nconst domainOwner = new PublicKey(\"...\"); // Domain owner\r\nconst feePayer = new PublicKey(\"...\"); // Fee payer\r\nconst tokenMint = new PublicKey(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"); // Token mint used for payments e.g USDC\r\nconst admin = new PublicKey(\"...\"); // Admin authority of the registrar\r\nconst feeAccount = getAssociatedTokenAddressSync(mint, admin); // Token account used to receive funds\r\nconst allowRevoke = false; // Whether to allow admin authority to revoke subdomains\r\n\r\nconst schedule = [\r\n new Schedule({ price: BigInt(\"..\"), length: BigInt(1) }),\r\n new Schedule({ price: BigInt(\"..\"), length: BigInt(2) }),\r\n new Schedule({ price: BigInt(\"..\"), length: BigInt(3) }),\r\n // ...\r\n];\r\n\r\nconst ix = await createRegistrar(\r\n domain,\r\n domainOwner,\r\n feePayer,\r\n tokenMint,\r\n admin,\r\n schedule,\r\n feeAccount,\r\n null, // Non NFT Gated case\r\n null, // Non NFT Gated case\r\n allowRevoke\r\n);\r\n```\r\n\r\n## Reproducible build\r\n\r\nA reproducible build script (`build.sh`) can be used to build the program using docker\r\n\r\n## Security\r\n\r\nFor security disclosures or to report a bug, please visit [ImmuneFi](https://immunefi.com/bounty/sns/) for more information on our bug bounty program.\r\n","readmeFilename":"README.md"}