Skip to content

Releases: IntersectMBO/cardano-node

Release list

11.0.1

11.0.1 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 May 16:47
11.0.1
This tag was signed with the committer’s verified signature.
johnalotoski John A. Lotoski
GPG key ID: 2C353A4D69521E8D
Verified
Learn about vigilant mode.
97036a6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.

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

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

10.7.1

10.7.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 15 Apr 21:39
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.

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

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

10.6.4

10.6.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Apr 18:21
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.

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

10.6.3

Choose a tag to compare

View all tags
@coot coot released this 01 Apr 19:10
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.

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

10.7.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 25 Mar 16:17
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.

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

10.6.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Feb 18:15
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.

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

10.5.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Feb 16:32
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.

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

10.6.1 Pre-release
Pre-release

Choose a tag to compare

View all tags
@CarlosLopezDeLara CarlosLopezDeLara released this 02 Dec 10:01
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.

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

10.5.3

Choose a tag to compare

View all tags
@github-actions github-actions released this 21 Nov 16:08
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.

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

10.5.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 21 Nov 02:57
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.

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