Useful Commands

Version Information

Check installed Monad binary versions:

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

Example output:

monad-node {"commit":"c0cdcaae8eb527e44d72c4638c1f1335025a5132","tag":"v0.12.2-rc","branch":"","modified":true}

CLI Help

View available CLI arguments:

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

Warning: CLI arguments should not be changed arbitrarily. Incorrect flags may cause instability or crashes.

Service Management

Check Service Status

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

Individual services:

systemctl status monad-bft
systemctl status monad-execution
systemctl status monad-rpc

View Logs

journalctl -u monad-bft -f
journalctl -u monad-execution -f
journalctl -u monad-rpc -f

Monitoring Block Height

The RPC service listens on port 8080 after state sync completes.

Query current block height:

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

MonadDB (TrieDB) Disk Usage

Check TrieDB disk usage and retained history:

monad-mpt --storage /dev/triedb

Notes:

• Automatic compaction triggers at ~80% capacity

• Designed to preserve SSD performance

Log Analysis with monlog

monlog parses recent BFT logs and provides node health information.

Setup

As root user:

usermod -a -G systemd-journal monad

Log out and log back in (or su - monad).

As monad user:

cd /home/monad
curl -sSL https://pub-b0d0d7272c994851b4c8af22a766f571.r2.dev/scripts/monlog -O
chmod u+x ./monlog
sha256sum ./monlog

Expected checksum:

f8a1066d8c093bbdb5f722f5b3d89904c17a76fa01fa1dd62e950f445e88327f

Run monlog

./monlog

Live updates:

watch -d "./monlog"

Last 10 log lines:

./monlog -r

Map secp keys to validator names:

./monlog -n

Disable color output:

./monlog --no-color

Consensus Information with ledger-tail

monad-ledger-tail streams consensus data by parsing ledger artifacts.

Start service:

systemctl start monad-ledger-tail

View output:

journalctl -fu monad-ledger-tail

Output includes:

• epoch

• round

• block number

• proposer

• timestamps

---

Node Status with monad-status

Install:

curl -sSL https://bucket.monadinfra.com/scripts/monad-status.sh \
 -o /usr/local/bin/monad-status
chmod +x /usr/local/bin/monad-status

Run:

monad-status

Provides:

• node version

• sync status

• validator keys

• peer count

• consensus state

• RPC status