Syscoin 3 to Syscoin 4 Upgrade Instructions

TO USE THIS GUIDE YOU MUST HAVE ALREADY CONVERTED TO SYS3 IF YOU HAVE NOT DO NOT INSTALL SYS4 AND CONTACT HELP IN DISCORD FOR THE PROCEDURE.

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.

DO NOT RESPOND TO ANYONE OFFERING TO HELP IN A PRIVATE MESSAGE USE THE PUBLIC DISCORD HELP CHANNEL, THEY WILL TRY AND STEAL YOUR COINS.

Once you have finished the conversion the MasterNode Setup guide is linked at the end of this page.

YOU WILL NEED EITHER A COPY OF QT3 OR BM3

If you have not already done so make a backup of your wallet.dat

Location of your wallet.dat.

MAC

/Users/[USERNAME]/Library/Application Support/SyscoinCore/

Note*: the Library directory is hidden by default, you can quickly access this directory by pressing:

CMD + Shift + G

in Finder then typing:

~/Library/Application Support/SyscoinCore

WINDOWS

C:\Users\[USERNAME]\AppData\Roaming\SyscoinCore\

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

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

Procedure for BM

Unlock wallet

Go to Wallet and select ‘Dump wallet’ (Top left) and enter path to save the file

Windows

C:\Users\Public\sys3dump.bmwalletdump

MAC

/Users/xxxxx/Public/sys3dump.bmwalletdump

xxxxx is your username.

Press Save

Procedure for QT 3

Open QT 3

Unlock your wallet Settings-Unlock wallet

Open the console, Go to Tools-debug console

To Dump your wallet type

Windows

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

MAC

dumpwallet "/Users/xxxxx/Public/sys3dump.bmwalletdump"

xxxxx is your username.

And press enter.

ALL

Windows

Navigate to

C:\Users\Public

and you will see the ‘sys3dump.bmwalletdump’ there.

Mac

Navigate to

/Users/john/Public/

and you will see the ‘sys3dump.bmwalletdump’ there.

You can now close BM3 or QT3

SYS4 INSTALLS INTO THE SYSCOIN FOLDER AND YOU NEED TO ENSURE THAT IF YOU STILL HAVE ONE (FROM SYS2) YOU RENAME IT TO SYSCOIN2

If you get this error when running SYS4 you probarly have an existing syscoin folder

MAC

/Users/[USERNAME]/Library/Application Support/Syscoin/

Note*: the Library directory is hidden by default, you can quickly access this directory by pressing:

CMD + Shift + G

in Finder then typing:

~/Library/Application Support/Syscoin

WINDOWS

C:\Users\[USERNAME]\AppData\Roaming\Syscoin

RENAME THE FOLDER TO SYSCOIN2

IMPORT ROUTINE

There are 2 wallets you can use with Syscoin, please note you can only run these one at a time as they share the same wallet.

QT4 (Syscoin and Masternodes)

https://github.com/syscoin/syscoin/releases

Spark (Syscoin and Assets) Closed Source by BCF

https://github.com/blockchainfoundryinc/syscoin-spark-wallet/releases

You can use any of these to import but the procedure is slightly different for each

IMPORTING INTO QT4

Run the latest QT4

Allow it to fully sync.

Open the console, Go to Window-console

Type

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

Add press enter

Or the location you saved the dump file earlier.

This import will take a while (can be 10 minutes or so)and you will see ‘null’ in the console when finished.

PLEASE NOW CHECK YOUR SYS4 BALANCE IS CORRECT

YOU SHOULD NOW CREATE A NEW ADDRESS AND SEND YOUR ENTIRE BALANCE TO THIS ADDRESS TO ENSURE YOUR HD SEED IS UP TO DATE.

IMPORTING INTO SPARK

If you have any existing syscoin.conf in your data directory, rename it, remove it. Spark will write a new configuration file. The new configuration file is backwards compatible with Syscoin-QT and syscoind

Run Spark and allow to fully sync.

Go to Tools-View syscoin conf and if there is a line ‘debug=1’ change it to ‘debug=0’ and save.

Once Synced go to Wallet-Import Wallet (Top left)

Change file type from .dat to Spark wallet dump files

Find and select the sys3dump file and press open, please wait and when finished you will get

Then

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

ALL VERSIONS

Ensure you encrypt your wallet and back it up.

PLEASE NOW CHECK YOUR SYS4 BALANCE IS CORRECT

YOU SHOULD NOW CREATE A NEW ADDRESS AND SEND YOUR ENTIRE BALANCE TO THIS ADDRESS TO ENSURE YOUR HD SEED IS UP TO DATE.

PLEASE ENSURE YOU PERMANENTLY DELETE THE SYS3DUMP FILE AS THIS CONTAINS ALL YOUR KEYS IN PLAIN TEXT AND NEVER GIVE THIS FILE TO ANYBODY.

Link to Masternode Guide

https://medium.com/@bittyjohn1954/syscoin-4-masternodes-setup-unofficial-guide-assuming-a-clean-install-b48d257741cf