Skip to content

Syncing the Wallet

Whenever you start the wallet, it must sync with the blockchain. This means that it is downloading all the data (accounts and transactions) on the Blocknet blockchain. This process is required for the wallet to function properly.

Note: Wallet balance may be incorrect until fully synced.

When the wallet syncs, it downloads the data in chronological order. Therefore, if the wallet is not fully synced, it may not reflect recent transactions. This can cause the an incorrect balance to be shown until syncing is finished.


Synchronization

When the wallet is opened, it begins syncing automatically. If this is the first time syncing the wallet or if you haven't opened the wallet in a few weeks, you can use a bootstrap to sync the wallet faster.

To view the syncing status, use the following instructions:

View syncing status using redesigned wallet

Redesigned Wallet

  • In the upper-right corner of the wallet you will see a set of icons.

    Status Bar

  • The bar shows how far out of sync the wallet is. This is NOT an estimate of how long it will take to sync.

    Sync Status

  • After syncing the blockchain data, it will begin syncing other network information.

    Sync Status Sync Status

  • When syncing is complete, it will read Fully synced, followed by the latest block.

    Sync Complete

  • The left-most symbol is how many peers you have. The number of peer is important because you download the blockchain data from them. If you don't have any peers, you will be unable to sync. When you first start the wallet this number will be low, but will increase after a few minutes. Typically you will have 8-16 peers.

    Peers Status

  • If you have 0 peers, make sure your firewall isn't blocking outgoing connections.

View syncing status using classic wallet

Classic Wallet

  • At the bottom of the wallet you will see a set of icons.

    Status Bar

  • The bar shows how far out of sync the wallet is. This is NOT an estimate of how long it will take to sync.

    Sync Status

  • After syncing the blockchain data, it will begin syncing other network information.

    Sync Status Sync Status

  • When syncing is complete, it will read Fully synced, followed by the latest block.

    Sync Complete

  • The symbol second from the right is how many peers you have. The number of peer is important because you download the blockchain data from them. If you don't have any peers, you will be unable to sync. When you first start the wallet this number will be low, but will increase after a few minutes. Typically you will have 8-16 peers.

    Peers Status

  • If you have 0 peers, make sure your firewall isn't blocking outgoing connections. This also may be due to antivirus software.

Troubleshooting

If you encounter issues, please join Blocknet's Discord for assistance.

Warning: Beware of scams

Be cautious of users sending you private messages on Discord to help with troubleshooting, even if they claim to be team members. Scammers will often prey on those having issues and offer help in an attempt to steal funds. This is usually done by impersonating team members.


Bootstrap

A bootstrap is a set of files containing blockchain data up to a certain point in time. Using these files helps shorten the amount of time it takes to sync the wallet since you don't need to sync the blockchain from scratch.

  1. Install the wallet or update to the latest release.
  2. Download the latest bootstrap files.
  3. Find the downloaded BlocknetDX.zip file. The default location is in Downloads.
  4. Double-click the file to unzip and reveal a folder named BlocknetDX.
  5. Close and quit the Blocknet wallet if it is running.
  6. Navigate to the data directory.

    Windows

    C:\Users\[YourUsername]\AppData\Roaming\BlocknetDX\
    
    Or paste %appdata%\Roaming\BlocknetDX\ into the file explorer path field.

    MacOS
    ~/Library/Application Support/BlocknetDX/
    
    Linux
    ~/.blocknetdx/
    
  7. Remove all files and folders EXCEPT for wallet.dat, blocknetdx.conf, xbridge.conf (may not be present), servicenode.conf, and the backups/ folder. Again, DO NOT delete the wallet.dat file as it contains the private keys for your funds. Deleting this file will result in loss of funds.

  8. Inside the unzipped BlocknetDX folder there are blocks/ and chainstate/ folders. Move these 2 folders into the Blocknet wallet's data directory that you just removed files from.
  9. Start the wallet and syncing should begin at the bootstrap's last block.
  10. Read more about syncing above.