Releases: IntersectMBO/cardano-node
10.1.2
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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 ... |
10.1.1
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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
toNodeToClientV_18
. - Updated N2N part of
latestReleasedNodeVersion
toNodeToNodeV_14
- Decrease the maximum permissible clock skew from 5s to 2s.
Ledger
- Translation of
RegTxCert
andUnRegTxCert
toPlutusV3
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
fromGlobals
, 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 thelegacy
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
andvote_reg_deleg_cert
andstake_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...
10.1.1-pre
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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... |
10.1.0-pre
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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 bycreate-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 ... |
10.0.0-pre
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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
toNodeToClientV_18
. - Updated N2N part of
latestReleasedNodeVersion
toNodeToNodeV_14
- Decrease the maximum permissible clock skew from 5s to 2s.
Ledger
- Translation of
RegTxCert
andUnRegTxCert
toPlutusV3
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
fromGlobals
, because it was unused: #4218
Network
- Added
NodeToNodeV_14
- Added
NodeToClientV_18
Cardano-cli
- Remove eras older than Babbage support in
transaction build
andtransaction build-estimate
- Remove
era transaction view
andtransaction view
commands. Usedebug 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 | ... |
9.2.1
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign off
Role | Approval |
---|---|
Cardano Head of Engineering | 🟢 |
Cardano Head of Product | 🟢 |
Test Engineer | 🟢 |
Performance Engineer | 🟢 |
Site Reliability Engineer | 🟢 |
Release Engineer | 🟢 |
Changelogs
Node
NONEConsensus
NONELedger
- Improve performance of certificate validation
Network
NoneCardano-cli
NONECardano-api
NONESubmit-api
NONEPlutus
NONEIndividual 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... |
9.2.0
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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
andGetRatifyState
queries. - Add
NodeToClientV_17
tosupportedNodeToClientVersions
.
Ledger
Network
tx-submission
mini-protocol now starts with a short delay, see #IntersectMBO/ouroboros-network#4927.
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 fortransaction 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
to357154 Lovelace
, improving clarity.
PR 873
Cardano-api
Features
- Upgrade Libraries: Upgrades to
cardano-ledger-*
,ouroboros-consensus-cardano
,ouroboros-network-api
,plutus-core
, andplutus-ledger-api
. PR 610 - New Types: Introduced
newtype UnsignedTx
anddata Era
to streamline era management for mainnet and upcoming eras. PR 604
Breaking Changes
- API Updates: Deprecated
valueFromList
,valueToList
, andcreateAndValidateTransactionBody
. IntroducedIsList Value
instance and recommend usingcreateTransactionBody
. PR 622 PR 597 - Transaction Changes:
BalancedTxBody
now returnsUnsignedTx
. PR 604 - Treasury Value Fix: Default value now set to
Nothing
instead of0
. Removed redundant type families in the Experimental API. PR 625
Bugfixes
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
andMonadEmitter
, and changed the type ofemit
toText -> BuiltinResult ()
: IntersectMBO/plutus#6224 - Forbade using
EvaluationResult
in the builtins code in favor ofBuiltinResult
, 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 theMkNil
type class without usage of built-in functions ordefineBuiltinTerm
: IntersectMBO/plutus#6347
Individual packages' changelogs
Package changelogs
| Package | Version | Changelog ...
9.1.1
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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... |
Cardano Node 9.1.0
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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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
- --vote-tx-in-reference
- --proposal-tx-in-reference (feature, compatible) IntersectMBO/cardano-cli#822
- 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
- cardano-api-9.1.0.0
- Export metadataValueFromJsonNoSchema (feature, compatible) IntersectMBO/cardano-api#591
- Make ScriptDatum in spending scripts optional in accordance with CIP69 (feature, compatible) IntersectMBO/cardano-api#575
- Update substituteExecutionUnits to include proposal and vote script witnesses (feature, breaking) IntersectMBO/cardano-api#587
- Fix reading of Plutus V2 cost models with different lengths in AlonzoGenesis in different eras (compatible, bugfix) IntersectMBO/cardano-api#564
- Export queryAccountState (compatible) IntersectMBO/cardano-api#588
- Add IsAllegraBasedEra, IsAlonzoBasedEra, IsBabbageBasedEra, IsConwayBasedEra, IsMaryBasedEra type classes. Add ToAlonzoScript and HasScriptLanguageInEra type classes. (feature, compatible) IntersectMBO/cardano-api#585
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 | ... |
Cardano Node 9.0.0
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, thetransaction build
command automatically populates thecurrentTreasuryValue
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
.
- Transactions running Plutus V1, Plutus V2 and Simple scripts to fail at submission with
⬆️ 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 withoverspent budget
. Usetransaction 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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
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-specificTxMeasure
adding the total
reference scripts size as a new dimension on top ofAlonzoMeasure
. - Updated N2C part of
latestReleasedNodeVersion
toNodeToClientV_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 | ... |