Introduction
Use Arcana Auth to streamline user onboarding for Web3 apps! Empower authenticated users to effortlessly, yet securely sign blockchain transactions and accelerate their journey into the world of decentralized applications!
Arcana Auth product components include:
Allow users to quickly onboard Web3 apps via the familiar Web2 authentication providers using the built-in plug-and-play login UX in the Arcana Auth SDK. Authenticated users can instantly access the embedded, non-custodial Arcana wallet and sign blockchain transactions.
Arcana Auth is powered by cutting-edge cryptographic techniques and asynchronous distributed key generation algorithms that ensure no single entity owns or manages the user's keys. Designed for developers and Web3 users, it is easy to integrate and offers a simple yet secure, and customizable user experience for signing blockchain transactions.
Already using Arcana Auth?
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.
Arcana Auth SDK
Arcana Auth SDK is a client-side library that can be integrated with any Web3 app, be it a vanilla JS app, apps built using various application frameworks such as React, NextJS, Remix, Vue, apps that use wallet connector frameworks such as Wagmi, RainbowKit, and Web3-React.
Once integrated, apps can easily onboard users via any of the configured social providers or the custom lAM providers such as AWS Cognito. The authenticated users can instantly access the embedded, non-custodial Arcana wallet for signing blockchain transactions.
Arcana Developer Dashboard
Developers must first register and configure the Arcana Auth SDK usage as per the Web3 app requirements by using the Arcana Developer Dashboard. Once an app is registered and configured, a unique Client ID is assigned to it. Developers can install the Arcana Auth SDK, use this Client ID and integrate the app with the Arcana Auth SDK.
Arcana wallet
Web3 application developers can enable the embedded, non-custodial Web3 wallet to their users by integrating with the Arcana Auth SDK. The Arcana wallet offers a user-friendly, secure, and customizable interface that can be branded to match your application. Users do not need to generate or manage their cryptographic keys or remember any passphrases. The wallet is built using the state-of-the-art asynchronous, distributed key generation protocol which allows users to have full control over their wallets and abstracts the complexity of cryptography.
Usage
1. Register & Configure App
Use Arcana Developer Dashboard to register the app, configure the user onboarding settings, and specify the wallet user experience settings. Save the unique app identifier called the Client ID assigned to the registered app. This will be required when the app is integrated with the Arcana Auth SDK.
2. Install & Integrate App
Install the auth package and integrate the app. For vanilla HTML/CSS/JS or Vue apps, create the AuthProvider by specifying the unique Client ID assigned to the app. Initialize the AuthProvider before calling its functions for onboarding users and Web3 wallet operations. Developers can use the AuthProvider to obtain the standard Ethereum provider and use it for blockchain transactions. In the case of React/NextJS apps, in addition to installing and integrating with the auth package also install the auth-react package and create the ProvideAuth react component using the AuthProvider created earlier.
For apps using the Wagmi and RainbowKit wallet connectors, install the auth and the auth-wagmi packages. For apps using the Web3-react framework, install the auth and the auth-web3-react packages. Then create an AuthProvider instance by specifying the Client ID as the input parameter. Create an ArcanaConnector instance using the AuthProvider as input and use it to initialize the framework. This will plug in the Arcana wallet in your app for authenticated users via the wallet connector framework.
See how to integrate with the Arcana Auth SDK by selecting instructions for the app type. For more details, refer to the tutorials.
3. Onboard Users & Enable Wallet
After integrating with the requisite Arcana Auth SDK packages, add code to onboard users. Simply use the built-in plug-and-play login UI or build a custom UI and wire it to call the Arcana Auth SDK functions for the configured authentication providers. See detailed instructions on how to onboard users for different app types.
4. Deploy Apps
That's all!
Web3 app is integrated with the Arcana Auth SDK and ready to be deployed on the Arcana Testnet for validation. Then you can create a Mainnet configuration profile and deploy your app on the Arcana Mainnet.
Key Features
Onboard Users
- Fast user onboarding for various types of Web3 applications - vanilla HTML/CSS/JS apps, simple Web3 apps using React, NextJS or Vue frameworks, apps using wallet connectors such as Wagmi, RainbowKit and Web3-React.
- Add user authentication with just a few lines of code.
- Easily customizable user onboarding options that allow users to authenticate via popular Web2 social providers, custom IAM providers, or use passwordless.
Web3 Wallet Transactions
- Authenticated users can instantly access the Arcana wallet and sign blockchain transactions.
- Developers can customize the Arcana wallet and manage user experience for the supported blockchain networks.
- Users can perform Web3 wallet operations, such as sending and receiving tokens and NFTs, managing NFTs, deploying contracts, and interacting with them.
Secure
- Authenticated Web3 application users now have an easy yet secure way to sign blockchain transactions.
- Powered by the state-of-the-art asynchronous distributed key generation protocol that is robust and scalable and offers reliable security, privacy for accessing user keys.
Easy to Use
- Offers an embedded, non-custodial wallet that works within the Web3 apps context.
- Users do not need to set up any browser extensions to use the Arcana wallet.
- Users do not need to remember any seed phrases or manage keys to sign blockchain transactions.