Difference between revisions of "Resyncing SPV file"

From Bisq Wiki
Jump to navigation Jump to search
(Create a simple SPV re-sync walkthrough with pictures)
 
 
(64 intermediate revisions by 8 users not shown)
Line 1: Line 1:
The Bisq application makes use of Bitcoin's Simplified Payment Verification or SPV for short. This allows the application to verify if a particular transaction is included in a block without having to download that entire block.  
+
'''Resyncing the SPV file''' can solve wallet issues such as incorrect balance showing, missing transactions, etc.
  
However, if the SPV file in your bisq application were to become corrupted or fall out of sync it could lead to any number of wallet issues, such as Bisq not displaying the correct account balance.
+
__TOC__
  
This can be resolved by deleting the SPV file and re-sycing Bisq. The data contained in the SPV file is a collection of data from the Bitcoin blockchain which allows Bisq to retrieve transaction information.
+
= How to Resync the SPV File =
  
By deleting it you allow Bisq to re-sync the file with the Bitcoin blockchain and fix any potential errors.  
+
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.
-----
 
'''Follow these steps to re-sync the SPV file.'''
 
-----
 
  
1. Open the Bisq application and click on the '''Settings''' tab
+
== From the Bisq interface ==
  
[[File:Market tab.png||1000px]]
+
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.
  
2. Click on '''NETWORK INFO'''
+
[[File:Resync-spv-file.png|600px|thumb|left|Where to initiate an SPV resync from within the Bisq interface.]]
  
[[File:Settings tab.png||1000px]]
+
<div style="clear: both;"></div>
  
3. Click on '''DELETE SPV FILE AND RESYNC'''
+
== From the file system ==
  
[[File:Network info.png||1000px]]
+
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'''.
  
''You may now restart the application - Re-syncs may take a while depending on the age of your wallet and number of transactions.''
+
Bisq will not prompt you to restart it again—so don't forget to actually do it!
  
''CPU usage may be high and the Bisq application may not respond, this is normal, be patient and allow the re-sync to finish.''
+
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 ==
'''Note: If you are unable to access Bisq, you can manually delete the SPV file from the Bisq directory ---> btc_mainnet ---> wallet ---> bisq.spvchain. You will then be required to manually restart Bisq twice to complete the 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).
 +
 
 +
== Video Guide ==
 +
 
 +
A video guide of this process can be found on the [https://youtu.be/9oW4HqVz_sQ?si=a60iI_2GPkWJ84hA Bisq Youtube channel].
 +
 
 +
[[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.