---

Network: Tellor Layer Palmito Testnet (Chain ID: layertest-5)
Version: v6.1.5
Last Updated: May 2026

---

Table of Contents

• Hardware Requirements
• Network Endpoints
• Step 1 — System Verification
• Step 2 — System Update and Dependencies
• Step 3 — Install Go
• Step 4 — Download Binary
• Step 5 — Install Cosmovisor
• Step 6 — Create Systemd Service
• Step 7 — Initialize the Node
• Step 8 — Download Genesis and Addrbook
• Step 9 — Configure Ports and Pruning
• Step 10 — Configure Seeds and Peers
• Step 11 — Start the Node
• Step 12 — Create a Wallet
• Step 13 — Register as a Validator
• Monitoring the Node
• Useful Commands

---

Hardware Requirements

---

Network Endpoints

---

Step 1 — System Verification

After SSH-ing into your server, verify the system meets requirements:

lsb_release -a          # Should be Ubuntu 22.04 or higher
uname -r                # Kernel version
lscpu | grep -E "Model name|CPU\(s\)|Thread|Socket|Core"
free -h                 # Minimum 16 GB RAM
df -h                   # Minimum 500 GB free disk

---

Step 2 — System Update and Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget htop tmux build-essential jq make lz4 gcc unzip \
  screen btop iotop nethogs hdparm cmake perl automake autoconf libtool libssl-dev

---

Step 3 — Install Go

cd $HOME
VER="1.23.0"
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"

[ ! -f ~/.bash_profile ] && touch ~/.bash_profile
echo 'export PATH=/usr/local/go/bin:$HOME/go/bin:$PATH' >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin

Verify the installation:

go version

Expected output: go version go1.23.0 linux/amd64

---

Step 4 — Download Binary

cd $HOME
mkdir -p $HOME/.layer/cosmovisor/upgrades/v6.1.5/bin

wget https://github.com/tellor-io/layer/releases/download/v6.1.5/layer_Linux_x86_64.tar.gz
tar -xvf layer_Linux_x86_64.tar.gz

sudo mv layerd $HOME/.layer/cosmovisor/upgrades/v6.1.5/bin/
chmod +x $HOME/.layer/cosmovisor/upgrades/v6.1.5/bin/layerd

sudo ln -sfn $HOME/.layer/cosmovisor/upgrades/v6.1.5 $HOME/.layer/cosmovisor/current
sudo ln -sfn $HOME/.layer/cosmovisor/current/bin/layerd /usr/local/bin/layerd

rm -f layer_Linux_x86_64.tar.gz

Verify:

layerd version

Expected output: v6.1.5

---

Step 5 — Install Cosmovisor

go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]

Verify:

cosmovisor version

---

Step 6 — Create Systemd Service

Set your moniker and port prefix:

MONIKER="YOUR_MONIKER"
PORT="27"   # Default is 26. Change to avoid conflicts if needed (e.g. 27, 28...)

Create the service file:

sudo tee /etc/systemd/system/layerd.service > /dev/null << EOF
[Unit]
Description=Tellor Layer Testnet Node Service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start --home $HOME/.layer
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.layer"
Environment="DAEMON_NAME=layerd"
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/.layer/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable layerd

---

Step 7 — Initialize the Node

layerd config node tcp://localhost:${PORT}657
layerd config keyring-backend os
layerd config chain-id layertest-5
layerd init $MONIKER --chain-id layertest-5

Set environment variables permanently:

echo "export MONIKER=$MONIKER" >> $HOME/.bash_profile
echo "export LAYER_CHAIN_ID=\"layertest-5\"" >> $HOME/.bash_profile
echo "export LAYER_PORT=$PORT" >> $HOME/.bash_profile
source $HOME/.bash_profile

---

Step 8 — Download Genesis and Addrbook

wget -O $HOME/.layer/config/genesis.json \
  https://raw.githubusercontent.com/hazennetworksolutions/tellor-testnet/refs/heads/main/genesis.json

wget -O $HOME/.layer/config/addrbook.json \
  https://raw.githubusercontent.com/hazennetworksolutions/tellor-testnet/refs/heads/main/addrbook.json

Verify genesis:

sha256sum $HOME/.layer/config/genesis.json

---

Step 9 — Configure Ports and Pruning

Custom Ports

