Skip to content

Latest commit

 

History

History
123 lines (87 loc) · 6.35 KB

add-a-validator.md

File metadata and controls

123 lines (87 loc) · 6.35 KB
description
How to add your Juneo Supernet node as a validator to the Juneo Primary Network.

Add a Node to the Validator Set

After successfully bootstrapping your node, you may add it as a validator on the primary network (after which you may create Multi-Chain Networks and deploy blockchains on them).

Stakes and fees

  • The minimum stake on Mainnet is 100 JUNE, where as the maximum stake is 30,000 JUNE. On the Socotra Testnet, the minimum stake is 1 JUNE, and the maximum stake is 30,000 JUNE. You will also need additional funds to pay for transaction fees.
  • The minimum staking period is 14 days on Mainnet and on Socotra Testnet. The maximum staking period for both networks is 365 days.
  • Any delegator staking their funds on your node will pay you the delegation fee, which is 12% of their reward. Delegators can stake no more than x4 of your own stake.

{% hint style="danger" %} After creating a validator delegation, you cannot perform a validation transaction to the same node again. Additionally, you will not be able to extend the duration or increase the stake (if duration is under 14 days) until the end of your validation period. {% endhint %}

{% hint style="info" %} A node cannot be a validator on a MCN longer than it is a validator on the Juneo Primary Network. If you wish to deploy a MCN and add your node as a validator, we recommend staking on the Juneo Primary Network for at least 15 days. Once you have staked your tokens, you will be able to deploy a MCN and add your node as a validator to it for the minimum required validation period. {% endhint %}

Mainnet Socotra Testnet
Minimum stake 100 JUNE 1 JUNE
Maximum stake 30,000 JUNE 1,000,000 JUNE
Minimum staking period 14 days 14 days
Maximum staking period 365 days 365 days

Node requirements

OS Ubuntu 22.04
CPU 4 cores
RAM 8 GiB
Storage 160 GiB SSD (500 GiB SSD on Mainnet)
Network 5 Mbps

Network

At least 5 Mbps bandwidth (both upload and download) is required to run a validator node.

The node needs to accept connections from the Internet on the network ports 9651 (and optionally port 9650 to allow remote RPC calls). To enable port access on macOS, use Apple documentation. On Linux, use ufw firewall:

sudo ufw allow 9650
sudo ufw allow 9651

{% hint style="warning" %} Running your node behind NAT is not recommended. Home installation is not recommended except for testing purposes. {% endhint %}

If you're running a node on a home computer, it's most likely that you have a dynamic IP. You will need to either ask your ISP to assign a permanent public address, or set up port forwarding of port 9651 (and optionally 9650) from the internet to your node computer. Please reference your router documentation.

An active node maintains thousands of live TCP connections, keep this in mind when choosing the router for such installation. A cheap router can cause network problems and make your node considered offline because of poor connection. Being online less than 80% of staking period means losing your rewards.

Date and time synchronization

{% hint style="danger" %} Having your node's time correctly synchronized is extremely important. Incorrect time synchronization may cause your node to be marked as offline resulting in lost staking rewards. {% endhint %}

To enable time synchronization on Linux, please run the the command timedatectl in your terminal.

If the NTP service parameter is set to no, then your node't time may get out of sync. Set up time synchronization by running the command:

timedatectl set-ntp on

Run timedatectl again, and the parameter System clock synchronized should now be set to yes.

For time synchronization on macOS, please follow their documentation.

Adding a validator using the graphic interface

The first step to becoming a validator is to obtain your Node ID and prepare your BLS key information, which includes your public key and proof of possession. Open the terminal on the server running your node, and execute the following call:

curl -X POST --data '{
    "jsonrpc":"2.0",
    "id"     :1,
    "method" :"info.getNodeID"
}' -H 'content-type:application/json' 127.0.0.1:9650/ext/info

Example response:

{
  "jsonrpc": "2.0",
  "result": {
    "nodeID": "NodeID-4JfgcoMWBpxCQL5VmyQ1f6L36mUbLLBga",
    "nodePOP": {
      "publicKey": "MyBLSKey",
      "proofOfPossession": "MyBLSSignature",
    }
  },
  "id": 1
}

Next, copy the value for the nodeID, publicKey, and proofOfPossession from the response and log into mcnwallet.io.

{% hint style="info" %} For non-advanced users, we recommend MNEMONIC usage for access to the the graphic interface. {% endhint %}

Please make sure that you have a balance of at least 100 JUNE in the P-chain, and additional JUNE for transaction costs. For this purpose, you may perform Cross-chain transactions to transfer JUNE from any of the other two chains to the P-chain in the Cross-chain page.

In the mcnwallet, navigate to the Stake page, and click on the Validate card. Enter your NodeID, BLS Key (publicKey), and BLS Signature (proofOfPossession). Set the staking amount to 100 JUNE, and the validation period to 14 days. Ensure all information is correctly entered to enable your node for validation.

https://mcnwallet.io/

Next, click Validate to add your node to the Validator set.


After this transaction has been completed, you may navigate to https://mcnscan.io/validator/validator-list and enter your nodeID in the search bar, which will show you the status of your node: