v0.14.5 Upgrade Instructions

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

Upgrade notes

eth_sendRawTransactionSync now subscribes to block updates from execution events, improving response time by up to 100ms. This method is now only supported with execution events enabled. Operators running RPC with websockets enabled will experience no changes; nodes without execution events will respond with “method not supported” for this endpoint. See the execution events setup guide for configuration details.

1. SSH into the node as root user

2. Upgrade monad package

If you encounter issues with the GPG signature (e.g. signatures were invalid), please renew the keys with the command below.

curl -fsSL https://pkg.category.xyz/keys/public-key.asc \
  | gpg --dearmor --yes -o /etc/apt/keyrings/category-labs.gpg

sudo apt update && sudo apt install --reinstall monad=0.14.5 -y --allow-downgrades --allow-change-held-packages
sudo apt-mark hold monad

The apt-mark hold monad command prevents the monad package from being upgraded automatically by apt-get upgrade. Without it, unattended system upgrades can install a newer version of monad that has not been approved for your network, causing version mismatch issues.

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 -V

Expected output:

monad-rpc {"commit":"25672d619cc35467f621d9fe9e6443d206b6bcd9","tag":"v0.14.5","branch":"","modified":true}