Skip to main content

Configure dApp

In this tutorial, you will learn how to configure your dApp and select, enable requisite Arcana SDK features using the Arcana Network developer dashboard. This is the very first thing you need to do before you can use any of the Arcana SDKs such as Auth or Storage.

note

After configuration, your dApp will be assigned a unique appID. You will require this to integrate with Arcana Auth SDK and Arcana Storage SDK.

Prerequisites

You need to have one of the supported social OAuth accounts before you can log in and configure your dApp using our dashboard.

  • Google
  • GitHub
  • Twitch
  • Discord

Step 1: Developer Dashboard Login

Visit Arcana Network Developer Dashboard:

https://dashboard.beta.arcana.network

Choose one of the social OAuth mechanisms displayed on the welcome screen to log into the dashboard.

Welcome screen

Step 2: Configure dApp Settings

The very first login to the dashboard brings up 'create new dApp' wizard. Provide the following details to register your dApp:

  • dApp name
  • Storage Region

Register dApp

caution

Storage Region:

Storage region setting is a one time configuration.

You can register your dApp using the Arcana Developer Dashboard:

https://dashboard.beta.arcana.network

When you visit the portal for the first time and register your dApp, you will be asked to choose a storage region or keep the default setting. The only way to change the storage region is to delete the dApp from the dashboard and configure afresh.

Once you start using your dApp and users store some data in the Arcana Store, you can always reconfigure the dApp using the dashboard for user storage limit values or enabling / disabling social authentication providers. However, storage region, once set, cannot be altered.

tip

Arcana Network aggregate your multiple social account login identities, meaning if one logs in through different social auth methods (Google, Twitter, Twitch) which all use the same underlying email, they will be treated as a single user. Therefore, in the case of the dashboard, if you want to create multiple apps you would have to log in through a social account which is registered with a different email ID (different to the one already used).

Subsequent logins into the dashboard will simply bring up your previously configured dApp. You can monitor dApp dashboard and view storage usage statistics.

To configure your dApp, check out various Arcana Network SDK settings grouped under tabs on the dashboard. Specify the field values in each tab as per your dApp use case or use defaults, as applicable.

  • Application Branding / Logo customization
  • Control to delete the dApp record from the Arcana blockchain

  • General Settings

caution

Wallet UI:

Arcana dashboard allows dApp developers to manage the user experience for signing blockchain transactions pertaining to user data storage operations. This is controlled using the WALLET UI setting in the Auth tab of the dashboard.

By default, WALLET UI mode is set to Disabled. What this means is there will be no pop up UI that requires the user to sign every file storage access operation (share, delete, revoke access, change owner). In this case, the end user experience is very similar to the typical Web2 applications without losing on any security or benefits of blockchain.

Once the UI mode is enabled using the dashboard setting, it cannot be disabled later or reconfigured due to security reasons.

Besides the dashboard setting, there is another control that works in tandem with the dashboard setting to tweak the blockchain transaction signing behavior.

The dApp developer can choose appMode during Auth SDK initialization function call. Once WALLET UI setting is enabled through the dashboard, the dApp developer can use appMode in the dApp code when integrating with the Auth SDK. The appMode parameter in the Auth SDK initialization function controls the popup UI type configuration that shows up for dApp users.

Typically, once coded in the dApp it should not be changed. See wallet mode for details on how different appMode choices can control popup UI behavior and user experience for blockchain transaction signing.

For step by step instructions see how to configure Wallet UI guide.

What's next?

Once you have successfully configured your dApp using the Arcana Network dashboard, you can view dApp resource usage metrics in the dashboard.

Dashboard metrics

If you have the same email ID associated with various social OAuth applications such as GitHub, Google etc., Arcana Network can identify you, irrespective of the mechanism used to login into the dashboard. By default, Arcana Network can aggregate your social OAuth into a single Arcana identity.

What this means is, if you have the same email ID associated with your Google and Discord accounts, then you can login into Arcana developer dashboard using one social OAuth, configure your dApp and later you can log into Arcana dashboard using a different social OAuth and you will see the same dashboard as your Arcana identity is associated with all your social OAuth. This works only if you your social OAuth uses the same email.

tip

You can reconfigure dApp settings later anytime by visiting developer dashboard and clicking on the Configure menu item on the top right of the screen.

note

You can refer to dApp appID assigned as part of registration with Arcana Network on the top right of the dashboard.

appID

See Also

You can setup social, passwordless or third-party wallet authentication after configuring your dApp. This will enable dApp users to associate with a unique Arcana identity that is based on distributed, secure keys and works for blockchain powered smart contract transaction signing.