Guides

Connect via Facewallet Kit

Suggest Edits

There are three ways to connect Facewallet Kit to your Dapp. You can choose a way suitable for your Dapp.

The ways to integrate Facewallet Kit are as following:

  1. Continue with OAuth ID Token
  2. Continue with Social Login (Direct Social Login)
  3. Continue with Facewallet

If you've already implemented OAuth (Social Login) system to your Dapp, [1. Continue with OAuth ID Token] is the best way to make users who don't know wallet or web3 to create their wallet very easily. This way can alternate social login part of Facewallet Kit with your social login system. If your Dapp pass OAuth ID Tokens to Facewallet Kit when users have logged in your Dapp, users can use Facewallet with their social login account. So,
users might not know about wallet. They can make a wallet as just logged in your Dapp.

If you don't have any login system in your Dapp and just need a wallet, [2. Continue with Social Login (Direct Social Login)] is the best way. This way is similar to [1. Continue with OAuth ID Token], but it has one more step for user. OAuth (Social Login) system is required in Facewallet Kit. They can make a wallet as just clicking social login button like "Continue with Google" or "Continue with Apple" in your Dapp and logging in Facewallet Kit with social login.

If you have already integrated other wallet and are making a Dapp for Web3 users, we recommend [3. Continue with Social Login + External Wallet]. It is appropriate when your Dapp provides various options to connect wallet including not supported wallet in Facewallet Kit or already integrated wallet. But, if you concern that users never heard about a wallet or don't know about Facewallet, we recommend [1. Continue with OAuth ID Token] or [2. Continue with Social Login (Direct Social Login)].

📘

Don't you have any resource to integrate various wallets?

Then, just integrate our wallet modal with "Social Login + External Wallet". This modal provides a wallet modal including Facewallet, Metamask and WalletConnect. You don't need to integrate them yourself. As integrating our "Social Login + External Wallet" modal, you will get the effect like integrating various wallets.

More information about this modal can be found here.


1. Continue with OAuth ID Token

[Continue with OAuth ID Token] is a way to connect Facewallet Kit using Social Login like Google, Facebook, Apple integrated in your Dapp. You should pass an OAuth ID Token which can derived from OAuth providers to connect Facewallet Kit using your login system with face.auth.loginWithIdToken(). If you want to get more information, please see here.


2. Continue with Social Login (Direct Social Login)

[Continue with Social Login (Direct Social Login)] is a way to connect Facewallet Kit using Social Login like Google, Facebook, Apple. You should make buttons to connect Facewallet Kit using social login directly with face.auth.directSocialLogin(). If you want to get more information, please see here.

We provide the icon assets for Social Login. If you want to make a button with social login icon, please download in here.


3. Continue with Facewallet

[Continue with Facewallet] is a way to connect Facewallet Kit to your Dapp. You should make a button to open a Face Wallet modal with face.auth.login(). If you want to get more information, please see here.


Updated 10 months ago