$ agent --node validator

last_verified: 2026-05-12 · raw markdown · human version

Validator node — agent instructions

CONSTANTS

CHAIN_ID=roguelayer-1
BINARY=rogued
DENOM=urogue
GENESIS_URL=TBD
SEED_PEERS=TBD
P2P_PORT=26656
RPC_PORT=26657
GO_VERSION_MIN=1.22
MIN_DISK_GB=200
MIN_RAM_GB=8

PREFLIGHT

Run these checks. Abort if any fails.

  • go version → version >= 1.22
  • df -BG ${HOME} | awk 'NR==2 {print $4}' | tr -d G → >= 200
  • awk '/MemTotal/ {print int($2/1024/1024)}' /proc/meminfo → >= 8
  • command -v jq curl git make → all four exist
  • port 26656 reachable from public internet (firewall + NAT)

STEPS

STEP 1 — install_binary

COMMAND:

git clone https://github.com/stepheniervella/RL1.git ~/rogue && cd ~/rogue && make install

EXPECT_EXIT: 0 VERIFY: rogued version prints a semver string on stdout. ON_FAILURE: if "rogued: command not found", ensure $(go env GOPATH)/bin is on PATH.

STEP 2 — init_node

COMMAND:

MONIKER="${MONIKER:-agent-validator}"; rogued init "$MONIKER" --chain-id roguelayer-1

EXPECT_EXIT: 0 VERIFY: [ -f ~/.rogued/config/genesis.json ] is true. ON_FAILURE: if "already initialized" and re-init intended, remove ~/.rogued/ and retry.

STEP 3 — fetch_genesis

COMMAND:

curl -fsSL "$GENESIS_URL" -o ~/.rogued/config/genesis.json

EXPECT_EXIT: 0 VERIFY: [ -s ~/.rogued/config/genesis.json ] AND sha256sum ~/.rogued/config/genesis.json matches the operator-supplied hash. ON_FAILURE: hash mismatch → STOP, do not proceed. Genesis URL or fetched file is wrong.

STEP 4 — configure_peers

COMMAND:

sed -i 's|^seeds = ".*"|seeds = "'"$SEED_PEERS"'"|' ~/.rogued/config/config.toml

EXPECT_EXIT: 0 VERIFY: grep -E '^seeds = ' ~/.rogued/config/config.toml shows the configured seeds. ON_FAILURE: edit config.toml manually; the seeds = "" line must exist for sed to match.

STEP 5 — install_systemd_unit

COMMAND:

sudo tee /etc/systemd/system/rogued.service > /dev/null <<EOF
[Unit]
Description=RogueLayer node
After=network-online.target

[Service]
User=$USER
ExecStart=$(go env GOPATH)/bin/rogued start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload && sudo systemctl enable --now rogued

EXPECT_EXIT: 0 VERIFY: systemctl is-active rogued prints active. ON_FAILURE: journalctl -u rogued -n 100 for context. Common causes: wrong ExecStart path, port permissions.

STEP 6 — wait_for_sync

COMMAND:

until rogued status 2>&1 | jq -e '.sync_info.catching_up == false' >/dev/null; do sleep 10; done

EXPECT_EXIT: 0 VERIFY: rogued status | jq -r .sync_info.catching_up returns false. ON_FAILURE: if peer count is 0 (curl -s localhost:26657/net_info | jq '.result.n_peers'), SEED_PEERS unreachable or port 26656 blocked.

STEP 7 — create_operator_key

COMMAND:

rogued keys add validator

EXPECT_EXIT: 0 VERIFY: rogued keys show validator -a prints a bech32 address. ON_FAILURE: if key exists, reuse it or rogued keys delete validator.

STEP 8 — fund_operator_address

(Out-of-band.) Fund the address from STEP 7 with at least min_self_delegation + gas urogue. VERIFY: rogued query bank balances $(rogued keys show validator -a) shows non-zero urogue balance. ON_FAILURE: STOP. Cannot proceed without funded address.

STEP 9 — create_validator

COMMAND:

rogued tx staking create-validator \
  --amount=1000000urogue \
  --pubkey="$(rogued tendermint show-validator)" \
  --moniker="$MONIKER" \
  --chain-id=roguelayer-1 \
  --commission-rate=0.10 \
  --commission-max-rate=0.20 \
  --commission-max-change-rate=0.01 \
  --min-self-delegation=1 \
  --from=validator \
  --gas=auto --gas-adjustment=1.3 -y

EXPECT_EXIT: 0 VERIFY: tx hash appears in output; rogued query tx <hash> shows code 0. ON_FAILURE: code 5 = insufficient funds; code 11 = out of gas (retry with higher --gas-adjustment).

VERIFY_FINAL

  • rogued query staking validator $(rogued keys show validator --bech val -a) → returns validator details with non-zero tokens.
  • rogued query slashing signing-info $(rogued tendermint show-address) → missed_blocks_counter stays low over time.

FAILURE_MODES

  • catching_up never becomes false → check peer count and SEED_PEERS reachability via port 26656.
  • create-validator fails with code 5 (insufficient funds) → fund operator address.
  • Node halts at a specific height → planned upgrade. Rebuild rogued from the upgrade tag and restart.
  • missed_blocks_counter climbs → node is unhealthy. Investigate disk I/O, peer count, system load before being slashed for downtime.

SAFETY

  • NEVER run two rogued processes with the same priv_validator_key.json. Doing so causes double-signing and immediate slashing with no recovery.
  • Back up ~/.rogued/config/priv_validator_key.json to a separate device before STEP 9.