IMPORTANT: Before attempting to setup your ANON masternode, you will need to have installed the original fullnode wallet on your machine (in the menu above: Resources > Wallets > Masternode Control). The ANONIO wallet cannot be used at present.

EVEN MORE IMPORTANT: It is best practice to follow the instructions on GITHUB to install your masternode. The following is provided as an additional reference for your convenience.


Masternode Control Wallet

To run an ANON masternode, you will need:

  • 10,000 ANON
  • A synced wallet, as shown above
  • A Virtual Private Server (VPS), with Ubuntu 18.04
    • We recommend 4 GB of RAM and a minimum of 30 GB of disk space. As the ANON blockchain grows, so will the disk space requirements (30 GB is adequate for now). It is possible to set up a masternode on lesser specifications – ask on Telegram or Discord tech-help channels for more information. 
  • An SSH client, which will enable you to access the VPS, such as “PuTTy” for Windows users. Linux and macOS have their own built-in SSH command utility.

Introduction

What is a masternode?

A masternode is a computer that runs a digital wallet full-time (i.e. 24 hours a day, seven days a week). Specific wallet configuration must be made in order to turn an ordinary digital wallet into a masternode.

What are the benefits of a Masternode?

Masternodes help support the wider network by contributing to decentralized operations. They are paid in coin rewards as an incentive for: investing in the necessary amount of coins required, and becoming a part of the ANON community; configuring, maintaining and hosting the masternode; participating in governance. ANON’s masternode owners are given voting rights for non-core decisions, encouraging an active and dynamic community.

Can I run a masternode on a home computer?

Yes, but it is not recommended. Ultimately, it’s all about protecting network services against denial of service attacks. A home internet connection cannot withstand even the simplest attacks. If your masternode is offline, you will not earn rewards. Your home masternode will live on your home network and it is announcing your personal IP address all over the internet. It will be listed on exchanges and other sites all over the world, simply because masternode IP’s are public knowledge. A VPS is recommended.

What is a VPS?

A VPS is a Virtual Private Server which is provided by a 3rd party. Each VPS runs an independent installation of an operating system (O/S), and typically provides root access to the O/S for advanced management and control. A VPS is highly recommended for your masternode.

Why is a VPS recommended for masternodes?

A VPS is recommended (and often required) for masternode setup, as you’ll need a dedicated static IP and 99.9% uptime to provide a stable and efficient node for the ANON network. Unlike your home or office PC, a masternode VPS serves one purpose, to securely and efficiently run a masternode. A VPS is online 24/7 and provides dedicated resources for the project’s decentralized network. This allows for a more stable and fluid network for the coin or token. The typical setup is to host a “hot” wallet on the VPS, and a “cold” wallet on the owner’s personal computer, which holds the collateral.


Before you start:

  1. If this is your first masternode, congratulations! It may seem overwhelming at first, but its not very hard if you just follow the steps. For some helpful advice and tips, please come and say hello to the ANON community – on Telegram or Discord. Do not hesitate to reach out if you aren’t clear on something, or if you get stuck. 
  2. Typing and copy/pasting commands: Any instructions given below for you to type, that are inside quotation marks (example – “type this”), – Do not include the quotation marks. A right-click of your mouse button will paste your clipboard when you are putting commands into the VPS.
  3. You will need to have sent exactly 10,000 ANON in one transaction to a transparent, empty wallet address that you wish to use for your masternode. This is done on your local (home) machine, in your masternode control wallet. It needs to have arrived and been confirmed 15 times before you can proceed. Don’t forget to have saved the private key for this address somewhere safe.
  4. You will have obtained a VPS, and gained SSH access (through PuTTy or similar). When you first login, you will need to change your password.
  5. You will need to have located your masternode.conf file on your local machine. By default, the location of the data directory is found in the following locations: Windows %HOMEPATH%AppData\Roaming\Anon; macOS ~/Library/Application Support/ANON; Linux ~/.anon
  6. You will need to know how to access your wallet through the command/terminal interface (as opposed to the GUI – Graphical User Interface).
  • For Widows users, press the [window] key and [r] key simultaneously. This will open a new window. Type “cmd” and press [enter]. Your command window should now be open. If you installed the ANON wallet to C:\anon, type “cd\anon”  and press [enter].
  • For macOS, press [command] key and [space] simultaneously. This opens a search box. Type in “terminal” – it should appear in the search results. Double-click it to launch.

