Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.



Download the NULS Wallet Software

Depending on your OS, download the proper NULS light wallet for your computer. Note, the image shows "Beta" but will be updated with the release of the official 2.0 mainnet software

There is no longer a "full client" in NULS 2.0. Instead, you can install and use a "light wallet" which does not require synchronizing blocks with the network, so it's much faster and more reliable than before. 

  1. Download the appropriate software for your computer
  2. Double click on the installer to Install it
  3. Open the NULS 2.0 Wallet by clicking on the new icon
    1. If you cannot locate your new software icon on windows, it's located under %localappdata%\Programs\NULS-Wallet\NULS-Wallet.exe

Image RemovedImage Added

Import your Private Keys

Once opened, you will initially be presented with a page where you can create a new key or import your existing one.

  1. If necessary, change the language to english as it defaults to chinese. Click the symbol in the top right corner, then pick "English"
  2. Click "Set" and then "Address List" to see a list of addresses
  3. Click the + Icon in the top right area of the "Address Management" page 
  4. Click "Import Wallet" at the bottom of the dialog box, then select "Key Import"
  5. Copy the first private key from your notepad and paste it into the first field
  6. Enter a new password in the Password field, and enter it again in the "Confirm password" field
  7. Click "Import Wallet"
  8. Repeat this process for each address you wish to import

If you do not run a NULS Agent node, you're done! You have successfully transferred your wallet addresses from your 1.0 NULS wallet to your 2.0 NULS wallet. 




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)
Note, the address below is for the beta, and will be updated when a mainnet 2.0 wallet is available.
  • Ports 8001 and 8002 open

You can always find the latest releases for NULS 2.0 on the official github:

Code Block
tar -xf NULS_Wallet_beta3.2-linux.tar.gz

Image RemovedImage Added

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.

    Code Block

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

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

    Code Block

  3. Open a NULS prompt with "cmd"

    Code Block

    (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

    Code Block

  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

    Code Block

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

    Code Block
    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 

    Code Block
    network info



Ensure you have at least 20,000 NULS in a single address in your wallet and that your wallet is fully synced to the blockchain

If your coins are located in an exchange, you're going to need a little bit (to pay for the network transaction fee) of NULS to send at least 20,000 coins to your wallet.

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. 

If Hosting your own node, make note of your packing address from Phase 4 and proceed to the next step. 

Image RemovedImage Added

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"

Click Validate on the Node Forge website

  1. Once you have created your agent node and removed the packing address, click "Validate"
  2. Your node will be finalized and you'll be returned to your Node Forge dashboard. You're done setting up your node!
  3. You can view the status of your node in your NULS wallet under the Consensus tab, by clicking "My Node". After a short while, you will see its "Credit" value slowly increase from 0 to 1. 

Activating your Agent Node and Joining Consensus

Once your node is set up, you'll need to attract stakers in order to raise your "Total Stake" and join Consensus. You will not receive rewards until you have reached at least 200,000 Total Stake.

Your node will start at 0 Credit and 0 Stake. Once you gain 200,000 or more stakers, you will see your node icon change from red to green, your credit will gradually rise from 0 to 1 by .02 every round, and you will begin to earn rewards. 

You can check your node's participation in the consensus by visiting and clicking on the "Consensus" tab, then clicking "Round Info".