Difference between revisions of "Resyncing SPV file"

From Bisq Wiki
Jump to navigation Jump to search
(added section and link to youtube guide video)
 
(58 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
'''Resyncing the SPV file''' can solve wallet issues such as incorrect balance showing, missing transactions, etc.
  
 +
__TOC__
  
The Bisq application makes use of Bitcoin's Simplified Payment Verification (SPV) mechanism. This allows the application to verify if a particular transaction is included in a block without having to download the entire block.
+
= How to Resync the SPV File =
  
However, if the SPV file in your Bisq application ever becomes corrupted or falls out of sync, it could lead to any number of wallet issues, such as Bisq not displaying the correct account balance.
+
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.
  
This can be fixed by resyncing the SPV file: deleting it and then rebuilding it from the Bitcoin blockchain. This should get rid of any errors and once again allow Bisq to retrieve accurate transaction information.
+
== From the Bisq interface ==
  
For more information, please refer to [https://docs.bisq.network/backup-recovery.html#resync-spv-chain Bisq Docs]
+
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.
  
 +
[[File:Resync-spv-file.png|600px|thumb|left|Where to initiate an SPV resync from within the Bisq interface.]]
  
==='''Follow these steps to re-sync the SPV file.''' ===
+
<div style="clear: both;"></div>
  
====1. Open Bisq and click on the '''Settings''' tab====
+
== From the file system ==
  
[[File:Market tab.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'''.
  
====2. Click on '''NETWORK INFO'''====
+
Bisq will not prompt you to restart it again—so don't forget to actually do it!
  
[[File:Settings tab.png||1000px]]
+
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.
  
====3. Click on '''DELETE SPV FILE AND RESYNC'''====
+
== Fix an incomplete SPV resync ==
  
[[File:Network info.png||1000px]]
+
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>.spvresync</code> file in the wallet folder and try again, Bisq should pick up from where it left off at the previous attempt.
  
You may now restart the application - Re-syncs can take a while depending on the age of your wallet and number of transactions.
+
== Video Guide ==
  
CPU usage may be high and the Bisq application may not respond—this is normal. Please be patient while the re-sync finishes.
+
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]]
 
 
Note: If you are unable to open Bisq to access the Settings section, you can manually delete `btc_mainnet/wallet/bisq.spvchain` from your data directory. See default data directory locations [https://docs.bisq.network/backup-recovery.html#back-up here]. You will then need to manually restart Bisq '''twice''' to complete the resync.
 

Latest revision as of 04:09, 24 December 2023

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 .spvresync file in the wallet folder and try again, Bisq should pick up from where it left off at the previous attempt.

Video Guide

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