For the complete documentation index, see llms.txt
Node
Node is a core component of the Midnight network, responsible for syncing, validating transactions, and maintaining the chain state.
To download the component, click the appropriate link under Artifacts.
Release 2.1.101LATEST
6 November 2026
Artifacts
Summary
- Upgrade every Mainnet validator and RPC node from v1.0.400 or v2.1.100 directly to v2.1.101 before the governance upgrade on 6 November 2026, with block producers upgrading together. The v2.1.0 release candidates are not a supported upgrade step. A node on v1.0.400 stops at the upgrade block.
- Binary first, then runtime: the chain keeps running ledger 8 until a governance action applies the runtime upgrade and moves Mainnet to ledger 9.1.0.1. The binary upgrade is one-way, so snapshot the data directory first. The node runs the 2.1.100 runtime (
spec_version2001100), which the governance upgrade enacts. - Known issue: a maintenance transaction that removes a verifier key (
VerifierKeyRemove) is rejected withBalanceCheckOverspendwhen client packages use ledger 9.1.0.0. Inserting a verifier key and replacing the maintenance authority work, so most contracts are unaffected. Update clients to ledger 9.1.0.1 when it is published; until then, redeploy a cross-contract caller that needs the 0.36.0 fix. - Known issue: keep the default
separatestorage layout. Settingstorage_separation=unifiedon an existing v1.0.400 data directory silently stops block import. To move tounified, stop the node, deletechains/andledger_storage/, and resync. - Added the
SafeModeandC2MBridgepallets. The bridge pallet ships turned off and stays off until governance enables it, with a rollout announced separately. - Removed the
smart-contracts,sign-address-association, andsign-block-producer-metadatasubcommands. The node connects to Cardano db-sync over TLS only. - After the upgrade, ledger 8 transactions do not decode on Mainnet. DApps and wallets need wallet SDK 2.0.0, Midnight.js 5.0.0, and indexer 4.4.101, and indexers re-index from genesis. See the ledger 9 upgrade page at /relnotes/ledger-9.
- DUST resets once at the upgrade and every Mainnet registration is replayed to its full cap, so Mainnet users do not need to do anything. Transactions submitted during the replay wait in the transaction pool and are included once it ends.
- Preview relaunched on 7 November 2026 as a new chain that runs ledger 9, with no history from the old chain. Start a Preview node on v2.1.101 with a fresh data directory. Preprod moved to node v2.1.101 and ledger 9 in place on 9 November 2026, so upgrade Preprod nodes the same way as Mainnet nodes.