Somnia Domains (.somi)

1. For Users

How to Claim a Domain?

1. Go to somnia.domains and connect your wallet.

2. Enter the domain you wish to claim in the “Domain Name” field.

3. If the domain address has not been reserved or claimed, you can claim it.

4. Claim periods of 1, 2, or 3 years are available. If you wish to extend it further, you can extend the period by clicking the “Renew” button in the “Domain Management” menu.

5. Domains that are not renewed before their expiration date will automatically expire and become available for others to claim.

How to Set Primary Domain?

1. You can view the domains you own from the “Domain Management” menu.

2. Here, you can set your desired domain as the Primary Domain.

3. Your primary domain is the domain that dApps can access via API. You can remove it or change it to another domain at any time.

2. For Developers

.somi API

https://api.somnia.domains/api/primary-domain/{walletAddress}

You can retrieve the primary domain data of wallets using somi's API. This allows users to see their Primary Domains instead of their wallet addresses in the frontend.

What does the API returns?

{
"wallet":"0x4F40da1a67b891Ec7cCD54F809AFDD72CCc07BEC",
"primaryDomain":"primary.somi",
"hasPrimary":true
}

You can display the wallet or primaryDomain strings in your frontend using the hasPrimary boolean value.