Skip to content

Releases: IntersectMBO/cardano-node

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.

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

Cardano Node 8.12.2

29 Jun 14:52
71f8c71
Compare
Choose a tag to compare

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

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

Cardano Node 8.12.1

27 Jun 14:42
06943b6
Compare
Choose a tag to compare

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 TxBodys. 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

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 and txNonDistinctRefScriptsSize
  • 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 ...
Read more

Cardano Node 8.9.4

27 Jun 21:14
8ac5f75
Compare
Choose a tag to compare

Node 8.9.4 fixes an issue that could lead to high system load when specific transactions were submitted to Cardano, in exactly the same way as node 8.12.1. This release is provided for users who are running older node versions and prefer not to upgrade to node 8.12.1.

There are no other changes compared to 8.9.3.

Known Issues

None.

Haskell Security Advisory

Haskell Security Advisory is a repository of security advisories filed against packages published via Hackage.
cabal-audit output:

Found advisories:

dependency "base" at version 4.19.1.0 is vulnerable for:
  HSEC-2023-0007 "readFloat: memory exhaustion with large exponent"
  published: 2024-05-04 20:52:44 +0200
  https://haskell.github.io/security-advisories/advisory/HSEC-2023-0007
  No fix version available
  toml, parser, dos

dependency "process" at version 1.6.18.0 is vulnerable for:
  HSEC-2024-0003 "process: command injection via argument list on Windows"
  published: 2024-05-04 20:52:44 +0200
  https://haskell.github.io/security-advisories/advisory/HSEC-2024-0003
  Fix available since version 1.6.19.0
  windows

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
  • Enforce Conway minfees for ref scripts in the mempool, even in Babbage
Ledger
  • Add tierRefScriptFee and txNonDistinctRefScriptsSize
  • Make reference scripts fee grow exponentially with size
Network

NONE

Cardano-cli

NONE

Cardano-api

NONE

Submit-api

NONE

Plutus

NONE

Individual packages' changelogs
Package Version Changelog
Win32-network 0.1.1.1 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.0.2 CHANGELOG.md
byron-spec-ledger 1.0.0.2 CHANGELOG.md
cardano-api 8.39.3.0 CHANGELOG.md
cardano-binary 1.7.1.0 CHANGELOG.md
cardano-cli 8.20.3.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.1
cardano-crypto-tests 2.1.2.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.1 CHANGELOG.md
cardano-data 1.2.2.0 CHANGELOG.md
cardano-ledger-allegra 1.3.0.0 CHANGELOG.md
cardano-ledger-alonzo 1.6.0.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.2.0.0 CHANGELOG.md
cardano-ledger-api 1.8.0.0 CHANGELOG.md
cardano-ledger-babbage 1.6.1.0 CHANGELOG.md
cardano-ledger-babbage-test 1.2.0.0 CHANGELOG.md
cardano-ledger-binary 1.3.0.0 CHANGELOG.md
cardano-ledger-byron 1.0.0.4 CHANGELOG.md
cardano-ledger-byron-test 1.5.0.1 ...
Read more

Cardano Node 8.12.0-pre

21 Jun 09:00
ae8bc93
Compare
Choose a tag to compare
Pre-release

NOTE: THIS RELEASE IS ONLY RECOMMENDED FOR USE ON THE SANCHONET AND PUBLIC TEST ENVIRONMENTS (E.G. PREVIEW) AT THIS TIME. IT IS NOT RECOMMENDED FOR USE ON MAINNET.

Node 8.12.0-pre 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. No changes are needed for Plutus v1 or v2 scripts. The node also includes a number of bug fixes and performance improvements, as well as enhancements to Peer-to-Peer networking and the CLI including a new debug log-epoch-state command.

This version of the node is recommended for use on Preview and SanchoNet only, but users are advised to test carefully against it since it comprises a release candidate for the Chang hard fork (node version 9.x). Note that node 8.12 includes breaking changes against node version 8.11 or earlier when running in the Conway era (but not Babbage).

Known Issues

Haskell Security Advisory

Haskell Security Advisory is a repository of security advisories filed against packages published via Hackage.
cabal-audit output:

Found advisories:

dependency "base" at version 4.14.3.0 is vulnerable for:
  HSEC-2023-0007 "readFloat: memory exhaustion with large exponent"
  published: 2024-06-13 08:04:41 +0200
  https://haskell.github.io/security-advisories/advisory/HSEC-2023-0007
  No fix version available
  toml, parser, dos

dependency "process" at version 1.6.13.2 is vulnerable for:
  HSEC-2024-0003 "process: command injection via argument list on Windows"
  published: 2024-06-13 08:04:41 +0200
  https://haskell.github.io/security-advisories/advisory/HSEC-2024-0003
  Fix available since version 1.6.19.0
  windows

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 or later
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 pre-release
Performance Engineer N/A for pre-release
Site Reliability Engineer N/A for pre-release
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.
  • New metric forging_enabled, indicating whether the Node's protocol has been instantiated with forger credentials or not.
