Skip to content

Configure Arcana Wallet

In this tutorial, you will learn about how to configure Arcana Wallet and what are the available Arcana wallet customizations.

If you wish to control when the integrated Arcana wallet shows up, see how to configure wallet visibility modes.


Integrate and Initialize Auth SDK

Follow instructions here to integrate Auth SDK in your dApp. During AuthProvider instantiation, the following configuration parameters are available:

  • position: location of wallet on the application screen. (default = right)
  • theme: light or dark theme
  • network: the Auth, Gateway and Wallet UI URL
  • chainConfig: the chainID and RPC URL of the blockchain network selected as default
  • redirectUri: Auth SDK redirectUri

For a complete list of parameters see Auth SDK Reference Guide.

The sample code here shows how to enable Widget mode while initializing the Auth SDK:

const { AuthProvider } = window.arcana.auth // From CDN
import { AuthProvider, CHAIN } from '@arcana/auth' //From npm

In the following code, Arcana wallet is configured to be displayed on the left side of the application screen. The theme is set as 'light'.

const appAddress = '445007f942f9Ba718953094BbeeeeeB9484cAfd2' // App Address Example

const auth = new AuthProvider(`${appAddress}`, {
  position: 'left', // defaults to right
  theme: 'light', // defaults to dark
  alwaysVisible: false, // defaults to true which is Full UI mode
  chainConfig: {
    rpcUrl: '',
try {
  await auth.init()
} catch (e) {
  // Handle exception case

That's it!

You are all set with customized Arcana wallet settings.

What's Next?

You can also configured the Auth SDK wallet visibility to manage blockchain signing user experience.

See also

Last update: January 7, 2023 by shaloo