Initia Validator Setup

Setup Validator Name

Replace "oneKiller" with your validator name:

MONIKER="oneKiller"

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

Install Go

sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.21.10.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 and Build Binaries

Clone Project Repository

cd $HOME
rm -rf initia
git clone https://github.com/initia-labs/initia.git
cd initia
git checkout v0.2.15

Build Binaries

make build

Prepare Binaries for Cosmovisor

mkdir -p $HOME/.initia/cosmovisor/genesis/bin
mv build/initiad $HOME/.initia/cosmovisor/genesis/bin/
rm -rf build

Create Application Symlinks

sudo ln -s $HOME/.initia/cosmovisor/genesis $HOME/.initia/cosmovisor/current -f
sudo ln -s $HOME/.initia/cosmovisor/current/bin/initiad /usr/local/bin/initiad -f

Install Cosmovisor and Create a Service

Download and Install Cosmovisor

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

Create Service

sudo tee /etc/systemd/system/initia.service > /dev/null << EOF
[Unit]
Description=initia 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/.initia"
Environment="DAEMON_NAME=initiad"
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/.initia/cosmovisor/current/bin"

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

Initialize the Node

Set Node Configuration

initiad config set client chain-id initiation-1
initiad config set client keyring-backend test
initiad config set client node tcp://localhost:17957

Initialize the Node

initiad init $MONIKER --chain-id initiation-1

Download Genesis and Addrbook

curl -Ls https://snapshots.kjnodes.com/initia-testnet/genesis.json > $HOME/.initia/config/genesis.json
curl -Ls https://snapshots.kjnodes.com/initia-testnet/addrbook.json > $HOME/.initia/config/addrbook.json

Add Seeds

sed -i -e "s|^seeds *=.*|seeds = \"3f472746f46493309650e5a033076689996c8881@initia-testnet.rpc.kjnodes.com:17959\"|" $HOME/.initia/config/config.toml

Set Minimum Gas Price

sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.15uinit,0.01uusdc\"|" $HOME/.initia/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/.initia/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:17958\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:17957\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:17960\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:17956\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":17966\"%" $HOME/.initia/config/config.toml
sed -i -e "s%^address = \"tcp://localhost:1317\"%address = \"tcp://localhost:17917\"%; s%^address = \":8080\"%address = \":17910\"%; s%^address = \"localhost:9090\"%address = \"localhost:17990\"%; s%^address = \"localhost:9091\"%address = \"localhost:17991\"%" $HOME/.initia/config/app.toml

Start Node

Start the node with the following command:

sudo systemctl start initia.service

Check Logs

Use the command below to check the node logs:

sudo journalctl -u initia.service -f --no-hostname -o cat

Setup State Sync

Stop Service

sudo systemctl stop initia.service

Reset State

initiad tendermint unsafe-reset-all --home $HOME/.initia --keep-addr-book

Setup State Sync

Stop Service

sudo systemctl stop initia.service

Reset State

initiad tendermint unsafe-reset-all --home $HOME/.initia --keep-addr-book

Get State Sync Information

SNAP_RPC="https://initia-testnet.rpc.kjnodes.com:443"
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height)
BLOCK_HEIGHT=$((LATEST_HEIGHT - 2000))
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

Configure State Sync

sed -i -e "s|^enable *=.*|enable = true|; s|^rpc_servers *=.*|rpc_servers = \"$SNAP_RPC,$SNAP_RPC\"|; s|^trust_height *=.*|trust_height = $BLOCK_HEIGHT|; s|^trust_hash *=.*|trust_hash = \"$TRUST_HASH\"|; s|^trust_period *=.*|trust_period = \"1000h\"|" $HOME/.initia/config/config.toml

Restart Service

sudo systemctl start initia.service
sudo journalctl -u initia.service -f --no-hostname -o cat

Set up Validator

Official documentation: Validator Documentation

1. Create a Wallet

You have two options to create a wallet:

Option 1: Create New Wallet

initiad keys add wallet

Option 2: Recover Existing Wallet

initiad keys add wallet --recover

