Skip to content

Integrate App

To integrate with the Arcana Auth SDK, Web3 app developers must first use the Arcana Developer Dashboard to register and configure the app with Arcana Network.

Next, select the app type and follow the instructions.

Note

Arcana Auth SDK v1.0.3 -> v1.0.4: Follow the instructions in the Migration Guide and upgrade easily!

Earlier Arcana Auth SDK versions < v1.0.3: Note that there may be breaking changes that require you to reconfigure your app and also update the integration code. For more information, see archives for Migration Guides and Release Notes.

Prerequisites

  1. Go to the Arcana Developer Dashboard, register your application and save the Client ID assigned to the registered app. This will be required during integration.
  2. Configure the Arcana Auth SDK user onboarding settings via the Arcana Developer Dashboard . See how to configure authentication providers to onboard users.

Select App Type

Depending upon whether the Web3 app is a vanilla HTML/CSS/JS app, a React app, or a React app that uses Wagmi or RainbowKit wallet connectors, developers must install a combination of the following Arcana Auth packages - auth, auth-react and auth-wagmi.

  • Web3 apps built with vanilla HTML/CSS and JavaScript can directly install and integrate the app with the auth package.

  • Simple React or NextJS apps must install both the auth package and the auth-react package. Next, you must integrate the app with the Arcana Auth SDK, create and use AuthProvider and also the React component, ProvideAuth.

  • React Apps using the Wagmi or RainbowKit wallet connectors must install both the auth package and the auth-wagmi package. Next, you must integrate the app with the Arcana Auth SDK and instantiate the AuthProvider. Use the AuthProvider to create an ArcanaConnector for enabling the Arcana wallet to sign blockchain transactions.

For detailed step-by-step integration instructions, select one of the options below as per your application type.

Integrate Vanilla JS App

Integrate React/NextJS App

Integrate Vue App


Last update: May 25, 2023 by shaloo, shalz