Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.privy.io/llms.txt

Use this file to discover all available pages before exploring further.

Once a user has created a embedded wallet, when they attempt to use the wallet on a new device, the key material for their wallet must be provisioned on that device. In most cases, once a user authenticates on a new device, Privy automatically orchestrates reconstitution of the key material for their wallet on that device. This requires no additional action from the user and allows them to seamlessly use their wallet on any device where they are authenticated. In self-custodial setups, you can also require users to input a password or authenticate with their cloud account (iCloud, Google Drive) in order to reconstitute their wallet on a new device. Follow the steps below to enable this setting.
Additional authentication factors for device provisioning can be reset on a provisioned device, but if a user loses all provisioned devices and their additional factor, they will be locked out of their account.Read more more about Privy’s self-custodial architecture.
1

Configure authentication factors for new devices.

Visit the Authentication page for your app in the Privy Dashboard and navigate to the MFA tab. Then, select the authentication factors (password, Google Drive backup, or iCloud backup) you’d like to offer users for new devices. Learn more
2

Prompt users to enroll authentication factors for new devices.

Once users have created a wallet, prompt your users to enroll authentication factors for new devices per this guide. Alternatively, to automatically prompt users to enroll authentication factors for new devices, toggle the Require additional authentication for new devices setting on.
3

Prompt users to authenticate when using the wallet on a new device.

When users log in on a new device, prompt them to authenticate with their additional factor per this guide.