Skip to main content
Users can recover their DFNS accounts using recovery credentials. When a recovery credential is used, all existing credentials (both regular and recovery) are invalidated for security. The user must create new credentials during the recovery process. A recovery credential is an encrypted private key that DFNS stores on your behalf. The encryption is performed by the frontend that created the credential, so DFNS never has access to the decryption password. This means recovery must happen through the same frontend that registered the credential:
  • Dashboard users: If the user registered through the DFNS dashboard, they recover via the dashboard at app.dfns.io/recover.
  • Users registered through your application: end users, and org users registered through delegated registration. You must implement the recovery flow in your application using the recovery APIs. DFNS provides the APIs; you own the recovery UX and encryption scheme.
The recovery flow depends on how the user registered:
  • Regular registration (tenant users, and org users invited with registration: "Direct"): the user recovers on their own, from the dashboard or from your frontend.
    1. : Send Recovery Code Email emails the user a verification code.
    2. : Create Recovery Challenge takes the code and returns the challenge with the user’s encryptedRecoveryKey. Decrypt it in your frontend with your own scheme.
    3. : Recover User, signed with the recovery key, registers the user’s new credentials.
  • Delegated or social registration (end users, and org users registered with registration: "Delegated"): DFNS sends no recovery email. Your service account starts recovery with Create Delegated Recovery Challenge, then the user completes it with Recover User.
For end users on your app, recovery is not optional. If a user loses their only credential and you never registered a recovery credential or prompted them to add a second device, their wallet is permanently inaccessible. Your only fallback is manual delegated recovery, one user at a time. Register a recoveryCredential at signup. See Implement end-user recovery.

Guides

Recover your account

Step-by-step guide for employees to recover their account using the dashboard.

Implement end-user recovery

Developer guide for implementing recovery flows for delegated wallet users.
Last modified on November 11, 2026