Skip to main content

Email Wallets

AppKit enables passwordless Web3 onboarding and authentication, allowing your users interact with your application by creating a non-custodial wallet with just their emails.

Note

Due to Safari’s strict third-party cookie policies, the SDK is not preserving sessions after the app is closed. Our team is working to solve this issue soon.

Integration​

Update your Cloud settings​

  1. Go to your Cloud project
  2. Open Dashboard and scroll down to Mobile Application IDs menu
  3. Add your iOS Bundle ID and/or your Android Package Name
  • Changes might take some minutes to impact

Install packages​

yarn add @web3modal/email-wagmi-react-native react-native-webview

On iOS, use CocoaPods to add the native modules to your project:

npx pod-install

Add the email connector in defaultWagmiConfig​

import { emailConnector } from '@web3modal/email-wagmi-react-native'

const email = emailConnector({ projectId, metadata })

const wagmiConfig = defaultWagmiConfig({
  chains,
  projectId,
  metadata,
  extraConnectors: [email]
})

User Flow​

  1. Users will be able to connect to you application by simply using an email address. AppKit will send to them a One Time Password (OTP) to copy and paste in the modal, which will help to verify the user's authenticity. This will create a non-custodial wallet for your user which will be available in any application that integrates AppKit and email login.

  2. Eventually the user can optionally choose to move from a non-custodial wallet to a self-custodial one by pressing "Upgrade Wallet" on AppKit. This will open the (WalletConnect secure website) that will walk your user through the upgrading process.