Genesis: link
Block explorer: TBA
Seeds: TBA
Chain Id: TBA
Here are the minimal hardware configs required for running a validator/sentry node
- 4GB RAM
- 2vCPUs
- 80GB Disk space
- Ubuntu 20.04+ or Debian 10+
- Go v1.18+
For the sake of simplicity we decided to use Cosmos Hub service binary. In order to install it please follow steps from official Cosmos HUB instructions. It is based on the v7.0.2
version of gaiad
binary. Please check version of used binary by running this command gaiad version --long
. You should get big list of text and at the beginning of it you should have following lines:
name: gaia
server_name: gaiad
version: v7.0.2
commit: cd27aaaf39cc7819b5164e4baf3fd5aad23ec52a
build_tags: netgo ledger
cd ~
gaiad init "<moniker-name>" --chain-id school-testnet-1
example:
gaiad init course-participant-1 --chain-id dvs-course-testnet-1
It's very important that after you run this command that you save the seed phrase that is generated. If you do not save you phrase, you will not be able to recover this account.
gaiad keys add <your validator key name>
or restore existing wallet with mnemonic seed phrase. You will be prompted to enter mnemonic seed.
gaiad keys add <key-name> --recover
or add keys using ledger
gaiad keys add <key-name> --ledger
Check your key:
gaiad keys show <key-name> -a
This command will help you to create account in your local genesis file. It will add funds to your address. Otherwise gaiad getntx
command will fail because of lack of funds.
gaiad add-genesis-account <key-name> 1000000000uatom
Create the gentx file. Note, your gentx will be rejected if you use any amount greater than 1000000000uatom.
gaiad gentx <key-name> 1000000000uatom --output-document=gentx.json \
--chain-id=dvs-course-testnet-1 \
--moniker="<moniker-name>" \
--website=<your-node-website> \
--details=<your-node-details> \
--commission-rate="0.10" \
--commission-max-rate="0.20" \
--commission-max-change-rate="0.01" \
--min-self-delegation="1"
After gentx will be ready you can find it in the ~/.gaiad/config/gentx
directory. After that you will be required to upload it into gentxs
directory of this repository. Please name it using following template gentx-<validator name>.json
.
In order to upload this file you will need to create fork of this repository. Please click on “Fork” button in the top right corner of this page, and name it somehow or leave repository name unchanged.
After that you can upload gentx
file into appropriate directory of your repository. Next, you will need to create a PR (Pull request) to add changes from your cloned repository into main repository.
Please go into root directory of your repository and click on “Contribute” button.
You will see this popup window.
Please “Open pull request”, check data, put some description into text box field and click on “Create pull request” inside it. Congratulations you have created your first pull request!
gaiad tx staking create-validator \
--amount=1000000000uatom \
--pubkey=$(gaiad tendermint show-validator) \
--chain-id=dvs-course-testnet-1 \
--moniker="<moniker-name>" \
--website=<your-node-website> \
--commission-rate="0.10" \
--commission-max-rate="0.20" \
--commission-max-change-rate="0.01" \
--min-self-delegation="1" \
--gas="auto" \
--gas-prices="0.0025uatom" \
--from=<key_name>
Set up cosmovisor to ensure any future upgrades happen flawlessly. To install Cosmovisor:
go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/[email protected]
Create the required directories:
mkdir -p ~/.gaiad/cosmovisor/genesis/bin
mkdir -p ~/.gaiad/cosmovisor/upgrades
After directories will be ready please copy gaiad
binaries created in the “Cosmos Hub binaries installation (gaiad)” section into ~/.gaiad/cosmovisor/genesis/bin
directory. You can do it using cp ~/go/bin/gaiad ~/.gaiad/cosmovisor/genesis/bin/gaiad
command.
Set up a service to allow cosmovisor to run in the background as well as restart automatically if it runs into any problems:
echo "[Unit]
Description=Cosmos Hub daemon
After=network-online.target
[Service]
Environment="DAEMON_NAME=gaiad"
Environment="DAEMON_HOME=${HOME}/.gaiad"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_LOG_BUFFER_SIZE=512"
Environment="UNSAFE_SKIP_BACKUP=true"
User=$USER
ExecStart=${HOME}/go/bin/cosmovisor start
Restart=always
RestartSec=3
LimitNOFILE=infinity
LimitNPROC=infinity
[Install]
WantedBy=multi-user.target
" >cosmovisor.service
Move this new file to the systemd directory:
sudo mv cosmovisor.service /lib/systemd/system/gaiad.service
Please refer to the Cosmos Hub documentation on validators for a general overview of running a validator. We are using the exact same validator model and software, but with slightly different parameters and other functionality specific to the Cosmic Horizon Network.