Get Started with Domain Wallets ​

Domain wallets enable businesses to provide secure, versatile wallets to their audience, facilitating access to a decentralized, user-owned, privacy-preserving digital world.

Start onboarding your users into the interoperable world of web3 today, and unlock novel and personalized digital experiences.

Sign up as a URL owner ​

Visit the admin dashboard to sign up as a URL owner. The admin dashboard enables you to connect your top-level domain (TLD), create campaigns, and track domain wallets minted.

Once your account is approved, you'll be able to connect your domain.

Connect your domain ​

Domain wallets currently support top-level domains registered through Cloudflare.

Once you have a Cloudflare domain, you will need to provide:

• Your Zone and account IDs
• An API token

These credentials are used to verify that you own the domain, to create DNS records for domain wallets, and to update the records when necessary.

Create your redirection worker ​

After setting up your CloudFlare domain, the last step is to create your redirection worker. This will enable you to forward profile information from a subdomain to domainwallet.id. For instance, a URL like alice.<your-domain>/profile will redirect to domainwallet.id/profile/alice.

To set this up, navigate to the "Workers" section in Cloudflare and create a new worker.

You can ask our team members for the latest code snippet to use in your worker.

Create a campaign ​

After connecting your domain, you are now ready create your first campaign.

Within a campaign, you have the option to customize:

• Name: The name of your campaign
• Slug: The slug of your campaign, which is used to fetch the campaign via the API
• Inventory: Determine the number of domain wallets to distribute
• Lifetime: Specify the duration of domain wallet ownership
• Name Blacklist: Specify domain names that should not be available for sale

New campaigns are initially saved as drafts. You can launch them immediately after creation or make them public whenever you're prepared.

Grab your DW API key ​

After connecting your domain, an API key associated with your domain is generated. This key serves as a unique identifier, ensuring that resources can only be requested by allowed parties.

Use this key to interact with the Domain Wallet Client API and SDK, allowing you to fetch your campaigns and tailor the registration flow in your app.

Next steps ​

• Learn about the technology that powers domain wallets.
• Leverage our API and SDKs to provide domain wallets to your users directly through your platform.