Create a new wallet for your data directory - Revision history

MwithM: /* Caveats */ format

2024-04-04T18:47:20Z

Caveats: format

MwithM: /* Preparations */ format

2024-04-04T15:42:52Z

Preparations: format

MwithM: /* Disaster recovery */ format

2024-04-04T15:42:12Z

Disaster recovery: format

MwithM: /* Disaster recovery */ add external device backup recommendations

2024-04-04T15:41:48Z

Disaster recovery: add external device backup recommendations

MwithM: /* Create a new wallet when the old one is empty */ format, add password suggestion.

2024-04-04T15:38:50Z

Create a new wallet when the old one is empty: format, add password suggestion.

MwithM: /* Instructions */ Format, modify backup and add password instructions.

2024-04-04T15:37:10Z

Instructions: Format, modify backup and add password instructions.

SuddenWhipVapor at 17:28, 17 November 2023

2023-11-17T17:28:59Z

SuddenWhipVapor at 17:28, 17 November 2023

2023-11-17T17:28:49Z

SuddenWhipVapor: /* Create a new wallet when no funds exist in Bisq */

2023-11-17T17:27:11Z

Create a new wallet when no funds exist in Bisq

SuddenWhipVapor: /* Instructions */

2023-11-17T17:25:37Z

Instructions

@@ Line 21: / Line 21: @@
 The provided instructions are safe as long as you don't make mistakes, which could amount to:
-* deleting a folder instead of renaming it
+* Deleting a folder instead of renaming it.
-* using a wrong address to send funds to
+* Using a wrong address to send funds to.
 The above mistakes can easily lead to loss of funds, which we obviously are not liable for.

@@ Line 12: / Line 12: @@
 Make sure the following checklist is observed:
