Release Notes
IMPORTANT If you're building from source you must upgrade to libblst 0.3.14.
This release provides a number of important enhancements to the networking layer that will improve node resilience and robustness. It is recommended that all SPOs upgrade to this version. The main changes are:
-
A checkpoint file has been added to the preview configuration for genesis mode syncing.
-
More robust diffusion layer:
- Enforce maximum number of reconnection attempts by the outbound governor.
- Shorten the timeout when waiting for
chain-syncto terminate. - Increase
chain-synctimeout in theStNext StMustReplystate to a random value between~10minsand~15mins(it used to be between~2.5minsand~5mins). - Fixed outbound governor bootstrap action.
Technical Specification
Minimum System Requirements
- An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
- Or, for MacOS, an Apple Silicon processor
- 24GB of RAM when running with the
InMemorybackend, 8GB when running with theOnDiskbackend (pending confirmation) - 300GB of free storage (350GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS, 26.04 LTS; Mint 20, 21, 21.1, 21.2, 21.3, 22, 22.1, 22.2; Debian 11, 12, 13)
- Windows 64-bit (10, 11)
- MacOS 10.15, 11 (Big Sur), 12 (Monterey), 13 (Ventura), 14 (Sonoma), 15 (Sequoia), 26 (Tahoe)
GHC/Cabal supported versions
- GHC 9.6
- Cabal 3.8/3.12
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- Cardano Node documentation
- For details about changes to configuration for
UTxO-HDplease refer to the Consensus docs on UTxO-HD - The getting started guide may also be helpful for general queries.
- Networking options and related changes are listed on the P2P section
- For details about changes to configuration for
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign-off
| Role | Approval |
|---|---|
| Technical Steering Committee (Intersect) | 🟢 |
| Product Committee (Intersect) | 🟢 |
| Test Engineer | 🟢 |
| Performance Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
Detailed Changelogs
Details
Package changelogs| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| byron-spec-chain | 1.0.1.1 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.1 | CHANGELOG.md |
| cardano-api | 10.16.4.0 | CHANGELOG.md |
| cardano-binary | 1.7.2.0 | CHANGELOG.md |
| cardano-cli | 10.11.0.0 | CHANGELOG.md |
| cardano-crypto-class | 2.2.3.2 | CHANGELOG.md |
| cardano-crypto-praos | 2.2.1.1 | CHANGELOG.md |
| cardano-crypto-test | 1.6.0.0 | CHANGELOG.md |
| cardano-crypto-tests | 2.2.2.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.6.1.0 | CHANGELOG.md |
| cardano-data | 1.2.4.1 | CHANGELOG.md |
| cardano-git-rev | 0.2.2.1 | |
| cardano-ledger-allegra | 1.7.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo | 1.13.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo-test | 1.3.1.0 | CHANGELOG.md |
| cardano-ledger-api | 1.11.0.0 | CHANGELOG.md |
| cardano-ledger-babbage | 1.11.0.0 | CHANGELOG.md |
| cardano-ledger-babbage-test | 1.3.1.0 | CHANGELOG.md |
| cardano-ledger-binary | 1.6.0.0 | CHANGELOG.md |
| cardano-ledger-byron | 1.1.0.0 | CHANGELOG.md |
| cardano-ledger-byron-test | 1.5.2.1 | CHANGELOG.md |
| cardano-ledger-conway | 1.19.0.0 | CHANGELOG.md |
| cardano-ledger-conway-test | 1.3.1.0 | CHANGELOG.md |
| cardano-ledger-core | 1.17.0.0 | CHANGELOG.md |
| cardano-ledger-mary | 1.8.0.0 | CHANGELOG.md |
| cardano-ledger-shelley | 1.16.0.0 | CHANGELOG.md |
| cardano-ledger-shelley-ma-test | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-shelley-test | 1.6.0.0 | CHANGELOG.md |
| cardano-lmdb | 0.4.0.3 | CHANGELOG.md |
| cardano-lmdb-simple | 0.8.1.0 | CHANGELOG.md |
| cardano-ping | 0.8.0.1 | CHANGELOG.md |
| cardano-prelude | 0.2.1.0 | ChangeLog.md |
| cardano-prelude-test | 0.1.0.5 | |
| cardano-protocol-tpraos | 1.4.0.0 | CHANGELOG.md |
| cardano-slotting | 0.2.0.1 | CHANGELOG.md |
| cardano-strict-containers | 0.1.5.0 | CHANGELOG.md |
| contra-tracer | 0.1.0.2 | |
| cuddle | 0.3.2.1 | CHANGELOG.md |
| diff-containers | 1.3.0.0 | CHANGELOG.md |
| ekg-forward | 0.9 | CHANGELOG.md |
| fingertree-rm | 1.0.0.4 | CHANGELOG.md |
| heapwords | 0.1.0.2 | CHANGELOG.md |
| iohk-monitoring | 0.2.1.2 | |
| lobemo-backend-aggregation | 0.1.0.3 | |
| lobemo-backend-ekg | 0.2.0.1 | |
| lobemo-backend-monitoring | 0.1.0.3 | |
| lobemo-backend-trace-forwarder | 0.1.0.0 | |
| lobemo-scribe-systemd | 0.1.0.0 | |
| measures | 0.1.0.2 | CHANGELOG.md |
| monoidal-synchronisation | 0.1.0.6 | CHANGELOG.md |
| network-mux | 0.8.0.2 | CHANGELOG.md |
| non-integral | 1.0.0.0 | CHANGELOG.md |
| optparse-applicative-fork | 0.18.1.0 | CHANGELOG.md |
| ouroboros-consensus | 0.27.0.0 | CHANGELOG.md |
| ouroboros-consensus-cardano | 0.25.1.0 | CHANGELOG.md |
| ouroboros-consensus-diffusion | 0.23.0.0 | CHANGELOG.md |
| ouroboros-consensus-protocol | 0.12.0.0 | CHANGELOG.md |
| ouroboros-network | 0.21.6.0 | CHANGELOG.md |
| ouroboros-network-api | 0.14.2.0 | CHANGELOG.md |
| ouroboros-network-framework | 0.18.0.2 | CHANGELOG.md |
| ouroboros-network-mock | 0.1.1.2 | CHANGELOG.md |
| ouroboros-network-protocols | 0.14.0.2 | CHANGELOG.md |
| ouroboros-network-testing | 0.8.1.0 | CHANGELOG.md |
| plutus-core | 1.45.0.0 | CHANGELOG.md |
| plutus-ledger-api | 1.45.0.0 | CHANGELOG.md |
| plutus-tx | 1.45.0.0 | CHANGELOG.md |
| prettyprinter-configurable | 1.36.0.0 | |
| quickcheck-monoids | 0.1.0.3 | CHANGELOG.md |
| set-algebra | 1.1.0.4 | CHANGELOG.md |
| small-steps | 1.1.2.0 | CHANGELOG.md |
| sop-extras | 0.4.1.0 | CHANGELOG.md |
| strict-checked-vars | 0.2.0.0 | CHANGELOG.md |
| strict-sop-core | 0.1.3.0 | CHANGELOG.md |
| tracer-transformers | 0.1.0.4 | |
| typed-protocols | 0.3.0.0 | CHANGELOG.md |
| typed-protocols-cborg | 0.3.0.0 | CHANGELOG.md |
| typed-protocols-examples | 0.5.0.0 | |
| typed-protocols-stateful | 0.3.0.0 | |
| typed-protocols-stateful-cborg | 0.3.0.0 | ChangeLog.md |
| vector-map | 1.1.0.1 | CHANGELOG.md |