Save the mnemonic output as this is the only way to recover your validator wallet in case you lose it!

To list your wallets use:

initiad keys list

2. Fund the Wallet

Fund the previously created wallet using Initia Faucet.

To check wallet balance:

initiad q bank balances $(initiad keys show wallet -a)

3. Create Validator

Ensure you have adjusted moniker, identity, details, and website to match your values.

initiad tx mstaking create-validator \
--amount 1000000uinit \
--pubkey $(initiad tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id initiation-1 \
--commission-rate 0.05 \
--commission-max-rate 0.20 \
--commission-max-change-rate 0.05 \
--from wallet \
--fees 5000uinit \
-y

Save the ~/.initia/config/priv_validator_key.json file as this is the only way to recover your validator signing key in case you lose it!

Set up Oracle

This guide is only for validator nodes.

Official documentation: Oracle Documentation

Slinky Oracle Components:

An on-chain component that retrieves price data from the sidecar with each block, forwards these prices to the blockchain through vote extensions, and compiles prices from all validators involved.
A sidecar process dedicated to polling price information from various providers and delivering this data to the on-chain component.

Step 1: Clone the Repository and Build Binaries

Clone Repository

cd $HOME
rm -rf slinky
git clone https://github.com/skip-mev/slinky.git
cd slinky
git checkout v0.4.3

Build Binaries

make build

Move Binary to Local Bin

mv build/slinky /usr/local/bin/
rm -rf build

Step 2: Run Oracle

Create Systemd Service

sudo tee /etc/systemd/system/slinky.service > /dev/null << EOF
[Unit]
Description=Slinky Oracle Service
After=network-online.target

[Service]
User=$USER
ExecStart=/usr/local/bin/slinky
Restart=always
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Enable and Start Systemd Service

sudo systemctl daemon-reload
sudo systemctl enable slinky.service
sudo systemctl start slinky.service

Step 3: Validating Prices

Upon launching the oracle, you should observe successful price retrieval from the provider sources. Additionally, you have the option to execute the test client script available in the Slinky repository by using:

make run-oracle-client

Step 4: Enable Oracle Vote Extension

To utilize the Slinky oracle data in the Initia node, enable the Oracle setting in the config/app.toml file.

[oracle]
# Enabled indicates whether the oracle is enabled.
enabled = "true"

# Oracle Address is the URL of the out of process oracle sidecar. This is used to
# connect to the oracle sidecar when the application boots up. Note that the address
# can be modified at any point, but will only take effect after the application is
# restarted. This can be the address of an oracle container running on the same
# machine or a remote machine.
oracle_address = "127.0.0.1:8080"

# Client Timeout is the time that the client is willing to wait for responses from 
# the oracle before timing out.
client_timeout = "500ms"

# MetricsEnabled determines whether oracle metrics are enabled. Specifically
# this enables instrumentation of the oracle client and the interaction between
# the oracle and the app.
metrics_enabled = "false"

Step 5: Check Systemd Logs

To check service logs:

journalctl -fu slinky --no-hostname

Successful Log Examples:

May 14 19:07:08 slinky[877177]: {"level":"info","ts":"2024-05-14T19:07:08.296Z","num_prices":65}
May 14 19:07:08 slinky[877177]: {"level":"info","ts":"2024-05-14T19:07:08.547Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":877177,"process":"oracle","last_sync":"2024-05-14T19:07:08.547Z","num_prices":65}
May 14 19:07:08 slinky[877177]: {"level":"info","ts":"2024-05-14T19:07:08.796Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":877177,"process":"oracle","last_sync":"2024-05-14T19:07:08.796Z","num_prices":65}
May 14 19:07:09 slinky[877177]: {"level":"info","ts":"2024-05-14T19:07:09.045Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":877177,"process":"oracle","last_sync":"2024-05-14T19:07:09.045Z","num_prices":65}
May 14 19:07:09 slinky[877177]: {"level":"info","ts":"2024-05-14T19:07:09.296Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":877177,"process":"oracle","last_sync":"2024-05-14T19:07:09.296Z","num_prices":65}