Listing an ENS Name

Steps to successfully list an ENS Name and start minting subnames!

Listing your ENS Name(s) on the Namespace platforms allows you, and your community or your users, to mint subnames from that name. Subnames can be minted on Ethereum, Base, or Optimism and in the future, we'll support more chains.

Important to know

To mint subnames from 1) Namespace platform, 2) ENS Widget, 3) Farcaster frame, or 4) using our SDK, you need to list that ENS Name first on our platform using the Manager!

Listing an ENS Name

1. Go to app.namespace.tech.

2. Connect your wallet that has an ENS name you want to list (and issue Subnames from)

   1. In this example, I'll list spaceninja.eth

3. Click on "Account" in the navigation bar

4. Click on the "Manager" tab

5. Select (search for) the Name you want to list from the drop-down menu

1. Select on what chain you want to do the listing and issue Subnames on

Two different Listing options

1. List the name and issue subnames on Ethereum

2. List the name and issue subnames on L2s (Base, Optimism, etc.)

The listing process is pretty much the same for both Ethereum and L2 subnames. For this example, I'll list spaceninja.eth on Base.

List and Mint on L2 chain

Listing an ENS name so that people can mint subnames on L2 chains involves deploying a registry on that L2 chain and other customizations. Let's walk through the entire setup.

1. Step: Select "Issue L2 Subnames"

1. Step: You have to:

   1. Give your listing a name (collection name, could be anything)

   2. Give your listing a symbol (token symbol, could be anything)

   3. Choose the L2 chain you want to deploy on (currently live on Base and Optimism)

   4. Decide if you want to retain the ability to take away ownership from someone who mints a subname by having the ability to burn subnames from that collection.

1. Step: Define the minting price for Subnames.

   1. Base minting price - general price for all subnames

   2. Price based on length - custom pricing for subnames based on their length

   3. Special subname price rules for Subnames containing:

      1. Numbers-only

      2. Letter-only

      3. Emoji-only

1. Step: Reserve (blacklist) some Subnames from being minted, or making them mintable but for a special price. You can blacklist some swear words, and you can reserve names for your team members, community members, etc.

1. Step: Optionally set a Deadline which allows you to control at which date and time in the future the minting will stop.

1. Step: Two Whitelisting options you can choose from:

   1. Only whitelisted wallet addresses will be able to mint a Subname

   2. Whitelisted wallet addresses can be minted for free and everyone else will have to pay for the prices you had set up in the "Minting Price" customization.

1. Step: The last one is Token-gated minting, which allows you to token-gate who gets to mint a Subname from the ENS name you're listing by requiring them to hold:

   1. A certain amount of some ERC20 token

   2. Some specific ERC721 tokens (NFT usually from some collection)

   3. Some specific ERC1155 token (NFT)

That's all.

Once you're happy with everything, just click on "List Name" and you're good to go. People can now mint subnames from your ENS Name through:

1. Namespace platform (app.namespace.tech/"yourENSname.eth")

2. ENS Widget - you can configure add to your website/blog and allow people to mint subnames directly from there

3. Farcaster Frame - you can create a Frame through which people will be able to mint subnames

4. Custom-built solution you build yourself (your wallet, game, community page, etc.) using our SDK

If you need any help, let your ninjas know in our Namespace Devs Telegram group chat

🥷🥷🥷