Core Wallet Best Practices / FAQ

2021-10-14 PIVX Core Wallet

Generic Questions

Make sure your wallet is fully synchronized; if your wallet is partially synchronized it will only show a partial balance.

zPIVs have been retired several years ago following the change of protocol (from Zerocoin to Shield). The grace period that was provided for recovery is now over so any zPIV not transfered before that date cannot be recovered.

1.backup_wallet.png

In the QT/GUI PIVX as above:

  1. Open the PIVX wallet, Select "settings"
  2. Select "Wallet Data"
  3. Select "Wallet"
  4. Select the box which states "Select folder ..."
  5. Save your PIVX wallet.dat in the directory of your choosing and name it whatever you like; when loading it into your PIVX wallet directory it must always be named wallet.dat.

Via file browser:

  1. Shutdown your PIVX Core Wallet
  2. Navigate to the the PIVX data folder; default values are:
    • On Windows: %appdata%/pivx
    • On Linux: ~/.pivx
    • On MacOS: ~/Library/Application Support/PIVX
  3. Locate the wallet.dat file and copy it to a safe place

Core Wallet

This can be caused by an abnormal exit of the wallet, resulting in corruption of your local blockchain cache.

  1. Make a backup of your wallet.dat
  2. Try using the -forcestart startup flag to see if it will recover from a failed start (If using Windows GUI, you will need to make a shortcut to the pivx-qt.exe file with the -forcestart flag; From the command line on all operating systems you can call the pivxd daemon with the switch -forcestart) If the above does not resolve the startup issue, try to resync the blockchain.

Blockchain Synchronisation

The first step is to confirm whether you are on the right chain. To do so, follow the following steps:

  • Run the getbestblockhash command in the debug console
  • Check whether that block is available on the PIVX explorer: https://explorer.pivx.link/
  • If it is not available there, your core wallet is on a forked chain, and needs to be resynced from scratch (see below for steps) If you're using the QT wallet, the steps are all summarized on the picture below: 2.fork_check.png

There are a few possibilities, among which:

  • Connecting to 'bad' peers that veer you onto an orphan chain.
  • Having too few peers, making net consensus less reliable.
  • General connectivity issues (net speed, reliability).

  1. Stop the wallet.
  2. Make a backup of your wallet.dat file.
  3. Start the wallet.
  4. Go to Settings --> Debug --> Wallet Repair --> Delete local blockchain.
  5. Wait for resync to complete.

Steps 3/4 can also be ran from the command line using: pivxd -daemon -resync

No, there is no official blockchain snapshot. You can however create your own if you don't want to have to download the full blockchain in case you need to reinstall the core wallet. Here are the steps:

  1. Shut down your wallet (not doing so will result in a corrupted snapshot)
  2. Navigate to your PIVX data directory. Default values are:
    • %appdata%/pivx on Windows
    • ~/.pivx on Linux
    • ~/Library/Application Support/PIVX on MacOS
  3. Take a backup of the following folders:
    • Blocks
    • Chainstate
    • Sporks
    • Zerocoin
  4. Zip these folders and keep them safe. Should you ever need to restore your blockchain simply copying over these folders to the same data directory mentioned above will allow your PIVX wallet to resume from where this snapshot was taken in terms of block height synced.