Difference between revisions of "Backing up your wallet seed"

From Bisq Wiki
Jump to navigation Jump to search
m
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Bisq seed words ==
+
It is critical that you '''back up your wallet seed'''. The Bisq wallet is totally controlled by you, and you only—wallets are created and stored by the Bisq software right on your machine.
  
Bisq is a non-custodial exchange. This means you control your funds (your private keys) at all times. The first time you use Bisq it is imperative that you encrypt and backup your Bisq wallet seed words and password. You are solely responsible for keeping your seed words and password. There are no other copies!
+
For this reason, you should keep your Bisq wallet's seed words safe and [[Encrypting_your_wallet|encrypt your Bisq wallet]] as well. There are no other copies of this data, so you're on your own if you lose them.
  
With your wallet seed words and date, you can recover your Bisq wallet and its contents (BTC and BSQ) if you lose it. Alternatively, if you lose your wallet seed words and date, you cannot restore your wallet, and '''all your funds are lost forever'''.
+
__TOC__
  
 +
== Write down your seed words ==
  
<!-- Bisq has a built-in Bitcoin (BTC) wallet based upon the Bitcoin Improvement Proposal (BIP 44). BTC wallets have a m/44'/0'/0' derivation path and Bisq (BSQ) wallets have a m/44'/142'/0' derivation path. Your same seed phrase is used for BTC and BSQ wallets.-->
+
With your wallet seed words and date, you can recover your Bisq wallet and funds if the wallet is ever lost, destroyed, or corrupted.  
  
 +
{{Wallet_date_explainer}}
  
If your wallet is ever destroyed or corrupted, your wallet ''seed words and date'' can be used to restore it.  If you do not have your seed words and date, '''your funds are lost forever'''.
+
You can find your wallet's seed words in <code>Account</code> > <code>Wallet seed</code>. If you've encrypted your wallet, you'll need to enter the password before you can see your seed words.
  
'''Important:''' Write your seed words and wallet date using pen and paper to eliminate digital attacks. Saving them on your computer, even in a secure password manager, makes it possible for a hacker to obtain them.  
+
'''Please ''actually'' write down your seed words and date with a 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.  
  
==== Recording your seed words and date ====
+
[[File:Find-wallet-seed-words.png|thumb|left|600px|Location of wallet seed words and date.]]
  
To record your wallet seed words and date perform the following steps:
+
<div style="clear: both;"></div>
  
# Go to the '''Wallet seed''' section of the '''Account''' screen
+
== What seed words do and don't do ==
# Write down the words in the '''Wallet seed words''' field and the '''Wallet date'''
 
Note: If you set a password, it is required to see your seed words and wallet date.
 
  
<!-- Wallet date is required by bitcoinj, which is the library Bisq uses to interact with the Bitcoin network.-->
+
Backing up a Bisq wallet's seed words only ensures that you will always have access to the funds stored in that Bisq wallet.  
  
 +
'''All other Bisq data must be backed up separately.''' Keys used for signing P2P messages (trade-related messages such as acknowledging payment sending/receiving, trader chat, dispute resolution, etc), Tor keys, payment account details, and more must be backed up separately.
  
[[File:Walletseed.png|thumb|left|500px]]
+
== Wallet derivation paths ==
 
 
<br clear=all>
 
'''Important:''' ''Write your seed words and wallet date using pen and paper. Pen and paper eliminates digital attacks. Saving them on your computer, even in a secure password manager, makes it possible for a hacker to obtain them. ''
 
<br clear=all>
 
  
 +
{{Wallet derivation paths}}
  
 
[[Category:Use Cases]]
 
[[Category:Use Cases]]

Latest revision as of 21:44, 17 June 2020

It is critical that you back up your wallet seed. The Bisq wallet is totally controlled by you, and you only—wallets are created and stored by the Bisq software right on your machine.

For this reason, you should keep your Bisq wallet's seed words safe and encrypt your Bisq wallet as well. There are no other copies of this data, so you're on your own if you lose them.

Write down your seed words

With your wallet seed words and date, you can recover your Bisq wallet and funds if the wallet is ever lost, destroyed, or corrupted.

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.

You can find your wallet's seed words in Account > Wallet seed. If you've encrypted your wallet, you'll need to enter the password before you can see your seed words.

Please actually write down your seed words and date with a 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.

Location of wallet seed words and date.

What seed words do and don't do

Backing up a Bisq wallet's seed words only ensures that you will always have access to the funds stored in that Bisq wallet.

All other Bisq data must be backed up separately. Keys used for signing P2P messages (trade-related messages such as acknowledging payment sending/receiving, trader chat, dispute resolution, etc), Tor keys, payment account details, and more must be backed up separately.

Wallet derivation paths

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.