-* no existing open offers (delete them -this will make you lose the fees- or wait until they are taken, and their respective trades are completed)
+* No existing open offers (delete them -this will make you lose the fees- or wait until they are taken, and their respective trades are completed).
-* no existing open trades (wait until they are completed)
+* No existing open trades (wait until they are completed).
-* no existing disputes (wait until their resolution)
+* No existing disputes (wait until their resolution).
-* consistent wallet state (go to Funds > Send Funds, and for each btc address containing funds, verify its balance actually exists by searching the address on [https://mempool.space mempool.space], otherwise do a [[Resyncing_SPV_file|SPV resync]] and repeat)
+* Consistent wallet state (go to Funds > Send Funds, and for each btc address containing funds, verify its balance actually exists by searching the address on [https://mempool.space mempool.space], otherwise do a [[Resyncing_SPV_file|SPV resync]] and repeat).
 = Caveats =

@@ Line 59: / Line 59: @@
 In case you made some mistakes along the way and things don't work as they should, and provided you never deleted anything, but rather renamed the folders as suggested above, you can go back to the starting point by simply making sure, after closing Bisq, that the data directory gets back to its original state, that is, <code>Bisq.old</code> is renamed to <code>Bisq</code>, and, if you got to that point, <code>wallet.old</code> to <code>wallet</code>.
-Having a copy of <code>wallet.old</code> in an external device (like a usb memory) is also recommended, in case of the unlikely event of permanent data loss.
 = Cleanup =
 Only after you are absolutely sure everything is in order, and if you need to free up as much disk space as possible, you can delete the <code>Bisq.new</code> and <code>wallet.old</code> folders.

@@ Line 59: / Line 59: @@
 In case you made some mistakes along the way and things don't work as they should, and provided you never deleted anything, but rather renamed the folders as suggested above, you can go back to the starting point by simply making sure, after closing Bisq, that the data directory gets back to its original state, that is, <code>Bisq.old</code> is renamed to <code>Bisq</code>, and, if you got to that point, <code>wallet.old</code> to <code>wallet</code>.
 = Cleanup =
 Only after you are absolutely sure everything is in order, and if you need to free up as much disk space as possible, you can delete the <code>Bisq.new</code> and <code>wallet.old</code> folders.

@@ Line 51: / Line 51: @@
 If you wish to switch to a brand new wallet, and there are no funds (anymore) in the previous one, the procedure is much simpler:
-# close Bisq
+# Close Bisq.
-# navigate to your [[Data_directory#Default_locations|data directory]] and into the <code>btc_mainnet</code> folder
+# Navigate to your [[Data_directory#Default_locations|data directory]] and into the <code>btc_mainnet</code> folder.
-# rename the <code>wallet</code> folder to <code>wallet.old</code>
+# Rename the <code>wallet</code> folder to <code>wallet.old</code>.
-# start Bisq, notice a new wallet was created, write down the new seed
+# Start Bisq, notice a new wallet was created, write down the new seed and set the password.
 = Disaster recovery =

@@ Line 29: / Line 29: @@
 If the above requirements are met, and you understood the caveats, assuming you have BTC (and probably BSQ as well) in your old wallet, you can follow the procedure outlined below:
-# close Bisq
+# Close Bisq.
-# rename the [[Data_directory#Default_locations|data directory]] from <code>Bisq</code> to <code>Bisq.old</code> (this is equivalent to creating a backup copy, as the original contents are still on your disk)
+# Rename the [[Data_directory#Default_locations|data directory]] from <code>Bisq</code> to <code>Bisq.old</code>. Copy this file to an external device, it will be used as a backup in case of data loss.
-# start Bisq
+# Start Bisq.
-# you will see a completely new Bisq instance appear, and a new data directory will be created (including a new wallet, which is the one we will soon be using to replace the old one)
+# A new Bisq instance called Bisq will be created (including a new wallet, which is the one we will soon be using to replace the old one).
-# go to ''Account'' > ''Wallet seed'' and write down the seed of the new wallet, as a precautionary measure
+# Go to ''Account'' > ''Wallet seed'' and write down the seed of the new wallet. Set the password for the wallet at ''Account'' > ''Wallet password''.
-# go to ''Funds'' > ''Receive Funds'' and copy the first btc receive address, pasting it into a separate text file for later use
+# Go to ''Funds'' > ''Receive Funds'' and copy the first btc receive address, pasting it into a separate text file for later use.
-# go to ''DAO'' > ''BSQ Wallet'' > ''Receive'' and copy the BSQ receive address of the new wallet, pasting it into your notes
+# Go to ''DAO'' > ''BSQ Wallet'' > ''Receive'' and copy the BSQ receive address of the new wallet, pasting it into your notes.
-# close Bisq
+# Close Bisq.
-# rename the newly created data directory, from <code>Bisq</code> to <code>Bisq.new</code>, and rename the previous directory from <code>Bisq.old</code> to <code>Bisq</code>
+# Rename the newly created data directory, from <code>Bisq</code> to <code>Bisq.new</code>, and rename the previous directory from <code>Bisq.old</code> to <code>Bisq</code>.
-# start Bisq
+# Start Bisq
-# you will be back into your old Bisq instance
+# You will be back into your old Bisq instance
-# go to ''DAO'' > ''BSQ Wallet'' > ''Send'' and send all your BSQ balance to the BSQ receive address of the new wallet (this needs to be done first! if you moved out all of your BTC now, there would be none left to pay for the mining fees to move the BSQ)
+# Go to ''DAO'' > ''BSQ Wallet'' > ''Send'' and send all your BSQ balance to the BSQ receive address of the new wallet (this needs to be done first! if you moved out all of your BTC now, there would be none left to pay for the mining fees to move the BSQ!)
-# go to ''Funds'' > ''Send Funds'' and move all your BTC balance to the BTC receive address of the new wallet
+# Go to ''Funds'' > ''Send Funds'' and move all your BTC balance to the BTC receive address of the new wallet.
-# close Bisq
+# Close Bisq
-# within the data directory, navigate to the contents of <code>btc_mainnet</code> and rename the <code>wallet</code> folder to <code>wallet.old</code>
+# Within the data directory, navigate to the contents of <code>btc_mainnet</code> and rename the <code>wallet</code> folder to <code>wallet.old</code>.
-# copy the <code>wallet</code> folder from the same location in <code>Bisq.new</code>, into the <code>btc_mainnet</code> folder of the "old" data directory, so that now there will be <code>wallet</code> and <code>wallet.old</code> folders under <code>btc_mainnet</code>
+# Copy the <code>wallet</code> folder from the same location in <code>Bisq.new</code>, into the <code>btc_mainnet</code> folder of the "old" data directory, so that now there will be <code>wallet</code> and <code>wallet.old</code> folders under <code>btc_mainnet</code>.
-# start Bisq, wait until wallet is synchronized with the blockchain, and verify that all your funds were correctly moved, checking the contents of ''Funds'' > ''Send Funds'', and ''DAO'' > ''BSQ Wallet''
+# Start Bisq, wait until wallet is synchronized with the blockchain, and verify that all your funds were correctly moved, checking the contents of ''Funds'' > ''Send Funds'', and ''DAO'' > ''BSQ Wallet''.
-# you can now operate normally with Bisq, knowing that the brand new wallet will be used instead of the old one
+# You can now operate normally with Bisq. The brand new wallet will be used instead of the old one.
 = Create a new wallet when the old one is empty =

← Older revision		Revision as of 17:28, 17 November 2023
Line 1:		Line 1:
	When you just need a fresh new wallet, but wish to keep everything else (accounts, signing status, onion address, trade history, notifications app association, and other custom settings), it is easier and faster to only generate a new wallet for Bisq, rather than [[switching to a new data directory]].		When you just need a fresh new wallet, but wish to keep everything else (accounts, signing status, onion address, trade history, notifications app association, and other custom settings), it is easier and faster to only generate a new wallet for Bisq, rather than [[switching to a new data directory]].
−
−	~~= WORK IN PROGRESS =~~

	__TOC__		__TOC__