Configure Wallet Chains

In this tutorial, you will learn how web3 app developers can control which subset of supported chains are displayed in the Arcana wallet UI and how to specify the default chain.

Prerequisites

Make sure you can access the Arcana Developer Dashboard: https://dashboard.arcana.network
Use the Arcana Developer Dashboard to register the app.

Steps

Managing Arcana wallet chains displayed in the wallet UI for a Web3 app integrated with the Arcana Auth SDK is simple!

Log in to the Arcana Developer Dashboard and click your registered app entry from the 'Manage Apps' screen. Click Configure in the LHS navigation area. Select Chain Management to add the specifics for the chain.

This will bring up the chain configuration UI as shown below:

Step 1: Check if the Chain Exists

The Arcana Auth SDK has a default subset of blockchain networks that appear in the wallet UI. In this default subset, Ethereum Mainnet is set as the default chain displayed in the wallet UI.

For the latest information on the default subset, see Arcana Auth SDK Reference Guide.

If the chain you wish to make default is already listed in the subset of chains that are configured to be displayed by the Arcana wallet, simply click it and use the instructions in Step 3 below to specify it as the default chain. Otherwise, first, add that chain and then make it the default chain for the wallet.

Step 2: Add Chain

Click Add Chain button on the top right of the 'Chain Management' dashboard screen.

To add a blockchain, specify the following details and click Save.

Network Name
Chain Id
Currency Symbol
RPC URL
Block Explorer URL
Testnet/Mainnet Chain Type

Supported Chains

Only EVM-compatible chains are supported by the Arcana Auth product. To learn more, see supported blockchains.

Once you click Save, the newly added chain will be displayed in the dashboard.

The newly added chain is configured for the Arcana wallet. When the app user authenticates and the wallet is displayed in the app's context, the user will see the newly added chain when they click on the dropdown in the wallet UI.

Step 3: Make Chain Default (Optional)

Developers can add and make the chain default by simply clicking on the entry in the dashboard and choosing Set as Default.

Once a chain is made default, you will see it marked as Default in the dashboard. The figure below shows that Shardeum Sphinx chain has been successfully set as the default chain by the developer.

That's all!

This is how the developer can control and manage which subset of chains is displayed in the Arcana wallet UI and how one of the chains in the subset can be marked as default so that an authenticated user sees it in the wallet.

What's Next?

Besides controlling and managing the chains via the Arcana Developer Dashboard configuration settings, a developer can also add new chains programmatically to the wallet via the wallet_addEthereumChain method. To do that, the app must be integrated with the Arcana Auth SDK and the AuthProvider initialized before calling any of the SDK functions. For details refer to the Arcana wallet Usage Guide.