Skip to content

2. Upgrading from Syscoin 3.x to Syscoin 4.x

Jump to bottom
Brad Hammerstron edited this page May 18, 2020 · 3 revisions

If you have already upgraded to Syscoin 4.0.0 successfully, you only need to install the latest version of Syscoin 4.x and skip these steps.

This upgrade procedure has TWO parts:

1. You will DUMP your existing Syscoin 3.x wallet keys from Blockmarket or Syscoin QT 3.x into a text file in your public folder.

2. You will then need to IMPORT the newly created file into a Syscoin 4.x wallet.

WARNING: Do NOT copy your wallet.dat into the new 'Syscoin' folder. Syscoin 3 and Syscoin 4 wallet.dat files are incompatible.

GET A CLEAN START:

Rename any DATA FOLDER called Syscoin. If you have a DATA FOLDER called Syscoin from a previous installation of Syscoin 2.x, you will need to rename it Syscoin2 or you will encounter errors attempting to read incompatible data. Syscoin 4.x creates and writes to a DATA FOLDER called Syscoin.

Now you will need to open either Blockmarket or Syscoin Qt 3.x and unlock the wallet. You do NOT need to synchronise to the Syscoin 3 chain.

Find your DATA FOLDER

The DATA FOLDER is found here:

  • 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

  • LINUX: /home/[USERNAME]/.Syscoin or ~/.syscoin/ You may need to do a "ls -a" to see directories that start with a dot.

Getting your system ready

If you have already installed Syscoin Qt 4 you can skip these steps.

  • Rename any existing Syscoin DATA FOLDER from Syscoin 2.x to Syscoin2.
  • If you do not have a Syscoin DATA FOLDER, Syscoin 4 will create one for you when run.
  • Syscoin 3 uses a DATA FOLDER called SyscoinCore which should be one level higher in your folders list - leave this folder alone or you will not be able to run your current Syscoin 3.x wallet!
Unlocking your wallet

  • In Syscoin Qt 3.x go to Console: Tools->Debug Console and type:
    walletpassphrase “mypasswordorpassphrase” 180
    And press ENTER (180 = this the amount of time to remain open in seconds)

  • In Blockmarket: Click the Lock icon in the upper right menu.
    Enter your password/passphrase in the form field and press the Unlock button

1. DUMPING YOUR WALLET TO A FILE (choose your existing wallet):

Dumping your wallet from Blockmarket

  • Unlock your wallet

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

On WINDOWS type: C:\Users\Public\sys3dump.bmwalletdump And press SAVE

On MAC type: /Users/[USERNAME]/Public/sys3dump.bmwalletdump And press SAVE

  • Once complete, you are done Step 1. Please move on to CHECK YOUR WORK
Dumping your wallet from Syscoin Qt 3.x

  • Unlock your wallet.

  • You may already be in the Console. If you are not, then open the console: Go to Tools->Debug Console

On WINDOWS type: dumpwallet "C:\Users\Public\sys3dump.bmwalletdump" And press ENTER

On MAC type: dumpwallet "/Users/[USERNAME]/Public/sys3dump.bmwalletdump" And press ENTER

  • On some versions of QT you will get ‘null’ this means it has worked.
  • Once complete, you are done Step 1. Please move on to CHECK YOUR WORK
CHECK YOUR WORK

Navigate to where you saved your sys3dump.bmwalletdump file.

On WINDOWS, navigate to: C:\Users\Public You should see the sys3dump.bmwalletdump file.

On MAC, navigate to /Users/[USERNAME]/Public/ You should see the sys3dump.bmwalletdump file.

  • If you see the sys3dump.bmwalletdump file, you have completed this step and may move on to Step 2: IMPORTING YOUR DUMP FILE.

2. IMPORTING YOUR DUMP FILE:

Importing into Syscoin Qt 4.x

Install and Run the latest version of Syscoin 4.x

  • Allow it to fully sync.

  • Open the Console, Go to Window->Console

On WINDOWS type: importwallet "C:\Users\Public\sys3dump.bmwalletdump"

On MAC type: importwallet "/Users/xxxxx/Public/sys3dump.bmwalletdump"

Add press ENTER

  • This import will take a while (can be 10 minutes or so)and you will see ‘null’ in the console when finished.
  • You can now move to FINISHING UP!
FINISHING UP

  • Check that your Syscoin balance is correct!

  • You should now create a new address and send your entire balance to this new address to ensure that your HD keys are up-to-date.

  • Delete the sys3dump.bmwalletdump file that you created in Step 2.
    It is an openly readable text file that displays your private keys. Be sure to remove it from your Trash (MAC) or Recycle Bin (WINDOWS)

  • You are done! If you wish to encrypt your wallet, move on to ENCRYPTING YOUR WALLET.
ENCRYPTING YOUR WALLET (click to expand):

You can use either a password (one word or string of characters) or a passphrase (multiple words or characters with spaces between) to encrypt your wallet.

Encrypting your wallet in Syscoin Qt 4.x

  • In Syscoin QT 4.x, go to Console: Window->Console and type:
    walletpassphrase "yourpasswordorpassphrase"
    Press Enter

  • Be sure to write down your password or passphrase and save it in a safe place.

  • You are done! Enjoy your Syscoin Wallet!

Clone this wiki locally