Difference between revisions of "Resyncing SPV file"

From Bisq Wiki
Jump to navigation Jump to search
 
(50 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
'''Resyncing the SPV file''' can solve wallet issues such as incorrect balance showing, missing transactions, etc.
  
<!-- This seems to be s solution to a problem. Perhaps a Problem/Solution format may work well? -->
+
__TOC__
  
'''Problem'''
+
= How to Resync the SPV File =
  
<!-- Is this section needed? "The Bisq application uses the Bitcoin Simplified Payment Verification (SPV) mechanism. SPV allows Bisq to verify that a transaction is included in a block without downloading the entire block." -->  <!-- is downloading a block something that a user needs to know or deal with? Does the user deal with downloading a block at all? Or, can we just say that SPV simplifies a Bisq transaction (or something similar)? -->
+
It is best to initiate an SPV resync from within Bisq. Sometimes this isn't possible, so we include directions on how to initiative an SPV resync from your file system too.
  
The SPV file <!-- we didn't mention a file? Also, we're now mentioning a problem. --> may become corrupt <!-- "or falls out of sync" Out of sync from what? To say this we now need to explain it. Maybe just leave it as "may become corrupt"), -->  and create Bisq wallet issues, such as a wallet not displaying the correct account balance.
+
== From the Bisq interface ==
  
'''Solution'''
+
Go to <code>Settings</code> > <code>Network Info</code> and click <code>Delete SPV File and Resync</code>. Bisq will prompt you to restart twice, and depending on the age of your wallet and how many transactions it has, it may take a while to finish syncing. It is normal for your machine to reach high CPU usage levels, and Bisq may not be responsive until syncing has finished.
  
Resync the SPV file by deleting it and then rebuilding it from the Bitcoin blockchain. Bisq can then retrieve accurate transaction information.  
+
[[File:Resync-spv-file.png|600px|thumb|left|Where to initiate an SPV resync from within the Bisq interface.]]
  
For more information, please refer to [https://docs.bisq.network/backup-recovery.html#resync-spv-chain Resync SPV chain]
+
<div style="clear: both;"></div>
  
 +
== From the file system ==
  
 +
Close Bisq, delete the <code>btc_mainnet/wallet/bisq.spvchain</code> from your [[Data_directory|data directory]], start Bisq, wait for it to load, and then '''restart Bisq again'''.
  
== How to Resync the SPV File ==
+
Bisq will not prompt you to restart it again—so don't forget to actually do it!
  
=== 1. Open Bisq and click <code>Settings</code> ===
+
Depending on the age of your wallet and how many transactions it has, it may take a while to finish syncing. During syncing, it's normal for your machine to reach high CPU usage levels, and Bisq may not be responsive until syncing has finished.
 
  
[[File:Market tab.png|thumb|left|500px]]
+
== Fix an incomplete SPV resync ==
 +
If the SPV resync hangs, and you have no choice other than restarting Bisq, only to find out the resync starts again from scratch, then, while Bisq is closed, delete the <code>resyncSpv</code> file in the root folder of your [[Data_directory#Default_locations|data directory]] and try again, Bisq should pick up from where it left off at the previous attempt. Important to note is that, after you do this, the UI will load before the SPV resync has finished, so the total amount of funds will not be correctly displayed until the block rescan is complete (you can repeat the previous procedure more than once if needed, so the resync can complete in several parts).
  
<br clear=all>
+
== Video Guide ==
===2. In the <code>Network Info</code> tab click <code>Delete SPV File and Resync</code> ===
 
  
 
+
A video guide of this process can be found on the [https://youtu.be/9oW4HqVz_sQ?si=a60iI_2GPkWJ84hA Bisq Youtube channel].
[[File:Settings tab.png||thumb|left|500px]]
 
 
 
<br clear=all>
 
 
 
===3. Click on the <code>Delete SPV File and Resync</code> button===
 
 
 
 
 
[[File:Network info.png|thumb|left|500px]]
 
 
 
<br clear=all>
 
===4. Restart ===
 
 
 
<!-- Restart is confusing Is this user initiated or this happens in response to step 3? --> Upon starting the resync process, you'll be prompted to restart Bisq. Please be advised that re-syncs can take a while depending on the age of your wallet and number of transactions. CPU usage may be high and the Bisq application may not respond for a while—this is normal. Please be patient while the re-sync finishes!
 
 
 
 
 
== Help! I Can't Access the Bisq Settings Screen==
 
 
 
 
 
If you can't open Bisq to access the Settings section, you can manually delete the <code>btc_mainnet/wallet/bisq.spvchain</code> from your [[Data_directory|data directory]].
 
 
 
The default data directory locations can be found [https://bisq.wiki/Backup_%26_Recovery here]. You will then need to manually restart Bisq '''twice''' to complete the resync.
 
  
 
[[Category:Use Cases]]
 
[[Category:Use Cases]]

Latest revision as of 21:41, 24 June 2024

Resyncing the SPV file can solve wallet issues such as incorrect balance showing, missing transactions, etc.

How to Resync the SPV File

It is best to initiate an SPV resync from within Bisq. Sometimes this isn't possible, so we include directions on how to initiative an SPV resync from your file system too.

From the Bisq interface

Go to Settings > Network Info and click Delete SPV File and Resync. Bisq will prompt you to restart twice, and depending on the age of your wallet and how many transactions it has, it may take a while to finish syncing. It is normal for your machine to reach high CPU usage levels, and Bisq may not be responsive until syncing has finished.

Where to initiate an SPV resync from within the Bisq interface.

From the file system

Close Bisq, delete the btc_mainnet/wallet/bisq.spvchain from your data directory, start Bisq, wait for it to load, and then restart Bisq again.

Bisq will not prompt you to restart it again—so don't forget to actually do it!

Depending on the age of your wallet and how many transactions it has, it may take a while to finish syncing. During syncing, it's normal for your machine to reach high CPU usage levels, and Bisq may not be responsive until syncing has finished.

Fix an incomplete SPV resync

If the SPV resync hangs, and you have no choice other than restarting Bisq, only to find out the resync starts again from scratch, then, while Bisq is closed, delete the resyncSpv file in the root folder of your data directory and try again, Bisq should pick up from where it left off at the previous attempt. Important to note is that, after you do this, the UI will load before the SPV resync has finished, so the total amount of funds will not be correctly displayed until the block rescan is complete (you can repeat the previous procedure more than once if needed, so the resync can complete in several parts).

Video Guide

A video guide of this process can be found on the Bisq Youtube channel.