Releases: IntersectMBO/cardano-node
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 | ... |
Cardano Node 8.12.2
Node 8.12.2
fixes an issue with the bootstrap peers networking feature in node 8.12.1
that could leave nodes "stuck". It is otherwise identical to node 8.12.1
.
Benchmarking reports relevant to the 8.12.1
release can be found in this post on Cardano Updates.
State Snapshot
Until mithril snapshots for 8.12 are available, an 8.12 state tarball, detached GPG signature and sha256sum are available here:
https://update-cardano-mainnet.iohk.io/cardano-node-state/db-mainnet-8-12-1-slot-127934016.tar.zstd
https://update-cardano-mainnet.iohk.io/cardano-node-state/db-mainnet-8-12-1-slot-127934016.tar.zstd.asc
https://update-cardano-mainnet.iohk.io/cardano-node-state/db-mainnet-8-12-1-slot-127934016.tar.zstd.sha256sum
Known Issues
Transaction Build CLI Command
The transaction build
CLI command no longer checks the datum that is provided for PlutusV1
and PlutusV2
scripts.
If the datum is missing or incorrect, then the transaction will now be built, but will fail when submitted on chain, as expected.
https://github.com/IntersectMBO/cardano-ledger/issues/4444
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
NONE
Consensus
NONE
Ledger
NONE
Network
- Fix bootstrap peers transition
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 | 8.48.0.1 | CHANGELOG.md |
cardano-binary | 1.7.1.0 | CHANGELOG.md |
cardano-cli | 8.24.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.2.0 | CHANGELOG.md |
cardano-git-rev | 0.2.2.0 | |
cardano-ledger-allegra | 1.5.0.0 | CHANGELOG.md |
cardano-ledger-alonzo | 1.9.0.0 | CHANGELOG.md |
cardano-ledger-alonzo-test | 1.2.1.2 | CHANGELOG.md |
cardano-ledger-api | 1.9.2.0 | CHANGELOG.md |
cardano-ledger-babbage | 1.8.1.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](https://github.com/input-output-hk/cardano-ledger/blob/923e75bf3e16da01f26ed1ab53d9aac... |
Cardano Node 8.12.1
Node 8.12.1
fixes an issue that could lead to high system load when specific transactions were submitted to Cardano.
It also includes all the changes from node 8.12.0-pre
and 8.11.0-pre
that have been made since node 8.9.3
.
Specifically, node 8.12.1
includes essential changes and fixes that are needed for the Chang hard fork. It provides an implementation of CIP-69 for Plutus v3 (only). Existing Plutus v3 scripts will therefore need to be changed. Most existing Plutus V1 or V2 scripts will continue to compile without errors, modulo some minor changes in the PlutusTx.Prelude
functionality (namely the check
function) that was needed to implement CIP-117. The hardfork combinator (HFC) has been made more robust and governance actions have been limited for the bootstrap phase. The PlutusV3
cost model has been added to the Conway
genesis file. Network code includes further peer sharing improvements and changes that are related to inbound and outbound governors. Modifications have also been made to the Praos chain order. New API features include the possibility to query the account state, and to estimate and calculate balanced TxBody
s. Finally, three new CLI commands have been introduced: governance action create-hardfork
to generate a hard fork governance action, transaction build-estimate
, to produce a balanced transaction body without requiring a connection to a live node, and debug log-epoch-state
to record the epoch state. The node also includes a number of bug fixes and performance improvements.
For full details of changes since 8.9.3 also review:
https://github.com/IntersectMBO/cardano-node/releases/tag/8.11.0-pre
https://github.com/IntersectMBO/cardano-node/releases/tag/8.10.0-pre
Benchmarking reports relevant to the 8.12.1
release can be found in this post on Cardano Updates.
State Snapshot
Until mithril snapshots for 8.12.1 are available, an 8.12.1 state tarball, detached GPG signature and sha256sum are available here:
https://update-cardano-mainnet.iohk.io/cardano-node-state/db-mainnet-8-12-1-slot-127934016.tar.zstd
https://update-cardano-mainnet.iohk.io/cardano-node-state/db-mainnet-8-12-1-slot-127934016.tar.zstd.asc
https://update-cardano-mainnet.iohk.io/cardano-node-state/db-mainnet-8-12-1-slot-127934016.tar.zstd.sha256sum
Known Issues
Bootstrap Peers
A networking issue has been reported relating to bootstrap peers. Until this is resolved, it is recommended either to run the node with this disabled in the configuration file, or to use node version 8.9.4
, which is unaffected by the issue.
To disable bootstrap peers, remove the bootstrap peer section from the topology file and use the following publicRoots
section:
"publicRoots": [
{
"accessPoints": [
{
"address": "backbone.cardano.iog.io",
"port": 3001
},
{
"address": "backbone.mainnet.emurgornd.com",
"port": 3001
},
{
"address": "backbone.mainnet.cardanofoundation.org",
"port": 3001
}
],
"advertise": false
}
],
IntersectMBO/ouroboros-network#4898
Transaction Build CLI Command
The transaction build
CLI command no longer checks the datum that is provided for PlutusV1
and PlutusV2
scripts.
If the datum is missing or incorrect, then the transaction will now be built, but will fail when submitted on chain, as expected.
https://github.com/IntersectMBO/cardano-ledger/issues/4444
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
- New metric
cardano_build_info
, using label syntax ({x="a", y="b", ...}
) to provide detailed build info about the Node binary. (since 8.12.0) - New metric
forging_enabled
, indicating whether the Node's protocol has been instantiated with forger credentials or not. (since 8.12.0)
Consensus
- Enforce Conway minfees for ref scripts in the mempool, even in Babbage
Ledger
- Add
tierRefScriptFee
andtxNonDistinctRefScriptsSize
- Make reference scripts fee grow exponentially with size
Network
- Fix
InboundGovernorCounters
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 | 8.48.0.1 | CHANGELOG.md |
cardano-binary | 1.7.1.0 | CHANGELOG.md |
cardano-cli | 8.24.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 | ... |