Difference between revisions of "Restoring your wallet from seed"

From Bisq Wiki
Jump to navigation Jump to search
(reword, update screenshot, polish formatting)
Line 1: Line 1:
=== Restoring Bisq wallet from seed ===
+
You can '''restore your wallet from seed''' to recover your funds in unusual circumstances when nothing else is working (e.g., if a data directory ''and'' its backups become corrupted).
  
'''Note:''' 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.'''
+
Note that such a recovery only restores funds (BTC and BSQ) but does not restore any other Bisq data such as payment accounts, open disputes, etc. This data is stored in the Bisq data directory. Furthermore, restoring from seed does not restore [https://docs.bisq.network/dao-user-reference.html#voting-stake reputation value] earned from contributing to Bisq.
'''Also note that restoring from seed does not restore [[https://docs.bisq.network/dao-user-reference.html#voting-stake 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 [[https://docs.bisq.network/backup-recovery.html#wallet-data these remedies]] to solve common wallet issues first.
+
__TOC__
  
To restore a wallet using your seed words first click on '''Account''' then click on the '''Wallet Seed''' tab. On this screen you may now enter your seed words in the '''Restore wallet from seed words''' box as well as your '''wallet date''' and press '''RESTORE WALLETS'''.
+
== Restoring to a Bisq wallet ==
  
'''Note:''' The wallet date is required by bitcoinj, which is the library Bisq uses to interact with the Bitcoin network.
+
Before restoring from seed, please try [[Backup_&_Recovery#2._Restore_a_wallet_backup|restoring your wallet from a backup]] first.
  
[[File:Walletseedtab.png|thumb|left|500px]]
+
To restore a wallet using seed words, go to <code>Account</code> > <code>Wallet Seed</code>, enter the seed words and date in the "Restore wallet from seed words" section, and then click <code>Restore Wallets</code>.
  
<br clear=all>
+
: ''{{Wallet_date_explainer}}''
If your goal is to transfer BTC or BSQ, it is 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 [[https://docs.bisq.network/dao-user-reference.html#more-about-bsq here]]).
+
Bisq will then restart and start to rebuild your wallet state. If you see a zero balance for BTC and/or BSQ after restoring from seed, wait until the program is done syncing with the Bitcoin network. You'll know syncing is done when the green bar on the bottom right labeled "Synchronizing With Bitcoin Mainnet (using Tor) / Synchronizing DAO"  goes away.
  
'''Note:''' 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
+
[[File:Restore-from-seed.png|600px|thumb|left|Go here to restore a Bisq wallet from seed.]]
'''Synchronizing With Bitcoin Mainnet (using Tor) / Synchronizing DAO'''  goes away).
 
  
===Restoring to a non Bisq wallet===
+
<div style="clear: both;"></div>
  
To restore you wallet data to a non Bisq wallet it is imperitive to use the correct derivation path. The built-in Bisq  Bitcoin (BTC) wallet is based upon the Bitcoin Improvement Proposal (BIP 44).
+
Things to know:
* BTC wallets have a m/44'/0'/0' derivation path.
 
* Bisq (BSQ) wallets have a m/44'/142'/0' derivation path.
 
The same seed phrase is used for BTC and BSQ wallets.
 
  
 +
* '''You should only restore from seed into a new Bisq wallet.'''
 +
* If your goal is merely to transfer BTC or BSQ to another Bisq instance, it's best to simply send the funds to the new instance with a transaction.
 +
* You can restore BTC funds to an external wallet like Electrum, but restoring BSQ on a non-Bisq wallet is highly discouraged and ''not'' supported. The rules to form valid BSQ transactions are rather complex, and even the slightest error can result in invalid BSQ.
 +
 +
== Restoring to a non-Bisq wallet ==
 +
 +
{{Wallet_derivation_paths}}
  
 
[[Category:Use Cases]]
 
[[Category:Use Cases]]

Revision as of 22:14, 30 May 2020

You can restore your wallet from seed to recover your funds in unusual circumstances when nothing else is working (e.g., if a data directory and its backups become corrupted).

Note that such a recovery only restores funds (BTC and BSQ) but does not restore any other Bisq data such as payment accounts, open disputes, etc. This data is stored in the Bisq data directory. Furthermore, restoring from seed does not restore reputation value earned from contributing to Bisq.

Restoring to a Bisq wallet

Before restoring from seed, please try restoring your wallet from a backup first.

To restore a wallet using seed words, go to Account > Wallet Seed, enter the seed words and date in the "Restore wallet from seed words" section, and then click Restore Wallets.

The date is not strictly required, but it makes the recovery process drastically quicker. Without a date, bitcoinj (the library Bisq uses to interact with the Bitcoin network) will resort to traversing the entire Bitcoin blockchain from 2013 (sometime around block 260,000) in order to rebuild your wallet state, and it will take a very long time. Specifying the date your wallet was created cuts recovery time significantly by telling bitcoinj where to start traversing the blockchain.

Bisq will then restart and start to rebuild your wallet state. If you see a zero balance for BTC and/or BSQ after restoring from seed, wait until the program is done syncing with the Bitcoin network. You'll know syncing is done when the green bar on the bottom right labeled "Synchronizing With Bitcoin Mainnet (using Tor) / Synchronizing DAO" goes away.

Go here to restore a Bisq wallet from seed.

Things to know:

  • You should only restore from seed into a new Bisq wallet.
  • If your goal is merely to transfer BTC or BSQ to another Bisq instance, it's best to simply send the funds to the new instance with a transaction.
  • You can restore BTC funds to an external wallet like Electrum, but restoring BSQ on a non-Bisq wallet is highly discouraged and not supported. The rules to form valid BSQ transactions are rather complex, and even the slightest error can result in invalid BSQ.

Restoring to a non-Bisq wallet

Bisq’s built-in bitcoin wallet is based on BIP-44. BTC segwit addresses have a m/44'/0'/1' derivation path and legacy addresses have a m/44'/0'/0' derivation path. BSQ wallets have a m/44'/142'/0' derivation path.

The same seed phrase is used for BTC and BSQ wallets.

Please do not try to send BSQ to a non-Bisq wallet, or to otherwise create your own BSQ transactions. The rules to form a valid BSQ transaction are rather complex, and even the slightest error can result in invalid BSQ. Bisq will NOT provide support for any such cases.