sed -i.bak -e "s%:1317%:${LAYER_PORT}317%g;
s%:8080%:${LAYER_PORT}080%g;
s%:9090%:${LAYER_PORT}090%g;
s%:9091%:${LAYER_PORT}091%g;
s%:8545%:${LAYER_PORT}545%g;
s%:8546%:${LAYER_PORT}546%g;
s%:6065%:${LAYER_PORT}065%g" $HOME/.layer/config/app.toml

sed -i.bak -e "s%:26658%:${LAYER_PORT}658%g;
s%:26657%:${LAYER_PORT}657%g;
s%:6060%:${LAYER_PORT}060%g;
s%:26656%:${LAYER_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${LAYER_PORT}656\"%;
s%:26660%:${LAYER_PORT}660%g" $HOME/.layer/config/config.toml

Gas Prices

sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0loya"|g' \
  $HOME/.layer/config/app.toml

Pruning

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

Enable Prometheus (optional)

sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.layer/config/config.toml

Disable Indexer (saves disk space)

sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.layer/config/config.toml

---

Step 10 — Configure Seeds and Peers

SEEDS="[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656"
PEERS="[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656"

sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
       -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" \
       $HOME/.layer/config/config.toml

---

Step 11 — Start the Node

sudo systemctl restart layerd
sudo journalctl -u layerd -f --no-pager -o cat

Verify the service is running:

sudo systemctl status layerd --no-pager

The service should show active (running).

Check sync status:

layerd status 2>&1 | jq .SyncInfo

Wait until catching_up is false before proceeding to validator registration.

---

Step 12 — Create a Wallet

layerd keys add wallet

⚠️ CRITICAL: Save your mnemonic phrase in a secure location. Without it, you cannot recover your wallet.

To recover an existing wallet:

layerd keys add wallet --recover

Check your balance:

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

---

Step 13 — Register as a Validator

The node must be fully synced before creating a validator.

Get your pubkey:

layerd comet show-validator

Create validator JSON:

cat > $HOME/validator.json << EOF
{
  "pubkey": $(layerd comet show-validator),
  "amount": "1000000loya",
  "moniker": "YOUR_MONIKER",
  "identity": "",
  "website": "",
  "security": "",
  "details": "",
  "commission-rate": "0.05",
  "commission-max-rate": "0.20",
  "commission-max-change-rate": "0.01",
  "min-self-delegation": "1"
}
EOF

Submit the transaction:

layerd tx staking create-validator $HOME/validator.json \
  --from wallet \
  --chain-id layertest-5 \
  --gas auto \
  --gas-adjustment 1.4 \
  --fees 500loya \
  -y

Verify your validator:

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

---

Monitoring the Node

Watch live block commits:

sudo journalctl -u layerd -f --no-pager | grep "committed block"

Full logs:

sudo journalctl -u layerd -f --no-pager

Sync status:

layerd status 2>&1 | jq .SyncInfo

Service management:

# Restart service
sudo systemctl restart layerd

# Stop service
sudo systemctl stop layerd

# Check status
sudo systemctl status layerd

---

Useful Commands

Wallet

# List wallets
layerd keys list

# Show wallet address
layerd keys show wallet -a

# Check balance
layerd query bank balances $(layerd keys show wallet -a)

Staking

# Delegate tokens
layerd tx staking delegate \
  $(layerd keys show wallet --bech val -a) 1000000loya \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

# Redelegate tokens
layerd tx staking redelegate \
  $(layerd keys show wallet --bech val -a) <NEW_VALOPER> 1000000loya \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

# Undelegate tokens
layerd tx staking unbond \
  $(layerd keys show wallet --bech val -a) 1000000loya \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

Rewards

# Withdraw all rewards
layerd tx distribution withdraw-all-rewards \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

# Withdraw commission
layerd tx distribution withdraw-rewards \
  $(layerd keys show wallet --bech val -a) --commission \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

Governance

# List proposals
layerd query gov proposals

# Vote on a proposal
layerd tx gov vote 1 yes \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

Validator Operations

# Edit validator
layerd tx staking edit-validator \
  --new-moniker "NEW_MONIKER" \
  --identity "" \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

# Unjail validator
layerd tx slashing unjail \
  --from wallet --chain-id layertest-5 \
  --gas auto --gas-adjustment 1.4 --fees 500loya -y

# Check validator signing info
layerd query slashing signing-info $(layerd comet show-validator)

---

Guide maintained by HazenNetworkSolutions