Upgrade Blockmarket or Syscoin 2/3.x.x to Syscoin 5.x.x


:warning: IMPORTANT NOTE: Please read this carefully, we really mean it.

  • Do not skip this section at any rate!
  1. Important information for users who are with us since Syscoin 2 or earlier (and all those who aren't sure)

    Syscoin QT creates a data directory called “Syscoin” if you do not have one. If you have one from a previous installation of Syscoin 2, you will need to rename it or you will encounter errors attempting to read incompatible data.

  2. If you have not already done so make a backup of your wallet.dat. You can find in Syscoin QT data directory.

  3. This procedure will Dump your existing Syscoin 3 wallet via BM 3 or QT 3 into your public folder, and ‘import’ this wallet into QT 5 from the same folder.

  4. You will need a copy of Syscoin-QT 3 or Blockmarket 3 (it does not need to be synced).

  5. We indicate placeholders by using squared brackets. [USERNAME] becomes Oliver if your username is Oliver.

  6. This document contains vital information for the security of your funds throughout the text but especially at the end. Skimp read it at your own peril. You have been warned.


A) Exporting from a Blockmarket or Syscoin 3 wallet

  1. Open either Blockmarket or QT 3 and unlock the wallet, you do NOT need to sync.

  2. Export your wallet:

    Procedure for Blockmarket 3
    1. Unlock wallet
    2. Go to Wallet and select ‘Dump wallet’ (Top left) and enter path to save the file
      Mac

      /Users/[USERNAME]/Public/sys3dump.bmwalletdump

      Windows

      C:\Users\Public\sys3dump.bmwalletdump

    3. Click Save
    Procedure for Syscoin-QT 3
    1. Unlock your wallet: Settings > Unlock wallet
    2. Open the debug console: Tools->Debug Console
    3. To dump your wallet, type
    Windows

    dumpwallet "C:\Users\Public\sys3dump.bmwalletdump"

    Mac

    dumpwallet "/Users/[USERNAME]/Public/sys3dump.bmwalletdump"

    Linux

    Type importwallet /home/[USERNAME]/dumpwallet


    4. Press Enter.

  3. Check the file was created correctly:

    Windows
    • Navigate to C:\Users\Public and you will see the sys3dump.bmwalletdump file there.
    Mac
    • Navigate to /Users/[USERNAME]/Public/ and you will see the sys3dump.bmwalletdump file there.
    Linux
    • Take a look at your home folder and you will see the dumpwallet file there.
  4. Now close Blockmarket or QT3.

:warning: Do not install Syscoin QT 5 yet

Syscoin 5 installs into the current Syscoin folder, for this reason, we must rename the current Syscoin directory where the old version is installed to another name to before the new Syscoin QT 5 installation.

You need to ensure that if you still have one from an earlier version of Syscoin, you rename folder Syscoin to other name prior to running a Syscoin 5 QT client.

Go to the directory where Syscoin is located and rename it to another name.


B) Install Syscoin QT 5 wallet

  1. Download and install the latest version of Syscoin QT 5 for your operating system.

:warning: If you get this error when running a Syscoin 5 wallet:

You probably have an existing Syscoin data directory.

  1. Create una nueva Wallet en Syscoin QT 5.

  2. Wait for Syscoin QT 5 to be fully synchronized.


C) Importing into a Syscoin QT 5 wallet

Import the file you previously exported into Syscoin QT 5

  1. Run the latest QT 5

  2. Make sure it is fully synchronized

  3. Open the console, go to Window > Console

  4. Unlock your Wallet:

    walletpassphrase "your_password" time_in_seconds
    

    Example:

    walletpassphrase "12345" 600
    
  5. Import your dumpfile

    Mac
    • Type: importwallet /Users/[USERNAME]/Public/sys3dump.bmwalletdump
    Windows
    • Type importwallet "C:\Users\Public\sys3dump.bmwalletdump"
    Linux
    • Type importwallet /home/[USERNAME]/dumpwallet

  6. Press Enter

  7. Once 100% synced you may have to close and open Spark again to see your balance.

  8. Please check that your balance is correctly displayed.

  9. Important! Now, create a backup of your wallet.dat file and store it in a safe place.
    You can find it in the wallets subfolder of Syscoin QT data directory, or in the menu File > Backup Wallet.

  10. Important! It is strongly recommended to create a new address and send your entire balance to it (Be careful if you have collateral from a SentryNode; moving it would cause you to lose Seniority).

    • Addresses generated by this wallet can be recreated from your HD Seed, but imported ones cannot.
    • During the export of old wallets, an unencrypted file containing all your private keys in plain text was generated on your hard drive.
    • You should be aware that all your old addresses are no longer secure.
  11. Delete the dumpfile that you created when exporting.

    • :warning: Important Note: Deleting files doesn’t make them unreadable. One can exfiltrate your old private keys from the harddrive that you saved the dumpfile on. This is why we advised you to encrypt your new wallet, create a new address, and transfer your entire balance to it.

:warning: If you get any issues, please use our support on Discord by opening a support ticket