Soft Reset Instructions

​

Automated Soft Reset (v0.12.1+)

1. SSH into the node as root user
2. Restart monad-related services (monad-bft will auto-fetch configs on startup):
   systemctl restart monad-bft monad-execution monad-rpc
   
3. Verify the systemd services are running:
   systemctl list-units --type=service monad-bft.service monad-execution.service monad-rpc.service
   UNIT                    LOAD   ACTIVE SUB     DESCRIPTION
   monad-bft.service       loaded active running "Service file for Monad BFT"
   monad-execution.service loaded active running "Service file for Monad Execution"
   monad-rpc.service       loaded active running "Service file for Monad RPC"
   
   # Check logs for a specific process to verify config fetching
   journalctl -u monad-bft
   

​

Manual Soft Reset

unset REMOTE_VALIDATORS_URL
unset REMOTE_FORKPOINT_URL

1. SSH into the node as root user
2. Stop monad-related services
   systemctl stop monad-bft monad-execution monad-rpc
   
3. Fetch new forkpoint.toml and validators.toml.
   • Mainnet
   • Testnet

   MF_BUCKET=https://bucket.monadinfra.com
   VALIDATORS_FILE=/home/monad/monad-bft/config/validators/validators.toml
   
   curl -sSL $MF_BUCKET/scripts/mainnet/download-forkpoint.sh | bash
   curl $MF_BUCKET/validators/mainnet/validators.toml -o $VALIDATORS_FILE
   chown monad:monad $VALIDATORS_FILE
   

   MF_BUCKET=https://bucket.monadinfra.com
   VALIDATORS_FILE=/home/monad/monad-bft/config/validators/validators.toml
   
   curl -sSL $MF_BUCKET/scripts/testnet/download-forkpoint.sh | bash
   curl $MF_BUCKET/validators/testnet/validators.toml -o $VALIDATORS_FILE
   chown monad:monad $VALIDATORS_FILE
   
   You may see the following log message:
   failed to fetch remote configs, using local forkpoint and validators config
   
4. Start monad-related services
   systemctl start monad-bft monad-execution monad-rpc
   
5. Verify the systemd services are running:
   systemctl list-units --type=service monad-bft.service monad-execution.service monad-rpc.service
   UNIT                    LOAD   ACTIVE SUB     DESCRIPTION
   monad-bft.service       loaded active running "Service file for Monad BFT"
   monad-execution.service loaded active running "Service file for Monad Execution"
   monad-rpc.service       loaded active running "Service file for Monad RPC"
   
   # Check logs for a specific process, e.g. bft
   journalctl -u monad-bft
   

​

Configuration Details

​

Forkpoint Serialization

• RLP format: Source of truth
• TOML format: Maintained for backward compatibility
• If TOML serialization fails, the node will no longer panic
• Nodes can start from either format for operational backwards compatibility