Skip to main content

Mainnet Changelog

This is a curated list of only changes affecting mainnet.

note

We group changes into

  • protocol changes (generally requiring a new Revision)
    • generally tagged with [EVM], [Consensus], or [Network params]
  • RPC/SDK behavioral changes (generally tagged with [RPC])
  • performance changes
    • tagged based on the nature of the change as [EVM], [Consensus], or [RPC]
  • internal/node-ops changes (generally tagged as [Node ops])

v0.13.0 [2026-03-12]​

Revision: MONAD_NINE (upgrade; Thursday, 2026-03-19 at 14:30 GMT)

Tags or hashes:

Note: The canonical release version is v0.13.0. The +1 build metadata on the monad execution tag indicates a post-release rebuild that includes the reserve balance precompile fallback cost fix (PR #2109).

Highlights​

  • RPC: latest block tag: Finalized -> Proposed — queries with the latest block tag now return data from the latest proposed block, reducing query latency for eth_getBalance, eth_call, and other state queries.
  • RPC: eth_sendRawTransactionSync: Voted -> Proposed — earlier receipts when using the eth_sendRawTransactionSync method.
  • Websocket: newHeads/logs: Finalized -> Voted — earlier notifications for websocket subscribers to either newHeads or logs.

Notable protocol changes​

All updates below are gated by the MONAD_NINE revision

Hard Fork: This release activates MONAD_NINE at timestamp 1773153000 (testnet) / 1773930600 (mainnet). Nodes must upgrade before activation.

Notable RPC/SDK changes​

Notable robustness changes​

Notable internal changes​

v0.12.7 [2026-01-29]​

Revision: MONAD_EIGHT (unchanged)

Notable RPC/SDK changes​

  • [RPC] Allow block hash as block identifier in eth_estimateGas
  • [RPC] Use RawValue for RPC id to preserve original JSON types
    • Reduces effectiveness of DoS attacks using large JSON arrays/dicts in request IDs
    • Ref: monad-bft PR #2455

Notable robustness changes​

Notable internal changes​

  • [Consensus] Add security tests for secp256k1
    • Adds Wycheproof tests, malleability tests, and security unit tests
    • Ref: monad-bft PR #2706
  • [Node ops] Update rkyv and other dependencies
  • [Consensus] Return bound socket addresses synchronously in dataplane
  • [Consensus] Rename state backend cache for clarity

v0.12.6 [2026-01-14]​

Revision: MONAD_EIGHT (unchanged)

Tags or hashes:

Notable RPC/SDK changes​

Notable robustness changes​

  • [Consensus] Add signature verification rate limiting with authenticated peer bypass
  • [Consensus] Validate confirm group message before updating peers
  • [Consensus] Use Tai64N directly for wireauth timestamp comparison
  • [Consensus] Improve RaptorCast decoding cache eviction
  • [Consensus] Fix blocksync in-flight request tracking on cache hydration
  • [Execution] Update triedb voted metadata before executing proposal
    • Solves a race condition between Voted updates through websocket and corresponding JSON-RPC calls
    • Ref: monad PR #1964
  • [Node ops] Persist peers periodically for improved discovery resilience

Notable performance changes​

  • [Consensus] Boost dataplane throughput with ring buffer implementation
  • [Execution] Native implementation for MLOAD, MSTORE, MSTORE8, CALLDATALOAD opcodes
  • [Execution] Improve snapshot write performance
  • [Execution] Optimize database history length adjustment with binary search
  • [Execution] Unify single buffer and scatter read handling in AsyncIO

Notable internal changes​

  • [Node ops] Docker single-node container updates for prebuilt images
  • [Consensus] Add support for generic txpool sidecars
  • [EVM] Osaka fork preparation
  • [Node ops] Accept --hyphen-style long options in CLI
  • [Node ops / Archive] Archive pipeline improvements
  • [Node ops] Simplify RPC txpool status tracking
  • [Node ops] Snapshot tooling improvements in monad_cli
  • [Node ops] Add RaptorCast decoding cache metrics
  • [Execution] Add CommitBuilder API to execution database
  • [Execution] Remove legacy using_chunks_for_root_offsets metadata field
  • [Node ops / Txgen] Add ERC-4337 + EIP-7702 generator (erc4337_7702_bundled)
  • [Node ops] Add systemd service scripts for blockcapd and execution events archivers
  • [SDK] Add monad_event_resolve_ring_file API
  • [Execution] Enable VM host exception handling outside VM

v0.12.4 [2025-12-05]​

Revision: MONAD_EIGHT (unchanged)

Tags or hashes:

Notable internal changes​

  • [Node ops] Fix peer discovery port configuration when constructing self name record
    • Use port from peer discovery config instead of bound socket when constructing self name record. This bug affected node operators using a NAT.
    • Ref: monad-bft PR #2655

v0.12.3 [2025-12-04]​

Revision: MONAD_EIGHT (unchanged)

Tags or hashes:

Notable RPC/SDK changes​

Notable robustness changes​

  • [Consensus] Wire authentication protocol for UDP
  • [Execution] Improve statesync shutdown and fix protocol corruption
    • Modified statesync_server_recv() to guarantee complete reads
    • Ref: monad PR #1930
  • [RPC] Prevent reserve balance crash in RPC
    • Add reserve balance violation error messages in call frames
    • Ref: monad PR #1932, monad-bft PR #2629
    • This was already previously released in v0.12.2-rpc-hotfix
  • [Consensus] Add timeout to txpool IPC stream
  • [Consensus] Reject timeout certificates with empty signers
  • [Consensus] Verify RaptorCast chunk length is non-zero
  • [Execution] Fix MPT restore bug that failed to preserve version_lower_bound
  • [Execution] Fix move trie version forward bug
    • Erase versions that fall out of history range before moving forward to newer versions
    • Ref: monad PR #1957
  • [Execution] Fix dangling pointers to intercode
    • Resolves memory safety issue with get_code and read_code functions
    • Ref: monad PR #1941
  • [Execution] Add retries to runloop_monad_ethblocks

Notable performance changes​

Notable internal changes​

  • [RPC / Node ops] Allow RPC to run without monad-bft
    • Enables standalone RPC operation for improved deployment flexibility
    • Ref: monad-bft PR #2613
  • [Node ops] Add --root-offsets-chunk-count flag to monad-mpt to configure the number of chunks allocated for root offsets
    • Each chunk holds approximately 16.5M blocks. Previously, all nodes were hardcoded to use 2 chunks (max TrieDB capacity of ~33M blocks)
    • New default: 16 must be a power of 2
    • Note that the default value of 16 translates to approximately 268M blocks ~ 1240 days. In most cases the limiting factor is disk capacity which will auto-compact when filled to 80%
    • Ref: monad PR #1937
  • [Node ops] Peer discovery improvements
  • [Node ops / Archive] Archive infrastructure improvements
    • Refactor monad-block-writer for improved reliability with --max-blocks-per-iter configuration
    • Async backfill with traces-only archive support
    • Add require-traces archiver flag and indexer fallback source
    • Support for historical execution event archiving with generic directory archiving
    • Potentially breaking: Remove --start-block from monad-archiver systemd service; operators must use imperative CLI to set start block
      • Example: monad-archiver set-start-block --block 1000000 --archive-sink s3://bucket-name/path
      • Use --async-backfill flag to set the async-backfill marker instead of primary marker
    • Ref: monad-bft PR #2610, monad-bft PR #2606, monad-bft PR #2598, monad-bft PR #2514, monad-bft PR #2612, monad-bft PR #2569, monad-bft PR #2623
  • [Node ops] Networking configuration updates
  • [Consensus] RaptorCast improvements
    • Clear histogram every 30s and keep only p99 for better latency tracking
    • Fix timer update after receiving control messages to ensure proper keepalives
    • Ref: monad-bft PR #2627, monad-bft PR #2637
  • [Consensus] Dataplane: refactor to use socket handles
    • Prepares dataplane for future extension with authenticated sockets
    • Ref: monad-bft PR #2458
  • [Execution] Replay monad: always execute first block off latest finalized state
  • [Node ops] Txgen improvements: README and guide, nonce gaps and legacy tx options, ERC20 pools, Uniswap v3 mode, NFT sale mode, websocket and RPC request generation

v0.12.2 [2025-11-18]​

The Public Mainnet phase began on 2025-11-24. As such, public mainnet started at v0.12.2.