OneKey Support Center

Passphrase function overview and usage tutorial

  • Updated

What is Passphrase

1. Passphrase is a number, word or sentence set by the user. It is different from the initial mnemonic phrase automatically generated by the hardware device when it is used for the first time. The word is randomly selected by the algorithm in the standard dictionary under the BIP39 protocol. Passphrase is the word selected by the user. Personally set and save, it can be any collection of numbers or letters, or even sentences. You can think of Passphrase as the "additional word (mnemonic +1)" function of the hardware wallet.

2. There is no right or wrong Passphrase, each new Passphrase will generate a brand new address and private key with the original mnemonic. There are two different accounts from the previous account. If you want to retrieve the previous address, you must enter the previous Passphrase.

That is: After you record the mnemonic phrase generated by the hardware device, and then set the Passphrase, a new set of addresses will be generated. And when you use a different Passphrase, a new set of addresses that are different from the previous address set will be generated.

It can be understood by the following formula:

Mnemonic phrase A = Address group A

Mnemonic phrase A + Passphrase A = Address group B

Mnemonic phrase A + Passphrase B = Address group C

▶ Address group A, address group B, and address group C are three groups of addresses that are unrelated.

▶ Mnemonic phrase A can only restore the addresses in address group A.

▶ When you want to restore the addresses in address group B or address group C, you need mnemonic phrase A + the corresponding Passphrase. Any error will cause the addresses in address group B and address group C to be unrecoverable.

▶ Therefore, we strongly advise novice users to enable Passphrase. When the Passphrase record is confused or forgotten, even if you have the correct mnemonic phrase, the address cannot be recovered.


How to turn on and turn off Passphrase

At present, Passphrase can only be turned on and off on the OneKey desktop, and Passphrase is not supported on the mobile app. That is, according to the above formula, the mobile app can only restore address group A through mnemonic phrase A, and address group B and group C that have been set with Passphrase cannot be restored on the app.

1. First open the OneKey desktop, click Settings, and select Device. Find Passphrase, click Enable, and then Confirm on the hardware device.




After the confirmation is completed, the passphrase is successfully turned on, and a prompt of successful setting pops up on the desktop.


2. Close the desktop, and then open the OneKey extension in the browser.

If the browser extension has been connected to a hardware device before, there will be a browser cache, which will cause the device to remain at the original address and unable to jump out of the interface for setting Passphrase. At this time, you need to click Forget this device and click on the extension management in the upper right corner Close and open the extension.

If it still does not work, you need to restart the computer, then log in to the extension again, and select Connect Hardware Wallet.



3. After authorizing the connection, enter the page for setting Passphrase.

At this time, you need to enter Passphrase and check it on the hardware device. The address group generated at this time is the new one generated by the hardware wallet mnemonic + Passphrase.




4. If you need to turn off Passphrase, go to the desktop again, click Settings —>Device —>Passphrase, click Close, and then confirm on the hardware device.

The upper right corner of the desktop pops up when the setting is changed successfully, then Passphrase is confirmed to be closed.




5. Close the desktop and return to the OneKey extension.

Because the hardware device has been connected before, the browser will have a cache, and it may still display the address generated after Passphrase is set. Therefore, you also need to click Forget this device, and then reconnect the hardware device to display the direct before Passphrase is not set. The address group generated by the mnemonic phrase of the hardware device is now.

If the address generated by Passphrase is still displayed, you need to restart the browser or restart the computer, clear the cache, etc.

If you still jump out of the page for setting Passphrase, you do not need to enter it and skip it directly. 


How to add Passphrase hidden wallet on desktop

1. Open the OneKey desktop , select Settings —> Device —> Open Passphrase. Then click OneKey account in the upper left corner, click Add Wallet, follow the prompts to enter Passphrase and confirm.





2. Because the Passphrase hidden wallet is empty when I set it up, I will be prompted to enter again to confirm the Passphrase. Once completed, Hidden Wallet #1 is generated. If you need to add the address group generated by the new Passphrase, you can continue to click Add hidden wallet. (If the balance of the first wallet is 0, you cannot add a new wallet.)

Click Hidden Wallet #1 in the upper left corner to enter the address of Hidden Wallet #1. This address is generated by the mnemonic phrase of the hardware device + the Passphrase just set.




The above is the function overview and usage tutorial of Passphrase.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request



Please sign in to leave a comment.