Resyncing SPV file

From Bisq Wiki
Jump to navigation Jump to search

Resyncing the SPV file (Simplified Payment Verification file, `bisq.spvchain`) can often solve wallet issues within Bisq, such as an incorrect balance showing, missing transactions, or other synchronization problems.

How to Resync the SPV File

It is generally best to initiate an SPV file resync using the button within the Bisq application interface. However, if Bisq cannot start properly, you may need to initiate it manually via the file system.

From the Bisq Interface

This is the recommended method if Bisq is operational.

  1. Go to `Settings` > `Network Info`.
  2. Click the `Delete SPV File and Resync` button.
  3. Bisq will prompt you to restart the application twice. Follow the prompts carefully.
Warn
Sync Time & Performance:
  • Resyncing can take a significant amount of time*, depending on the age of your wallet and the number of transactions it contains.
  • It is normal for your computer to experience high CPU usage during the resync process.
  • Bisq may become unresponsive while syncing. Please be patient and let the process complete.
Click the button under Settings > Network Info to resync the SPV file via the UI.

From the File System

Use this method if you cannot access the button within Bisq (e.g., if Bisq fails to start fully).

  1. Ensure Bisq is completely closed.
  2. Navigate to your Bisq data directory.
  3. Locate and delete the SPV chain file: `btc_mainnet/wallet/bisq.spvchain`
  4. Start Bisq and wait for it to fully load (it will begin the resync process).
  5. Crucially, close Bisq completely and restart it a second time. Bisq will not prompt you for this second restart when using the manual method, but it is required for the wallet state to initialize correctly after the sync.
Warn
Sync Time & Performance:
  • As with the interface method, resyncing manually can take a significant amount of time, depending on wallet age and transaction count.
  • Expect high CPU usage and potential Bisq unresponsiveness during the sync process. Be patient.

Fix an Incomplete SPV Resync

Sometimes, especially on older or larger wallets, the SPV resync might hang or get interrupted. If restarting Bisq causes the resync to start over from 0% instead of resuming, you can try this:

  1. Ensure Bisq is completely closed.
  2. Navigate to the root folder of your Bisq data directory.
  3. Locate and delete the file named `resyncSpv`. (This file typically only exists if a previous resync was interrupted).
  4. Restart Bisq.

It should now attempt to resume the SPV sync from where it previously left off.

Note
When resuming an incomplete sync this way, the Bisq UI might load and show balances before the background sync is fully complete. Your balance may appear incorrect until the process finishes. You can repeat steps 1-4 if the sync gets interrupted again, allowing it to complete in stages.

Preventing Frequent or Slow Resyncs: Connect to Your Own Node

If you find that Bisq frequently requires SPV file resyncs, or if the process consistently takes an extremely long time (especially with an older or high-transaction wallet), the most robust solution is to connect Bisq to your own Bitcoin full node.

When connected to your local node, Bisq gets blockchain information directly and reliably, bypassing the need for the SPV synchronization process over the Tor network. This typically results in faster startups and eliminates most common sync-related issues and errors.

For details on setting up a node and configuring Bisq to use it, please see:

While running a full node requires more resources (disk space, bandwidth), it offers the best performance, privacy, and stability when using Bisq.