🧩 Useful Commands

Binary & Vers

Check installed Monad binaries:

monad-node --version
monad-rpc --version

Display full CLI options:

monad --help
monad-bft --help
monad-rpc --help

Service Control

Check overall service status:

systemctl status monad-bft monad-execution monad-rpc --no-pager

Restart all core

sudo systemctl restart monad-execution monad-bft monad-rpc

Stop services (maintenance mode):

sudo systemctl stop monad-bft monad-execution monad-rpc

Logs & Debugging

Live consensus logs:

journalctl -fu monad-bft

Execution engine logs:

journalctl -fu monad-execution

RPC logs:

journalctl -fu monad-rpc

Last 100 log lines:

journalctl -u monad-bft -n 100 --no-pager

Sync & Block Height

Query current block height via RPC:

curl http://localhost:8080 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

RPC availability check:

ss -ltnp | grep 8080

Disk & Storage

Check TrieDB (MonadDB) usage:

monad-mpt --storage /dev/triedb

Monitor disk utilization:

df -h
lsblk

Automatic TrieDB compaction starts at ~80% capacity.

Node Overview

Quick validator summary:

monad-status

Displays:

• binary versions

• sync state

• peer count

• validator keys

• consensus role

• RPC availability

Consensus & Validator Insight

Consensus stream (if enabled):

systemctl status monad-ledger-tail
journalctl -fu monad-ledger-tail

Outputs:

• epoch

• round

• proposer

• block height

• timestamps

monlog (BFT Log Analyzer)

Run interactive health view:

./monlog

Live updates:

watch -d "./monlog"

Last 10 consensus events:

./monlog -r

Map validator keys to names:

./monlog -n

Disable color output:

./monlog --no-color

Emergency Commands

Force service restart:

sudo systemctl restart monad-bft

Check for crashes:

systemctl --failed

Reboot node (last resort):

sudo reboot

---

Operator Notes

• Avoid restarting during critical consensus windows

• Always check logs after upgrades

• Keep disk usage below 80%

• Never modify CLI flags on live validators without release notes