​
0. Prerequisites

This guide assumes that you have completed the setup guide.

​
1. Enable a user to log in via email

This quickstart guide will demonstrate how to authenticate a user with a one time password as an example, but Privy supports many authentication methods. Explore our Authentication docs to learn about other methods such as socials, passkeys, and external wallets to authenticate users in your app.

To authenticate a user via their email address, use the React Native SDK’s useLoginWithEmail hook.

import {useLoginWithEmail} from '@privy-io/expo';
...
const {sendCode, loginWithCode} = useLoginWithEmail();

Ensure that this hook is mounted in a component that is wrapped by the PrivyProvider. You can use the returned methods sendCode and loginWithCode to authenticate your user per the instructions below.

​
Send an OTP

Send a one-time passcode (OTP) to the user’s email by passing their email address to the sendCode method returned from useLoginWithEmail:

import {useLoginWithEmail} from '@privy-io/expo';

export function LoginScreen() {
  const [email, setEmail] = useState('');
  const [codeSent, setCodeSent] = useState(false);

  const {sendCode} = useLoginWithEmail();

  return (
    <View>
      <Text>Login</Text>

      {/* prettier-ignore */}
      <TextInput
        value={email}
        onChangeText={setEmail}
        placeholder="Email"
        inputMode="email"
      />

      {!codeSent ? (
        <Button
          onPress={async () => {
            await sendCode({email});
            setCodeSent(true);
          }}
        >
          Send Code
        </Button>
      ) : (
        {/* prettier-ignore */}
        <Button onPress={() => loginWithCode({code: code, email})}>
          Login
        </Button>
      )}
    </View>
  );
}

​
2. Create an embedded wallet for the user

Your app can configure Privy to automatically create wallets for your users as part of their login flow. The embedded wallet will be generated and linked to the user object upon authentication.

Alternatively your app can manually create wallets for users when required.

Privy can provision wallets for your users on both Ethereum and Solana.

​
3. Send and sign transactions using the embedded wallet

To request signatures and transactions from a wallet, you must first get an EIP1193 provider for the wallet.

import {useEmbeddedEthereumWallet} from '@privy-io/expo';
// Get an EIP-1193 Provider
const {wallets} = useEmbeddedEthereumWallet();
const provider = await wallets[0].getProvider();

Once you have the embedded wallet’s EIP-1193 provider, you can use the provider’s request method to send JSON-RPC requests that request signatures and transactions from the wallet!

The request method accepts an object with the fields:

  • method (required): the name of the JSON-RPC method as a string (e.g. personal_sign or eth_sendTransaction)
  • params (optional): an array of arguments for the JSON-RPC method specified by method
// Get address
const accounts = await provider.request({
  method: 'eth_requestAccounts'
});

// Sign message
const message = 'I hereby vote for foobar';
const signature = await provider.request({
  method: 'personal_sign',
  params: [message, accounts[0]]
});

Learn more about sending transactions with the embedded wallet. Privy enables you to take many actions on the embedded wallet, including sign a message, sign typed data, and sign a transaction.

Congratulations, you have successfully been able to integrate Privy authentication and wallet into your React Native application!