Bisq is a non-custodial exchange, which means you retain control of your funds. That also means you’re in charge of securing your funds.
This doc covers Bisq wallet basics and how you can secure your Bisq wallet by (1) encrypting it and (2) writing down its seed words so you can restore it later.
Wallet Info
Bisq’s built-in Bitcoin wallet is based on BIP 44. BTC wallets have a m/44'/0'/0' derivation path and BSQ wallets have a m/44'/142'/0' derivation path.
The same seed phrase is used for BTC and BSQ wallets.
Security
Encrypt your wallet
Before setting a password, your Bisq wallet files are stored on your hard drive unencrypted. That means anyone who gains access to your computer (whether by physically stealing it or by hacking it remotely) can gain access to your private keys and take your bitcoin.
Setting a password encrypts your Bisq wallet files so they’re useless to anyone without the password.
To set a password, go to the Wallet password section of the Account screen and enter a password.
Write down your seed words
Now that you’ve set a password, it’s time to write down your wallet’s seed words. Go to the Wallet seed section of the Account screen and write down the words you see in the Wallet seed words field along with the Wallet date. Wallet date is required by bitcoinj, which is the library Bisq uses to interact with the Bitcoin network.
| You should actually write down your seed words and wallet date using pen and paper. Saving them on your computer, even if you do so in a secure password manager, makes it possible for a hacker to obtain them through sneaky schemes like keylogging. Going low-tech with pen and paper eliminates all such digital attack vectors. |
With just your wallet’s seed words and date, you can restore your Bisq wallet and all its BTC and BSQ into a new Bisq wallet if you ever need to. If you lose your wallet’s seed words and date, you won’t be able to restore your wallet, and all funds in it are lost forever. So make sure you keep that paper safe!
With your wallet encrypted and your seed words written down, the bitcoin in your Bisq wallet is much more secure.
Restoring from seed
|
Your seed words can restore your wallet’s BTC and BSQ, but they do not restore other Bisq application data such as your payment accounts, open disputes, etc. For that, you need to back up the Bisq data folder. Also note that restoring from seed does not restore reputation value earned from contributing to Bisq. |
Restoring from seed is intended as an emergency measure, to be used if you can’t get your funds back any other way. We highly recommend trying these remedies to solve common wallet issues first.
If your goal is to transfer BTC or BSQ, it’s best to send the funds to a new address with a transaction. This is also better for usability, as wallets with lots of transactions can cause Bisq to get laggy over time.
You should only restore from seed into a new Bisq wallet. You could restore BTC funds to an external wallet like Electrum, but restoring BSQ on a non-Bisq wallet is virtually guaranteed to fail given the complex nature of BSQ transactions (see warning here).
If you do restore from seed on Bisq and still see a zero balance for BTC or BSQ, make sure to wait until the program is done syncing with the Bitcoin network (when done, the green bar on the bottom right labeled Synchronizing with Bitcoin Mainnet (using Tor) / Synchronizing DAO will go away).
|