Skip to content

Masternode Tool migration guide

justanwar edited this page Dec 16, 2020 · 4 revisions

Backup

Before starting, please backup your Znode Tool v0.9.19r3/v0.9.19r4 existing configuration to a safe location. You can do this in Znode Tool by going to File -> Save Configuration or by backing up the config.ini file from the following default location:

Windows: C:\Users\YOURUSERNAME\.znode-tool
Linux: ~/.znode-tool
MacOS: ~/.znode-tool

Setup

Znode Tool Evo can be downloaded here: https://github.com/zcoinofficial/znode-tool-evo

The new Znode Tool uses a different configuration folder than the previous version. You will need to import your existing configuration into it from the previous version. To do this, go to File -> Import configuration, select the config.ini from the .znode-tool directory and click Open. This will also import any existing Znodes that you have previously configured.

Importing the previous configuration will erase the remote nodes that comes with the new Znode Tool. Add them back in the File -> Settings -> Dash Network tab using the following information:

RPC host: firo32615.allnodes.me / firo22191.allnodes.me
RPC port: 8898
RPC username: ZtUser
RPC password: ZtUserPassword
SSL: On

Before starting, go to File -> Settings -> Miscellaneous, select your Hardware Wallet type and click on OK.

If you have imported your Znodes into Znode Tool, you can skip to Step 3.

Step 1

Click on New. Leave all User Role checked. Fill in the name, IP address and port of the Znode.

Step 2

Unlock your hardware wallet and click Locate Collateral, select the relevant TX and click Apply. The collateral address, collateral TX hash, and index should now be filled in automatically. If you already have the information above, you can fill them in manually to make the process faster.

Step 3

Click on Register Znode.

Set a payout address for this Znode. If you have filled in the Collateral Address earlier, it should appear here.

For privacy reasons, it is not recommended to use one payout address for all your Znodes. You also might want to use a different payout address rather than reusing your collateral address as payout.

Set operator reward (0% by default). If you are unsure, leave it at default as this cannot be changed later.

Owner private key and voting private key are generated from your hardware wallet. Make sure both fields are the same.

If you are hosting your own Znode, you can use the auto-generated operator private key.

If you are using a Znode hosting provider, your provider will provide you with a operator public key. Click on Use Pubkey and enter the provided key.

Click on Continue.

Step 4

Choose a method to submit the ProRegTx. If unsure, select Remote Zcoin RPC node. Choose the manual method if you have a Zcoin wallet running on the same machine and have sufficient Zcoin to create the transaction.

Once you have made your selection, click on Continue.

4.1 Remote/automatic

Wait until Preparing a ProRegTx transaction on a remote node says Success. After that, you will be prompted to confirm the transaction on hardware wallet. Please do so to continue.

4.2 Local/manual

On your Zcoin wallet, open the Debug Console and enter listaddressbalances 0.01. Choose an address with Zcoin in it to fund the ProRegTx. Paste the address to Section 1's box.

Some text will appear in the Section 2. Copy the command to the wallet's Debug Console and press Enter.

Now copy the output of the above command from the wallet's Debug Console to the text box in Section 3. Make sure that everything from the first { to the } is copied. Click on the 'Sign message with hardware wallet' and confirm the transaction on your hardware wallet.

Once the above is done, new text will appear in the Section 4 box. Copy it to the wallet's Debug Console and press Enter.

A transaction ID will result from the above command. Copy and paste it into the text box in Section 5 and click on Continue.

Step 5

Congratulations, you have registered your deterministic Znode. If you set the operator private key yourself, you will be prompted to add it to the zcoin.conf on the Znode. Click on Close to close the window and return to the main Znode Tool window.

Click on the Save icon to save your Znode information. Click on New to add and register another Znode.

To check your Znode's status, select your Znode from the dropdown menu and click on the Get Status button.

To check your Znode's status on the Znode itself, do ./zcoin-cli evoznode status. If everything was setup correctly, you should see your Znode's details along with these two lines at the bottom:

"state": "READY",
"status": "Ready
Clone this wiki locally