NULS 2.0 Upgrade Guide

Open your NULS 1.0 Wallet

If your NULS is stored on a 1.0 wallet on your PC, you'll need to get a backup of your private keys to import your NULS into your 2.0 wallet.

1. Click your NULS icon to open your NULS wallet.
2. It may take 30-60 seconds to open, but it will open in a browser window. 
3. Click on the Wallet tab and ensure your accounts are listed under the "Account" drop down box
4. Click the  Icon next to the "Account" drop down box, and make a note of each address using a notepad application of your choice

Back up your private keys

Follow these steps for each address you noted down in the previous step!

1. Click the "Backup" link next to the account you wish to back up
2. Enter your password for your wallet
3. Click the "Private key backup of plaintext" link 
4. In the box that appears, click the "Copy" button to copy your private key to your clipboard.
5. Go to your notepad where you noted down your address, and paste it next to your address.
6. Close the popup window displaying your private key and click the "< Account" link at the top of the window to return to the previous page
7. Repeat these steps for each address in your account list. 
8. Close your NULS 1.0 wallet. You will no longer need it, and can delete it at this point (but it might not be a bad idea to keep it around until you're completely up and running with your 2.0 wallet!)

Agent Node Operators - Backing up your packing address key (Optional)

1. Log into your NULS Agent Node server via ssh and navigate to your NULS software folder. It should have the following folders: bin, conf, data, jre, libs, logs.

2. Type the following command to open your NULS console

   sh ./bin/cmd.sh

3. Type "getaccounts 0 0" to list your accounts on your node. Typically, there will only be one - your packing address. Copy the "address" field and save it on your notepad

4. Type the following command to back up your private key, where ADDRESS is the address you copied in the previous step 

   backup ADDRESS .

5. Type "exit" to leave the command line. You should be returned to your directory where your bin, conf, data etc folders are located. 
6. Type "ls" to list all the files in this directory. A new file named ADDRESS.keystore will exist next to your folders. 

7. Type "cat ADDRESS.keystore" to get the contents of your keystore. It will show a string of text like this:

   {"address":"Nse2V8bHQMc7Rx7fBJyudXsCb6xqFHCR","encryptedPrivateKey":null,"alias":null,
   "pubKey":"023c8bdf89b2037247cc267e5dc6679fd5449df24eb1108e34b08353a5a216ea3a",
   "prikey":"YOUR_PRIVATE_KEY_HERE"}

8. Your private key will be displayed in the YOUR_PRIVATE_KEY_HERE area (red in the picture on the right). Copy this string and save it to your notepad next to your address from the previous step. 

Download and extract the NULS 2.0 software

You can most likely use your previous NULS 1.0 server as long as it meets the system requirements for NULS 2.0. If you need a server, we recommend using Digital Ocean.

• 4 Cores
• 16GB RAM
• 100GB SSD Disk Space
• 20Mbps upllink
• CentOS 7.4/7.5
• Ubuntu 16.04/18.04 (works, but not official)
• Ports 8001 and 8002 open

You can always find the latest releases for NULS 2.0 on the official github: https://github.com/nuls-io/nuls-v2/releases

wget http://nuls-usa-west.oss-us-west-1.aliyuncs.com/2.0/NULS_Wallet_linux64_v2.0.0.tar.gz
tar -xf NULS_Wallet_beta3.2-linux.tar.gz

Start the node software

1. The node software is started with the "start" application located in the root directory. It will not show anything when you start it.

   ./start

   (If using windows, double click "start.bat")
   
   

2. Watch the "check-status" application to make sure everything is green

   ./check-status

3. Open a NULS prompt with "cmd"

   ./cmd

   (If using windows, double click "cmd.bat")
   
   

You'll see a "nuls>>>" prompt when the initialization is finished. 

Import your packing address key (optional)

1. If you opted to back up your packing address key in prevoius steps, you can import it using the following command

   import YOUR_PRIVATE_KEY_HERE

2. You'll be prompted to input a password and confirm it. 
   
   

   When importing a packing address you MUST use the following password: nuls123456

3. Display the new address created when you imported your key

   getaccounts

Create a packing address (optional)

1. If you did not opt to import your private key, you can instead create a new address using the "create" command

   create 1

2. You'll be prompted to input a password and confirm it. 
   
   

   When creating a packing address you MUST use the following password: nuls123456
3. Your new address will be displayed after entering your password twice. 

Check your block height before creating your agent

Before proceeding, make sure your agent node is fully synchronized with the network

1. Run the "network info" command at the NULS prompt to check your synchronization progress. Make sure that "localBestHeight" equals "netBestHeight", and double check it against nulscan.io. 

   network info

Make a note of your Agent Address

1. Open your NULS "collateral" wallet (the wallet that contains all your NULS) 
2. Click the "Assets" tab at the top
3. Pick the appropriate account from the drop down "Account:" window at the top that has your NULS in it
4. Take note of this address. This is your "AGENT_ADDRESS", which will be used to set up your NULS agent node.

Create an Alias for your Agent Address (Optional)

1. If you would like your node to have a "friendly name", click on the "Set" tab at the top and pick "Address List"
2. Next to your agent address with your, click the  icon under "Alias"
3. Type in the name you would like in the alias field
4. Click "Next" to assign your Agent Address the friendly name
5. Enter your wallet password to confirm the submission
6. Wait for the "Aliased" transaction on your transaction records to change state to "Confirmed"

If Hosting with Node Forge, copy your Packing Address from the Node Forge Site

1. On Node Forge site, under the My Nodes page, expand your node, then click on the "complete setup" link. 

2. Click the "Copy" button to copy your "PACKING_ADDRESS" to your clipboard. 
   
   

Create your Agent Node

1. On your NULS wallet, click the "Consensus" tab at the top
2. Click the "New Node" link on the right hand side
3. In the "Create address" field, ensure your "AGENT_ADDRESS" that contains your NULS is listed. If not, pick it from the  menu in the top right.
4. In the "Reward address" field, enter an address that you would like your rewards to go to. It can be your AGENT_ADDRESS if you prefer. 
5. In the "Packing address" field, paste in your "PACKING_ADDRESS" from the Node Forge site.
6. In the "Deposit (NULS)" field, type in the amount of NULS you wish to "deposit" as collateral (20,000 is the minimum).
7. In the Commission rate (%)" field, type in a percentage of earnings that you want to keep as commission. 10% is the minimum, and also the most common selection if you want to attract stakers.
8. Click Confirm.
9. If prompted for a password, enter the password for your "AGENT_ADDRESS" that you set previously
10. You will be taken to the Transaction Record page. After a short time, your "Register Node" transaction should switch to "Confirmed"