This documentation under development by nodex.one team! πŸ‘·β€β™‚οΈπŸ‘‹
Networks
Mainnet
βš”οΈ Install

Manual Installation

Let's explore the manual installation process as we set up a node with Cosmovisor!

Install Dependencies

Update system package and install build tools
sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential fail2ban ufw
sudo apt -qy upgrade

Secure Setup

πŸ“’

While this step is optional, it is strongly recommended for those running on the mainnet to take a closer look, as it plays a crucial role in ensuring basic security. If you don't want to, you can skip ahead to configure moniker.

Setup ssh for zetachain user replace YOUR_PUBLIC_SSH_KEY with your own!
sudo adduser zetachain --disabled-password -q
sudo usermod -aG sudo zetachain
sudo -u zetachain bash -c 'mkdir -p ~/.ssh && echo "YOUR_PUBLIC_SSH_KEY" >> ~/.ssh/authorized_keys && chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys'

Configure Moniker

Replace <your-moniker-name> with your own validator name
MONIKER="<your-moniker-name>"

Install Go

install go version 1.21.3
sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.21.3.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)

Download Binaries

Download compiled zetachain binary
cd $HOME
wget -O zetacored https://github.com/zeta-chain/node/releases/download/v12.2.0/zetacored-linux-amd64
chmod +x zetacored

Latest commit : e7fd29074db2e07827bc6416f7b36cb963ff49dc

Prepare binaries for cosmovisor
mkdir -p $HOME/.zetacored/cosmovisor/genesis/bin
mv zetacored $HOME/.zetacored/cosmovisor/genesis/bin/
Create symlinks
sudo ln -s $HOME/.zetacored/cosmovisor/genesis $HOME/.zetacored/cosmovisor/current -f
sudo ln -s $HOME/.zetacored/cosmovisor/current/bin/zetacored /usr/local/bin/zetacored -f

Cosmovisor Setup

Install cosmovisor
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.5.0

Create Service

Create a systemd service
sudo tee /etc/systemd/system/zeta.service > /dev/null << EOF
[Unit]
Description=zetachain node service
After=network-online.target
 
[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.zetacored"
Environment="DAEMON_NAME=zetacored"
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/.zetacored/cosmovisor/current/bin"
 
[Install]
WantedBy=multi-user.target
EOF

Enable Service

Enable zetachain systemd service
sudo systemctl daemon-reload
sudo systemctl enable zeta

Initialize Node

Setting node configuration
zetacored config chain-id zetachain_7000-1
zetacored config keyring-backend test
zetacored config node tcp://localhost:12357
Initialize node
zetacored init $MONIKER --chain-id zetachain_7000-1

Download Genesis & Addrbook

Download genesis & addrbook file
curl -Ls https://snap.nodex.one/zetachain/genesis.json > $HOME/.zetacored/config/genesis.json
curl -Ls https://snap.nodex.one/zetachain/addrbook.json > $HOME/.zetacored/config/addrbook.json

sha256sum genesis.json : 1f6883987b4fc9b0ee2f20dc9cc538473a2bdd94916139c7c6bef90a86915275

Configure Seeds

Setting up a seed peers
sed -i -e "s|^seeds *=.*|seeds = \"5f5cfac5c38506fbb4275c19e87c4107ec48808d@seeds.nodex.one:12310\"|" $HOME/.zetacored/config/config.toml

Configure Gas Prices

Setting up a gas prices
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0azeta\"|" $HOME/.zetacored/config/app.toml

Pruning Setting

Configure pruning setting
sed -i \
  -e 's|^pruning *=.*|pruning = "nothing"|' \
  $HOME/.zetacored/config/app.toml

Custom Port

Please note that updating the port is optional!

Configure a custom port
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:12358\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:12357\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:12360\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:12356\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":12366\"%" $HOME/.zetacored/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:12317\"%; s%^address = \":8080\"%address = \":12380\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:12390\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:12391\"%; s%:8545%:12345%; s%:8546%:12346%; s%:6065%:12365%" $HOME/.zetacored/config/app.toml

Download Snapshots

Download latest chain snapshot
curl -L https://snap.nodex.one/zetachain/zetachain-latest.tar.lz4 | tar -Ilz4 -xf - -C $HOME/.zetacored
[[ -f $HOME/.zetacored/data/upgrade-info.json ]] && cp $HOME/.zetacored/data/upgrade-info.json $HOME/.zetacored/cosmovisor/genesis/upgrade-info.json

Start Service

Letss f*cking goooo!
sudo systemctl start zeta