Mint Subdomains Using Smart Contracts Guide

This guide covers how to mint UD subdomains using proxy contracts. This process requires using the Polygonscan user interface to write and execute proxy contracts.

Step 1: Select a Minting Manager Smart Contract

The Minting Manager smart contract is an interface for minting second-level domains. Choose one of the Minting Manager smart contracts to interact with (either Polygon mainnet or testnet).

Step 2: Open the "Write as Proxy" Tab for the Minting Manager

Navigate to the Contract tab in the Polygonscan page of the Minting Manager contract and click on the Write as Proxy tab:

Step 3: Connect Your Web3 Wallet

Click on the Connect to Web3 button in the Write as Proxy tab and connect the wallet associated with the domain:

Step 4: Mint the Subdomain

Choose the issueWithRecords() method from the Write as Proxy tab section. The method allows you to mint subdomains of domains you already own to your wallet address.

Next, add your wallet address that owns the root domain to the to field and the subdomain you want to mint to the labels field. For example, if you own the example.crypto domain with your wallet address as 0xC37d3c4326ab0E1D2b9D8b916bBdf5715f780fcF and you want to mint blog.example.crypto, you will fill the parameters like so:

Then, add the record(s) you want pre-filled in the subdomain after minting to the keys and values fields as an array of values. See the Records Reference documentation for supported values. You can also provide empty records if you wish to. Set parameter withReverse to false if you do not need to set reverse record for the subdomain. It is possible to set reverse record for subdomain only if it is going to be minted to parent's domain owner, otherwise setting reverse is considered insecure without subdomain owner's signature.

Step 5: Execute the Contract

Click the Write button to sign the transaction and execute the contract. After signing the transaction, you can view its details on the blockchain explorer, like so:

Considerations

The following considerations apply to minting subdomains:

• Subdomains must contain only lowercase letters ( a-z ), numbers ( 0-9 ), and hyphens ( - )
• Subdomain names cannot start with a hyphen ( - )