Crypto Wallet Domains
Learn how to assign your Decentraweb Domain to your Wallet Address
When using Decentraweb Domains as Domains for your Wallet Address, there are two types of records
These Records can be set for both Web3 TLDs (e.g. .yourtld) and Web3 Domains (e.g. anything.yourtld)
Primary Domain Records are used for :
Replacing 0x Address with Domain within Websites using Namekit SDK or within Decentrachat
Send Crypto Payments from Domain
Wallet Domain Records are used for :
Receiving Crypto Payments to Domain (for 150+ cryptocurrencies)
To have all three use cases for your Domain, you'll need to set both Primary Domain Records and Wallet Domain Records
Primary Domain (Reverse Record)
Wallet Address -> Domain
e.g 0xA19b27b8f1d58dFB5B9bf2326DCb4E0c42A3a192 -> name.yourtld
You can only have one Primary Domain per wallet, per network (Ethereum and Polygon currently). Primary Domains are also known as Reverse Records and allow for your Wallet Address to be looked up by your Decentraweb Domain. This means web3 websites and app developers that utilize our Namekit SDK can lookup your ETH address to find your DWEB TLD or SLD and display that instead - making for friendlier UI/UX experiences with human-readable domains replacing where wallet addresses usually display.
Without Primary Domain Set | With Primary Domain Set |
How to set Primary Domain Record
Connect your wallet you'd like to set a Primary Domain for to our DNS App - dns.decentraweb.org
Within My Account navigation dropdown, select Set Primary Domain
Select the Domain you'd like to use for your Primary Domain and press Commit. This will open up 2 txns within your wallet to approve and pay gas.
Following this transaction approving, refresh the page to see your Primary Domain has been set 🎉
When setting your Primary Domain, you can also add Wallet Domains which points the domain set as your primary domain to wallet addresses for 150+ cryptocurrencies. Learn more about Wallet Domains below.
Wallet Domains (Forward Records)
Domain -> Wallet Address
.e.g 🍕 -> 0xA19b...A3a192
Wallet Domains allow for your Domain to point to your Wallet Address, thus allowing for payments to your Domain, which in turn is pointed to your wallet address.
You can set Wallet Domains for up to 150+ cryptocurrencies per Domain
You can have unlimited Domains with Wallet Domain records set to a singular wallet address. For example :
🍕 -> 0xA19b...A3a192
name.yourtld -> 0xA19b...A3a192
anything.yourtld -> 0xA19b...A3a192
Wallet Domains are set per Domain. If you'd like to set Wallet Domains to your Primary Domain, you can do this when setting your Primary Domain Record.
How to set Wallet Domain Records
Connect your wallet that owns the domain(s) you'd like to set Wallet Domain records for within our DNS App - dns.decentraweb.org
Within the My Account navigation, head to My Domains and select the Domain you'd like to set Wallet Domain Records for :
Within Address Records, select the blockchain/coin you'd like to set a Wallet Domain record for and paste in the wallet address you'd like your Decentraweb Domain to point to for that blockchain.
Decentraweb's SDK Are you an app developer and interested in building further. Check out the full SDK and docs on our Github! https://github.com/decentraweb/decentrawebjs
Last updated