INSTRUCTIONS


Local wallet setup on your home machine:

  1. Open your masternode.conf file (see above – Before you start: #5). You will see some lines or text already there, beginning with a hashtag. They are comments, and are not “read” by the wallet. They are for users (i.e. you) to read. You will be creating a new line underneath these lines.
  2. You need a name for your masternode, so on the new line, type “MN1” followed by a [space]. Next, type in the IP address of your VPS, then a colon “:” and the numbers “33130”, followed by a [space]. Leave this window open, you will need to come back and finish this with two more pieces of information.
  3. Now, your wallet needs to be running, so open the GUI and wait for it to sync. Minimize it, as we just want it running in the background.
  4. Open a second access to your wallet, this time through the command/terminal interface, and navigate to the ANON directory (see above – Before you start: #6).
  5. In the command/terminal interface, type “anon-cli masternode genkey” and press [enter]. It will give an output of letters and numbers.
  6. Copy that output and paste it onto the line that you started in your masternode.conf file, and follow it with a [space]. To copy: right-click, select ‘mark’, highlight the string of letters and numbers with the left mouse button, and press [Ctrl]+[c].
  7. You will need this output again later, so also paste it somewhere else, like notepad.
  8. Go back to the command/terminal interface, type “anon-cli masternode outputs” and press [enter]. It will give another output of letters and numbers.
  9. Copy and paste that output in your masternode.conf file after where you pasted the last one. Delete the quotation marks and the colon, so you are left with just a string of letters and numbers, followed by a [space] and either a 0 or a 1.
  10. Save your masternode.conf file, and close it.
  11. Close your command window.


Masternode setup on VPS:

  1. Login to the VPS.
  2. OPTIONAL STEP!
    Install the bootstrap.
    The “bootstrap” is a copy of the blockchain up to a certain height, for a faster deployment process. This is provided for your convenience only. We recommend that you let your masternode sync without completing this step. Copy and paste each of these lines one by one into your VPS, followed by [enter] (and do the same for all the commands listed hereafter in bold):

    mkdir .anon

    cd .anon

    wget https://assets.anonfork.io/anon-bootstrap.zip

    sudo apt-get install unzip

    unzip -o anon-bootstrap.zip

    rm -f anon-bootstrap.zip

    cd
  3. Update the system:

    sudo apt-get update

    sudo apt-get upgrade -y

    reboot
  4. Log back in to your VPS. Get dependencies (copy and paste this whole part as one command):

    sudo apt-get install \
    build-essential pkg-config libc6-dev m4 g++-multilib \
    autoconf libtool ncurses-dev unzip git python \
    zlib1g-dev wget bsdmainutils automake -y
  5. Building the node (copy and paste this whole part as one command):

    git clone https://github.com/anonymousbitcoin/anon.git
  6. Building the node (continued). Please note, the second command here will take about an hour to execute:

    cd anon

    ./anonutil/build.sh

    ./anonutil/fetch-params.sh
  7. Create config file (this will open an “editor” window):

    touch ~/.anon/anon.conf

    sudo nano ~/.anon/anon.conf
  8. Paste into the editor (make sure these are on 9 separate lines):

    rpcuser=XXX
    rpcpassword=XXX
    rpcallowip=127.0.0.1
    server=1
    daemon=1
    txindex=1
    masternode=1
    masternodeprivkey=YYY
    externalIP=ZZZ
  9. Replace the “XXX”s with your own choice of alpha-numeric name and password. Replace the “YYY” with your masternode genkey that you pasted somewhere in step #7 of Local wallet setup on your home machine instructions. Replace “ZZZ” with the IP address of the VPS.
  10. Save and Exit the editor (press [Ctrl]+[x], [y], [Enter]).
  11. Installing Sentinel:

    cd

    sudo apt-get -y install python-virtualenv

    sudo apt-get install virtualenv

    git clone https://github.com/anonymousbitcoin/sentinel.git

    cd sentinel

    virtualenv ./venv

    ./venv/bin/pip install -r requirements.txt
  12. Edit cronjob:

    sudo crontab -e
  13. Press [1], [Enter]
  14. If you are root user (if your login name is “root”), then paste:

    * * * * * cd /root/sentinel && ./venv/bin/python bin/sentinel.py >/dev/null 2>&1

    Non-root users paste this instead:
    * * * * * cd /home/YOURUSERNAME/sentinel && ./venv/bin/python bin/sentinel.py >/dev/null 2>&1

  15. Press [Ctrl + x], then [y] and [Enter] to save and close.
  16. Start your masternode:

    cd

    cd anon

    ./src/anond
  17. Wait until your masternode is synced before moving on to the final steps. You can check where it is up to by using the following command:
    ~/anon/src/anon-cli getinfo
  18. Close your SSH client.

Final steps:

  1. Open your wallet GUI on your local machine.
  2. Go to the “My Masternodes” tab, and enable your masternode by clicking on the “Start Alias” button. Select the masternode you wish to start.
    Your masternode should then change status to “Pre_Enabled”, and later it will show “Enabled” if everything was setup correctly. “Enabled” usually appears after a few blocks have been mined – it could be up to an hour or two. Sometimes during the process from “Pre_Enabled” to “Enabled” your masternode will also change status to “Watchdog_Expired” or “Expired”. Don’t worry, it should become “Enabled” eventually.
  3. If it says “New_Start_Required”, your masternode may not have been synced correctly when making the first attempt to start. Repeat step 2 above.
  4. If it has been more than a few hours, please review all the steps carefully. Did you miss anything, or get a step wrong? You may need to start again, or contact tech-support (on Telegram or Discord) for further instructions.

Additional information:

  • Once your masternode is enabled, you can confirm that it is recognized by the network by finding it here: Masternodesbyrank. Scroll through and look for your address to which you sent the collateral.
  • There are approximately 144 blocks mined per day. Each block, a masternode is rewarded. You can calculate how often your masternode should get rewarded (on average) by dividing the total amount of masternodes by 144. For example, if there are 1000 masternodes, 1000/144=6.94 – so you should receive a reward every 7 days or so. Keep in mind that the number of masternodes can increase or decrease and change the reward frequency.
  • The “rank” of a masternode is not related to payments. All masternodes are equal. The computation to reward a masternode is predominantly based on:
    • It must be enabled (have the 10,000 ANON collateral, valid protocol version, and some other technical things)
    • It must be among the 10% oldest nodes (by last received payment)
  • If those prerequisites are fulfilled the score for each of those 10% masternodes is computed. The score is (basically) the hash from some data from the blockchain and some properties of your masternode, so each node comes to the same result. The masternode with the highest score gets the payment. But – and this is the important part: the hash is (more or less) a random number, so you never know which masternode will win beforehand. And, if you have really bad luck, your masternode might stay in that 10% list for some time until it gets paid. As long as your masternode is enabled, it stays in that 10% of nodes. In the long run, good and bad luck equals out and everyone gets the same number of rewards, so no need to worry!
  • Newly mined ANON needs 100 confirmations before it can be spent (moved).
  • Once you receive your reward it needs to be sent to a shielded address FIRST before being able to be moved elsewhere, as is the case for all newly mined ANON coins. Ask for help on Telegram or Discord tech-support if you need assistance with this.