Integrate Auth SDK
To integrate your application the Auth SDK, ensure the pre-requisites are met and then follow the instructions based on your application type.
Danger
Auth SDK v1.0.2 -> v1.0.3: Simply upgrade your installation to the latest Auth SDK v1.0.3 and you are good to go!
Auth SDK v0.2.2, v0.3.0 -> 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 Migration Guides and Release Notes.
Prerequisites
- Go to the Arcana Dashboard and register your application.
- Configure the Auth SDK usage settings based on the required user onboarding experience and the Arcana wallet usage for signing blockchain transactions. See how to configure auth section for details.
Select Integration Method
Depending upon whether your Web3 app is a vanilla HTML/CSS/JS app, a React app, or a React app that uses Wagmi, you may need to install one or more of the following Arcana Auth SDK packages - auth
, auth-react
and auth-wagmi
.
- If your application is built with vanilla HTML/CSS and JavaScript, you can directly install and integrate the app with the Arcana
auth
package. - If your application is built using the React framework, you need to install both the
auth
package and theauth-react
package. Next, you must integrate the app with the Auth SDKAuthProvider
and also use the React component,ProvideAuth
. - If your application uses Wagmi or RainbowKit, you need to install and integrate the app only with the
auth-wagmi
wrapper package and create anArcanaConnector
to enable user onboarding and signing of blockchain transactions using the Arcana wallet.
For detailed step-by-step instructions, select one of the options below as per your application type.