Repository navigation
Releases: IntersectMBO/cardano-node
Release list
11.1.3
Release Notes
Cardano-node 11.1.3 issues a fix Ledger's IPv4 decoding: releases before 11.1.x decoded IPv4s using network order, which 11.1.2 inadvertently changed; this has been reverted to using network order for decoding IPv4s.
Known issues
- There is a slight increase in memory usage compared to node version
11.0.1when syncing, but this is significantly less than the regression in 11.1.0. Full details - There is a small increase in memory usage compared to node version
11.0.1when on tip, which correlates with taking ledger snapshots. (Full details published in release benchmark report; link see below).
Breaking changes
plutus-ledger-api: plc optimise no longer accepts the --certify and --certifier- options.
Release Benchmarks
Benchmarking reports are not affected by node version 11.1.3. The reports relevant to the 11.1.1 release can be found in this post on Cardano Updates.
System Testing
System testing results for the 11.1.1 release are applicable to 11.1.3 and can be found on the corresponding tag testing page.
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
- Release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
Documentation
- Cardano Node documentation
- The operators handbook may also be helpful for general queries.
- Networking options and related changes are listed on the topology section
- 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
cardano-node
- Updates PV minor in the block header
cardano-tracer
No changes.
cardano-submit-api
No changes.
cardano-testnet
No changes.
cardano-cli
No changes.
cardano-api
No changes.
cardano-rpc
No changes.
Network
No changes.
Consensus
No changes.
Ledger
- Fix IPv4 decoding to use network order
Plutus
plutus-ledger-api:plc optimiseno longer accepts the--certifyand--certifier-options.
Tracing
No changes.
Detailed Changelogs
Package changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| acts-generic | 0.1.1.0 | CHANGELOG.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| basement | 0.0.16 | |
| byron-spec-chain | 1.0.1.2 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.2 | CHANGELOG.md |
| cardano-addresses | 4.0.2 | ChangeLog.md |
| cardano-api | 11.6.0.0 | CHANGELOG.md |
| cardano-base | 0.1.6.0 | CHANGELOG.md |
| cardano-binary | 1.9.1.0 | CHANGELOG.md |
| cardano-cli | 11.2.3.0 | CHANGELOG.md |
| cardano-crypto | 1.3.0 | |
| cardano-crypto-class | 2.5.1.0 | CHANGELOG.md |
| cardano-crypto-leios | 0.2.0.0 | CHANGELOG.md |
| cardano-crypto-praos | 2.2.4.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.7.0.0 | CHANGELOG.md |
| cardano-data | 1.3.1.0 | [CHANGELOG.md](https://github.com/IntersectMBO/cardano-ledger/blob/ab2525cf81b0b6d74d5ae43d2a... |
11.1.2
Release Notes
Cardano-node 11.1.2 optimizes memory usage in time lock scripts.
Known issues
- There is a slight increase in memory usage compared to node version
11.0.1when syncing, but significantly less than the regression in 11.1.0. Full details - There is a small increase in memory usage compared to node version
11.0.1when on tip, which correlates with taking ledger snapshots. (Full details published in release benchmark report; link see below).
Breaking changes
cardano-rpc contains a number of breaking changes from 11.0.
Release Benchmarks
Benchmarking reports are not affected by node version 11.1.2. The reports relevant to the 11.1.1 release can be found in this post on Cardano Updates.
System Testing
System testing results for the 11.1.1 release are applicable to 11.1.2 and can be found on the corresponding tag testing page.
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
- Pre-release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
Documentation
- Cardano Node documentation
- The operators handbook may also be helpful for general queries.
- Networking options and related changes are listed on the topology section
- 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
cardano-node
- Updates PV minor in the block header
cardano-tracer
No changes.
cardano-submit-api
No changes.
cardano-testnet
No changes.
cardano-cli
No changes.
cardano-api
No changes.
cardano-rpc
No changes.
Network
No changes.
Consensus
No changes.
Ledger
- Optimizes memory usage in time lock scripts.
Plutus
No changes.
Tracing
No changes.
Detailed Changelogs
Package changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| acts-generic | 0.1.1.0 | CHANGELOG.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| basement | 0.0.16 | |
| byron-spec-chain | 1.0.1.2 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.2 | CHANGELOG.md |
| cardano-addresses | 4.0.2 | ChangeLog.md |
| cardano-api | 11.6.0.0 | CHANGELOG.md |
| cardano-base | 0.1.6.0 | CHANGELOG.md |
| cardano-binary | 1.9.1.0 | CHANGELOG.md |
| cardano-cli | 11.2.3.0 | CHANGELOG.md |
| cardano-crypto | 1.3.0 | |
| cardano-crypto-class | 2.5.1.0 | CHANGELOG.md |
| cardano-crypto-leios | 0.2.0.0 | CHANGELOG.md |
| cardano-crypto-praos | 2.2.4.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.7.0.0 | CHANGELOG.md |
| cardano-data | 1.3.1.0 | CHANGELOG.md |
| cardano-diffusion | 1.1.1.0 | [CHANGELOG.md](https://github.com/IntersectMBO/ouroboros-network/blob/c5117705f6d5f8ea57ce3e772b6f9c35bfdb9167/cardano-diffusion/CHANGELOG.md "CHANG... |
11.1.1
Release Notes
Node version 11.1.1 includes a number of performance improvements and general enhancements, and prepares the way for the Dijkstra-era hard fork. It also completes the removal of the legacy tracing system ("iohk-monitoring-framework"): the new tracing system is now the only one included, and configurations still using legacy keys must be migrated (see the New Tracing Quick Start and PR 6580 for the list of removed config keys).
This release also removes the V1 LedgerDB and the LMDB storage backend, and makes ledger snapshots predictable and Mithril-compatible, so snapshots are comparable and shareable across nodes. LMDB users must switch storage backend.
Other highlights:
- Performance improvements: more efficient transaction forwarding between peers, mempool snapshots that stay fast as the mempool grows, and quicker Plutus script validation.
- Initial network and consensus support for Peras. This is off by default, behind the experimental
NodeToNodeV_16protocol version. - Continued groundwork on the Dijkstra era.
- New methods in the experimental gRPC/UTxO-RPC interface (
ReadTip,FollowTip,ReadGenesis,SearchUtxos,evalTx);FetchBlocknow returns full transactions. - A reworked
cardano-cli pingthat accepts multiple targets and DNS SRV records (CIP-0155). cardano-tracerdrops the discontinued RTView component; its opt-in metrics API now follows the Prometheus wire format.- The OCI images for
cardano-node,cardano-tracerandcardano-submit-apican now run as a non-root user and/or on a read-only filesystem. - The Mithril signer binary is now included in the
x86_64-linuxrelease tarball.
Known issues
- There is a slight increase in memory usage compared to node version
11.0.1when syncing, but significantly less than the regression in 11.1.0. Full details - There is a small increase in memory usage compared to node version
11.0.1when on tip, which correlates with taking ledger snapshots. (Full details published in release benchmark report; link see below).
Breaking changes
cardano-rpc contains a number of breaking changes.
Release Benchmarks
Benchmarking reports relevant to the 11.1.1 release can be found in this post on Cardano Updates.
System Testing
System testing results for the 11.1.1 release can be found on the corresponding tag testing page.
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
- Pre-release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
Documentation
- Cardano Node documentation
- The operators handbook may also be helpful for general queries.
- Networking options and related changes are listed on the topology section
- 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
cardano-node
- The legacy tracing system was removed along with the legacy tracing configuration. See #6580 for a comprehensive list of config keys that disappeared, as well as links to "New Tracing Quick Start".
- The cardano-node OCI image now supports a read-only root filesystem and non-root execution. See
nix/docker/README.mdfor details. - The cardano-node OCI entrypoint fixes
climode being dispatched after theNETWORKmodes. - The mithril signer binary was added to the
x86_64-linuxrelease binary tarball - The cardano-node NixOS service options
useNewTopology,lmdbDatabasePathandwithUtxoHdLmdbwere removed. P2P is the only networking mode, souseNewTopologyno longer had an effect, and the LMDB UTxO-HD backend was dropped. Configurations still setting any of these will fail to evaluate. - The cardano-node NixOS service added
blsKeysfor optional Leios BLS key support, andprofilingOutputDirto place GHC RTS profiling output on a writable path. RTS stats stay enabled by default, while the heavier profiling and eventlog outputs are now gated, for both node and tracer services.
cardano-tracer
- The
cardano-tracerOCI image now supports a read-only root filesystem and non-root execution. Seenix/docker/README.mdfor details. - The
cardano-tracerOCI image no longer aborts underset -ewhenCARDANO_MIN_LOG_SEVERITYis unset. - Timeseries query endpoints are now closely aligned with Prometheus wire format:
- URL-encoded form for POST; URL query string for GET
- response JSON aligned with Prometheus conventions
- New timeseries endpoints for querying connected nodes, node info, node startup info and node sync progress
- Full removal of discontinued RTView component
- NB: The metrics timeseries store and HTTP API are still disabled by default and require an explicit opt-in in cardano-tracer's config file
cardano-submit-api
- The
cardano-submit-apiOCI image now supports a read-only root filesystem and non-root execution. Seenix/docker/README.mdfor details. - The
cardano-submit-apiNixOS service added ametricsPortoption, passed through to the OCI image. The service definition was updated for the new tracing configuration and now uses a group-accessible node socket. - The
cardano-submit-apiprometheus metrics now default to a new tracing system prefix ofcardano_submit_api_metrics_. For legacy behavior with no metrics prefix, remove theTraceOptionMetricsPrefixfrom the submit-api config file.
cardano-testnet
No changes.
cardano-cli
- New
cardano-cli ping: multiple targets, DNS resolution, SRV records (CIP-0155), unix sockets, and--mode ping|tip|query(breaking, feature) pingCLI reshuffle: positionalADDRSreplaces--host/--port/--unixsock;--magicrenamed--network-magic; new--srv-prefix,--color,--short-hash;-hnow only means--help(breaking, feature)genesis create/create-staked/create-testnet-datawrite initial funds, pools, delegations, and DReps into the newextraConfiggenesis field, leaving deprecated top-level fields empty (breaking)--pool-relay-portis now required with--single-host-pool-relay(breaking)stake-pool registration-certificategains opt-in--validate-relaysreachability check (feature)- Add
--key-output-bech32/--key-output-text-envelopeto governance key-gen commands (feature, compatible) - Migrate the friendly tx renderer onto
Exp.SignedTx/Exp.UnsignedTx;debug transaction viewandtransaction viewnow only acc...
11.1.0
Release Notes
Node version 11.1.0 is a pre-release version of cardano-node that is not yet recommended for use on mainnet. It includes a number of performance improvements and general enhancements, and prepares the way for the Dijkstra-era hard fork. It also completes the removal of the legacy tracing system ("iohk-monitoring-framework"): the new tracing system is now the only one included, and configurations still using legacy keys must be migrated (see the New Tracing Quick Start and PR 6580 for the list of removed config keys).
This release also removes the V1 LedgerDB and the LMDB storage backend, and makes ledger snapshots predictable and Mithril-compatible, so snapshots are comparable and shareable across nodes. LMDB users must switch storage backend.
Other highlights:
- Performance improvements: more efficient transaction forwarding between peers, mempool snapshots that stay fast as the mempool grows, and quicker Plutus script validation.
- Initial network and consensus support for Peras. It's off by default, behind the experimental
NodeToNodeV_16protocol version. - Continued groundwork on the Dijkstra era.
- New methods in the experimental gRPC/UTxO-RPC interface (
ReadTip,FollowTip,ReadGenesis,SearchUtxos,evalTx);FetchBlocknow returns full transactions. - A reworked
cardano-cli pingthat accepts multiple targets and DNS SRV records (CIP-0155). cardano-tracerdrops the discontinued RTView component; its opt-in metrics API now follows the Prometheus wire format.- The OCI images for
cardano-node,cardano-tracerandcardano-submit-apican now run as a non-root user and/or on a read-only filesystem. - The Mithril signer binary is now included in the
x86_64-linuxrelease tarball.
Known issues
- There is a 12% increase in memory usage compared to node version
11.0.1when loading genesis files with large amounts of preseeded data on testnets. Mainnet is not affected.
Release Benchmarks
Benchmarking reports relevant to the 11.1.0 release can be found in this post on Cardano Updates.
System Testing
System testing results for the 11.1.0 release will be uploaded after the pre-release stage.
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
- Pre-release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
Documentation
- Cardano Node documentation
- The operators handbook may also be helpful for general queries.
- Networking options and related changes are listed on the topology section
- 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 | N/A |
| Performance Engineer | N/A |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
cardano-node
- The legacy tracing system was removed along with the legacy tracing configuration. See #6580 for a comprehensive list of config keys that disappeared, as well as links to "New Tracing Quick Start".
- The cardano-node OCI image now supports a read-only root filesystem and non-root execution. See
nix/docker/README.mdfor details. - The cardano-node OCI entrypoint fixes
climode being dispatched after theNETWORKmodes. - The mithril signer binary was added to the
x86_64-linuxrelease binary tarball - The cardano-node NixOS service options
useNewTopology,lmdbDatabasePathandwithUtxoHdLmdbwere removed. P2P is the only networking mode, souseNewTopologyno longer had an effect, and the LMDB UTxO-HD backend was dropped. Configurations still setting any of these will fail to evaluate. - The cardano-node NixOS service added
blsKeysfor optional Leios BLS key support, andprofilingOutputDirto place GHC RTS profiling output on a writable path. RTS stats stay enabled by default, while the heavier profiling and eventlog outputs are now gated, for both node and tracer services.
cardano-tracer
- The cardano-tracer OCI image now supports a read-only root filesystem and non-root execution. See
nix/docker/README.mdfor details. - The cardano-tracer OCI image no longer aborts under
set -ewhenCARDANO_MIN_LOG_SEVERITYis unset. - Timeseries query endpoints are now closely aligned with Prometheus wire format:
- URL-encoded form for POST; URL query string for GET
- response JSON aligned with Prometheus conventions
- New timeseries endpoints for querying connected nodes, node info, node startup info and node sync progress
- Full removal of discontinued RTView component
- NB: The metrics timeseries store and HTTP API are still disabled by default and require an explicit opt-in in cardano-tracer's config file
cardano-submit-api
- The cardano-submit-api OCI image now supports a read-only root filesystem and non-root execution. See
nix/docker/README.mdfor details. - The cardano-submit-api NixOS service added a
metricsPortoption, passed through to the OCI image. The service definition was updated for the new tracing configuration and now uses a group-accessible node socket. - The cardano-submit-api prometheus metrics now default to a new tracing system prefix of
cardano_submit_api_metrics_. For legacy behavior with no metrics prefix, remove theTraceOptionMetricsPrefixfrom the submit-api config file.
cardano-testnet
No changes.
cardano-cli
- New
cardano-cli ping: multiple targets, DNS resolution, SRV records (CIP-0155), unix sockets, and--mode ping|tip|query(breaking, feature) pingCLI reshuffle: positionalADDRSreplaces--host/--port/--unixsock;--magicrenamed--network-magic; new--srv-prefix,--color,--short-hash;-hnow only means--help(breaking, feature)genesis create/create-staked/create-testnet-datawrite initial funds, pools, delegations, and DReps into the newextraConfiggenesis field, leaving deprecated top-level fields empty (breaking)--pool-relay-portis now required with--single-host-pool-relay(breaking)stake-pool registration-certificategains opt-in--validate-relaysreachability check (feature)- Add
--key-output-bech32/--key-output-text-envelopeto governance key-gen commands (feature, compatible) - Migrate the friendly tx renderer onto
Exp.SignedTx/Exp.UnsignedTx;debug transaction viewandtransaction viewnow only accept Conway and Dijkstra files, pre-Conway fails withDeprecatedEra(breaking, refactoring) - Remove deprecated
--update-proposal-filefrom era-basedtransaction build/build-raw(kept incompatiblecommands) (breaking)
11.0.1
Release Notes
Node 11.0.1 is the first release to support the PV11 intra-era hard fork, enabling the upgrade to protocol version 11 once the hard fork governance action has been voted on by the SPOs, DReps, and the Constitutional Committee and enacted on chain. The release also bumps cardano-api and cardano-cli to their 11.0 series and advances the experimental hard fork target to protocol version 12. This release also adds HTTPS support for EKG and Prometheus metric servers in cardano-tracer, along with a new timeseries store exposed via REST API.
For linux, liburing, protobuf-compiler and snappy-c are new dependencies since node version 10.7. These support e.g. the new LSM capabilities.
Known issues
- When using the LSM storage backend,
cardano-nodecannot read blocks with more than 4096 items due to a bug in blockio-uring. This issue already has a fix that will be included into the next release. - When using the LSM storage backend,
cardano-nodecould crash due to howghchandles system threads. This only happens on resource-constrained devices such as the Raspberry Pi. The fix will be shipped in the next release. - When using the LSM storage backend, the CPU idle time is reported as
iowait. This is not a performance or correctness issue, but it may be confusing. The fix will be shipped in the next release. - The cardano-submit-api OCI image had an update published to fix a configuration bug and is link below.
Release Benchmarks
Benchmarking reports relevant to the 11.0.1 release can be found in this post on Cardano Updates.
System Testing
System testing results for the 10.7.1 release can be found on the corresponding tag testing page.
Node version 11.0.1 will be uploaded later today.
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
- Release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
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
cardano-node
cardano-tracer
cardano-testnet
cardano-cli
cardano-api
cardano-rpc
Network
Consensus
Ledger
Plutus
Tracing
Detailed Changelogs
Package changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| acts-generic | 0.1.1.0 | CHANGELOG.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| basement | 0.0.16 | |
| bech32 | 1.1.10 | ChangeLog.md |
| bech32-th | 1.1.10 | ChangeLog.md |
| byron-spec-chain | 1.0.1.1 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.1 | CHANGELOG.md |
| cardano-addresses | 4.0.2 | ChangeLog.md |
| cardano-api | 11.0.0.0 | CHANGELOG.md |
| cardano-base | 0.1.3.0 | CHANGELOG.md |
| cardano-binary | 1.8.0.0 | CHANGELOG.md |
| cardano-cli | 11.0.0.0 | CHANGELOG.md |
| cardano-crypto | 1.3.0 | |
| cardano-crypto-class | 2.3.2.0 | [CHANGELOG.md](https://github.com/IntersectMBO/cardano-base/blo... |
10.7.1
Release Notes
Node version 10.7.1 is a minor update to the Cardano node that includes a number of fixes and improvements to the Plutus and Consensus layers, as well as to the tracing system. This version of the node addresses a number of performance issues that were found in node version 10.7.0.
For linux, liburing, protobuf-compiler and snappy-c are new dependencies.
Known issues
Release Benchmarks
Benchmarking reports relevant to the 10.7.1 releases can be found in this post on Cardano Updates.
System Testing
System testing results for the 10.7.1 release can be found on the corresponding tag testing page.
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
- Release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
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
cardano-node
- Bulk credentials handling was fixed (#6502)
cardano-tracer
- Support for TLS encrypted HTTPS connections to endpoints. To use that, the config needs to provide a
"tlsCertificate": {}object and set the optional field"epForceSSL": trueon individualhas*endpoints. For a detailed example, seecardano-tracer's Changelog. - Experimental: New (optional)
hasTimeseriesendpoint. By configuring this,cardano-tracerwill maintain an internal timeseries store for all connected Nodes' metrics. The store can be queried via the/timeseries/querypath,POSTing the query as plain UTF8 text. Query examples can be found in folderbench/cardano-timeseries-io/examples; the query language is heavily inspired byPromQL.
cardano-testnet
cardano-cli
cardano-api
cardano-rpc
Network
Consensus
- Significantly improve mempool performance: transaction differences are cached the first time the transaction is validated, and re-used when revalidating the mempool on forging and syncing with the LedgerDB.
- Fix directory management in LSM-trees snapshot conversion.
- Ignore exceptions when deleting a snapshot.
Ledger
Plutus
- Added
ScriptContextBuildertest utility (PlutusLedgerApi.Test.ScriptContextBuilder) toplutus-ledger-api-testlibfor constructing realisticScriptContextvalues in tests using a composable builder pattern. - Improved the performance and testing of the
flatlibrary. - Improved the performance of
writeBits. - Improved the
uplcexecutable: it now supports taking contract blueprints as input (#7685), and configuring optimization options (#7682).
Tracing
- Exposed some
PrometheusSimplebackend DoS protection parameters in the Node config (see example below). All of those fields are optional and will selectively override the hard-coded default. - The
ChainDB.AddBlockEvent.SwitchedToAForktrace message now contains a"reason"field stating why a chain fork was chosen. Example messages in #6014 . - New
rpc.request.*metrics denoting the timespan for evaluating gRPC methods. - Performance optimizations for evaluation of some metrics.
Example:
"TracePrometheusSimpleRun": {
"connCountGlobal": 20,
"connCountPerHost": 8,
"connPerSecond": 10.0,
"connTimeout": 30
}
Detailed Changelogs
Package changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| acts-generic | 0.1.1.0 | CHANGELOG.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| basement | 0.0.16 | |
| bech32 | 1.1.10 | ChangeLog.md |
| bech32-th | 1.1.10 | ChangeLog.md |
| byron-spec-chain | 1.0.1.1 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.1 | CHANGELOG.md |
| cardano-addresses | 4.0.2 | ChangeLog.md |
| cardano-... |
10.6.4
Release Notes
IMPORTANT If you're building from source you must upgrade to libblst 0.3.14.
Node version 10.6.4 is a minor update to the Cardano node that includes a numbers of fixes and improvements to the Plutus interpreter. It is recommended that all SPOs upgrade to it.
Known issues
- Old tracing system: The new metrics counting soft and hard mempool timeouts are missing the common node metrics prefix
cardano.node.metrics. - Syncing mainnet from genesis is about 20% slower than on 10.6.1.
Release Benchmarks
Benchmarking reports relevant to the 10.6.4/10.6.3/10.6.2 releases can be found in this post on Cardano Updates.
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
- Release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
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
cardano-node
cardano-tracer
cardano-testnet
cardano-cli
cardano-api
Network
Consensus
Plutus
- Added
ScriptContextBuildertest utility (PlutusLedgerApi.Test.ScriptContextBuilder) toplutus-ledger-api-testlibfor constructing realisticScriptContextvalues in tests using a composable builder pattern. - Improved the performance and testing of the
flatlibrary. - Improved the performance of
writeBits. - Improved the
uplcexecutable: it now supports taking contract blueprints as input (#7685), and configuring optimization options (#7682).
Detailed Changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| basement | 0.0.16 | |
| bech32 | 1.1.10 | ChangeLog.md |
| bech32-th | 1.1.10 | ChangeLog.md |
| byron-spec-chain | 1.0.1.1 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.1 | CHANGELOG.md |
| cardano-addresses | 4.0.2 | ChangeLog.md |
| cardano-api | 10.23.0.0 | CHANGELOG.md |
| cardano-binary | 1.7.2.0 | CHANGELOG.md |
| cardano-cli | 10.15.0.0 | CHANGELOG.md |
| cardano-crypto | 1.3.0 | |
| 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](https://github.com/IntersectMBO/cardano-ledger/blob/faa7a9dc347697b1... |
10.6.3
Release Notes
IMPORTANT If you're building from source you must upgrade to libblst 0.3.14.
Node version 10.6.3 is a minor update to the Cardano node that includes an updated CHaP configuration for those users who are building from source. It is otherwise identical to node version 10.6.2.
Known issues
- Old tracing system: The new metrics counting soft and hard mempool timeouts are missing the common node metrics prefix
cardano.node.metrics. - Syncing mainnet from genesis is about 20% slower than on 10.6.1.
Release Benchmarks
Benchmarking reports relevant to the 10.6.3/10.6.2 releases can be found in this post on Cardano Updates.
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
- Release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
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
cardano-node
cardano-tracer
cardano-testnet
cardano-cli
cardano-api
Network
Consensus
Plutus
Detailed Changelogs
Package changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| basement | 0.0.16 | |
| bech32 | 1.1.10 | ChangeLog.md |
| bech32-th | 1.1.10 | ChangeLog.md |
| byron-spec-chain | 1.0.1.1 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.1 | CHANGELOG.md |
| cardano-addresses | 4.0.2 | ChangeLog.md |
| cardano-api | 10.23.0.0 | CHANGELOG.md |
| cardano-binary | 1.7.2.0 | CHANGELOG.md |
| cardano-cli | 10.15.0.0 | CHANGELOG.md |
| cardano-crypto | 1.3.0 | |
| 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.8.0.0 | CHANGELOG.md |
10.7.0
Release Notes
Node version 10.7.0 contains a number of major improvements, and also includes internal changes that will be enacted by the forthcoming hard fork to Protocol Version 11 in a future node version. A key change is that introduces the LSM Tree backend for storage layer that delivers the UTxO-HD OnDisk storage backend. This is enabled by a new LSM (Log-Structured Merge) tree implementation in Consensus (LedgerDB V2) that replaces the previous LMDB backend. Operators running with the OnDisk backend now require only 8GB of RAM, compared to 24GB for the InMemory backend. The new backend is capable of tracking table sizes and uses versioned on-disk encoding (TablesCodecVersion1). Additional highlights include KES Agent support for improved operational key security, the first experimental release of cardano-rpc (a gRPC/UTxO-RPC interface), dmq-node and kes-agent binaries added to the release, TLS/SSL support for EKG/Prometheus in cardano-tracer, and support for a protocol minor version bump.
Local root changes:
- Local root peers can be configured with a new boolean field
behindFirewall(falseis the default). - For
Trustablelocal root peers,Chain-Syncwon't timeout in theStNext StMustReplystate (e.g. awaiting for a header announcement).
Note: This release requires a full chain replay due to the introduction of versioned ledger table encoding.
Breaking changes
- Chain replay required: Versioned ledger table encoding (
TablesCodecVersion1) alters on-disk serialisation forLedgerStateandExtLedgerState. Upgrading from any prior release requires a full chain replay. - cardano-api:
submitTxToNodeLocalnow returnsTxSubmitResultinstead ofSubmitResult TxValidationErrorInCardanoMode. Network-level errors no longer escape as exceptions; see the API changelog for details.
Known issues
- There is a known issue with increased memory use when testing with large numbers of DReps
- The new
behindFirewallfield for local root peers is not reflected in the log file (IntersectMBO/ouroboros-network#5343). - The node option
--bulk-credentials-filedoes not correctly process bulk credentials - For custom networks using
ExperimentalHardForksEnabled, a dijkstra genesis file will need to be added to the node config.
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, M3, M4 or M5) processor
- 24GB of RAM when running with the
InMemorybackend, 8GB when running with theOnDiskbackend - 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.7
- Cabal 3.8/3.12
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
- Pre-release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
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 | N/A |
| Performance Engineer | N/A |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
Node
-
Configuration of LedgerDB:
V1InMemoryvariant removed,V2LSMvariant added (with optionalFilePath). -
New config fields:
TxSubmissionLogicVersion(defaultV1) andTxSubmissionInitDelayparsed from node config JSON, forwarded toRunNodeArgs. -
Node feature flags added to
RunNodeArgs, for now always initialised asrnFeatureFlags = mempty. -
New
KESSourcetype:KESKeyFilePath FilePath | KESAgentSocketPath FilePath. -
ProtocolFilepaths.shelleyKESFilereplaced byshelleyKESSource :: Maybe KESSource. -
CLI offers
--shelley-kes-keyor--shelley-kes-agent-socket.
Tracing
- The
trace-dispatcherpackage was moved to a standalone repository, see https://github.com/IntersectMBO/hermod-tracing. - All P2P tracing orphan instances (
TracePeerSelection,DebugPeerSelection,PeerSelectionCounters,ConnectionManagerTrace,
InboundGovernorTrace,ServerTrace, etc.) moved upstream intoouroboros-network:tracingandcardano-diffusion:tracing. dtDebugPeerSelectionInitiatorTraceranddtDebugPeerSelectionInitiatorResponderTracermerged into a singledtDebugPeerSelectionTracer.TraceTxSubmissionCollectednow carries[txid]instead ofInt; new constructorsTraceTxInboundAddedToMempool,TraceTxInboundRejectedFromMempool,TraceTxInboundError,TraceTxInboundDecision.- The types related to the network topology (
NetworkTopology/LocalRootPeersGroup/PublicRootPeers/RootConfig) were moved tocardano-diffusion, seeCardanoNetworkTopologyfromCardano.Network.Diffusion.Topology. - Dijkstra era stubs:
LogFormatting/ToObjectinstances added for Dijkstra ledger predicate failures (allerror "Dijkstra era is not active yet").
Consensus
- Peras Protocol Integration: Major foundational work was added for the Peras protocol, including the introduction of
PerasCertDB, Peras voting APIs, and a shift in chain selection to prioritize Peras weight over chain length when enabled. - LedgerDB V2 and LSM-Trees: The new LedgerDB V2 was implemented featuring an LSM-trees backend (capable of tracking table sizes) and the extraction of backend storage logic into dedicated sub-libraries (
ouroboros-consensus-lsm,ouroboros-consensus-lmdb). - Mempool Timeouts and Tracking: The mempool was significantly upgraded to support execution timeouts (
MempoolTimeoutConfig) and track how much monotonic clock time transactions take to validate (DiffTimeMeasure). - Enhanced Chain Selection Tracing: Chain selection was refactored to explicitly carry and emit a
ReasonForSwitch(e.g., length, weight, or tiebreaker) in traces likeAddedToCurrentChainandSwitchedToAFork. - Networking and Protocol Updates: Node-to-Client protocols were bumped to
NodeToClientV_23, introducing queries likeGetLedgerPeerSnapshotand adding crucial size limits for keep-alive servers and peer-sharing clients. - Transaction and Serialization Changes: The codebase adapted to Ledger's nested transaction levels and changes in
ApplyTxErrorserialization. It also introducedtxWireSizeto accurately measure CBOR-encoded transaction sizes over the network. - Critical Memory and Resource Fixes: Numerous patches addressed resource management, fixing double read lock acquisitions, leaky handles in LedgerDB, and ensuring proper garbage collection of
ProtocolInfoandLedgerDbArgs. - Codebase Consolidation: Several previously standalone libraries (including
diffusion,protocol,cardano,lsm, andlmdb) were absorbed directly into theouroboros-consensuspackage to streamline the architecture. - Ledger Table Versioning: Ledger tables encoding was versioned (
TablesCodecVersion1), altering on-disk serialization forLedgerStateandExtLedgerState, which will require a chain replay.
Ledger
- Finished impleme...
10.6.2
Release Notes
IMPORTANT If you're building from source you must upgrade to libblst 0.3.14.
Node version 10.6.2 expands Plutus capabilities, adding major new features — Array, Value, modular exponentiation, BLS12-381 multi-scalar multiplication, dropList, case analysis on built-in types, among others — all of which will become available in protocol version 11. These features significantly enhance smart contract expressiveness and performance. This release also strengthens node stability and networking by introducing defensive mempool protections, fixing a potential deadlock, adding mempool timeouts with new EKG metrics, and refining chain-sync and outbound governor behavior. Tracing and monitoring are improved, cardano-testnet behavior is refined, the CLI gains transaction fee estimation and updated stake address output (this is a breaking change), and the cardano-api introduces a new ledger-aligned TxBodyContent type with related cleanups and fixes.
The release artifacts for 10.6.2 now include linux and darwin arm64 variants and use an updated artifact naming scheme to accommodate the new artifacts. The OCI images for cardano-node, cardano-tracer and cardano-submit-api now include an arm64 variant. Pulling the usual container via tag will auto-select the appropriate architecture for your system. The utilities db-{analyser,synthesizer,truncater} have been added to the cardano-node container.
Breaking changes
- updated stake address output
Known issues
- Old tracing system: The new metrics counting soft and hard mempool timeouts are missing the common node metrics prefix
cardano.node.metrics. - Syncing mainnet from genesis is about 20% slower than on 10.6.1.
Release Benchmarks
Benchmarking reports relevant to the 10.6.2 release can be found in this post on Cardano Updates.
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
- Release configuration files
- Docker Images: cardano-node, cardano-tracer, cardano-submit-api
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
cardano-node
- Added soft and hard timeouts to mempool (IntersectMBO/ouroboros-consensus#1831)
- Added EKG metrics for soft and hard mempool timeouts (#6420)
- Improved
cardano-node --helpoutput by making it the same as the one shown when callingcardano-nodewithout arguments (#6403) - Improved consistency of traces between immdb-server and cardano-node (#6397)
- New Tracing
- Environment variable
TRACE_DISPATCHER_LOGGING_HOSTNAME, covering same functionality asCARDANO_NODE_LOGGING_HOSTNAMEin the legacy system (#6429) - Increased
PrometheusSimplerobustness: Restart backend upon crash; add start/stop traces and more eagerly reap dangling sockets (#6396) - Adjusted config for tracing system (#6401)
- Environment variable
- Remove
peersFromNodeKernelmetric andNodeKernelPeerstracer as well asTraceOptionPeerFrequencyconfig key (#6387)
cardano-tracer
cardano-testnet
cardano-cli
Main changes
-
Print estimated transaction fee in
transaction build-estimate
(feature)
PR 1325 -
Modified
query stake-address-infoto include the correct CIP129 hex format as well as the Ledger State format.
(breaking change)
PR 1313
Bug fixes
-
create-testnet-data: use the same k for byron and shelley genesis
(bugfix)
PR 1318 -
Improved error message for malformed timestamps
(bugfix)
PR 1324 -
Upgrade cardano-crypto-class-2.2.3.2 with hashes deserialisation fix
(compatible, bugfix)
PR 1310 -
Fixed error message in readStringOfMaxLength to correctly display the actual maximum length parameter instead of hardcoded value "128"
(bugfix)
PR 1297 -
Updated
cardano-ledger-apito fix bug inqueryPoolState, where current Pool parameters were returned instead of the future ones.
(bugfix)
PR 1298
cardano-api
Main changes
-
In order to move away from the "old" api's
TxBodyContentthat utilizes the "eon" abstractions and somewhat
unnecessarily wrapped data definitions, we introduced a newTxBodyContenttype that aims to be closer to the
ledger's type definitions and therefore easier to use.
(feature)
PR 1011 -
Deprecated "old" certificate api helper functions and introduced equivalent functions exposed by:
Cardano.Api.Compatible.Certificate
Cardano.Api.Experimental.Certificate
(feature, breaking, refactoring)
PR 983 -
Replace
CertificateinTxCertificateswith new api'sCertificatetype.
(breaking)
PR 962 -
Renamed throwErrorAsException to throwErrorM
(breaking)
PR 1032
Bug fixes
- Made canonicalisation functionality does work with CBOR maps in CBOR lists
(bugfix)
[PR 1047](https://github.com/I...