Quickstart

​

0. Prerequisites

This guide assumes that you have completed the setup guide.

​

1. Enable a user to log in via email

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.

​

3. Send and sign transactions using the embedded wallet

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

// Get an EIP-1193 Provider
const provider = await wallet.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]]
});

// 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]]
});

// Get address
// Get an EIP-1193 Provider
const provider = await wallet.getProvider();
const accounts = await provider.request({
  method: 'eth_requestAccounts'
});

// Send transaction (will be signed and populated)
const response = await provider.request({
  method: 'eth_sendTransaction',
  params: [
    {
      from: accounts[0],
      to: '0x0000000000000000000000000000000000000000',
      value: '1'
    }
  ]
});

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