Consensus
  • Changed GetStakeDistribution and GetPoolDistr queries to return a
    Consensus-vendored version of PoolDistr (instead of using the one from
    Ledger, as it changed in a backwards-incompatible manner).
Ledger
  • Implemented CIP-0069, which improves PlutusV3 functionality by making spending datums optional and enforcing all scripts to have exactly one argument.
  • Ensure that CommitteeMinSize protocol parameter is ignored during bootstrap phase.
  • Restrict types for some protocol parameters and fixup CDDL specification to reflect actual deserializers.
  • Create pool stake distribution query for voting.
  • Included rewards accounts in stake pool distribution calculation for voting.
  • Bug fixes:
    • Fixes to DRep expiry logic and the choice of correct threshold for the committee voting.
    • Script execution for certificates with the same plutus script did not execute correctly.
    • Prevent delegation to a non-existent pool.
Network
  • Don't include peers that are failing in peershare responses.
  • Bump io-sim and io-classes
  • Refactor testnet
  • Added ShowProxy SlotNo instance
Cardano-cli
  • New debug log-epoch-state command (feature, compatible, refactoring) PR 775
  • transaction view: show proposals and votes
    This adds two new fields to the JSON output of transaction view: governance actions and voters.
    Please see [this](IntersectMBO/cardano-cli#774 (comment) for example outputs) issue.
    When those fields are irrelevant, they are present but there value is null.
    (compatible)
    PR 774
  • query protocol-parameters: use ledger JSON encoding, not API one (breaking) PR 758
  • Make --fee mandatory in transaction build-raw. Remove TxCmdTxFeeValidationError type. (breaking, bugfix) PR 768
  • Remove UnwitnessedCliFormattedTxBody constructor (improvement) PR 707
  • Make --prev-governance-action-tx-id and --prev-governance-action-tx-id optional for create-no-confidence command
Cardano-api
  • Deserialize ouroboros-consensus's PoolDistr instead of cardano-ledger's PoolDist to maintain backwards compatibility with the PoolDistr query. This is needed because cardano-ledger's PoolDistr datatype has changed. (compatible) IntersectMBO/cardano-api#562
  • Updated dependencies:
    • cardano-ledger
    • ouroboros-consensus
    • ouroboros-network
    • plutus
  • Replaced Cardano.Api.Fees.TransactionValidityError.TransactionValidityTranslationError with Cardano.Api.Fees.ScriptExecutionError.ScriptErrorTranslationError
  • Concretized toShelleyMultiSig and fromShelleyMultiSig to ShelleyEra. (feature, breaking) IntersectMBO/cardano-api#552
  • evaluateTransactionExecutionUnitsShelley: return logs that are useful for debugging (breaking) IntersectMBO/cardano-api#555
  • Export Target type from ouroboros-network, to be more convenient to users (compatible) IntersectMBO/cardano-api#448
  • Add MuxError handling in FoldBlocksError. Rename LedgerStateCondition to ConditionResult.
  • Prepare deprecation of ProtocolParameters
  • TxBodyContent: support treasury donations
  • Added deprecation warning to function serialiseTxLedgerCddl
Plutus - Added a new `Value` type backed by `Data`. This is currently experimental and not yet used in the ledger API.
  • Exported the following from PlutusLedgerApi.Common in #6178:

    • ExCPU (..)
    • ExMemory (..)
    • SatInt (unSatInt)
    • fromSatInt
    • toOpaque,
    • fromOpaque
    • BuiltinData (..)
    • ToData (..)
    • FromData (..)
    • UnsafeFromData (..)
    • toData
    • fromData
    • unsafeFromData
    • dataToBuiltinData
    • builtinDataToData
  • Removed semantically incorrect Eq instances for AssocMap.

  • V3 scripts has new type signature as described in the CIP-69

    • V3 scripts return BuiltinUnit instead of ().
    • PlutusTx.check used to have type :: Bool -> () and is changed now to :: Bool -> BuiltinUnit.
      (This breaks compilation of existing V1/V2 scripts, however any scripts compiled with an older compiler will still continue to work)
Individual packages' changelogs
Package Version Changelog
Win32-network 0.2.0.0 [ChangeLog.md](https://github.com/IntersectMBO/Win32...
Read more

8.11.0-sancho

17 May 02:29
235e34f
Compare
Choose a tag to compare
8.11.0-sancho Pre-release
Pre-release

8.11.0 with updated sanchonet configuration only to be used on sanchonet.

Docker Image

Release Notes

Configuration FIles

Cardano Node 8.11.0-pre

16 May 23:23
8.11.0-pre
38c7f1c
Compare
Choose a tag to compare
Pre-release

NOTE: THIS RELEASE IS ONLY RECOMMENDED FOR USE ON THE SANCHONET AND PUBLIC TEST ENVIRONMENTS (E.G. PREVIEW) AT THIS TIME. IT IS NOT RECOMMENDED FOR USE ON MAINNET.

Node 8.11.0-pre introduces a number of changes that are needed to prepare for the Conway era, as well as other improvements. 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 TxBodys. Finally, two new CLI commands have been introduced: governance action create-hardfork to generate a hard fork governance action, and transaction build-estimate, to produce a balanced transaction body without requiring a connection to a live node.

Known Issues

Haskell Security Advisory

Haskell Security Advisory is a repository of security advisories filed against packages published via Hackage.
cabal-audit output:

Found advisories:

dependency "base" at version 4.19.1.0 is vulnerable for:
  HSEC-2023-0007 "readFloat: memory exhaustion with large exponent"
  published: 2024-05-04 20:52:44 +0200
  https://haskell.github.io/security-advisories/advisory/HSEC-2023-0007
  No fix version available
  toml, parser, dos

dependency "process" at version 1.6.18.0 is vulnerable for:
  HSEC-2024-0003 "process: command injection via argument list on Windows"
  published: 2024-05-04 20:52:44 +0200
  https://haskell.github.io/security-advisories/advisory/HSEC-2024-0003
  Fix available since version 1.6.19.0
  windows

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 pre-release
Performance Engineer N/A for pre-release
Site Reliability Engineer N/A for pre-release
Release Engineer 🟢

Changelogs

Node
Consensus
  • Restricted the VRF tiebreaker based on slot distance starting in the Conway era.
  • Added GetAccountState query.
  • Changed ShelleyLedgerUpdate by replacing ShelleyUpdatedProtocolUpdates with ShelleyUpdatedPParams.
  • Changed the Praos chain order such that for two blocks A and B by the same
    issuer with the same block number, A is now preferred over B only if A
    has a higher issue number and (new) A and B are in the same slot.
    This is in line with the motivation for the issue number tiebreaker, and
    fixes the transitivity of the Ord PraosChainSelectView instance in a special
    case.
  • Allowed to configure Praos chain order to restrict the VRF tiebreaker based on
    slot distance.
  • Updated BlockFetch punishment logic for BlockSupportsDiffusionPipelining.
  • Updated chainSel tentative header logic for BlockSupportsDiffusionPipelining.
  • Introduced new ChainOrde (with preferCandidate) class for SelectViews,
    and add necessary instances. Adapted preferAnchoredCandidate to use
    preferCandidate instead of relying on preferAnchoredFragment.
  • Renamed QueryLedger class to BlockSupportsLedgerQuery.
  • VolatileDB traces were tweaked
    • VolatileDB.OpenedVolatileDB trace message now includes the maximum slot seen.
    • Added VolatileDB.ClosedDB.
Ledger
  • Prepared changes for the bootstrap period by restricting government actions and by ignoring DRep thresholds.

  • Added the ability to do a HardForkInitiation into a new era.

  • Added PlutusV3 cost model to Conway genesis.

  • Stopped counting expired committee members in active committee size calculation.

  • Included rewards accounts in DRep distribution calculation.

  • Added AccountState ledger state query.

  • Bug fixes:

    • Stopped embedding UTXO and UTXOS predicate failures from previous eras.
    • Fixed predicate failure deserialisation bug when re-submitting a Conway transaction with an invalid plutus script.
Network
  • Refactored inbound governor error handling
  • Synchronised churn with the outbound governor
  • Peer sharing improvements
  • New outbound governor counters included in EKG
  • Outbound governor timeout improvements
Cardano-cli
  • Introduces the governance action create-hardfork cmd.
  • Enable manual specification of execution units for plutus voting and proposing scripts
  • cardano-cli query stake-distribution: add --output-{json,text} flags
  • Introduce new cardano-cli latest transaction build-estimate command which will produce a balanced transaction body without requiring a connection to a live node
  • Add minFeeRefScriptCostPerByte to create-protocol-parameter-update governance action command.
  • Fixed misunderstanding in generated README file by genesis create-testnet-data.
  • cardano-cli conway governance committe key-hash: support extended Constitutional Committee keys
  • Defaulted calculate-min-fee --reference-script-size's value to 0
  • Enable both --cold-script-file and --cold-script-hash for governance committee create-hot-key-authorization-certificate and committee create-cold-key-resignation-certificate
  • Fixed --include-stake behavior in query drep-state
Cardano-api
    • Updated conwayGenesisDefaults and alonzoGenesisDefaults.
    • Changed CostModel to use Int64 instead of Integer.
  • Update estimateBalancedTxBody to account for required deposits due to governance proposals and stake registration certificates
  • Adding MinFeeRefScriptCostPerByte to Conway PParams
  • Fixed the implementation of toAlonzoPParams function.
  • Sort metadata keys for no-schema json for canonical CBOR
  • Implement estimateBalancedTxBody and estimateOrCalculateBalancedTxBody
  • Add support for Constitutional Committee keys in the SomeAddressVerificationKey type
Submit-api
Plutus
Individual packages' changelogs
Package Version Changelog
Win32-network 0.1.1.1 ChangeLog.md
base-deriving-via 0.1.0.2 CHANGELOG.md
byron-spec-chain 1.0.1.0 CHANGELOG.md
byron-spec-ledger 1.0.1.0 CHANGELOG.md
cardano-api 8.46.0.0 [CHANGELOG.md](https://github.com/IntersectMBO/cardano-api/blob/74e45283f15aaf1831153ab3da1b8e2a8c469...
Read more