Skip to content

Releases: IntersectMBO/cardano-node

10.4.1

30 Apr 16:52
10.4.1
420c94f
Compare
Choose a tag to compare

Node 10.4.1 integrates UTxO-HD into the Cardano node. UTxO-HD is a rework of the Consensus layer of the node which allows the UTxO set to be stored either fully in-memory (as with previous node versions) or else on some external storage medium (e.g. SSD or HD). The latter lowers the memory requirements of the running node at the cost of some speed. This first version of UTxO-HD provides an LMDB backend, but future releases will incorporate a more fine-tailored backend based on LSM trees. More information on UTxO-HD can be found in the consensus website.

This release also provides fixes and enhancements to the tracing system, to the location of LedgerDB configuration options, and to the node CLI and API. It also updates the dependency on Plutus to 1.45.

System testing results for the 10.4.1 release can be found on the corresponding tag testing page.

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

Important

Users migrating from a previous version of the node should read the migration guide to properly configure the node and convert the database such that a replay from genesis can be avoided. Mainnet block producers and associated relays should only use the V2InMemory UTXO-HD backend.

This version of the node is mainnet ready. It is recommended for production use using the in-memory backend only.

Warning

The LMDB backend has not yet been benchmarked. While it may provide sufficient performance for edge nodes (wallets, explorers, exchanges etc.) at a valuable reduction in memory usage, it should not be used for block producer or relay nodes on mainnet.

Known Issues

