These instructions are only applicable to testnet. These can be ignored for mainnet.
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
Expected output:
monad-rpc {"commit":"25672d619cc35467f621d9fe9e6443d206b6bcd9","tag":"v0.14.5","branch":"","modified":true}