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
Example signature
Example transaction
// 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]]
});
Congratulations, you have successfully been able to integrate Privy authentication and wallet into your React Native application!