Setting up your dApp Definition

A dApp Definition Account serves two purpose:

The role of the dApp Definition Account is visibly most meaningful in the Radix Wallet to inform your users how entities of your dApp are related to each other. Most importantly, it helps authenticate your dApp’s website (and other entities) to ensure your users are not fooled by fake representation of your dApp. In essence, the dApp Definition Account acts as a hub which connects all the parts of your dApp together.

Setting up a dApp Definition on the Radix Dashboard

Ideally, a dApp Definition account should be created after you’ve built your dApp’s components and resources, and created a website front end for it.

  1. Create a new account in the Radix Wallet. This is the account which we will convert to a dApp Definition account.

  2. Head to the Developer Console’s Manage dApp Definitions page. This page provides a simple interface to set the metadata on an account to make it a dApp Definition.

  3. Connect your Radix Wallet to the Dashboard and select the account you just created to be a dApp Definition.

  4. In the dropdown menu next to "Select Account", make sure the account is the same account you selected to be a dApp definition.

  5. Check the box for “Select this checkbox to configure your accounts as a dApp”.

  6. Fill in the name, description, and linked websites, and linked entities of your dApp. Later you’ll also be able to specify an icon image, but that’s not ready just yet.

    1. Linked websites - Here, you can claim ownership of your dApps website(s) for authenticity. This is confirmed by looking up an expected .well-known/radix.json file at the claimed website origin. This will be required for your dApp to successfully send requests to the Radix Wallet at mainnet. More information about configuring the well-known file on your website is coming soon.

    2. Linked Entities - Here, you can claim ownership of resources, components, and packages.

  7. Click “Update”

  8. An approve transaction should appear in your Radix Wallet to confirm!

When you set up the Radix dApp Toolkit in your dApp frontend website, you’ll configure it with the dApp Definition address that you just created, and it will be sent to the Radix Wallet whenever a user connects or receives a transaction from your dApp. The Wallet will then look up that dApp Definition address on the Radix Network, pull the latest metadata, and show it to the user. When a user logins to your dApp, an entry in the wallet’s preferences for your dApp will appear too.

Further details on the dApp Definition system are forthcoming.