Why did I receive a 'root fingerprint error'?

Make sure you have the correct device plugged in or your passphrase is properly enabled.

What is a fingerprint?

A fingerprint, when it pertains to your hardware wallet, refers to a private key identifier. Just like each private key is unique, each private key also has a unique fingerprint associated with it.

The root fingerprint error ultimately means the incorrect private key is attempting to approve activity on behalf of another private key. 

What causes this error?

Two frequent causes for the fingerprint error are:

  • Having the wrong device plugged in, or
  • Having (or not having) a passphrase enabled on your device

The first thing you should ensure is that you have the correct device plugged in (with the right seed loaded), and if that fails, ensure you have correctly enabled your passphrase (or ensure you don't enter a passphrase if you don't have one).

Caution: If you set up an Unchained vault yourself using Trezor devices, the Trezor bridge likely asked for a passphrase when exporting your public key. Please note that a passphrase and a PIN are two different things. Your PIN is the several-digit code you established when initializing your device. The passphrase that the Trezor bridge asks you for when exporting your public key is a 13th or 25th word that adds a second layer of security to your seed phrase. Do not enter your PIN as your passphrase!

Ensure the correct device is plugged in

Since our platform uses multiple keys to construct multisig vaults, it's easy to connect the wrong device when performing a key check or other function in the Unchained platform. If your hardware wallets might be mislabeled or confused, try another hardware wallet. 

If you have a passphrase enabled on your Trezor

If you know you have a passphrase enabled on your device, follow these steps to ensure you enter it correctly when prompted by the Trezor bridge.

  1. Click the Connect to Trezor button for the action you are trying to perform in the Unchained dashboard (key check, sign, or confirm an address). This will open the Trezor Suite bridge.
  2. Type in your PIN.
  3. When prompted for your passphrase, type in your passphrase.
  4. If you correctly entered your passphrase and you no longer see a fingerprint error, that's it!

If you don't have a passphrase enabled on your Trezor

  1. Click the Connect to Trezor button for the action you are trying to perform in the Unchained dashboard (key check, sign, or confirm an address). This will open the Trezor Suite bridge.
  2. Type in your PIN.
  3. When prompted for your passphrase, leave the field blank and click Enter.
  4. If you correctly left the passphrase field blank, and you no longer see a fingerprint error, that's it!