Cosmos Hub Validator Tools & Infrastructure Documentation

Setting up your validator node has never been so easy. Get your validator running in minutes by following step by step instructions.

#Setup validator name

MONIKER="YOUR_MONIKER_GOES_HERE"
Copy

#Install dependencies

#Update system and install build tools

sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential
sudo apt -qy upgrade
Copy

#Install Go

sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.19.8.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
eval $(echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/golang.sh)
eval $(echo 'export PATH=$PATH:$HOME/go/bin' | tee -a $HOME/.profile)
Copy

#Download and build binaries

# Clone project repository
cd $HOME
rm -rf cosmoshub
git clone https://github.com/cosmos/gaia cosmoshub
cd cosmoshub
git checkout v21.0.0

# Build binaries
make install

# Prepare binaries for Cosmovisor
mkdir -p $HOME/.gaiad/cosmovisor/genesis/bin
mv ~/go/bin/gaiad $HOME/.gaiad/cosmovisor/genesis/bin/
rm -rf build
Copy

#Install Cosmovisor and create a service

# Download and install Cosmovisor
go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]

# Create service
sudo tee /etc/systemd/system/gaiad.service > /dev/null << EOF
[Unit]
Description=osmosis node service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
WorkingDirectory=$HOME/.gaiad
Restart=always
RestartSec=5
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.gaiad"
Environment="DAEMON_NAME=gaiad"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:$HOME/.gaiad/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable gaiad
Copy

#Initialize the node

# Set node configuration
gaiad config chain-id cosmoshub-4
gaiad config node tcp://localhost:14957

# Initialize the node
gaiad init $MONIKER --chain-id cosmoshub-4

# Download genesis and addrbook
curl -Ls https://github.com/cosmos/mainnet/raw/master/genesis/genesis.cosmoshub-4.json.gz > $HOME/.gaiad/config/genesis.json
curl -Ls https://snapshots.lavenderfive.com/snapshots/cosmoshub/addrbook.json > $HOME/.gaiad/config/addrbook.json

# Add seeds
seeds="ba3bacc714817218562f743178228f23678b2873@public-seed-node.cosmoshub.certus.one:26656,[email protected]:14956,[email protected]:14956,57a5297537b9b6ef8b105c08a8ad3f6ac452c423@seeds.goldenratiostaking.net:1618,[email protected]:14956,[email protected]:26656,400f3d9e30b69e78a7fb891f60d76fa3c73f0ecc@cosmoshub.rpc.kjnodes.com:11359,fe21dd474640247888fc7c4dce82da8da08a8bfd@seed-cosmos-hub-01.stakeflow.io:26656,[email protected]:43656,87ccc1dcc0b846fc1623ab9a5ab55682e8e2ad2e@seed-cosmoshub.freshstaking.com:26656,[email protected]:28156,00bf1f9d3c65137dc99c40cd03864384ce0ef7c3@cosmoshub-mainnet-seed.itrocket.net:34656,[email protected]:16685"
sed -i -e "s|^seeds *=.*|seeds = \"$seeds\"|" $HOME/.gaiad/config/config.toml

# Set minimum gas price
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.005uatom\"|" $HOME/.gaiad/config/app.toml

# Set pruning
sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
  $HOME/.gaiad/config/app.toml

# Set custom ports
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:14958\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:14957\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:14960\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:14956\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":14966\"%" $HOME/.gaiad/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:14917\"%; s%^address = \":8080\"%address = \":14980\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:14990\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:14991\"%; s%:8545%:14945%; s%:8546%:14946%; s%:6065%:14965%" $HOME/.gaiad/config/app.toml
Copy

#Start service and check the logs

sudo systemctl start gaiad && sudo journalctl -u gaiad -f --no-hostname -o cat
Copy

#Sync

To catch up quickly, you can either use a snapshot or state sync