Installation

Last updated: 2025-04-20

This guide walks you through installing and running a validator node for the Allora testnet.

---

🧩 1. Install Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc unzip -y

---

🏗️ 2. Install Go

cd $HOME
VER="1.22.3"
wget "https://golang.org/dl/go$VER.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$VER.linux-amd64.tar.gz"
rm "go$VER.linux-amd64.tar.gz"
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source ~/.bash_profile
mkdir -p ~/go/bin

---

⚙️ 3. Clone & Build Allora Binary

git clone https://github.com/alloranetwork/allora-chain
cd allora-chain
git checkout v0.10.0
make install

---

📦 4. Set Environment Variables

echo "export MONIKER=\"AlloraNode\"" >> ~/.bash_profile
echo "export ALLO_CHAIN_ID=\"allora-testnet-1\"" >> ~/.bash_profile
echo "export ALLO_PORT=\"26\"" >> ~/.bash_profile
echo "export DENOM=\"uallo\"" >> ~/.bash_profile
source ~/.bash_profile

---

🌱 5. Initialize Node

allorad init $MONIKER --chain-id $ALLO_CHAIN_ID

---

🌐 6. Download Genesis, Peers, and Seeds

GENESIS_URL="https://raw.githubusercontent.com/allora-network/networks/main/allora-testnet-1/genesis.json"
SEEDS_URL="https://raw.githubusercontent.com/allora-network/networks/main/allora-testnet-1/seeds.txt"
PEERS_URL="https://raw.githubusercontent.com/allora-network/networks/main/allora-testnet-1/peers.txt"

curl -Ls $GENESIS_URL > $HOME/.allorad/config/genesis.json
SEEDS=$(curl -s $SEEDS_URL)
PEERS=$(curl -s $PEERS_URL)

sed -i.bak -e "s/^seeds *=.*/seeds = \"$SEEDS\"/" $HOME/.allorad/config/config.toml
sed -i -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.allorad/config/config.toml

---

🧊 7. Enable State Sync (Optional)

STATE_SYNC_RPC1="https://allora-rpc.testnet.allora.network:443"
STATE_SYNC_RPC2="https://allora-rpc.testnet.allora.network:443"

TRUST_HEIGHT=$(($(curl -s $STATE_SYNC_RPC1/block | jq -r '.result.block.header.height') - 100))
TRUST_HEIGHT=$(($TRUST_HEIGHT - ($TRUST_HEIGHT % 1000)))
TRUST_HASH=$(curl -s "$STATE_SYNC_RPC1/block?height=$TRUST_HEIGHT" | jq -r '.result.block_id.hash')

sed -i -e "s/^enable *=.*/enable = true/" $HOME/.allorad/config/config.toml
sed -i -e "s|^rpc_servers *=.*|rpc_servers = \"$STATE_SYNC_RPC1,$STATE_SYNC_RPC2\"|" $HOME/.allorad/config/config.toml
sed -i -e "s|^trust_height *=.*|trust_height = $TRUST_HEIGHT|" $HOME/.allorad/config/config.toml
sed -i -e "s|^trust_hash *=.*|trust_hash = \"$TRUST_HASH\"|" $HOME/.allorad/config/config.toml

---

⚙️ 8. Customize Ports

sed -i.bak -e "s%:1317%:${ALLO_PORT}317%g;
s%:8080%:${ALLO_PORT}080%g;
s%:9090%:${ALLO_PORT}090%g;
s%:9091%:${ALLO_PORT}091%g;
s%:8545%:${ALLO_PORT}545%g;" $HOME/.allorad/config/app.toml

sed -i.bak -e "s%:26656%:${ALLO_PORT}656%g;
s%:26657%:${ALLO_PORT}657%g;
s%^external_address *=.*%external_address = \"$(wget -qO- eth0.me):${ALLO_PORT}656\"%;
s/^timeout_commit *=.*/timeout_commit = \"3s\"/" $HOME/.allorad/config/config.toml

---

🧹 9. Pruning

sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.allorad/config/app.toml 
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.allorad/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.allorad/config/app.toml

---

🛎️ 10. Create Systemd Service

sudo tee /etc/systemd/system/allorad.service > /dev/null <<EOF
[Unit]
Description=Allora Node
After=network-online.target
[Service]
User=$USER
WorkingDirectory=$HOME/.allorad
ExecStart=$(which allorad) start --home $HOME/.allorad
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF

---

▶️ 11. Start Node

sudo systemctl daemon-reload
sudo systemctl enable allorad
sudo systemctl restart allorad && sudo journalctl -u allorad -f --no-hostname -o cat

---

👛 12. Create Wallet

allorad keys add wallet
# Or recover
allorad keys add wallet --recover

---

🔄 13. Check Sync

allorad status 2>&1 | jq .SyncInfo

---

💰 14. Check Balance

allorad query bank balances $(allorad keys show wallet -a)

---

🧙 15. Create Validator

allorad tx staking create-validator \\
  --amount 1000000uallo \\
  --from wallet \\
  --pubkey $(allorad tendermint show-validator) \\
  --moniker $MONIKER \\
  --chain-id $ALLO_CHAIN_ID \\
  --commission-rate "0.10" \\
  --commission-max-rate "0.20" \\
  --commission-max-change-rate "0.01" \\
  --min-self-delegation "1" \\
  --gas auto --gas-adjustment 1.5 \\
  --yes

---

✅ Make sure your wallet is funded before running the validator creation transaction.