11.2.1

Release Notes

Node version 11.2.1 is a pre-release version of cardano-node that is not yet recommended for use on mainnet. It is a maintenance release on top of 11.2.0. It updates to ouroboros-consensus 5.4, cardano-api 11.12 and cardano-cli 11.7, which together reduce the node's memory use around ledger snapshots, and it raises the protocol version the node advertises in block headers to 11.3.

For the full set of 11.2 changes (the new cardano-config configuration format, gRPC over HTTP/2, the removal of node-to-client versions below NodeToClientV_23, and more), see the 11.2.0 release notes.

Highlights:

• Lower memory use. Writing a ledger snapshot no longer temporarily grows live memory by about the snapshot's size. The ChainDB also no longer keeps the genesis ledger state alive, which saves several hundred MiB on networks with a large genesis UTxO or delegation set.
• Faster snapshots while syncing. Until the node has first caught up, ledger snapshots are written as soon as they are requested. The randomised snapshot delay applies only after that.
• LSM is supported for block production. The UTxO-HD LSM has been confirmed to meet Praos performance guarantees for block production.
• Network configurations: the maximum ledger snapshot delay (Storage.LedgerDB.Snapshots.MaxDelay) is capped at 1 hour on all networks (down from 6 hours on mainnet and preprod).
• The block header protocol version is bumped from 11.1 to 11.3.
• The node no longer crashes when writing traces to stdout fails (for example a closed pipe or an encoding error).

It is recommended to test the LSM backend in a safe environment before deployment in a block producer, and to allow at least 8GB of RAM.

Known issues

Breaking changes

There are no breaking changes for node operators in 11.2.1.

Breaking changes introduced in 11.2.0

These apply when upgrading from 11.1.x. See the 11.2.0 release notes for details.

• Configuration files: the published mainnet-config.json/.yaml (and other network configs) are in the cardano-config envelope format and are not readable by pre-11.2 nodes. Flat configurations remain supported by 11.2.1; use cardano-node config migrate to convert one.
• Docker: CARDANO_CONFIG_JSON_MERGE is a plain deep merge, so a merge document written for the flat shape silently does nothing against an enveloped config. Nest keys under Configuration.<Section> (e.g. {"Configuration":{"HermodTracing":{"TraceOptions":…}}}); see nix/docker/README.md.
• Node-to-client: NodeToClientV_16 – NodeToClientV_22 were removed, along with the queries only they could reach: GetProposedPParamsUpdates, GetStakeDistribution (use GetStakeDistribution2) and GetPoolDistr (use GetPoolDistr2).
• NixOS service: blsKeys (added in 11.1) is replaced by a single blsKey; multiple keys go in one file as a JSON array of text envelopes.
• Tracing: log consumers should note the tracing changes listed in the 11.2.0 release notes: the mempool "tx" field is now hex CBOR, the DelegAccountAlreadyRegistered failure was renamed, there are new namespaces, and the trace forwarding config changed.

Release Benchmarks

