Running a Testnet Validator Node

Hardware Requirements
Minimal
8 GB RAM
250 GB SSD Storage
1.4 GHz x2 CPU
Recommended
16 GB RAM
500 GB SSD Storage
2.0 GHx x4 CPU
Prerequisites
Golang 1.18+ required. (Installation Ref)
git Installation Ref​
make Installation Ref​
Installation
Installation of Node
Generate Wallet
Run the following to generate a wallet. Save the mnemonic displayed on the output, which can be used for scenarios where you would like to import your wallet address.
hid-noded keys add <key-name>
If you already have a BIP39 mnemonic, you can import your wallet by running the following. Enter the mnemonic string in the prompt and the wallet will be imported.
hid-noded keys add <key-name> --recover
Configure the Full Node
Initialise the node with a moniker name.
hid-noded init <moniker-name> --chain-id jagrat
Configuration files of the node are stored in the default location: $HOME/.hid-node. If you want to specify a different location, append the flag --home <hid-node-home-directory> to the above command. In this case, for every transaction based commands, you have to explicitly pass this flag.
Replace genesis.json present in <hid-node-home-directory>/config with the Testnet genesis here.
Copy the final peers from here. Open <hid-node-home-directory>/config/config.toml and the add the peers in the field persistent_peers.
Set the minimum-gas-price in <hid-node-home-directory>/config/app.toml to 0.02uhid.
Run Full Node
NOTE: The network is live since 28th September 2022, and have gone through two governance based upgrades. Hence, it's highly advisable to use State Sync. Please donot rely on Foundation Node for state sync, as we don't provide the service yet.
The node can be run in either of the following ways:
Standalone
hid-noded binary can be run in either of the following ways:
In Terminal
hid-noded start
As a system service
Change directory: cd /etc/systemd/system
Add the hid-noded system service file to /etc/systemd/system directory.
Reload service files: sudo systemctl daemon-reload
To make sure your service starts on every reboot (Optional): sudo systemctl enable hidnoded-standalone.service
To start the service: sudo systemctl start hidnoded-standalone.service
To check the status of service: sudo systemctl status hidnoded-standalone.service
To restart the service: sudo systemctl restart hidnoded-standalone.service
Cosmovisor
Cosmovisor is a tool which will enable automatic upgrade of a blockchain, once a software upgrade governance proposal is passed. More information on Cosmovisor here.
Use this approach only if you already have some basic understanding or experience in running Cosmovisor.
Setup Cosmovisor
Download and Install Cosmovisor
wget https://github.com/cosmos/cosmos-sdk/releases/download/cosmovisor%2Fv1.2.0/cosmovisor-v1.2.0-linux-amd64.tar.gz && tar -C /usr/local/bin/ -xzf cosmovisor-v1.2.0-linux-amd64.tar.gz
Export the following environment variables which are needed by cosmovisor
export DAEMON_NAME=hid-noded
export DAEMON_PATH=$(which hid-noded)
export DAEMON_HOME=<Blockchain Config Path Directory>/.hid-node  # Example: $HOME/.hid-node
Create the cosmovisor directory and copy the existing blockchain binary to the following location
mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin
cp $DAEMON_PATH $DAEMON_HOME/cosmovisor/genesis/bin
Cosmovisor can be run in either of the following ways:
Standalone
cosmovisor run start
As a system service
Change directory: cd /etc/systemd/system
Add the Cosmovisor system service file to /etc/systemd/system directory.
Open the system service file and make necessary changes in line 7, in case your hid-node config path is different.
Reload service files: sudo systemctl daemon-reload
To make sure your service starts on every reboot (Optional): sudo systemctl enable hidnoded-cosmovisor.service
To start the service: sudo systemctl start hidnoded-cosmovisor.service
To check the status of service: sudo systemctl status hidnoded-cosmovisor.service
To restart the service: sudo systemctl restart hidnoded-cosmovisor.service
Important Points
If you haven't run any Tendermint-based chains before, please note the following points before moving to the upcoming sections below:-
RPC and gRPC ports can be modified in <blockchain-config-dir>/config/config.toml
API port can be modified in <blockchain-config-dir>/config/app.toml
There are primarily two types of commands:
Transaction based. It starts with hid-noded tx ...
Query based. It starts with hid-noded q ...
Transaction based commands may/always require the following flags:
--chain-id jagrat
--fees 4000uhid: The value of fees is arbitrary, but it should be sufficiently high enough for the transaction to go through. 4000uhid is an appropriate value for almost every transaction
--node <rpc-ip-or-dns:rpc-port>: The node expects RPC to run on default port 26657. If your RPC port is different from default, you need to explicitly pass this flag. In case of default port, it can be skipped.
Query based commands may require the following flag:
--node <rpc-ip-or-dns:rpc-port>: The node expects RPC to run on default port 26657. If your RPC port is different from default, you need to explicitly pass this flag. In case of default port, it can be skipped.
Learn more about Cosmos SDK's modules and their respective commands from here​
Promotion of Full Node to Validator Node
Perform these steps only when your node is completely synced with the testnet.
Acquire some $HID tokens. Use the faucet channel of Hypersign Protocol's Discord Server from here​
Perform the following validator creation transaction.
hid-noded tx staking create-validator \
--from <key-name> \
--amount 1000000uhid \
--pubkey "$(hid-noded tendermint show-validator)" \
--chain-id jagrat \
--moniker="<validator-name>" \
--commission-max-change-rate=0.01 \
--commission-max-rate=1.0 \
--commission-rate=0.07 \
--min-self-delegation="1000000" \
--details="<enter details about your validator node or validation service>" \
--security-contact="<contain details>" \
--website="<your website>"
--fees="<Transaction fees in uhid. Example: 4000uhid>"
Redeeming Staked Rewards
Having significant stake in the blockchain comes with reward in the form of tokens. The redemption of rewards needs to be done manually. Run the following to redeem rewards:
hid-noded tx distribution withdraw-rewards <validator-addr> --from <validator-wallet-address> --chain-id jagrat --fees <Transaction fees in uhid. Example: 4000uhid>
<validator-addr> - Validator's Operator address. (Prefix is hidvaloper)
<validator-wallet-address> - Validator's wallet address from which they have stake tokens. (Prefix hid)
If you also want to withdraw validator commission, append the --commission flag to the above command.
To check the outstanding validator rewards.
hid-noded q distribution validator-outstanding-rewards <validator-addr>
<validator-addr> - Validator's Operator address. (Prefix is hidvaloper)
Unjailing a validator node
In Tendermint-based blockchain, if a node is not active for a certain period of time or if the current self stake falls below the minimum self stake, it is temporarily moved out of the validator set. This situation is called Jailing of a validator. The validator remains in the jailed period for about 10 minutes.
The validator can only be unjailed manually through a transaction after the jailed period is over and if the current self stake is above the required self stake at the time the time of performing the following unjail transaction:
hid-noded tx slashing unjail --from <validator-associated-wallet-address> --chain-id jagrat --fees <amount-in-uhid>
Last modified 3mo ago