Cardano node 9.1.0 includes all the features that are necessary to be able to cross the upcoming Chang hard fork. The main change from node 9.0.0 is that node 9.1.0 requires a Conway genesis file at startup, where the genesis file was optional in node 9.0.0. This file is needed to cross the Chang hard fork. The necessary Conway genesis and other configuration files can be found here.
This release also incorporates a number of bug fixes and enhancements to the CLI and API, including a "query treasury" command, and changes to ensure compatibility with CIP69 and CIP119.
SPOs and other critical node users (exchanges, explorers, wallets, etc.) are strongly encouraged to upgrade to this version of the node. An update proposal to trigger the Chang hard fork will be submitted when sufficient SPOs and exchanges have upgraded to this version.
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
- Requires conway genesis file at startup
- Reports 9.1.0 in block header
Consensus
- No changes.
Ledger
- No changes.
Network
- No changes.
Cardano-cli
- cardano-cli-9.2.1.0, offers the following improvements with respect to cardano-cli-9.0.0.0
- Add "query treasury" command (feature, compatible) IntersectMBO/cardano-cli#845
- Relax requirement on supplying datums to Plutus spending scripts.
- Add flags to enable use of reference scripts with voting and proposing scripts
- --vote-tx-in-reference
- --proposal-tx-in-reference (feature, compatible) IntersectMBO/cardano-cli#822
- Make genesis: create, create-staked and create-cardano commands accept optional era parameters. (feature, compatible) IntersectMBO/cardano-cli#812
- Remove check on Drep metadata size, always return the hash of the file passed by the user. This is to ensure compatibility with CIP119. Upgrade cardano-api-9.1.0.0 (feature, breaking) IntersectMBO/cardano-cli#818
Cardano-api
- cardano-api-9.1.0.0
- Export metadataValueFromJsonNoSchema (feature, compatible) IntersectMBO/cardano-api#591
- Make ScriptDatum in spending scripts optional in accordance with CIP69 (feature, compatible) IntersectMBO/cardano-api#575
- Update substituteExecutionUnits to include proposal and vote script witnesses (feature, breaking) IntersectMBO/cardano-api#587
- Fix reading of Plutus V2 cost models with different lengths in AlonzoGenesis in different eras (compatible, bugfix) IntersectMBO/cardano-api#564
- Export queryAccountState (compatible) IntersectMBO/cardano-api#588
- Add IsAllegraBasedEra, IsAlonzoBasedEra, IsBabbageBasedEra, IsConwayBasedEra, IsMaryBasedEra type classes. Add ToAlonzoScript and HasScriptLanguageInEra type classes. (feature, compatible) IntersectMBO/cardano-api#585
Submit-api
- No changes.
Plutus
- No changes.
Individual packages' changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.0 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| byron-spec-chain | 1.0.1.0 | CHANGELOG.md |
| byron-spec-ledger | 1.0.1.0 | CHANGELOG.md |
| cardano-api | 9.1.0.0 | CHANGELOG.md |
| cardano-binary | 1.7.1.0 | CHANGELOG.md |
| cardano-cli | 9.2.1.0 | CHANGELOG.md |
| cardano-crypto | 1.1.2 | |
| cardano-crypto-class | 2.1.5.0 | CHANGELOG.md |
| cardano-crypto-praos | 2.1.2.0 | CHANGELOG.md |
| cardano-crypto-test | 1.5.0.2 | |
| cardano-crypto-tests | 2.1.2.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.5.1.2 | CHANGELOG.md |
| cardano-data | 1.2.3.0 | CHANGELOG.md |
| cardano-git-rev | 0.2.2.0 | |
| cardano-ledger-allegra | 1.5.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo | 1.10.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo-test | 1.2.1.2 | CHANGELOG.md |
| cardano-ledger-api | 1.9.2.1 | CHANGELOG.md |
| cardano-ledger-babbage | 1.8.2.0 | CHANGELOG.md |
| cardano-ledger-babbage-test | 1.2.0.3 | CHANGELOG.md |
| cardano-ledger-binary | 1.3.3.0 | CHANGELOG.md |
| cardano-ledger-byron | 1.0.1.0 | CHANGELOG.md |
| cardano-ledger-byron-test | 1.5.1.1 | CHANGELOG.md |
| cardano-ledger-conway | 1.16.0.0 | CHANGELOG.md |
| cardano-ledger-conway-test | 1.2.1.7 | CHANGELOG.md |
| cardano-ledger-core | 1.13.2.0 | CHANGELOG.md |
| cardano-ledger-mary | 1.6.1.0 | CHANGELOG.md |
| cardano-ledger-shelley | 1.12.2.0 | CHANGELOG.md |
| cardano-ledger-shelley-ma-test | 1.2.2.2 | CHANGELOG.md |
| cardano-ledger-shelley-test | 1.4.0.2 | CHANGELOG.md |
| cardano-ping | 0.2.0.14 | CHANGELOG.md |
| cardano-prelude | 0.2.0.0 | ChangeLog.md |
| cardano-prelude-test | 0.1.0.3 | |
| cardano-protocol-tpraos | 1.2.0.1 | CHANGELOG.md |
| cardano-slotting | 0.2.0.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.1.0 | |
| 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.2 | CHANGELOG.md |
| non-integral | 1.0.0.0 | CHANGELOG.md |
| optparse-applicative-fork | 0.18.1.0 | CHANGELOG.md |
| ouroboros-consensus | 0.20.0.0 | CHANGELOG.md |
| ouroboros-consensus-cardano | 0.18.0.0 | CHANGELOG.md |
| ouroboros-consensus-diffusion | 0.17.0.1 | CHANGELOG.md |
| ouroboros-consensus-protocol | 0.9.0.1 | CHANGELOG.md |
| ouroboros-network | 0.16.1.1 | CHANGELOG.md |
| ouroboros-network-api | 0.7.3.0 | CHANGELOG.md |
| ouroboros-network-framework | 0.13.2.1 | CHANGELOG.md |
| ouroboros-network-mock | 0.1.1.1 | CHANGELOG.md |
| ouroboros-network-protocols | 0.9.0.0 | CHANGELOG.md |
| ouroboros-network-testing | 0.6.2.0 | CHANGELOG.md |
| plutus-core | 1.30.0.0 | CHANGELOG.md |
| plutus-ledger-api | 1.30.0.0 | CHANGELOG.md |
| plutus-tx | 1.30.0.0 | CHANGELOG.md |
| prettyprinter-configurable | 1.30.0.0 | |
| quickcheck-monoids | 0.1.0.0 | CHANGELOG.md |
| set-algebra | 1.1.0.3 | CHANGELOG.md |
| small-steps | 1.1.0.0 | CHANGELOG.md |
| sop-extras | 0.2.0.0 | CHANGELOG.md |
| strict-checked-vars | 0.2.0.0 | CHANGELOG.md |
| strict-sop-core | 0.1.1.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