System Testing

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 InMemory backend, 8GB when running with the OnDisk backend (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 protocol version the node advertises in block headers is bumped from 11.1 to 11.3. (#6767)
• Network configurations: the maximum randomised ledger snapshot delay (Storage.LedgerDB.Snapshots.MaxDelay) is capped at one hour (3600s). On mainnet and preprod it was 6 hours (21600s); on preview and sanchonet it was 4320s. MinDelay and Interval are unchanged. (#6767, iohk-nix#624)
• Updated to ouroboros-consensus 5.4, cardano-api 11.12 and cardano-cli 11.7. See the Consensus section for the memory improvements. (#6767)

cardano-tracer

No changes.

cardano-submit-api

• Updated to cardano-api 11.12 and cardano-cli 11.7. (#6767)

cardano-testnet

• New status command that reports the state of a testnet created with cardano-testnet, in human-readable form or as JSON with --json. The JSON output has a schema, checked in CI. (#6741)
• Starting a testnet can no longer hang forever while waiting for a node to start. (#6750)
• The --output-dir help now gives the real default (./testnet) and says the directory must not already contain a testnet. (#6752)
• Updated to cardano-api 11.12 and cardano-cli 11.7. (#6767)

cardano-cli

Updated to cardano-cli 11.7.0.0:

• New dijkstra stake-pool bls-registration-certificate offline: takes an existing pool registration certificate and writes a new one with only the BLS key and its proof of possession replaced. Use it to register a pool's BLS key for the first time or rotate it, without re-entering pool parameters. Accepts certificates from the Conway era and from earlier cardano-cli versions.
• New `debug certificate vie...

11.2.0

Release Notes

Node version 11.2.0 is a pre-release version of cardano-node that is not yet recommended for use on mainnet. Its headline change is the move to the new cardano-config library for reading node configuration: the node now understands a versioned configuration "envelope" alongside the existing flat format, and the configuration files published for each network are now in the envelope format. It also extends the gRPC interface, continues the groundwork for the Dijkstra era, Leios and Peras, and fixes several operator-facing bugs.

Highlights:

• New configuration format. Configurations are read through cardano-config.
  • Existing flat configurations still work.
  • The new envelope format ($schema / Version / MinNodeVersion / Configuration) is schema-validated.
  • New cardano-node config migrate, cardano-node config schema and cardano-node config resolve subcommands convert, describe and check a configuration.
  • The shipped network configs are now enveloped and cannot be read by nodes older than 11.2.
• gRPC over HTTP/2. The gRPC server can now listen on a TCP address/port, in plaintext (h2c) or with TLS (--grpc-listen-address/--grpc-listen-port, --grpc-tls-*), instead of only a unix socket.
• New gRPC methods ReadMempool, WatchMempool and ReadEraSummary, plus server reflection.
• Node-to-client versions older than NodeToClientV_23 are no longer supported. Clients (wallets, indexers, tools) must be built against a version of the network libraries that speaks NodeToClientV_23 (shipped since node 10.7.0).
• Ledger snapshots are now taken by default every 40 * k slots with no offset (once a day on mainnet).
• The node traces the resolved snapshot policy at startup, and warns if it is implausible for the network's slot length.
• Continued Dijkstra-era work:
  • cardano-cli supports sub-transactions and guard credentials.
  • cardano-submit-api accepts Dijkstra transactions.
  • The CIP-0168 Plutus builtins have a cost model.
• Groundwork for Leios and Peras (off by default).

Known issues

Breaking changes

• Configuration files: the published mainnet-config.json/.yaml (and other network configs) are in the cardano-config envelope format and are not readable by pre-11.2 nodes. Flat configurations remain supported by 11.2.0; use cardano-node config migrate to convert one.
• Docker: CARDANO_CONFIG_JSON_MERGE is a plain deep merge, so a merge document written for the flat shape silently does nothing against an enveloped config. Nest keys under Configuration.<Section> (e.g. {"Configuration":{"HermodTracing":{"TraceOptions":…}}}); see nix/docker/README.md.
• Node-to-client: NodeToClientV_16 – NodeToClientV_22 were removed, along with the queries only they could reach: GetProposedPParamsUpdates, GetStakeDistribution (use GetStakeDistribution2) and GetPoolDistr (use GetPoolDistr2).
• NixOS service: blsKeys (added in 11.1) is replaced by a single blsKey; multiple keys go in one file as a JSON array of text envelopes.
• Tracing: log consumers should note the changes listed in the "Tracing" changelog below (mempool "tx" field is now hex CBOR, renamed DelegAccountAlreadyRegistered failure, new namespaces; trace forwarding config change).
• cardano-cli: node issue-pop-BLS and node key-hash-BLS were removed. Proof-of-possession is built into stake-pool registration-certificate --bls-signing-key-file.
• cardano-cli: --script-valid/--script-invalid were removed from the Dijkstra transaction build* commands (Conway unaffected).

Release Benchmarks

System Testing

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 InMemory backend, 8GB when running with the OnDisk backend (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 node reads its configuration through cardano-config. Two dialects are understood: the legacy flat format (read by both the node's own parser and cardano-config, with any divergence reported as a non-fatal warning) and the new cardano-config envelope, resolved by cardano-config alone. New subcommands cardano-node config migrate, cardano-node config schema and cardano-node config resolve (the latter also reports divergences between the two parsers for a flat config). (#6677)
• The shipped network configurations were refreshed for the 11.2 series and moved to the envelope format. Release tarballs ship the enveloped config. (#6677)
• mainnet-config.yaml drops LastKnownBlockVersion-* and is no longer readable by a pre-11.2 node. (#6677)
• The gRPC server can listen over HTTP/2 instead of only a unix socket: --grpc-listen-address/--grpc-listen-port (config RpcListenAddress/RpcListenPort), and TLS via --grpc-tls-certificate/--grpc-tls-private-key/--grpc-tls-chain-certificate. Conflicting or incomplete combinations are rejected at parse time. (#6668)
• Standard handles now always use UTF-8, independent of the system code page or locale. On Windows, stdout traces were written in the legacy code page, so JSON lines were not valid UTF-8, and characters outside that code page (e.g. in a non-ASCII host name or TraceOptionNodeName) crashed the node at startup. The same crash happened on Linux under a non-UTF-8 locale such as LC_ALL=C. (#6711)
• Tracing changes visible to log consumers, now that the consensus tracing instances are used instead of the node's own copy:
  • mempool rejections always carry errdetails;
  • the detailed "tx" field of mempool traces is now the CBOR in hex;
  • new namespaces Mempool.CapacityChanged, Snapshot.ConfiguredSnapshotPolicy, Snapshot.ImplausibleSnapshotPolicy, RPC.SubmitService.ReadMempool.Span and `RPC.SubmitServi...

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.1 when 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.1 when 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 InMemory backend, 8GB when running with the OnDisk backend (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 optimise no longer accepts the --certify and --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.1 when 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.1 when 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 InMemory backend, 8GB when running with the OnDisk backend (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_16 protocol version.
• Continued groundwork on the Dijkstra era.
• New methods in the experimental gRPC/UTxO-RPC interface (ReadTip, FollowTip, ReadGenesis, SearchUtxos, evalTx); FetchBlock now returns full transactions.
• A reworked cardano-cli ping that accepts multiple targets and DNS SRV records (CIP-0155).
• cardano-tracer drops the discontinued RTView component; its opt-in metrics API now follows the Prometheus wire format.
• The OCI images for cardano-node, cardano-tracer and cardano-submit-api can 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-linux release tarball.

Known issues

• There is a slight increase in memory usage compared to node version 11.0.1 when 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.1 when 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 InMemory backend, 8GB when running with the OnDisk backend (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.md for details.
• The cardano-node OCI entrypoint fixes cli mode being dispatched after the NETWORK modes.
• The mithril signer binary was added to the x86_64-linux release binary tarball
• The cardano-node NixOS service options useNewTopology, lmdbDatabasePath and withUtxoHdLmdb were removed. P2P is the only networking mode, so useNewTopology no 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 blsKeys for optional Leios BLS key support, and profilingOutputDir to 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.md for details.
• The cardano-tracer OCI image no longer aborts under set -e when CARDANO_MIN_LOG_SEVERITY is 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.md for details.
• The cardano-submit-api NixOS service added a metricsPort option, 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 the TraceOptionMetricsPrefix from 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)
• ping CLI reshuffle: positional ADDRS replaces --host/--port/--unixsock; --magic renamed --network-magic; new --srv-prefix, --color, --short-hash; -h now only means --help (breaking, feature)
• genesis create/create-staked/create-testnet-data write initial funds, pools, delegations, and DReps into the new extraConfig genesis field, leaving deprecated top-level fields empty (breaking)
• --pool-relay-port is now required with --single-host-pool-relay (breaking)
• stake-pool registration-certificate gains opt-in --validate-relays reachability check (feature)
• Add --key-output-bech32/--key-output-text-envelope to governance key-gen commands (feature, compatible)
• Migrate the friendly tx renderer onto Exp.SignedTx/Exp.UnsignedTx; debug transaction view and transaction view now 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_16 protocol version.
• Continued groundwork on the Dijkstra era.
• New methods in the experimental gRPC/UTxO-RPC interface (ReadTip, FollowTip, ReadGenesis, SearchUtxos, evalTx); FetchBlock now returns full transactions.
• A reworked cardano-cli ping that accepts multiple targets and DNS SRV records (CIP-0155).
• cardano-tracer drops the discontinued RTView component; its opt-in metrics API now follows the Prometheus wire format.
• The OCI images for cardano-node, cardano-tracer and cardano-submit-api can 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-linux release tarball.

Known issues

• There is a 12% increase in memory usage compared to node version 11.0.1 when 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 InMemory backend, 8GB when running with the OnDisk backend (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.md for details.
• The cardano-node OCI entrypoint fixes cli mode being dispatched after the NETWORK modes.
• The mithril signer binary was added to the x86_64-linux release binary tarball
• The cardano-node NixOS service options useNewTopology, lmdbDatabasePath and withUtxoHdLmdb were removed. P2P is the only networking mode, so useNewTopology no 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 blsKeys for optional Leios BLS key support, and profilingOutputDir to 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.md for details.
• The cardano-tracer OCI image no longer aborts under set -e when CARDANO_MIN_LOG_SEVERITY is 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.md for details.
• The cardano-submit-api NixOS service added a metricsPort option, 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 the TraceOptionMetricsPrefix from 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)
• ping CLI reshuffle: positional ADDRS replaces --host/--port/--unixsock; --magic renamed --network-magic; new --srv-prefix, --color, --short-hash; -h now only means --help (breaking, feature)
• genesis create/create-staked/create-testnet-data write initial funds, pools, delegations, and DReps into the new extraConfig genesis field, leaving deprecated top-level fields empty (breaking)
• --pool-relay-port is now required with --single-host-pool-relay (breaking)
• stake-pool registration-certificate gains opt-in --validate-relays reachability check (feature)
• Add --key-output-bech32/--key-output-text-envelope to governance key-gen commands (feature, compatible)
• Migrate the friendly tx renderer onto Exp.SignedTx/Exp.UnsignedTx; debug transaction view and transaction view now only accept Conway and Dijkstra files, pre-Conway fails with DeprecatedEra (breaking, refactoring)
• Remove deprecated --update-proposal-file from era-based transaction build/build-raw (kept in compatible commands) (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-node cannot 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-node could crash due to how ghc handles 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 InMemory backend, 8GB when running with the OnDisk backend (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-HD please 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
• 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 InMemory backend, 8GB when running with the OnDisk backend (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-HD please 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
• 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": true on individual has* endpoints. For a detailed example, see cardano-tracer's Changelog.
• Experimental: New (optional) hasTimeseries endpoint. By configuring this, cardano-tracer will maintain an internal timeseries store for all connected Nodes' metrics. The store can be queried via the /timeseries/query path, POSTing the query as plain UTF8 text. Query examples can be found in folder bench/cardano-timeseries-io/examples; the query language is heavily inspired by PromQL.

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 ScriptContextBuilder test utility (PlutusLedgerApi.Test.ScriptContextBuilder) to plutus-ledger-api-testlib for constructing realistic ScriptContext values in tests using a composable builder pattern.
• Improved the performance and testing of the flat library.
• Improved the performance of writeBits.
• Improved the uplc executable: it now supports taking contract blueprints as input (#7685), and configuring optimization options (#7682).

Tracing

• Exposed some PrometheusSimple backend 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.SwitchedToAFork trace 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 InMemory backend, 8GB when running with the OnDisk backend (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-HD please 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
• 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 ScriptContextBuilder test utility (PlutusLedgerApi.Test.ScriptContextBuilder) to plutus-ledger-api-testlib for constructing realistic ScriptContext values in tests using a composable builder pattern.
• Improved the performance and testing of the flat library.
• Improved the performance of writeBits.
• Improved the uplc executable: it now supports taking contract blueprints as input (#7685), and configuring optimization options (#7682).

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](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 InMemory backend, 8GB when running with the OnDisk backend (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-HD please 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
• 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 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