Skip to content

Releases: IntersectMBO/cardano-node

10.7.1

15 Apr 21:39
@github-actions github-actions
10.7.1
This tag was signed with the committer’s verified signature.
disassembler Samuel Leathers
GPG key ID: FFD741455081B713
Verified
Learn about vigilant mode.
045bc18
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
10.7.1 Latest
Latest

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.

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

Documentation

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-api 10.26.0.0 CHANGELOG.md ...
Read more
Assets 8
Loading

10.6.4

14 Apr 18:21
@github-actions github-actions
10.6.4
This tag was signed with the committer’s verified signature.
disassembler Samuel Leathers
GPG key ID: FFD741455081B713
Verified
Learn about vigilant mode.
5a4dcd1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
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

Documentation

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...
Read more
Loading

10.6.3

01 Apr 19:10
@coot coot
10.6.3
e252ede
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
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

Documentation

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
Read more
Loading

10.7.0

25 Mar 16:17
@github-actions github-actions
10.7.0
This tag was signed with the committer’s verified signature.
disassembler Samuel Leathers
GPG key ID: FFD741455081B713
Verified
Learn about vigilant mode.
1e6d822
This commit was signed with the committer’s verified signature.
disassembler Samuel Leathers
GPG key ID: FFD741455081B713
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
10.7.0 Pre-release
Pre-release

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 (false is the default).
  • For Trustable local root peers, Chain-Sync won't timeout in the StNext StMustReply state (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 for LedgerState and ExtLedgerState. Upgrading from any prior release requires a full chain replay.
  • cardano-api: submitTxToNodeLocal now returns TxSubmitResult instead of SubmitResult 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 behindFirewall field for local root peers is not reflected in the log file (IntersectMBO/ouroboros-network#5343).
  • The node option --bulk-credentials-file does 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 InMemory backend, 8GB when running with the OnDisk backend
  • 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

Documentation

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: V1InMemory variant removed, V2LSM variant added (with optional FilePath).

  • New config fields: TxSubmissionLogicVersion (default V1) and TxSubmissionInitDelay parsed from node config JSON, forwarded to RunNodeArgs.

  • Node feature flags added to RunNodeArgs, for now always initialised as rnFeatureFlags = mempty.

  • New KESSource type: KESKeyFilePath FilePath | KESAgentSocketPath FilePath.

  • ProtocolFilepaths.shelleyKESFile replaced by shelleyKESSource :: Maybe KESSource.

  • CLI offers --shelley-kes-key or --shelley-kes-agent-socket.

Tracing
  • The trace-dispatcher package 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 into ouroboros-network:tracing and cardano-diffusion:tracing.
  • dtDebugPeerSelectionInitiatorTracer and dtDebugPeerSelectionInitiatorResponderTracer merged into a single dtDebugPeerSelectionTracer.
  • TraceTxSubmissionCollected now carries [txid] instead of Int; new constructors TraceTxInboundAddedToMempool, TraceTxInboundRejectedFromMempool, TraceTxInboundError, TraceTxInboundDecision.
  • The types related to the network topology (NetworkTopology/LocalRootPeersGroup/PublicRootPeers/RootConfig) were moved to cardano-diffusion, see CardanoNetworkTopology from Cardano.Network.Diffusion.Topology.
  • Dijkstra era stubs: LogFormatting/ToObject instances added for Dijkstra ledger predicate failures (all error "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 like AddedToCurrentChain and SwitchedToAFork.
  • Networking and Protocol Updates: Node-to-Client protocols were bumped to NodeToClientV_23, introducing queries like GetLedgerPeerSnapshot and 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 ApplyTxError serialization. It also introduced txWireSize to 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 ProtocolInfo and LedgerDbArgs.
  • Codebase Consolidation: Several previously standalone libraries (including diffusion, protocol, cardano, lsm, and lmdb) were absorbed directly into the ouroboros-consensus package to streamline the architecture.
  • Ledger Table Versioning: Ledger tables encoding was versioned (TablesCodecVersion1), altering on-disk serialization for LedgerState and ExtLedgerState, which will require a chain replay.
Ledger
  • Finished impleme...
Read more
Loading

10.6.2

12 Feb 18:15
@github-actions github-actions
10.6.2
This tag was signed with the committer’s verified signature.
johnalotoski John A. Lotoski
GPG key ID: 2C353A4D69521E8D
Verified
Learn about vigilant mode.
0d697f1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
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 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

Documentation

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 --help output by making it the same as the one shown when calling cardano-node without arguments (#6403)
  • Improved consistency of traces between immdb-server and cardano-node (#6397)
  • New Tracing
    • Environment variable TRACE_DISPATCHER_LOGGING_HOSTNAME, covering same functionality as CARDANO_NODE_LOGGING_HOSTNAME in the legacy system (#6429)
    • Increased PrometheusSimple robustness: Restart backend upon crash; add start/stop traces and more eagerly reap dangling sockets (#6396)
    • Adjusted config for tracing system (#6401)
  • Remove peersFromNodeKernel metric and NodeKernelPeers tracer as well as TraceOptionPeerFrequency config key (#6387)
cardano-tracer
  • Support Prometheus HTTP Service Discovery (#6377)
  • RTView: Removed monitoring based on the NodePeers datapoint (#6422)
cardano-testnet
  • Made cardano-testnet remain running until stopped (#6405)
  • Made cardano-testnet exit earlier when cardano-node fails on startup (#6408)
cardano-cli

Main changes

  • Print estimated transaction fee in transaction build-estimate
    (feature)
    PR 1325

  • Modified query stake-address-info to 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-api to fix bug in queryPoolState, 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 TxBodyContent that utilizes the "eon" abstractions and somewhat
    unnecessarily wrapped data definitions, we introduced a new TxBodyContent type 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 Certificate in TxCertificates with new api's Certificate type.
    (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...
Read more
Loading

10.5.4

06 Feb 16:32
@github-actions github-actions
10.5.4
This tag was signed with the committer’s verified signature.
johnalotoski John A. Lotoski
GPG key ID: 2C353A4D69521E8D
Verified
Learn about vigilant mode.
b0a1259
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
10.5.4

Release Notes

IMPORTANT If you're building from source you must upgrade to libblst 0.3.14.

This release provides a number of important enhancements to the networking layer that will improve node resilience and robustness. It is recommended that all SPOs upgrade to this version. The main changes are:

  1. A checkpoint file has been added to the preview configuration for genesis mode syncing.

  2. More robust diffusion layer:

  • Enforce maximum number of reconnection attempts by the outbound governor.
  • Shorten the timeout when waiting for chain-sync to terminate.
  • Increase chain-sync timeout in the StNext StMustReply state to a random value between ~10mins and ~15mins (it used to be between ~2.5mins and ~5mins).
  • Fixed outbound governor bootstrap action.

Benchmarking reports relevant to the 10.5.4 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 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

Documentation

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

Network

Detailed Changelogs

Package changelogs
Package Version Changelog
Win32-network 0.2.0.1 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.1 CHANGELOG.md
byron-spec-ledger 1.1.0.1 CHANGELOG.md
cardano-api 10.16.4.0 CHANGELOG.md
cardano-binary 1.7.2.0 CHANGELOG.md
cardano-cli 10.11.0.0 CHANGELOG.md
cardano-crypto-class 2.2.3.2 CHANGELOG.md
cardano-crypto-praos 2.2.1.1 CHANGELOG.md
cardano-crypto-test 1.6.0.0 CHANGELOG.md
cardano-crypto-tests 2.2.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.6.1.0 CHANGELOG.md
cardano-data 1.2.4.1 CHANGELOG.md
cardano-git-rev 0.2.2.1
cardano-ledger-allegra 1.7.0.0 CHANGELOG.md
cardano-ledger-alonzo 1.13.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.3.1.0 CHANGELOG.md
cardano-ledger-api 1.11.0.0 CHANGELOG.md
cardano-ledger-babbage 1.11.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.3.1.0 CHANGELOG.md
cardano-ledger-binary 1.6.0.0 CHANGELOG.md
cardano-ledger-byron 1.1.0.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.2.1 [CHANGELOG.md](https://g...
Read more
Loading

10.6.1

02 Dec 10:01
@CarlosLopezDeLara CarlosLopezDeLara
10.6.1
This tag was signed with the committer’s verified signature.
CarlosLopezDeLara Carlos LopezDeLara
SSH Key Fingerprint: tcaIXCJt1udI6OLTY3c3FQsQ0s83NcJqCFa8lUuHPEc
Verified
Learn about vigilant mode.
0c220b2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
10.6.1 Pre-release
Pre-release

IMPORTANT If you're building from source you must upgrade to libblst 0.3.14.

** This version includes the hot fix in cardano-crypto-class addressing an issue with hash sizes**

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 or M4) 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

Documentation

Sign-off

Role Approval
Technical Steering Committee (Intersect) 🟢
Product Committee (Intersect) 🟢
Test Engineer N/A
Performance Engineer 🟢
Site Reliability Engineer N/A
Release Engineer 🟢
Legend
  • 🟢 - signed / agreed / supported
  • 🟥 - not agreed / unsupported

Detailed Changelogs

Package changelogs
Package Version Changelog
Win32-network 0.2.0.1 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.1 CHANGELOG.md
byron-spec-ledger 1.1.0.1 CHANGELOG.md
cardano-api 10.19.1.0 CHANGELOG.md
cardano-binary 1.7.2.0 CHANGELOG.md
cardano-cli 10.13.1.0 CHANGELOG.md
cardano-crypto-class 2.2.3.2 CHANGELOG.md
cardano-crypto-praos 2.2.1.1 CHANGELOG.md
cardano-crypto-test 1.6.0.0 CHANGELOG.md
cardano-crypto-tests 2.2.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.6.1.0 CHANGELOG.md
cardano-data 1.2.4.1 CHANGELOG.md
cardano-git-rev 0.2.2.1
cardano-ledger-allegra 1.8.0.0 CHANGELOG.md
cardano-ledger-alonzo 1.14.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.4.0.0 CHANGELOG.md
cardano-ledger-api 1.12.1.0 CHANGELOG.md
cardano-ledger-babbage 1.12.0.0 CHANGELOG.md
cardano-ledger-binary 1.7.0.0 CHANGELOG.md
cardano-ledger-byron 1.2.0.0 CHANGELOG.md
cardano-ledger-conway 1.20.0.0 CHANGELOG.md
cardano-ledger-core 1.18.0.0 CHANGELOG.md
cardano-ledger-dijkstra 0.1.0.0 CHANGELOG.md
cardano-ledger-mary 1.9.0.0 CHANGELOG.md ...
Read more
Loading

10.5.3

21 Nov 16:08
@github-actions github-actions
10.5.3
6c034ec
This commit was signed with the committer’s verified signature.
disassembler Samuel Leathers
GPG key ID: FFD741455081B713
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
10.5.3

IMPORTANT If you're building from source you must upgrade to libblst 0.3.14.

This is a bugfix release addressing an issue with hash sizes and an issue in the networking stack concerning peer selection. In the diffusion layer under some conditions, the periodic churn mechanism may not meet its design intent and fail to demote sufficiently many warm peers. In turn, further sampling of active peers from this pool may not be sufficiently diverse over longer time frames.

This networking deficiency was discovered with cardano-ignite: a tool for managing Cardano testnets with multiple stake pools distributed across different simulated regions.

All node users running versions 10.3.1 through 10.5.1, including SPOs, must upgrade to this version promptly.

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 or M4) 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; Mint 20, 21, 21.1, 21.2, 21.3, 22, 22.1; Debian 11, 12)
  • Windows 64-bit (10, 11)
  • MacOS 10.15, 11 (Big Sur), 12 (Monterey), 13 (Ventura), 14 (Sonoma), 15 (Sequioa)
GHC/Cabal supported versions
  • GHC 9.6
  • Cabal 3.8/3.12
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign-off

Role Approval
Technical Steering Committee (Intersect) 🟢
Product Committee (Intersect) 🟢
Test Engineer 🟢
Performance Engineer 🟢
Site Reliability Engineer 🟢
Release Engineer 🟢

Note: all checkmarks weren't available, but we deemed it worth publishing so SPOs stuck on preview could start upgrading.

Legend
  • 🟢 - signed / agreed / supported
  • 🟥 - not agreed / unsupported
Loading

10.5.2

21 Nov 02:57
@github-actions github-actions
10.5.2
1ec98e9
This commit was signed with the committer’s verified signature.
disassembler Samuel Leathers
GPG key ID: FFD741455081B713
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
10.5.2

This is a bugfix release addressing an issue with hash sizes and an issue in the networking stack concerning peer selection. In the diffusion layer under some conditions, the periodic churn mechanism may not meet its design intent and fail to demote sufficiently many warm peers. In turn, further sampling of active peers from this pool may not be sufficiently diverse over longer time frames.

This networking deficiency was discovered with cardano-ignite: a tool for managing Cardano testnets with multiple stake pools distributed across different simulated regions.

All node users running versions 10.3.1 through 10.5.1, including SPOs, must upgrade to this version promptly.

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 or M4) 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; Mint 20, 21, 21.1, 21.2, 21.3, 22, 22.1; Debian 11, 12)
  • Windows 64-bit (10, 11)
  • MacOS 10.15, 11 (Big Sur), 12 (Monterey), 13 (Ventura), 14 (Sonoma), 15 (Sequioa)
GHC/Cabal supported versions
  • GHC 9.6
  • Cabal 3.8/3.12
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign-off

Role Approval
Technical Steering Committee (Intersect) 🟢
Product Committee (Intersect) 🟢
Test Engineer 🟢
Performance Engineer 🟢
Site Reliability Engineer 🟢
Release Engineer 🟢

Note: all checkmarks weren't availabe, but we deemed it worth publishing so SPOs stuck on preview could start upgrading.

Legend
  • 🟢 - signed / agreed / supported
  • 🟥 - not agreed / unsupported

Detailed Changelogs

Package changelogs
Package Version Changelog
Win32-network 0.2.0.1 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.1 CHANGELOG.md
byron-spec-ledger 1.1.0.1 CHANGELOG.md
cardano-api 10.16.3.0 CHANGELOG.md
cardano-binary 1.7.2.0 CHANGELOG.md
cardano-cli 10.11.0.0 CHANGELOG.md
cardano-crypto-class 2.2.3.2 CHANGELOG.md
cardano-crypto-praos 2.2.1.1 CHANGELOG.md
cardano-crypto-test 1.6.0.0 CHANGELOG.md
cardano-crypto-tests 2.2.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.6.1.0 CHANGELOG.md
cardano-data 1.2.4.1 CHANGELOG.md
cardano-git-rev 0.2.2.1
cardano-ledger-allegra 1.7.0.0 CHANGELOG.md
cardano-ledger-alonzo 1.13.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.3.1.0 CHANGELOG.md
cardano-ledger-api 1.11.0.0 CHANGELOG.md
cardano-ledger-babbage 1.11.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.3.1.0 CHANGELOG.md
cardano-ledger-binary 1.6.0.0 CHANGELOG.md
cardano-ledger-byron 1.1.0.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.2.1 CHANGELOG.md
cardano-ledger-conway ...
Read more
Loading

10.6.0

18 Nov 17:56
@github-actions github-actions
10.6.0
f5ac0eb
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
10.6.0 Pre-release
Pre-release

Cardano Node version 10.6.0

IMPORTANT: This release has been superseded. Please skip version 10.6.0 entirely and upgrade directly to version 10.6.1

This release initiates the deprecation of the legacy tracing system, removes the legacy networking stack and introduces foundational work for two placeholder hard forks: a new Plutus Version (V4) via an intra-era hard fork (Protocol Version 11), and the new Dijkstra era (Protocol Version 12).

Tracing Systems:

  • Deprecation Notice: Node version 10.6.0 starts the deprecation window for the legacy tracing system in favor of the new tracing system.
  • Both the legacy and the new tracing systems are bundled in this release and will coexist temporarily.
  • The legacy tracing system will be completely decommissioned in a future release following this deprecation window.
  • For an overview of design and configuration changes, please see New Tracing: Quick Start
  • Adjusting monitoring to allow for changes in metric names will be required as a one-off effort. For details, please see New Tracing: Metrics Migration

Networking:

  • Implemented support for DNS SRV records, which provide a mechanism for exposing decentralised protocols co-deployed with a Cardano node, such as Mithril or Hydra. SPOs who wish to register their cardano-node stake pool via this facility may do so by prefixing their domain with _cardano._tcp. eg. _cardano._tcp.<SPO_DOMAIN_NAME> or for the upcoming DMQ node for Mithril under _dmq._mithril._cardano._tcp.<SPO_DOMAIN_NAME>. See CIP-0155 for details and current SRV registry.
  • When operating in relay mode and with Ouroboros Genesis enabled (configuration key ConsensusMode = GenesisMode, the default on preview/preprod, optional on mainnet), the node emits a warning when a ledger peer snapshot (key peerSnapshotFile in the topology file) is not specified or the file is missing. When Ouroboros Genesis becomes the mainnet default in a future release (possibly as early as 10.7), the peer snapshot file will be mandatory and the node will fail to start if it is not provided. It is recommended that SPOs run at least one of their non-block producing relays in GenesisMode.
  • Non-P2P mode is no longer available and has been dropped.

Benchmarking reports relevant to the 10.6.0-pre release can be found in this post on Cardano Updates.

Breaking changes

API & CLI Changes (Breaking): The cardano-api module structure underwent a major refactor according to ADR-009, resulting in extensive module renames (PR). Other breaking changes include using raw bytes instead of CBOR for CIP-129 identifier serialisation (PR) and modifications to the stake-address-info CLI command output (PR).

Networking: Support for the legacy Non-P2P stack has been removed in this release.

Known issues

There is a known issue with increased memory use when testing with large numbers of DReps

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

Documentation

Sign-off

Role Approval
Technical Steering Committee (Intersect) 🟢
Product Committee (Intersect) 🟢
Test Engineer N/A
Performance Engineer N/A
Site Reliability Engineer N/A
Release Engineer 🟢
Legend
  • 🟢 - signed / agreed / supported
  • 🟥 - not agreed / unsupported

Changelogs

Node
  • The bundled release configuration files are now provided as config.json which uses the new tracing system, and config-legacy.json which uses the legacy tracing system.
  • There is no longer a separate configuration file for block producers and non-block producers. Node will automatically assign PeerSharing, TargetNumberOfKnownPeers and TargetNumberOfRootPeers configuration parameters based on forging status. These can still be explicitly declared.
  • The EnableP2P parameter is no longer declared in the configuration file as p2p is now the only network operating mode.
  • The bundled release peer snapshot files are now included for all environments (mainnet, preview, preprod) at version 2, v2.
  • There is a new container for cardano-tracer. See the docker README.md for information.
  • cardano-submit-api configs were added to the binary release artifacts.
Tracing
  • Trace / metrics forwarding now supports connection over TCP (in addition to Unix domain sockets or Windows named pipes).
  • Failure to initialise the PrometheusSimple backend is now lenient - i.e., won't cause the Node to abort.
  • Improved structure and metadata of autogenerated trace documentation.
  • Fixed CPU resource tracing on MacOS (Darwin).
  • New KES Agent tracer (namespace Consensus.KESAgent).
  • New DNS tracer (namespace Net.DNS).
  • New churn mode tracer (namespace Net.PeerSelection.ChurnMode).
  • Canonicalized diffusion tracers to namespaces Net.Mux.{Local|Remote}.{Bearer|Channel}.
  • Several renames in the ChainDB.LedgerEvent.Flavor.V2, Consensus.GSM and Net.Peers.Ledger traces.
  • Fixed block replay tracer.
  • Removed non-P2P diffusion tracer.
  • For an exhaustive list of trace messages and metrics implemented in a particular Node build, please run the cardano-node trace-documentation CLI command.
Consensus
  • Added ShelleyNodeToClientVersion14 which adds SRV support in GetBigLedgerPeerSnapshot query.
  • Added CardanoNodeToClientVersion18 which maps to ShelleyNodeToClientVersion14.
  • Define new Node-To-Client versions CardanoNodeToClientVersion17, ShelleyNodeToClientVersion13.
  • Deprecate GetPoolDistr in favor of GetPoolDistr2 (new in NodeToClientV_21).
  • Deprecate GetStakeDistribution in favor of GetStakeDistribution2 (new in NodeToClientV_21).
  • Expose new query GetMaxMajorProtocolVersion as a Shelley query, for getting the max known protocol version for a node.
  • Return full map instead of emp...
Read more
Loading