KIICHAIN VALIDATOR

Kiichain Node Setup

Complete guide to deploying and managing a high-performance Kiichain validator node with enterprise-grade reliability

NETWORK STATUS: ACTIVE

System Requirements

Component Minimum Recommended
OS Ubuntu 20.04 Ubuntu 22.04 LTS
CPU 4 Cores 8+ Cores
RAM 8GB 16GB+
Storage 500GB SSD/NVMe 1TB SSD/NVMe
Network 10Mbps 100Mbps+

Manual Installation

Step 1: Install Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install git curl build-essential make jq gcc snapd chrony lz4 tmux unzip bc -y

Step 2: Install Go

rm -rf $HOME/go
sudo rm -rf /usr/local/go
curl https://dl.google.com/go/go1.23.linux-amd64.tar.gz | sudo tar -C/usr/local -zxvf -
cat <<'EOF' >>$HOME/.profile
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin
EOF
source $HOME/.profile
go version

Step 3: Install Kiichain Node

cd $HOME
rm -rf kiichain
git clone https://github.com/KiiChain/kiichain.git
cd kiichain
make install
kiichaind version

Step 4: Initialize Node

kiichaind init YOUR_NODE_NAME --chain-id oro_1336-1

Step 6: Configure Peers

# Set persistent peers
PEERS="5b6aa55124c0fd28e47d7da091a69973964a9fe1@uno.sentry.testnet.v3.kiivalidator.com:26656,5e6b283c8879e8d1b0866bda20949f9886aff967@dos.sentry.testnet.v3.kiivalidator.com:26656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.kiichain/config/config.toml

# Set minimum gas price
sed -i 's|^minimum-gas-prices =.*|minimum-gas-prices = "1000000000akii"|' $HOME/.kiichain/config/app.toml

Validator Configuration

Create Wallet

kiichaind keys add wallet --keyring-backend test --coin-type 118 --key-type secp256k1

⚠️ Securely backup your mnemonic phrase!

Recover Wallet

kiichaind keys add wallet --keyring-backend test --recover --coin-type 118 --key-type secp256k1

Create Validator

kiichaind tx staking create-validator \
--amount=1000000000000000000000akii \
--moniker="$Your_Validator_Name" \
--identity="" \
--details="" \
--website="" \
--from wallet \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--pubkey $(kiichaind tendermint show-validator) \
--chain-id oro_1336-1 \
--fees=1000000000akii \
-y

Step 7: Create Systemd Service

# Create service file
sudo tee /etc/systemd/system/kiichaind.service <<'EOF' > /dev/null
[Unit]
Description=Kiichain Node
After=network-online.target

[Service]
User=$USER
ExecStart=$(which kiichaind) start --home $HOME/.kiichain
Restart=on-failure
RestartSec=10
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

# Reload systemd
sudo systemctl daemon-reload

# Enable service
sudo systemctl enable kiichaind

# Start service
sudo systemctl start kiichaind

# Check status
sudo systemctl status kiichaind

Service Management

# Stop service
sudo systemctl stop kiichaind

# Restart service
sudo systemctl restart kiichaind

# View logs
journalctl -u kiichaind -f -o cat

# Check resource usage
htop

Essential Commands

Check Sync Status

kiichaind status 2>&1 | jq

Check Validator Status

kiichaind query staking validator $(kiichaind keys show wallet --bech val -a)

Monitor Logs

journalctl -fu kiichaind -o cat

Upgrade Binary

Upgrade to v3.0.0


sudo systemctl stop kiichaind
cd $HOME
rm -rf kiichain
git clone https://github.com/KiiChain/kiichain.git
cd kiichain
git checkout v3.0.0
make install

mkdir -p $HOME/kiichain_build
cp $(which kiichaind) $HOME/kiichain_build/kiichaind

sudo systemctl restart kiichaind && sudo journalctl -u kiichaind -f -o cat
      

Pastikan node Anda tersinkronisasi setelah upgrade dan memantau log untuk memastikan tidak ada error.

Sync/Snapshot

State Sync Configuration

# Get trust height and hash
LATEST_HEIGHT=$(curl -s https://rpc.uno.sentry.testnet.v3.kiivalidator.com/block | jq -r ".block.header.height")
TRUST_HEIGHT=$((LATEST_HEIGHT - 1000))
TRUST_HASH=$(curl -s "https://rpc.uno.sentry.testnet.v3.kiivalidator.com/block?height=$TRUST_HEIGHT" | jq -r ".block_id.hash")

# Enable state sync
sed -i.bak -e "s/^enable *=.*/enable = true/" $NODE_HOME/config/config.toml
sed -i.bak -e "s|^rpc_servers *=.*|rpc_servers = \"https://rpc.uno.sentry.testnet.v3.kiivalidator.com,https://rpc.dos.sentry.testnet.v3.kiivalidator.com\"|" $NODE_HOME/config/config.toml
sed -i.bak -e "s/^trust_height *=.*/trust_height = $TRUST_HEIGHT/" $NODE_HOME/config/config.toml
sed -i.bak -e "s/^trust_hash *=.*/trust_hash = \"$TRUST_HASH\"/" $NODE_HOME/config/config.toml

Snapshot

Coming soon - snapshot will be available soon for faster syncing.

Public API/RPC Endpoints

RPC Endpoint

https://rpc.uno.sentry.testnet.v3.kiivalidator.com/

Rest (LCD)

https://lcd.uno.sentry.testnet.v3.kiivalidator.com/

GRPC

grpc.uno.sentry.testnet.v3.kiivalidator.com:443

JSON-RPC (EVM)

https://json-rpc.uno.sentry.testnet.v3.kiivalidator.com/

CLI Cheatsheet

Wallet Operations

# List all wallets
kiichaind keys list

# Recover wallet
kiichaind keys add wallet --recover --keyring-backend test --coin-type 118 --key-type secp256k1

# Check balance
kiichaind q bank balances $(kiichaind keys show wallet -a)

Node Management

# Start node
sudo systemctl start kiichaind

# Stop node
sudo systemctl stop kiichaind

# Restart node
sudo systemctl restart kiichaind

# Check logs
journalctl -fu kiichaind -o cat

Staking Operations

# Delegate to validator
kiichaind tx staking delegate [validator-address] [amount]akii --from wallet --chain-id oro_1336-1 --fees=1000000000akii -y

# Withdraw rewards
kiichaind tx distribution withdraw-all-rewards --from wallet --chain-id oro_1336-1 --fees=1000000000akii -y

# Unbond from validator
kiichaind tx staking unbond [validator-address] [amount]akii --from wallet --chain-id oro_1336-1 --fees=1000000000akii -y