PIVX Core Wallet Release (Mandatory Upgrade)


PIVX Core Wallet Release (05/02/2018)

PIVX v3.1.0.2 core wallet update has been released with multiple major feature additions, new GUI design, UI/UX enhancements, numerous bug fixes and performance enhancements. Some highlight additions / changes are:

  • zPIV Staking (zPoS) (https://pivx.org/zpos/)
  • Deterministic zPIV (dzPIV) (see FAQ below for more info)
  • Encrypted zPIV (ezPIV) (zPIV data is now encrypted in wallet.dat)
  • New graphical user interface layout & design.
  • Updated block reward payment schedule.
  • User defined wallet.dat backup location.
  • and much much more!

This is a mandatory update if you are currently running or older.

You MUST upgrade to wallet or newer if running an older version

Release Notes
Please take the time to fully read the release notes to ensure you are aware of what has been changed.
https://github.com/PIVX-Project/PIVX/releases/tag/v3.1.0.2 (read the full 3.1.0 release notes also for more info)

Download Link
Download the appropriate wallet binary for your OS from the links below:

For Self-compilers, please use “git checkout v3.1.0.2” to compile. (not master)

How to Update

As always, it is recommended to backup the existing wallet.dat file to a safe location before upgrading if you haven’t done so already via File -> Backup wallet and saving it in a different directory with a new name. If you use CLI/Linux, you can backup using the command ./pivx-cli backupwallet. If your wallet is not running currently, you can back up the file “wallet.dat” from e.g. Start -> Run -> %APPDATA%\PIVX on Windows by making a copy elsewhere.

  1. Gracefully exit/stop the current wallet from the wallet. (File - Exit or ./pivx-cli stop)

  2. Download and install the new wallet appropriate for your OS.
    Linux/Rpi: Overwrite the existing executable files with the newly downloaded wallet binaries.
    Windows: Install via the setup executable file and run through the setup wizard to install.
    Mac OSX: Download .dmg file, open .dmg then drag PIVX icon to the applications folder icon. (copy over /Applications/PIVX-Qt)

  3. Re-start the wallet. (Launch from your PIVX shortcut icon or ./pivxd for linux)

  4. Once the wallet finishes syncing, follow this guide to ensure you are on the right network chain.

  5. Upgrade completed.


  1. Will I lose my coins after the upgrade?
    No, you will not lose your coins after the upgrade. In fact, we recommend everyone to upgrade to the latest wallet to benefit from increased security & stability that comes with it.

  2. I’m having issues with my wallet launching, not seeing my coins, having issues syncing etc
    Please check the Knowledge-base Articles here:
    or open a ticket at pivx.support
    or ask for help on the support channels in PIVX Discord @ https://discord.pivx.org.

  3. Who can I ask if I don’t know how to upgrade still?
    You can ask in support channels in PIVX Discord for real-time assistance.
    If you aren’t yet a member there, you can join via https://discord.pivx.org
    Also can open a ticket at pivx.support for more private support…

  4. I’m missing some zPIV that got minted and sent to the Accumulator. Where are they?
    Firstly, make sure you aren’t using the same wallet in multiple places. If so, it could be the cause as zPIV is only visible from the wallet.dat that it minted from. Also, if you have tried swapping out your wallet.dat with previous backups in an attempt to recover your zPIV, make sure to NOT delete the latest wallet.dat as your most recent zPIV minting information does not exist in your older backups, So if you have restored to an older backup, please restore back the latest wallet.dat which was used to mint those zPIV. Then please follow this KB: https://pivx.freshdesk.com/solution/articles/30000025649

  5. My zPIV isn’t staking?
    If you have zPIV that were minted with the 3.0.6 wallet or older, they are classified as zPIV v1 and are not able to be staked even after zPoS is activated. You will need to spend them back to your own address, then re-mint them back as zPIV using the 3.1.0.x wallet. Then they will become zPIV v2 which is able to be staked.

  6. What is Deterministic Seed (dzPIV) & how do I use it exactly to backup/restore my zPIV?
    Please see this detailed post by presstab (PIVX core developer):




Great!!! Thanks for the update :smiley:


specific instructins to upgrade a masernode would be useful…
These instructions broke my masternode - now it says:

“Masternode not found in the list of available masternodes. Current status: Node just started, not yet activated”

But my local wallet says it is Enabled & active.

Any idea?


There seems to be an issue with the masternode.conf reader

Script does not parse port 51472 correctly (might be looking for the test port)


@willb Hi, ah. I believe you need to restart the masternode from the controller wallet. (it was always the case with previous mandatory updates due to its change in protocol version)

@zax I have heard reports of this and seems it may be a bug that only occurs on the Windows wallet for those who are running it as their controller wallet. Our developers said that they will release a fixed version soon as it’s already fixed & is being tested.


Yes I did already attempt to restart it
and no - I am using OSX.

Anyway I noticed that my blocks were stuck on block 1044101
and not updating so I decided to do:

./pivxd -reindex &

I will update what happens after I reindex the blocks

EDIT: it is stuck AGAIN at block 1044101

??? what should i do?




@willb Not sure why as the new wallet wouldn’t have anything to do with that.

The best thing you could try is resync from scratch or using the bootstrap / snapshot to get back to latest block fast.



I am re downloading the entire chain again. very annoying.
Not sure why it’s not possible to smoothly upgrade.?
I think PIVX should provide specific instructions for masternode upgrade. Please !


Finally got it working, but now my local wallet says ‘ENABLED ’ ACTIVE 0s’.
And the 0s never changes?
If I start the node using debug console then it changes to say -3m:-34s
Any ideas?


after 1 hour my local wallet still says that my masternode is ACTIVE for “-3m:34s”


masternode list-conf says ““status”: “ACTIVE””

my VPS says it is active etc. everything looks normal,
“message”: “Masternode successfully started”"

but the ACTIVE time stays at “-3m:34s”



A small niggle.
I installed the Linux wallet on Ubuntu 18.04 (and I’m pretty new to Ubuntu, but I didn’t wanna use Windows).
I can no longer maximize the Wallet window, just minimize.
I can extend the sides but not make it smaller past a certain point.
It’s annoying because at my 1366 x 768 resolution the wallet doesn’t fit on the screen. I lose the bottom ‘2 lines’ where the blockchain sync status is…so I can’t tell how long to sync.
Is this intentional?
Can we have back the maximize window button?
Like I said, small thing…