Full / RPC node — agent instructions

CONSTANTS

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

PREFLIGHT

• go 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 exist

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_FAILURE: ensure $(go env GOPATH)/bin is on PATH.

STEP 2 — init_and_genesis

COMMAND:

rogued init "$(hostname)" --chain-id roguelayer-1 && curl -fsSL "$GENESIS_URL" -o ~/.rogued/config/genesis.json

EXPECT_EXIT: 0 VERIFY: [ -s ~/.rogued/config/genesis.json ] AND sha256sum matches operator-supplied hash. ON_FAILURE: hash mismatch → STOP.

STEP 3 — 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 configured seeds.

STEP 4 — expose_rpc_optional

Only run if external RPC access is required. Default: skip.

COMMAND:

sed -i 's|^laddr = "tcp://127.0.0.1:26657"|laddr = "tcp://0.0.0.0:26657"|' ~/.rogued/config/config.toml
sed -i '/^\[api\]/,/^\[/ s|^enable = false|enable = true|' ~/.rogued/config/app.toml
sed -i '/^\[api\]/,/^\[/ s|^address = "tcp://localhost:1317"|address = "tcp://0.0.0.0:1317"|' ~/.rogued/config/app.toml

EXPECT_EXIT: 0 VERIFY: grep 'laddr = "tcp://0.0.0.0:26657"' ~/.rogued/config/config.toml matches. SAFETY: do NOT expose 26657 to the public internet without a rate-limiting reverse proxy.

STEP 5 — install_systemd_unit

COMMAND:

sudo tee /etc/systemd/system/rogued.service > /dev/null <<EOF
[Unit]
Description=RogueLayer full 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 → active.

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 → false.

VERIFY_FINAL

• curl -s localhost:26657/status | jq -r .result.sync_info.latest_block_height → matches the explorer height ± a few blocks.

FAILURE_MODES

• catching_up stays true → peer count 0 → SEED_PEERS unreachable or port 26656 blocked.
• Disk fills up → enable pruning in ~/.rogued/config/app.toml: pruning = "default".