NOTE: As with 8.9.0, please refrain from updating all relays simultaneously; instead, we recommend spreading out the rollout over the upcoming weeks to minimize disruptions.
Cardano Node 8.9.1 focuses on networking improvements. In particular, it enables node-to-node version 13 without needing to set the ExperimentalProtocolsEnabled option. This enables some peer sharing protocol changes/fixes/improvements.
Benchmarking reports relevant to the 8.9.1 release can be found in this post on Cardano Updates.
System testing results for the 8.9.1 release can be found on the corresponding tag testing page.
Known Issues
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 (M1, M2 or M3) processor
- 24GB of RAM
- 200GB of free storage (250GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
- Windows 64-bit (8.1, 10, 11)
- MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
- GHC 8.10.7/Cabal 3.8.1.0
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign off
| Role | Approval |
|---|---|
| Cardano Head of Engineering | 🟢 |
| Cardano Head of Product | 🟢 |
| Test Engineer | 🟢 |
| Performance Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Changelogs
Node
- Clean up orphan
GenericandNFDatainstances.
Consensus
- Bump
NodeToNodeVersionpart oflatestReleasedNodeVersionto
NodeToNodeV_13fromNodeToNodeV_11.
Ledger
NONE
Network
- Fix
LedgerStateJudgementredundant tracing - Let light peer sharing depend on the configured peer sharing flag
- Split churning of non-active peers into an established step and a known step.
- When peer sharing ask for more peers than needed, but only add as many unique
peers as desired. - Honour policyPeerShareActivationDelay timeout when peersharing
Cardano-cli
- Bump dependency version bounds
Cardano-api
- Bump dependency version bounds
Submit-api
NONE
Plutus
NONE
Individual packages' changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.1.1.1 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| byron-spec-chain | 1.0.0.2 | CHANGELOG.md |
| byron-spec-ledger | 1.0.0.2 | CHANGELOG.md |
| cardano-api | 8.39.3.0 | CHANGELOG.md |
| cardano-binary | 1.7.1.0 | CHANGELOG.md |
| cardano-cli | 8.20.3.0 | CHANGELOG.md |
| cardano-crypto | 1.1.2 | |
| cardano-crypto-class | 2.1.4.0 | CHANGELOG.md |
| cardano-crypto-praos | 2.1.2.0 | CHANGELOG.md |
| cardano-crypto-test | 1.5.0.1 | |
| cardano-crypto-tests | 2.1.2.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.5.1.1 | CHANGELOG.md |
| cardano-data | 1.2.0.0 | CHANGELOG.md |
| cardano-ledger-allegra | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo | 1.6.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo-test | 1.2.0.0 | CHANGELOG.md |
| cardano-ledger-api | 1.8.0.0 | CHANGELOG.md |
| cardano-ledger-babbage | 1.6.0.0 | CHANGELOG.md |
| cardano-ledger-babbage-test | 1.2.0.0 | CHANGELOG.md |
| cardano-ledger-binary | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-byron | 1.0.0.4 | CHANGELOG.md |
| cardano-ledger-byron-test | 1.5.0.1 | |
| cardano-ledger-conway | 1.12.0.0 | CHANGELOG.md |
| cardano-ledger-conway-test | 1.2.1.3 | CHANGELOG.md |
| cardano-ledger-core | 1.10.0.0 | CHANGELOG.md |
| cardano-ledger-mary | 1.5.0.0 | CHANGELOG.md |
| cardano-ledger-shelley | 1.9.0.0 | CHANGELOG.md |
| cardano-ledger-shelley-ma-test | 1.2.1.6 | CHANGELOG.md |
| cardano-ledger-shelley-test | 1.3.0.1 | CHANGELOG.md |
| cardano-ping | 0.2.0.13 | CHANGELOG.md |
| cardano-prelude | 0.1.0.4 | ChangeLog.md |
| cardano-prelude-test | 0.1.0.2 | |
| cardano-protocol-tpraos | 1.1.0.0 | CHANGELOG.md |
| cardano-slotting | 0.1.2.0 | CHANGELOG.md |
| cardano-strict-containers | 0.1.3.0 | CHANGELOG.md |
| contra-tracer | 0.1.0.2 | |
| ekg | 0.4.0.15.0.0.0.0.2 | CHANGELOG.md |
| ekg-core | 0.1.1.7.0.0.0.0.1 | CHANGELOG.md |
| ekg-forward | 0.5 | CHANGELOG.md |
| ekg-json | 0.1.0.7.0.0.0.0.2 | CHANGELOG.md |
| fs-api | 0.2.0.1 | CHANGELOG.md |
| fs-sim | 0.2.1.1 | CHANGELOG.md |
| heapwords | 0.1.0.2 | CHANGELOG.md |
| iohk-monitoring | 0.1.11.4 | |
| libsystemd-journal | 1.4.5.0.0.0.0.1 | Changelog.md |
| lobemo-backend-aggregation | 0.1.0.0 | |
| lobemo-backend-ekg | 0.1.0.1 | |
| lobemo-backend-monitoring | 0.1.0.0 | |
| 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.5 | CHANGELOG.md |
| network-mux | 0.4.5.1 | CHANGELOG.md |
| non-integral | 1.0.0.0 | CHANGELOG.md |
| optparse-applicative-fork | 0.18.1.0 | CHANGELOG.md |
| ouroboros-consensus | 0.16.0.0 | CHANGELOG.md |
| ouroboros-consensus-cardano | 0.14.1.0 | CHANGELOG.md |
| ouroboros-consensus-diffusion | 0.12.0.0 | CHANGELOG.md |
| ouroboros-consensus-protocol | 0.7.0.0 | CHANGELOG.md |
| ouroboros-network | 0.13.1.0 | CHANGELOG.md |
| ouroboros-network-api | 0.7.1.0 | CHANGELOG.md |
| ouroboros-network-framework | 0.12.0.0 | CHANGELOG.md |
| ouroboros-network-mock | 0.1.1.1 | CHANGELOG.md |
| ouroboros-network-protocols | 0.8.1.0 | CHANGELOG.md |
| ouroboros-network-testing | 0.6.0.0 | CHANGELOG.md |
| plutus-core | 1.21.0.0 | CHANGELOG.md |
| plutus-ledger-api | 1.21.0.0 | CHANGELOG.md |
| plutus-tx | 1.21.0.0 | CHANGELOG.md |
| prettyprinter-configurable | 1.21.0.0 | |
| set-algebra | 1.1.0.2 | CHANGELOG.md |
| small-steps | 1.0.1.0 | CHANGELOG.md |
| small-steps-test | 1.0.1.0 | CHANGELOG.md |
| sop-extras | 0.1.0.0 | CHANGELOG.md |
| strict-checked-vars | 0.2.0.0 | CHANGELOG.md |
| strict-sop-core | 0.1.0.0 | CHANGELOG.md |
| tracer-transformers | 0.1.0.4 | |
| typed-protocols | 0.1.1.0 | CHANGELOG.md |
| typed-protocols-cborg | 0.1.0.4 | CHANGELOG.md |
| typed-protocols-examples | 0.2.0.2 | |
| validation-selective | 0.2.0.0.0.0.0.0.1 | CHANGELOG.md |
| vector-map | 1.1.0.0 | CHANGELOG.md |
Legend
-
🟢 - signed / agreed / supported
-
🟥 - not agreed / unsupported