@arcana/auth

Arcana Network Auth SDK

What is Auth SDK?

You can integrate your application with Arcana Network Auth SDK to securely sign blockchain transactions and easily onboard application users. Auth SDK can be used to enable one or more authentication mechanisms. After authentication, each user is internally assigned a unique key that is secure, private and never exposed. Application users don't need to manage keys or share them explicitly for enabling any blockchain transaction. At the same time, application users get complete flexibility to choose the way they onboard a dApp using familiar Web2 signup/login mechanisms configured by the application developer.

Auth SDK enables secure Ethereum provider for dApps. If the dApp requires to provide blockchain enabled secure and private file storage and access functionality, Auth SDK seamlessly works with Arcana Storage SDK to enable file based transaction signing and approval by the user.

If your application use case requires you to have a secure, private file store for user data while managing your own keys, or using your own wallet, or a third party wallet, then you can directly integrate your application with Storage SDK. Otherwise, it is recommended that you use Arcana Auth SDK and Storage SDK together for a seamless experience.

Following authentication mechanisms are supported:

• Social OAuth

  • Discord
  • GitHub
  • Google
  • Reddit
  • Twitter
  • Twitch

• Passwordless authentication

💪 Key Features

🗝️   Enables secure Ethereum provider access to dApps

🔒   Onboard dApp users via social, passwordless login

👛   Encrypt/Decrypt data using Ethereum Provider interface

⛓️   Sign blockchain transactions using Ethereum Provider interface

⚙️   Configure transaction signing user experience (no UI, popup UI) as per dApp use case

🏗️ Installation

npm

npm install --save @arcana/auth

yarn

yarn add @arcana/auth

CDN

<script src="https://cdn.jsdelivr.net/npm/@arcana/auth"></script>

<script src="https://unpkg.com/@arcana/auth"></script>

📋 Prerequisites

Before you can start using the Arcana Auth SDK, you need to register your dApp using Arcana Developer Dashboard.

A unique AppId will be assigned to your dApp and you need the same to initialize the Arcana Auth SDK.

📚 Documentation

Check out Arcana Network documentation for Auth SDK Quick Start Guide, Usage Guide and API reference Guide.

Refer to the sample code or the How To Guides for examples related to specific use cases. For example, configuring Arcana Auth SDK, encrypting or decrypting data, signing transactions and more.

💡 Support

For any support or integration related queries, contact Arcana support team.

🤝 Contributing

We appreciate your feedback and contribution to Arcana Auth SDK. Open a GitHub issue and discuss your RFP with Arcana Network developers. We plan to come up with a detailed contributing guide soon. Stay tuned!

ℹ️ License

Arcana Auth SDK is distributed under the MIT License.

For details see Arcana License.