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
- 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.
- 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 theauth-react
package. Next, you must integrate the app with the Arcana Auth SDK, create and useAuthProvider
and also the React component,ProvideAuth
. -
React Apps using the Wagmi or RainbowKit wallet connectors must install both the
auth
package and theauth-wagmi
package. Next, you must integrate the app with the Arcana Auth SDK and instantiate theAuthProvider
. Use theAuthProvider
to create anArcanaConnector
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.