Skip to content

Releases: IntersectMBO/cardano-node

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

9.2.1

25 Sep 19:50
5d3da8a
Compare
Choose a tag to compare

Node version 9.2.1 is a minor node release that improves the performance of certificate validation.
It is recommended that stake pool operators upgrade to this version 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

Node NONE
Consensus NONE
Ledger
  • Improve performance of certificate validation
Network None
Cardano-cli NONE
Cardano-api NONE
Submit-api NONE
Plutus NONE
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 9.3.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 9.4.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.0 CHANGELOG.md
cardano-git-rev 0.2.2.0
cardano-ledger-allegra 1.6.0.0 CHANGELOG.md
cardano-ledger-alonzo 1.10.2.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.2.1.3 CHANGELOG.md
cardano-ledger-api 1.9.3.0 CHANGELOG.md
cardano-ledger-babbage 1.9.0.0 CHANGELOG.md
cardano-ledger-babbage-test 1.2.0.4 CHANGELOG.md
cardano-ledger-binary 1.3.4.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.16.1.0 CHANGELOG.md
cardano-ledger-conway-test 1.2.1.8 CHANGELOG.md
cardano-ledger-core 1.14.0.0 CHANGELOG.md
cardano-ledger-mary 1.7.0.0 CHANGELOG.md
cardano-ledger-shelley 1.13.1.0 [CHANGELOG.md](https://github.com/IntersectMBO/cardano-ledger/blob/ead6175cbb07f6bb272d534c...
Read more

9.2.0

20 Sep 19:36
341ea87
Compare
Choose a tag to compare

Node version 9.2.0 provides a number of improvements and bug fixes, including script-based DRep Support in the update certificate CLI command and an improved transaction view CLI command. The tx-submission mini-protocol now starts with a short delay. The node also includes governance-related ledger state queries, improved Plutus debug functionality, a new method to compute over-the-wire CBOR encoded transaction size, plus fixes to DRep registration expiration and the DRep threshold for ratifying NoConfidence votes, and new GetProposals and GetRatifyState consensus queries. Finally, it includes a major rework of the new tracing metrics naming schema.

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

Breaking Changes

There are number of breaking changes to the API: valueFromList, valueToList, createAndValidateTransactionBody and IsList Value are deprecated, BalancedTxBody now returns UnsignedTx and the default value for Treasury Value is now set to Nothing instead of 0.

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 🟢
Performance Engineer 🟢
Site Reliability Engineer 🟢
Release Engineer 🟢

Changelogs

Node

Configuration Enhancements

Database Path Customization

  • Separate Paths for Volatile and Immutable Databases: Users can now specify paths for volatile and immutable databases separately.

Command Line Options:

Users can specify database paths directly via command line:

[ --database-path FILEPATH
| --immutable-database-path FILEPATH --volatile-database-path FILEPATH
]

Configuration File:

Alternatively, paths can be set in the configuration YAML file under the "DatabaseFile" key:

"DatabasePath": {
  "ImmutableDbPath": "mainnetnode/db/node-imm",
  "VolatileDbPath": "mainnetnode/db/node-vol"
},

or for a single path configuration:

"DatabasePath": "mainnetsingle/db/node",

New tracing system

Major rework of the metrics naming schema

  • Change all metric names to match those of the current tracing system, simplifying switching back and forth for existing integrations
  • Augment metric names with type-spefic suffixes (like e.g. _int)
  • Add optional Node config value TraceOptionMetricsPrefix (String) to specify a namespace prefix for metric names
Consensus
  • Add GetProposals and GetRatifyState queries.
  • Add NodeToClientV_17 to supportedNodeToClientVersions.
Ledger
  • DRep registration expiration fix: #4547
  • Use correct DRep threshold to ratify NoConfidence: 4516
  • Added method to compute over-the-wire CBOR encoded transaction size needed for network layer: 4521
  • Add governance related ledger state queries: 4514
  • Improve Plutus debug functionality: 4503
Network
Cardano-cli

Features

  • Script-based DRep Support on Update Certificate: Adds support for using a script-based decentralized representatives (DRep) in the update certificate command.
    PR 884

  • Enhanced Transaction View: Modifies transaction view to show which inputs redeemers refer to, enhancing traceability.
    PR 861

Breaking Changes

  • Propagate Experimental API: Propagates the experimental API to transaction build internals and deprecates pre-Conway eras for transaction build.
    PR 853
  • Change in Default Behavior for Testnet Data Creation: The create-testnet-data command no longer defaults the --total-supply option. It now derives the total supply from the Shelley genesis file or uses half of that as the --delegated-supply if not specified.
    PR 874

Bugfixes

  • Mandatory Treasury Withdrawal Fields: Makes the funds receiving address and amount mandatory for treasury withdrawal actions, fixing a potential oversight in command requirements.
    PR 877
  • Prevent Overflow in Int Parsers: Addresses and forbids incorrect value entries in parsers for Int-like options to prevent silent overflows.
    PR 864
  • Fix Estimated Fee Rendering: Corrects the estimated fee output format from Coin 357154 to 357154 Lovelace, improving clarity.
    PR 873
Cardano-api

Features

  • Upgrade Libraries: Upgrades to cardano-ledger-*, ouroboros-consensus-cardano, ouroboros-network-api, plutus-core, and plutus-ledger-api. PR 610
  • New Types: Introduced newtype UnsignedTx and data Era to streamline era management for mainnet and upcoming eras. PR 604

Breaking Changes

  • API Updates: Deprecated valueFromList, valueToList, and createAndValidateTransactionBody. Introduced IsList Value instance and recommend using createTransactionBody. PR 622 PR 597
  • Transaction Changes: BalancedTxBody now returns UnsignedTx. PR 604
  • Treasury Value Fix: Default value now set to Nothing instead of 0. Removed redundant type families in the Experimental API. PR 625

Bugfixes

  • Fee Estimation: Fixed fee estimation when autobalancing minted assets. PR 622
  • Data Handling: Included datums and redeemers in makeUnsignedTx. PR 623
  • Datum Conversion: Fixed datum conversion in fromShelleyTxOut for ShelleyBasedEraAlonzo. PR 613
Submit-api
Plutus
  • Fixed a bug in the Plutus Core type normalizer in IntersectMBO/plutus#6272
  • The case-of-case optimization on Plutus IR was removed from the compiler due to it causing OOMs: IntersectMBO/plutus#6248
  • Removed Emitter and MonadEmitter, and changed the type of emit to Text -> BuiltinResult (): IntersectMBO/plutus#6224
  • Forbade using EvaluationResult in the builtins code in favor of BuiltinResult, so that builtins throw errors with more helpful messages: IntersectMBO/plutus#5926
  • Made [] :: [Integer], [] :: [Bool], [] :: [Data], and [(Data, Data)] compile directly to the respective empty list via the MkNil type class without usage of built-in functions or defineBuiltinTerm: IntersectMBO/plutus#6347
Individual packages' changelogs

Package changelogs

| Package | Version | Changelog ...

Read more

9.1.1

02 Sep 17:08
efd5600
Compare
Choose a tag to compare

Node version 9.1.1 fixes an issue with node 9.1.0 where nodes would replay from the Genesis block if they were restarted when in the Conway era, as described in IntersectMBO/cardano-ledger#4589. If a node is upgraded to 9.1.1 from node versions 9.0.0/9.1.0 then no replay should be required. Updating from earlier versions might require one replay from Genesis.

It is recommended that all users upgrade to node version 9.1.1 when restarting a node.

Known Issues

Cardano-cli shows the wrong sync percentage on query tip. Being fixed in IntersectMBO/cardano-cli#851. Solved in cardano-cli-9.3.0.0

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
Consensus
  • No changes.
Ledger
  • No changes.
Network
  • No changes.
Cardano-cli
Cardano-api
Submit-api
  • No changes.
Plutus
  • No changes.
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 9.1.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 9.2.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.0 CHANGELOG.md
cardano-git-rev 0.2.2.0
cardano-ledger-allegra 1.5.0.0 CHANGELOG.md
cardano-ledger-alonzo 1.10.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.2.1.2 CHANGELOG.md
cardano-ledger-api 1.9.2.1 CHANGELOG.md
cardano-ledger-babbage 1.8.2.0 CHANGELOG.md
cardano-ledger-babbage-test 1.2.0.3 CHANGELOG.md
cardano-ledger-binary 1.3.3.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.16.0.0 CHANGELOG.md
cardano-ledger-conway-test 1.2.1.7 [CHANGELOG.md](https://github.com/IntersectMBO/cardano-ledger/blob/698a24c1b5064468...
Read more

Cardano Node 9.1.0

25 Jul 01:06
176f99e
Compare
Choose a tag to compare

Cardano node 9.1.0 includes all the features that are necessary to be able to cross the upcoming Chang hard fork. The main change from node 9.0.0 is that node 9.1.0 requires a Conway genesis file at startup, where the genesis file was optional in node 9.0.0. This file is needed to cross the Chang hard fork. The necessary Conway genesis and other configuration files can be found here.

This release also incorporates a number of bug fixes and enhancements to the CLI and API, including a "query treasury" command, and changes to ensure compatibility with CIP69 and CIP119.

SPOs and other critical node users (exchanges, explorers, wallets, etc.) are strongly encouraged to upgrade to this version of the node. An update proposal to trigger the Chang hard fork will be submitted when sufficient SPOs and exchanges have upgraded to this version.

Known Issues

Cardano-cli shows wrong sync percentage on query tip. Being fixed in IntersectMBO/cardano-cli#851.

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
  • Requires conway genesis file at startup
  • Reports 9.1.0 in block header
Consensus
  • No changes.
Ledger
  • No changes.
Network
  • No changes.
Cardano-cli
  • cardano-cli-9.2.1.0, offers the following improvements with respect to cardano-cli-9.0.0.0
    • Add "query treasury" command (feature, compatible) IntersectMBO/cardano-cli#845
    • Relax requirement on supplying datums to Plutus spending scripts.
    • Add flags to enable use of reference scripts with voting and proposing scripts
    • Make genesis: create, create-staked and create-cardano commands accept optional era parameters. (feature, compatible) IntersectMBO/cardano-cli#812
    • Remove check on Drep metadata size, always return the hash of the file passed by the user. This is to ensure compatibility with CIP119. Upgrade cardano-api-9.1.0.0 (feature, breaking) IntersectMBO/cardano-cli#818
Cardano-api
Submit-api
  • No changes.
Plutus
  • No changes.
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 9.1.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 9.2.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.2 CHANGELOG.md
cardano-data 1.2.3.0 CHANGELOG.md
cardano-git-rev 0.2.2.0 ...
Read more

Cardano Node 9.0.0

08 Jul 18:47
2820a63
Compare
Choose a tag to compare

Node 9.0.0 is a major release of the Cardano node that contains all the changes that are needed for the Conway ledger era, including on-chain governance via CIP-1694, support for Plutus v1 reference scripts, and Plutus script signature support via CIP-69. It is recommended that all node users upgrade to this or a later version of the node.

This is the first node that can support crossing the 9.0 hard fork (Chang) boundary on mainnet and long-running testnets, such as PreProd). It only supports entering the bootstrap phase of CIP-1694 in production environments (Protocol Version 9.0) and not
the transition to enable DRep voting and all governance actions (Protocol Version 10.0).

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

No Conway Genesis File
Note that node 9.0.0 is supplied without a valid Conway-era Genesis file, which will be needed to cross the Chang hard fork. This will be supplied at a later date, necessitating a small configuration update.

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

Known Issues

Cardano CLI

  • In cardano-cli-9.0.0.0, in the Conway era, the transaction build command automatically populates the currentTreasuryValue on every transaction. This should, however, happen only on Treasury donation transactions. This issue causes:
    • Transactions running Plutus V1, Plutus V2 and Simple scripts to fail at submission with CurrentTreasuryFieldNotSupported.
    • Also, regular transactions created on one epoch and submitted on a different epoch fail with ConwayTreasuryValueMismatch.

⬆️ This is fixed on cardano-cli-9.0.0.1 Users are encouraged to use this latest version.

  • In cardano-cli-9.0.0.0, in the Conway era, transaction build command may underestimate Plutus script execution units. This causes script execution to fail with overspent budget. Use transaction build-raw instead.

No Conway Genesis File

Note that node 9.0.0 is supplied without a valid Conway-era Genesis file, which will be needed to cross the Chang hard fork. This will be supplied at a later date, necessitating a small configuration update.

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
  • Allows updating to conway era without ExperimentalHardForksEnabled
Consensus
  • Added GetSPOStakeDistr query.
  • Introduced ConwayMeasure, a Conway-specific TxMeasure adding the total
    reference scripts size as a new dimension on top of AlonzoMeasure.
  • Updated N2C part of latestReleasedNodeVersion to NodeToClientV_16.
Ledger
  • Authorization of hot credentials for constitutional committee members is now only
    possible for cold credentials that are present in the ledger state, either in the current
    committee or in one of the proposals.
  • Voting is restricted to entities that are present in the ledger state
  • DRep votes will be removed whenever DRep unregisters
  • Pricing model for the size of reference scripts was changed from linear to
    exponential. Moreover, extra limits on the total size of reference scripts being used
    have been put in place.
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 9.0.0.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 9.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
cardano-crypto-tests 2.1.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.2 CHANGELOG.md
cardano-data 1.2.3.0 CHANGELOG.md
cardano-git-rev 0.2.2.0 ...
Read more