v0.14.0 Upgrade Instructions

This page contains upgrade instructions for testnet and mainnet. Always verify which network the instructions apply to.

Upgrade notes

Authenticated UDP configuration is enforced

As of this release, Authenticated UDP is required. Ensure your configuration is compliant using the Authenticated UDP Checker, and follow the documentation if needed.

Raptor redundancy factor limit lowered

The protocol-wide MAX_REDUNDANCY cap has been lowered from 7 to 3. If you have customized raptor10_fullnode_redundancy_factor in your node.toml to be higher than 3, you must lower it before upgrading or the node will fail to start with BuildError::RedundancyTooHigh.

Most operators use the default value (2) and are unaffected.

monad-ledger-tail flags updated

The --node-config-path flag has been removed and --peers-path has been introduced. Suggested configuration is:

- --node-config-path=/home/monad/monad-bft/config/node.toml
+ --peers-path=/home/monad/monad-bft/config/peers.toml

If you run monad-ledger-tail manually or in a custom systemd unit, update the configuration before upgrading.

1. SSH into the node as monad user

2. Upgrade monad package

sudo apt update && sudo apt install --reinstall monad=0.14.0 -y --allow-downgrades --allow-change-held-packages

3. Restart the services and verify

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

Expected output: All services should show Active: active (running)

4. Verify the correct version is running

monad-rpc --version

Expected output:

monad-rpc {"commit":"2d487de007d7beb70c14cbbdf20ed5c63c36de28","tag":"v0.14.0","branch":"","modified":true}