There is a known bug with the experimental Ouroboros Genesis feature that is not yet recommended for mainnet use.
ChainSync Jumping (CSJ) is not disabled once a node is caught up. This should not affect normal operation of the syncing node, but does risk a DoS attack for the caught-up node. It will be corrected in a future release (Issue IntersectMBO/ouroboros-consensus#1490).

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 18.04 LTS, 20.04 LTS, 22.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 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

Node
  • Relocate configuration options related to the LedgerDB under a new "LedgerDB" key in the configuration file. See Consensus' webpage for more information.
Tracing
  • New tracing: fix the following faulty metrics: connectionManager_*, slotsMissed.

  • Old Tracing: rename metric connectionManager.prunableConns to connectionManager.fullDuplexConns for incerased consistency.

  • Reworded human description of some traces to be more explanatory.

  • Relocate LedgerDB related traces under the LedgerEvent namespace.

Consensus
  • Release UTxO-HD rework. For more information check the webpage.
  • Decrease the maximum permissible clock skew from 5s to 2s.
Ledger
  • No changes
Network
  • No changes
CLI
  • Corrected the flipped text & JSON output format for query stake-pools command.
    (bugfix)
    PR 1139

  • Make the output format flag for the query utxo command only have one default: JSON (rather than a different default depending on whether the output file is specified).
    (breaking, refactoring)
    PR 1133

  • Add canonical CBOR output toggle for transaction building and signing commands.
    (feature, compatible)
    PR 1092

API
  • Better reporting of negative balance in transaction balancing.
    (breaking, refactoring, bugfix)
    PR 799

  • Add outputs, fromShelleyUTxO and toShelleyUTxO functions to Cardano.Api.Tx.UTxO.
    (compatible)
    PR 812

Submit API
  • No changes
Plutus
  • No changes

Detailed Changelogs

Individual packages' 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.0 CHANGELOG.md
byron-spec-ledger 1.1.0.0 CHANGELOG.md
cardano-api 10.14.1.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 10.8.0.0 CHANGELOG.md
cardano-crypto-wrapper 1.6.0.0 CHANGELOG.md
cardano-crypto-test 1.6.0.0 CHANGELOG.md
cardano-crypto-praos 2.2.1.0...
Read more

10.3.1

17 Apr 12:51
10.3.1
b3f237b
Compare
Choose a tag to compare

Node 10.3.1 primarily improves on performance: it improves execution speed, reduces memory usage and gives faster synchronisation times. In addition, it provides several enhancements to the new tracing system. It also provides support for light-weight checkpointing that is needed to enable ouroboros-genesis. Finally, it includes bug-fixes for a number of CLI commands. The docker images for node and submit-api have also received improvements to streamline operations.

System testing results for the 10.3.1 release can be found on the corresponding tag testing page.

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

Known Issues

  • New tracing system: connectionManager_* metrics are incorrect; the underlying trace message ConnectionManagerCounters however logs the correct values.

  • New tracing system: slotsMissed metric is incorrect; it falsely counts slots since the most recent block production as missed. However, the block producer does not actually miss a slot.

  • GenesisMode: the optional peerSnapshotFile declaration in the topology file interprets relative paths with respect to node's binary directory rather than the topology file directory.

  • There is a known bug with the experimental Ouroboros Genesis feature that is not yet recommended for mainnet use.
    ChainSync Jumping (CSJ) is not disabled once a node is caught up. This should not affect normal operation of the syncing node, but does risk a DoS attack for the caught-up node. It will be corrected in a future release (Issue IntersectMBO/ouroboros-consensus#1490).

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
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS, 22.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 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

Node
  • Update the default compiler version from 8.10.x to 9.6.x.

  • Add ForkPolicy to the configuration (this is an experimental option for network behaviour)

  • Optionally support light-weight check-pointing for ouroboros-genesis.

  • Tracing

    • New PrometheusSimple backend which runs a simple TCP server for direct exposition of metrics, without forwarding, under the URL /metrics.
    • New maxReconnectDelay config option in TraceOptionForwarder: Specifies maximum delay (seconds) between (re-)connection attempts of a forwarder (default: 60s).
    • Fix: change semantics of several Forge.* metrics to counters - to match semantics of legacy tracing.
    • Fix: correct blockdelay_cdf* metric
    • Fix: correct blockReplayProgress metric
    • Optimizations to trace + metrics forwarding, aimed at reducing CPU usage when under low / idle load.
  • Docker

    • Add baseline network configuration references for the node image
    • Add a new merge mode for the node image
    • Reduce default path inconsistencies within and between the node and submit-api images
    • Improve documentation
    • Implemented in PR#6110 where breaking changes are also noted
Consensus
  • Queries and mini-protocols
    • Removed legacy {HardForkSpecific,Shelley,Cardano}NodeToClientVersions and related code.
    • Export new function querySupportedVersions. For this, add method blockQueryIsSupportedOnVersion to BlockSupportsLedgerQuery.
    • Use NodeToClientV_20.
      • Expose new query QueryStakePoolDefaultVote.
      • Query GetProposedPParamsUpdates has been deprecated and is not supported in ShelleyNodeToClientV12 (NodeToClientV_20).
  • Tracers
    • Added a new CSJ tracer to ChainSync client interface.
    • Renamed the existing tracer in Ouroboros.Consensus.Node.Tracers.Tracers.
    • Added peer sharing tracer to NTN tracers.
  • Renaming and relocation
    • Move Ouroboros.Consensus.Cardano.ByronHFC to Ouroboros.Consensus.Byron.ByronHFC.
  • Expose blockchain time as getBlockchainTime :: BlockchainTime m in the NodeKernel
  • Deprecate the StandardX type aliases for eras.
Ledger
  • Removed crypto-parametrization from ledger eras, which finally allowed us to avoid regression in ghc-9 and stop using ghc-8.10.7 for building cardano-node releases.
  • Improve performance of ledger snapshot creation by changing how we serialize UTxO in the ledger state. This should sove an issue with missed leadership checks due to snapshot creation problem ouroboros-consensus#868
  • Add cli to plutus-debug executable and provide ability for overridding different parts used for script execution.
  • Much cleanup, re-organization of the code and various minor performance optimizations
Network
  • keep-alive mini-protocol receiver is always (re)started, when we receive traffic on any other node-to-node mini-protocol
  • experimental option which binds mini-protocol threads to lower capabilities, leaving two capabilities free for other threads

Link to the development tracker

CLI
  • Bump cardano-api to include bug fixes for:

    • Silently dropping simple scripts in transaction construction
    • Not selecting the highest protocol version in a given era. This resulted in erroneous plutus script decoding failures.

    (compatible, bugfix)
    PR 1127

  • Bump to cardano-api-10.13.0.0 - Fix bug in the construction of the redeemer pointer map
    (bugfix)
    PR 1124

  • Delete top level babbage command group
    (breaking)
    PR 1117

  • Source import of the vary package
    (feature)
    PR 1121

  • Bumped ledger and dependencies for node 10.3 release.

    • Removed use of parameterised crypto (EraCrypto c, this enables many other data types to become mono-morphic over StandardCrypto)
    • Added query stake-pool-default-vote
    • Ensured security parameter is non-zero
      (breaking, feature)
      PR 1075
  • Add a new query for stake-pool default vote
    (feature, release)
    PR 1081

  • Delete top-level shelley command group and delete associated tests
    (breaking)
    PR 1111

  • Parallelised help golden test generation and validation
    (optimisation)
    PR 1103

  • Added support for mnemonic sentence generation and extended key derivation from mnemonic sentences.
    (feature)
    [PR 975](https://github.com/...

Read more

10.2.1

19 Feb 23:23
52b708f
Compare
Choose a tag to compare

Node 10.2.1 provides support for the new tracing system and an initial integration of Ouroboros Genesis, a new feature which enables nodes to bootstrap from the network. It also provides a number of bug fixes and enhancements, including fixes and improvements to a number of CLI commands.

Benchmarking reports relevant to the 10.2.x release series can be found in this post on Cardano Updates.

Limitations

Note that lightweight checkpoints are not integrated into node 10.2.1, so it is recommended to only use Ouroboros Genesis for testing purposes (on e.g. Preview or PreProd) and not on Mainnet.

Known Issues

There is a known bug with the experimental Ouroboros Genesis feature that is not yet recommended for mainnet use.
ChainSync Jumping (CSJ) is not disabled once a node is caught up. This should not affect normal operation of the syncing node, but does risk a DoS attack for the caught-up node. It will be corrected in a future release (Issue IntersectMBO/ouroboros-consensus#1490).

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
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS, 22.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7
  • Cabal 3.8/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

Node

cardano-node

  • Ledger peer snapshot path entry added to topology JSON parser,
    which a new decoder function readPeerSnapshotFile processes
    at startup and SIGHUP. Data is available to the diffusion layer
    via TVar.

  • Configuration changes:

    • Add ConsensusMode and MinBigLedgerPeersForTrustedState
    • Add Genesis config
    • Add diffusionMode to local root peers group configuration
    • Add DoDiskSnapshotChecksum
  • Use new tracing system by default. To continue using the current system, explicitly set "UseTraceDispatcher": false in the config.

  • Change fallback node name for trace forwarding from host:port to host_port

  • Replace snap-server based web stack inside the Node with warp / wai

  • Tracing updates:

    • Add support for ChainSelStarvationEvent, ExtValidationError
    • Add support for KeepAlive protocol
    • Add support for LocalStateQuery protocol
    • Add support for UsingBigLedgerPeerSnapshot, VerifyPeerSnapshot
    • Add support for ConnectionError
    • Add support for AddNewNodeIdMapping
    • Add support for PeerFetch and PeerStarvedUs
    • Add support for SnapshotMissingChecksum
    • Add support for stateful messages
    • Add maximumKesEvolutions to InvalidKesSignatureOCERT event
    • Rename kind field of all MuxXxx trace messages to be Mux.Xxx
    • Rename fields in RotatedDynamo event to oldPeer, newPeer
    • Rename ConnectTo to Connect
    • Change format of GenesisPoint, LabelPeer, DecisionEvent
    • Change format of ConnectionManagerState
    • Change format of AddedToCurrentChain
    • Drop support for ClientAgency, ServerAgency
    • Drop support for FetchDecision declined, FetchDecision results
    • Drop support for StakeKeyInRewardsDELEG
    • Drop support for ChainSelectionForFutureBlock, BlockInTheFuture,
      CandidateContainsFutureBlocks, CandidateContainsFutureBlocksExceedingClockSkew,
      InvalidBlockReason
  • Drop NodeToClient versions 9 through 15, and add 19

  • Increase minor protocol version to 10.3

Consensus
  • Snapshots are now CRC-checksum checked (link).
  • Drop NodeToClient versions < 16 (link).
  • Remove cdbFutureBlocks as headers now will be delayed until they are no
    longer "from the future" (link).
  • Implement new bulk sync logic for BlockFetch for Genesis (link).
  • Update to typed-protocols-0.3.0.0 API and add KeepAlive tracer (link).
  • Fixed a bug where a valid tx with less than 4 bytes less than the max tx size
    would be incorrectly rejected by the mempool (link).
  • TestXxxHardForkAtVersion was removed in favor of CardanoHardForkTriggers (link).
Ledger
  • Add registered DRep stake distribution query
Network
cardano-cli

Release Notes for cardano-cli (10.2.0.0 to 10.4.0.0)

Main changes

  • Added cardano-cli latest query ledger-peer-snapshot for a snapshot of big ledger peers used when syncing in Genesis
    (feature)
    PR 727

    A new query subcommand ledger-peer-snapshot was introduced to serialize a snapshot of big ledger peers. These relays will be relied on by network layer when a node is syncing up in Genesis consensus mode, since a node may not have any or up to date information from its own ledger which are the big ledger peer relays.

  • Added the debug check-node-configuration --node-configuration-file node-config.json command
    that reads node-config.json and checks that the hashes of genesis files are correct.
    (feature)
    PR 923 based on ADR 5

  • Added anchor data hash checks to transaction build
    (feature)
    PR 951

    This version adds a built-in check that allows cardano-cli to verify anchor data linked by a transaction at the time it is being built if using the command transaction build. The cardano-cli will automatically try to download the referenced anchor data, hash it, and check the obtained hash against the one in the transaction, letting the user know if there is a mismatch.

Other features

  • Added cardano-cli conway query future-pparams
    (feature, compatible)
    PR 1038

  • Added the ratify-state query
    (feature, compatible)
    PR 1036

  • Added certificates to CLI interface in compatible transaction-sign
    (feature, compatible)
    PR 972

  • DRep ID: support key hash as input
    (compatible)
    PR 1009

  • transaction id: added --output-[json,text] flag to control format of the output
    (feature, compatible)
    [PR 1005](https...

Read more

10.1.4

07 Jan 21:32
1f63dbf
Compare
Choose a tag to compare

It is required that all Cardano stake pools and relays upgrade to this node version in order to mitigate a potential DoS attack following a hard fork to Protocol Version 10 ("Plomin" hard fork on mainnet). It is recommended that all other node users upgrade to this version. Node users who do not upgrade put themselves at risk of a potential DoS attack following the hard fork.

Node 10.1.4 is a mainnet-ready release of the Cardano node that is capable of crossing the Chang#2 ("Plomin") hard fork.
It adds safeguards at the mempool level to block specific types of transaction that could lead to a DoS attack following the hard fork.

For further details about cardano-node 10.1.4 please see the release notes for node versions 10.1.1, 10.1.2 and 10.1.3.

Benchmarking reports relevant to the 10.1.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 (M1, M2, M3 or M4) processor
  • 24GB of RAM
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7/Cabal 3.8.1.0
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign off

Role Approval
Cardano Head of Engineering 🟢
Cardano Head of Product 🟢
Test Engineer 🟢
Performance Engineer 🟢
Site Reliability Engineer 🟢
Release Engineer 🟢

Changelogs

Individual packages' changelogs Package changelogs
Package Version Changelog
Win32-network 0.2.0.0 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.0 CHANGELOG.md
byron-spec-ledger 1.0.1.0 CHANGELOG.md
cardano-api 10.1.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 10.1.1.0 CHANGELOG.md
cardano-crypto 1.1.2
cardano-crypto-class 2.1.5.0 CHANGELOG.md
cardano-crypto-praos 2.2.0.0 CHANGELOG.md
cardano-crypto-test 1.5.0.2
cardano-crypto-tests 2.1.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.3 CHANGELOG.md
cardano-data 1.2.3.1 CHANGELOG.md
cardano-git-rev 0.2.2.0
cardano-ledger-allegra 1.6.0.1 CHANGELOG.md
cardano-ledger-alonzo 1.11.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.3.0.0 CHANGELOG.md
cardano-ledger-api 1.9.4.0 CHANGELOG.md
cardano-ledger-babbage 1.10.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.3.0.0 CHANGELOG.md
cardano-ledger-binary 1.4.0.0 CHANGELOG.md
cardano-ledger-byron 1.0.1.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.2.0 CHANGELOG.md
cardano-ledger-conway 1.17.4.0 CHANGELOG.md
cardano-ledger-conway-test 1.3.0.0 CHANGELOG.md
cardano-ledger-core 1.15.0.0 [CHANGELOG.md](https://github.com/input-output-hk/cardano-ledger/blob/0ba8e73c418...
Read more

10.1.3

30 Nov 13:53
36871ba
Compare
Choose a tag to compare

This version of the node has been superseded by version 10.1.4, which has a critical fix. 10.1.3 users on Mainnet should upgrade to node version 10.1.4 prior to the Plomin (Chang#2) hard fork to avoid the risk of a potential DoS attack.

Node 10.1.3 is a mainnet-ready release of the Cardano node that is capable of crossing the Chang#2 hard fork. This update addresses a ledger issue where DRep delegations could be removed under some conditions. This inadvertently affected the ability to withdraw rewards in Protocol Version 10, and changed the stake distribution for some DReps.

For further details about cardano-node 10.1.3 please see the release notes for 10.1.1, since significant upgrades were performed compared to previous versions of the node.

Technical Specification

Minimum System Requirements
  • An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
  • Or, for MacOS, an Apple Silicon (M1, M2 or M3) processor
  • 24GB of RAM
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7/Cabal 3.8.1.0
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign off

Role Approval
Cardano Head of Engineering 🟢
Cardano Head of Product 🟢
Test Engineer 🟢
Performance Engineer 🟢
Site Reliability Engineer 🟢
Release Engineer 🟢

Changelogs

Ledger
  • Fix buggy behavior of DRep delegations #4772
Individual packages' changelogs Package changelogs
Package Version Changelog
Win32-network 0.2.0.0 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.0 CHANGELOG.md
byron-spec-ledger 1.0.1.0 CHANGELOG.md
cardano-api 10.1.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 10.1.1.0 CHANGELOG.md
cardano-crypto 1.1.2
cardano-crypto-class 2.1.5.0 CHANGELOG.md
cardano-crypto-praos 2.1.2.0 CHANGELOG.md
cardano-crypto-test 1.5.0.2
cardano-crypto-tests 2.1.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.3 CHANGELOG.md
cardano-data 1.2.3.1 CHANGELOG.md
cardano-git-rev 0.2.2.0
cardano-ledger-allegra 1.6.0.1 CHANGELOG.md
cardano-ledger-alonzo 1.11.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.3.0.0 CHANGELOG.md
cardano-ledger-api 1.9.4.0 CHANGELOG.md
cardano-ledger-babbage 1.10.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.3.0.0 CHANGELOG.md
cardano-ledger-binary 1.4.0.0 CHANGELOG.md
cardano-ledger-byron 1.0.1.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.1.1 CHANGELOG.md
cardano-ledger-conway 1.17.3.0 CHANGELOG.md
cardano-ledger-conway-test 1.3.0.0 CHANGELOG.md
cardano-ledger-core 1.15.0.0 CHANGELOG.md
cardano-ledger-mary 1.7.0.1 [CHANGELOG.md](http...
Read more

10.1.2

04 Nov 11:57
01bda2e
Compare
Choose a tag to compare

Node 10.1.2 is a mainnet release of the Cardano node that is capable of crossing the Chang#2 hard fork. This update patches cardano-cli only, and does not change the node implementation. As described here, it restores some previous top level commands that were removed in node 10.1.1 such as query tip, which are widely used by SPOs and other node users.

For further details about cardano-node 10.1.2 please see the release notes for 10.1.1, since significant upgrades were performed compared to previous versions of the node.

Technical Specification

Minimum System Requirements
  • An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
  • Or, for MacOS, an Apple Silicon (M1, M2 or M3) processor
  • 24GB of RAM
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7/Cabal 3.8.1.0
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign off

Role Approval
Cardano Head of Engineering 🟢
Cardano Head of Product 🟢
Test Engineer 🟢
Performance Engineer 🟢
Site Reliability Engineer 🟢
Release Engineer 🟢

Changelogs

Cardano-cli
  • Restore stable query cmds #955
Individual packages' changelogs
Package Version Changelog
Win32-network 0.2.0.0 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.0 CHANGELOG.md
byron-spec-ledger 1.0.1.0 CHANGELOG.md
cardano-api 10.1.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 10.1.1.0 CHANGELOG.md
cardano-crypto 1.1.2
cardano-crypto-class 2.1.5.0 CHANGELOG.md
cardano-crypto-praos 2.1.2.0 CHANGELOG.md
cardano-crypto-test 1.5.0.2
cardano-crypto-tests 2.1.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.3 CHANGELOG.md
cardano-data 1.2.3.1 CHANGELOG.md
cardano-git-rev 0.2.2.0
cardano-ledger-allegra 1.6.0.1 CHANGELOG.md
cardano-ledger-alonzo 1.11.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.3.0.0 CHANGELOG.md
cardano-ledger-api 1.9.4.0 CHANGELOG.md
cardano-ledger-babbage 1.10.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.3.0.0 CHANGELOG.md
cardano-ledger-binary 1.4.0.0 CHANGELOG.md
cardano-ledger-byron 1.0.1.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.1.1 CHANGELOG.md
cardano-ledger-conway 1.17.2.0 CHANGELOG.md
cardano-ledger-conway-test 1.3.0.0 CHANGELOG.md
cardano-ledger-core 1.15.0.0 CHANGELOG.md
cardano-ledger-mary 1.7.0.1 CHANGELOG.md
cardano-ledger-shelley 1.14.1.0 ...
Read more

10.1.1

30 Oct 16:35
4184f92
Compare
Choose a tag to compare

Node 10.1.1 is a mainnet release of the Cardano node that is capable of crossing the Chang#2 hard fork. It includes a number of improvements to the governance system, including support for SPO delegation to pre-defined voting options, and support for auto-abstain DRep votes supplanting abstaining via rewards address delegation. It also enables new Plutus primitives as defined in CIP-0122, CIP-0123, and CIP-0127. Finally it includes a number of other improvements to the ledger, CLI, API and networking code bases, as detailed below.

Note that, although staking rewards will continue to be earned as usual, in order to withdraw their rewards, following the Chang#2 hard fork, Ada holders will need to delegate to a DRep, which may be one of the pre-defined options, a single key or a Plutus v3 script. Until the hard fork, rewards may be withdrawn normally. Although following the hard fork, rewards may not be withdrawn unless a DRep is delegated to, rewards will continue to accrue to the Ada holder normally, regardless of whether or not a DRep is delegated to.

Benchmarking reports relevant to the 10.1.1 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 (M1, M2 or M3) processor
  • 24GB of RAM
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7/Cabal 3.8.1.0
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign off

Role Approval
Cardano Head of Engineering 🟢
Cardano Head of Product 🟢
Test Engineer 🟢
Performance Engineer 🟢
Site Reliability Engineer 🟢
Release Engineer 🟢

Changelogs

Node
  • Removed support for legacy P2P topology format
  • Integrates Plutus 1.36 and corresponding ledger changes
  • Removed support for NodeToNodeV_12 and earlier
Consensus
  • Add GetFuturePParams query
  • Updated N2C part of latestReleasedNodeVersion to NodeToClientV_18.
  • Updated N2N part of latestReleasedNodeVersion to NodeToNodeV_14
  • Decrease the maximum permissible clock skew from 5s to 2s.
Ledger
  • Translation of RegTxCert and UnRegTxCert to PlutusV3 scripts context will now be done correctly, which means deposit and refund respectively, will actually be translated: #4627
  • Treasury withdrawals that are empty or sum up to zero will no longer be allowed: #4630
  • Prevent non-registered return accounts for proposals' deposits and TreasuryWithdrawals #4639
  • Ensure ppuCoinsPerUTxOBytes cannot be zero: #4650
  • Ensure dreps exist prior to delegation: #4652
  • Change how SPO votes are counted: #4659
  • Disallow withdrawals to non-delegated keyhashes post-bootstrap #4555
  • Remove maxMajorPV from Globals, because it was unused: #4218
  • Fix DRep delegation invariant preservation #4709
  • Fix simultaneous withdrawal and deregistation tx #4715
Network
  • Added NodeToNodeV_14
  • Added NodeToClientV_18
Cardano-cli

Release Notes for cardano-cli-10.1.1.0

Major Changes

  • Introduce "compatible" command group
    (feature, compatible)
    PR 917
Usage: cardano-cli compatible 
                                ( shelley
                                | allegra
                                | mary
                                | alonzo
                                | babbage
                                | conway
                                )

  Limited backward compatible commands for testing only.

Available options:
  -h,--help                Show this help text

Available commands:
  shelley                  Shelley era commands
  allegra                  Allegra era commands
  mary                     Mary era commands
  alonzo                   Alonzo era commands
  babbage                  Babbage era commands
  conway                   Conway era commands

This is a group of commands predominantly exposed for our testing requirements. It paves the way to deprecate all pre-mainnet eras from cardano-cli's interface as users are interested in interacting with the current era and the upcoming era if there is a hardfork on the horizon. Note, this does not imply that prior functionality introduced in previous eras will be unavailable.

  • Large deprecation of legacy commands and removal of related code.
    (breaking)
    PR 905

We waited until after the Chang hardfork to begin refactoring cardano-cli (internal code and the external interface). This is still ongoing work but the summary of the changes are as follows:

cardano-cli - General purpose command-line utility to interact with
cardano-node. Provides specific commands to manage keys, addresses, build &
submit transactions, certificates, etc.
 Usage: cardano-cli 
-                     ( shelley
+                     ( address
+                     | key
+                     | node
+                     | query
+                     | legacy
+                     | byron
+                     | shelley
                      | allegra
                      | mary
                      | alonzo
                      | babbage
                      | conway
                      | latest
-                     | legacy
-                     | Legacy commands
-                     | byron
                      | hash
                      | ping
                      | debug commands
                      | version
+                     | compatible
                      )

Note:

  • Several of the era agnostic commands have been moved to the top level e.g key, address, node etc.

  • The majority of the legacy commands have been removed and we intend to fully remove the legacy command group in future releases.

Expect future changes to the cli's interface but note that we will be socializing proposed changes via our working group to get feedback from the community.

Features

  • Implement cddl's stake_reg_deleg_cert and vote_reg_deleg_cert and stake_vote_reg_deleg_cert as:

    • cardano-cli conway stake-address registration-and-delegation-certificate
    • cardano-cli conway stake-address registration-and-vote-delegation-certificate
    • cardano-cli conway stake-address registration-stake-and-vote-delegation-certificate
      (feature)
      PR 919
  • create-testnet-data now takes a node configuration file as input. If a file is given, it is augmented with the hashes (and paths) of the genesis files, or if the hashes/paths are present; they are checked.
    (feature, breaking)
    PR 908

  • Add anchor data hash checks to all governance action commands
    (feature, breaking, test)
    PR 915

  • Adding support for script stake credentials and stake address in create-treasury-withdrawal and improving help text. New options are: --funds-receiving-stake-script-file and --funds-receiving-stake-address
    (feature, documentation)
    [PR 914](htt...

Read more

10.1.1-pre

24 Oct 21:14
4184f92
Compare
Choose a tag to compare
10.1.1-pre Pre-release
Pre-release

Node 10.1.1-pre is a pre-release of the Cardano node that fixes a ledger issue whereby it was impossible to withdraw rewards and deregister staking credentials in the same transaction. All users running node version 10.0.0-pre or 10.1.0-pre should upgrade to this version.

Note that this version of the node is not recommended for mainnet use. It should only be deployed on test environments such as SanchoNet and Preview.

Known Issues

None

Technical Specification

Minimum System Requirements
  • An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
  • Or, for MacOS, an Apple Silicon (M1, M2 or M3) processor
  • 24GB of RAM
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7/Cabal 3.8.1.0
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign off

Role Approval
Cardano Head of Engineering 🟢
Cardano Head of Product 🟢
Test Engineer N/A for prerelease
Performance Engineer N/A for prerelease
Site Reliability Engineer N/A for prerelease
Release Engineer 🟢

Changelogs

Node

NONE

Consensus

NONE

Ledger
  • Fix simultaneous withdrawal and deregistation tx #4715
Network

NONE

Cardano-cli

NONE

Cardano-api

NONE

Submit-api

NONE

Plutus

NONE

Individual packages' changelogs
Package Version Changelog
Win32-network 0.2.0.0 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.0 CHANGELOG.md
byron-spec-ledger 1.0.1.0 CHANGELOG.md
cardano-api 10.1.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 10.1.0.0 CHANGELOG.md
cardano-crypto 1.1.2
cardano-crypto-class 2.1.5.0 CHANGELOG.md
cardano-crypto-praos 2.1.2.0 CHANGELOG.md
cardano-crypto-test 1.5.0.2
cardano-crypto-tests 2.1.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.3 CHANGELOG.md
cardano-data 1.2.3.1 CHANGELOG.md
cardano-git-rev 0.2.2.0
cardano-ledger-allegra 1.6.0.1 CHANGELOG.md
cardano-ledger-alonzo 1.11.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.3.0.0 CHANGELOG.md
cardano-ledger-api 1.9.4.0 CHANGELOG.md
cardano-ledger-babbage 1.10.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.3.0.0 CHANGELOG.md
cardano-ledger-binary 1.4.0.0 CHANGELOG.md
cardano-ledger-byron 1.0.1.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.1.1 CHANGELOG.md
cardano-ledger-conway 1.17.2.0 CHANGELOG.md
cardano-ledger-conway-test 1.3.0.0 CHANGELOG.md
cardano-ledger-core 1.15.0.0 [CHANGELOG.md](https://github.com/input-output-hk/cardano-ledger/blob/0ba8e73c41847142e0bed09e09a8aa166fc10384/libs/cardano-ledger...
Read more

10.1.0-pre

23 Oct 15:19
cf78673
Compare
Choose a tag to compare
10.1.0-pre Pre-release
Pre-release

Node 10.1.0-pre is a pre-release of the Cardano node that fixes a ledger issue concerning a sequence of actions that could result in delegating to an invalid DRep. This node also includes a number of fixes to the CLI and API. All users running node version 10.0.0-pre should upgrade to this version.

Note that this node is not recommended for mainnet use. It should only be deployed on test environments such as SanchoNet and Preview.

Known Issues

None

Technical Specification

Minimum System Requirements
  • An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
  • Or, for MacOS, an Apple Silicon (M1, M2 or M3) processor
  • 24GB of RAM
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7/Cabal 3.8.1.0
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign off

Role Approval
Cardano Head of Engineering 🟢
Cardano Head of Product 🟢
Test Engineer N/A for prerelease
Performance Engineer N/A for prerelease
Site Reliability Engineer N/A for prerelease
Release Engineer 🟢

Changelogs

Node

NONE

Consensus

NONE

Ledger
  • Fix drep delegation invariant preservation #4709
Network

NONE

Cardano-cli
  • Fixes the known issue listed on 10.0-pre release bulletin
  • Fixed the number of DRep credentials generated by create-testnet-data
  • Introduced a "compatible" command group
  • Added new envelope types for transactions and removed deprecated types
Cardano-api
  • Fix bug that ignored a specific stake deregistration certificate in Conway
  • Fix datum conversion in 'fromLedgerTxOuts' when using 'fromAlonzoTxOut'
Submit-api

NONE

Plutus

NONE

Individual packages' changelogs
Package Version Changelog
Win32-network 0.2.0.0 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.0 CHANGELOG.md
byron-spec-ledger 1.0.1.0 CHANGELOG.md
cardano-api 10.1.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 10.1.0.0 CHANGELOG.md
cardano-crypto 1.1.2
cardano-crypto-class 2.1.5.0 CHANGELOG.md
cardano-crypto-praos 2.1.2.0 CHANGELOG.md
cardano-crypto-test 1.5.0.2
cardano-crypto-tests 2.1.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.3 CHANGELOG.md
cardano-data 1.2.3.1 CHANGELOG.md
cardano-git-rev 0.2.2.0
cardano-ledger-allegra 1.6.0.1 CHANGELOG.md
cardano-ledger-alonzo 1.11.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.3.0.0 CHANGELOG.md
cardano-ledger-api 1.9.4.0 CHANGELOG.md
cardano-ledger-babbage 1.10.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.3.0.0 CHANGELOG.md
cardano-ledger-binary 1.4.0.0 CHANGELOG.md
cardano-ledger-byron 1.0.1.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.1.1 CHANGELOG.md
cardano-ledger-conway 1.17.1.0 CHANGELOG.md ...
Read more

10.0.0-pre

19 Oct 00:13
cdb45dd
Compare
Choose a tag to compare
10.0.0-pre Pre-release
Pre-release

Node 10.0.0-pre is a pre-release of the Cardano node that is capable of crossing the Chang#2 hard fork. It includes a number of improvements to the governance system, including support for SPO delegation to pre-defined voting options, and support for auto-abstain DRep votes supplanting abstaining via rewards address delegation. It also enables new Plutus primitives as defined in CIP-0122, CIP-0123, and CIP-0127. Finally it includes a number of other improvements to the ledger, CLI, API and networking code bases, as detailed below.

Note that, in order to withdrawal their rewards, following the hard fork, Ada holders will need to delegate to a DRep, which may be one of the pre-defined options, a single key or a Plutus v3 script.

Known Issues

Cardano CLI

  • cardano-cli 10.0.0.0 transaction build command doesn't balance tx output when key deposit is returned when attempting to deregister a stake address. Link to issue.

Technical Specification

Minimum System Requirements
  • An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
  • Or, for MacOS, an Apple Silicon (M1, M2 or M3) processor
  • 24GB of RAM
  • 200GB of free storage (250GB recommended for future growth)
Platforms
  • Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
  • Windows 64-bit (8.1, 10, 11)
  • MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
  • GHC 8.10.7/Cabal 3.8.1.0
Supported roles
Platform Block Production Relay Client (Desktop)
Linux 🟢 🟢 🟢
Windows 🟥 🟥 🟢
MacOS 🟥 🟥 🟢
Downloads

Documentation

Sign off

Role Approval
Cardano Head of Engineering 🟢
Cardano Head of Product 🟢
Test Engineer N/A for prerelease
Performance Engineer N/A for prerelease
Site Reliability Engineer N/A for prerelease
Release Engineer 🟢

Changelogs

Node
  • Removed support for legacy P2P topology format
  • Integrates Plutus 1.36 and corresponding ledger changes
  • Removed support for NodeToNodeV_12 and earlier
Consensus
  • Add GetFuturePParams query
  • Updated N2C part of latestReleasedNodeVersion to NodeToClientV_18.
  • Updated N2N part of latestReleasedNodeVersion to NodeToNodeV_14
  • Decrease the maximum permissible clock skew from 5s to 2s.
Ledger
  • Translation of RegTxCert and UnRegTxCert to PlutusV3 scripts context will now be done correctly, which means deposit and refund respectively, will actually be translated: #4627
  • Treasury withdrawals that are empty or sum up to zero will no longer be allowed: #4630
  • Prevent non-registered return accounts for proposals' deposits and TreasuryWithdrawals #4639
  • Ensure ppuCoinsPerUTxOBytes cannot be zero: #4650
  • Ensure dreps exist prior to delegation: #4652
  • Change how SPO votes are counted: #4659
  • Disallow withdrawals to non-delegated keyhashes post-bootstrap #4555
  • Remove maxMajorPV from Globals, because it was unused: #4218
Network
  • Added NodeToNodeV_14
  • Added NodeToClientV_18
Cardano-cli
  • Remove eras older than Babbage support in transaction build and transaction build-estimate
  • Remove era transaction view and transaction view commands. Use debug transaction view instead.
  • Adding support for script stake credentials and stake address in create-treasury-withdrawal and improving help text. New options are: --funds-receiving-stake-script-file and --funds-receiving-stake-address
  • create-testnet-data now takes a node configuration file as input
  • implements:
    • cardano-cli conway stake-address registration-and-delegation-certificate
    • cardano-cli conway stake-address registration-and-vote-delegation-certificate
    • cardano-cli conway stake-address registration-stake-and-vote-delegation-certificate
  • Large deprecation of legacy commands and removal of related code.
Cardano-api
  • Fix collateral balancing when building transaction
  • Add voting to simple tx interface
  • Handle Plutus related ledger events in Conway
  • When building applications that need to spend from a script UTxO which has a datum attached,
    that off-chain code needs access to the raw Datum for evaluating the transaction and calculate fees.
Submit-api

NONE

Plutus
  • Reference scripts are enabled for Plutus V1 scripts. This enables legacy scripts to take advantage of reference scripts, reducing DApp
    costs and increasing on-chain capacity.
  • The minFeeRefScriptsCoinsPerByte protocol parameter refines the Plutus cost model and improves fee calculations by allowing separate
    tuning of the costs for reference scripts.
Individual packages' changelogs
Package Version Changelog
Win32-network 0.2.0.0 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.0 CHANGELOG.md
byron-spec-ledger 1.0.1.0 CHANGELOG.md
cardano-api 10.0.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 10.0.0.0 CHANGELOG.md
cardano-crypto 1.1.2
cardano-crypto-class 2.1.5.0 CHANGELOG.md
cardano-crypto-praos 2.1.2.0 CHANGELOG.md
cardano-crypto-test 1.5.0.2 ...
Read more