Developers

Auth

9min



Social Login

Social Logins eliminate the friction of setting up and managing wallets for new users, who might’ve dropped off the onboarding journey. It simplifies the onboarding process for new users by using familiar social authentication providers or email, making it super easy.



Custodial wallets also offer social login, but they require users to sacrifice privacy and control, as a third party can access your keys and wallet funds.



Arcana's non-custodial wallet is user-friendly, offering simplicity to new users while prioritizing user privacy, security, and ownership.



Arcana Auth

The Arcana Auth SDK offers social login via email, Web2 authentication providers such as Google, GitHub, Discord, and Twitter, and custom IAM providers such as Firebase and Cognito.



Document image




Arcana Auth Benefits

Arcana Auth makes it simple for users who are new to Web3 to try out apps using their social or email accounts while ensuring ownership of their keys. It works with familiar Web2 authentication mechanisms such as Google, Twitter, twitch, discord, and passwordless logins.

Arcana Auth is one of the fastest web3 authentication providers with a sub-5-second login time.

Once authenticated, users can securely and instantly use the non-custodial Web3 Arcana wallet from within your app, without the need to install browser extensions.

Developer Benefits

  • Higher conversions: Lowers barrier to entry for new users to start using Web3 apps. Up to 90% higher conversion.
  • Quick integration: Easy to integrate into any Web3 app - Web, Mobile, Unity, etc. with support for connectors such as WAGMI, RainbowKit, etc.
  • Customizable: Developers have the flexibility to pick and choose the user experience for onboarding and signing blockchain transactions:
    • Plug-and-Play login UI or custom login UI to onboard users
    • Enable one or more preferred social authentication providers of your choice for your app
    • Select Caduceus as the default active chain for the user to begin signing blockchain transactions
    • Add other supported blockchains into the preconfigured list of networks displayed in the wallet
    • Control wallet visibility in the app context
    • Use built-in Arcana wallet UI or Whitelabel the UI to customize it to your needs
  • Caduceus enabled: A predefined list of supported blockchain networks including Caduceus, comes ready to use out of the box. The developer has to simply enable the chain and set it as default during app creation on the dashboard

User Benefits

  • Lower barrier to Web3 entry: To onboard any Web3 app that is registered, configured, or integrated with the Auth SDK, users can simply log in via a familiar Web2-like social login
  • Better User Experience
    The Arcana wallet appears in the app right after the user logs in. Developers can customize the user onboarding and wallet experience, deciding when to display the wallet, and whether to display all transaction details or only basic minimum information as required.
  • Simplicity and ease of use
    Users are not required to install a browser extension to start using a wallet. Also, they don’t need to generate and manage private keys or give up key ownership to a third party for signing blockchain transactions.
  • Privacy & Ownership: Arcana Auth SDK uses a state-of-the-art asynchronous distributed key generation (ADKG) protocol which allows users to have full control over their wallets while abstracting away the Web3 key management complexity. The user’s key never resides in its complete form at any point on the Arcana network. Key shares are fetched and the key is assembled only in the client context for authenticated users. The key shares are generated on the ADKG subsystem with several nodes, some of which are owned and managed by trusted partners. There is no single node that has access to all the key shares required to generate the key.
  • Out-of-the-box Caduceus access: Users can simply log into the apps integrated with the Auth SDK and start signing blockchain transactions on the Caduceus network as it is pre-configured in the Arcana wallet.



Dev Guide: Enable Social Login

Developers can enable social login in Web3 apps by integrating with the Arcana Auth product using these simple steps:

  • Step 1: Register the app with the Arcana Network using the Arcana Developer Dashboard and get a unique client identifier. During app registration, the developer can choose the default chain as Caduceus from the list of pre-configured chains. This can also be specified later through the dashboard.
    • After registering the app, Configure the social providers and enable user onboarding options specific to your app.
    • Next, click on the App dashboard and check the Configure -> Chain Management section. Caduceus Network is available in the pre-configured list of blockchains displayed in the wallet. If not already selected during app registration, developers can later use the dashboard, select Caduceus network, and enable it as the default chain with a single click.
Document image




For more details, see the Arcana Auth SDK Quick Start Guide.



User Guide

To start using Web3 apps, all you have to do is use social login and sign in to the apps integrated with the Arcana Auth SDK.

Once you're logged in, you can right away get to your Arcana wallet. If the app developer has configured Caduceus as the default blockchain through the Arcana Dashboard, you will see Caduceus as the active chain in your Arcana wallet. This means you can access all your assets on the Caduceus chain through the wallet and perform Web3 blockchain transactions such as sending and receiving tokens, etc.

The good news is you don't need to install any browser add-ons to use the Arcana wallet.

Access Arcana Wallet

Step1: Log into the Web3 app via social login enabled through Arcana Auth integration. The wallet will be displayed in the app context right after authentication.

Step2: Click on the wallet displayed in the minimized form at the bottom left (LHS) or right (RHS) of the app page. You will see the full wallet view.

In the example below, the user logs into a sample app using the email ID and clicks on the verification link for authentication. Once authenticated, the wallet shows up in the app context automatically! If the developer configures Caduceus as the default chain, then the authenticated user will see the Caduceus chain when the wallet shows up. If the developer has not specified the Caduceus chain as the default chain, then the user can simply click the arrow icon next to the network on the top right of the wallet and select the Caduceus network.



Document image


Note: In addition to the pre-configured list of blockchain networks displayed in the wallet, users can also add any other supported network through the wallet UI. To add a network, click the 'Add Network' option. For example, the Galaxy Caduceus Testnet network can be added by the user, as it is not available in the preconfigured list of blockchains. However, users must note that any chains configured by the user through the wallet UI are not accessible across user login sessions.

Step3: If the app asks you to sign a ‘personal sign’ message type or switch chain, you will see a pop-up displaying the transaction details. Read the transaction details carefully before signing or approving any blockchain transaction issued through the app.

Step4: Discover other Arcana wallet features - check account balance, send/receive native and custom tokens, browse NFTs owned by the wallet address, check profile details, export your private key, enable MFA, view blockchain transaction activity, etc.

For more details on using the Arcana wallet, refer to the Wallet User Guide.

Updated 25 Mar 2024
Doc contributor
Did this page help you?