Releases: IntersectMBO/cardano-node
10.5.1
Node 10.5.1 provides a number of improvements over node 10.5.0. In particular, the Tracing system fixes the slotsMissed_int metric, while networking improvements include Windows socket fixes, reduced caching time of DNS lookup errors, refined PeerSharing configuration behavior (see networking changes below for details), and the deprecation of --non-producer-node in favor of --start-as-non-producer-node command line switch for starting the node. This release also removes a number of irrelevant binaries from the Node artifacts and adds tx-generator.
Benchmarking reports relevant to the 10.5.1 release can be found in this post on Cardano Updates.
System testing results for the 10.5.1 release can be found on the corresponding tag testing page.
Please note the changed default behavior for PeerSharing for relay nodes, but not for block producers. This reflects the recommendations for mainnet usage -- mainnet block producers may not meet the Praos performance guarantees if PeerSharing is enabled and IP will also be leaked, but this is not an issue for relays.
Known issues
- There is a known bug when starting from a Byron snapshot. The node will reject the snapshot and replay the chain from the start. However the time it takes to replay the Byron era is small, and very few users are expected to need to start the node from a Byron snapshot. Therefore the issue will be fixed in 10.6.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, M3 or M4) processor
- 24GB of RAM when running with the
InMemorybackend, 8GB when running with theOnDiskbackend (pending confirmation) - 300GB of free storage (350GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS; Mint 20, 21, 21.1, 21.2, 21.3, 22, 22.1; Debian 11, 12)
- Windows 64-bit (10, 11)
- MacOS 10.15, 11 (Big Sur), 12 (Monterey), 13 (Ventura), 14 (Sonoma), 15 (Sequioa)
GHC/Cabal supported versions
- GHC 9.6
- Cabal 3.8/3.12
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- Cardano Node documentation
- For details about changes to configuration for
UTxO-HDplease refer to the Consensus docs on UTxO-HD - The getting started guide may also be helpful for general queries.
- Networking options and related changes are listed on the P2P section
- For details about changes to configuration for
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign-off
| Role | Approval |
|---|---|
| Technical Steering Committee (Intersect) | 🟢 |
| Product Committee (Intersect) | 🟢 |
| Test Engineer | 🟢 |
| Performance Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
Node
- Some irrelevant binaries have been removed from the release binary artifacts, and
tx-generatoradded.
Tracing
- New Tracing System: fixed
slotsMissed_intmetric
Consensus
- No changes
Ledger
- No changes
Network
- Fixed an issue on Windows: setting unsupported Windows socket option which resulted in connections being torn down
- Lowered the time of caching DNS lookup errors to at most 15 minutes
- Allow
PeerSharinginInitiatorOnlyDiffusionMode - The default value of
PeerSharingconfiguration parameter depends on whether the node is configured as a block producer (=PeerSharingDisabled) or a relay (=PeerSharingEnabled) for normal operations. For this purpose, the node is considered a BP if any of the protocol files are present at startup. The default can be overridden by explicitly setting thePeerSharingkey in the configuration file to the desired value.
CLI
- No changes
API
- No changes
Submit API
- No changes
Plutus
- No changes
Detailed Changelogs
Individual packages' changelogs
Package changelogs| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| byron-spec-chain | 1.0.1.0 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.0 | CHANGELOG.md |
| cardano-api | 10.16.3.0 | CHANGELOG.md |
| cardano-binary | 1.7.1.0 | CHANGELOG.md |
| cardano-cli | 10.11.0.0 | CHANGELOG.md |
| cardano-crypto-class | 2.2.2.0 | CHANGELOG.md |
| cardano-crypto-praos | 2.2.1.0 | CHANGELOG.md |
| cardano-crypto-test | 1.6.0.0 | CHANGELOG.md |
| cardano-crypto-tests | 2.2.1.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.6.0.0 | CHANGELOG.md |
| cardano-data | 1.2.4.0 | CHANGELOG.md |
| cardano-git-rev | 0.2.2.0 | ... |
10.5.0
Cardano Node version 10.5.0 introduces several key improvements and fixes across the Cardano ecosystem. The Node now exposes an LMDB MaxReaders configuration option, while Consensus includes optimizations for Ouroboros Genesis, drops GHC 8.10 support, and removes deprecated features such as SlotForgeTimeOracle. Network changes reduce the default peer connection targets, add configurable egress buffering, and fix synchronisation issues. The Cardano Node CLI standardizes JSON/YAML outputs, enables offline Plutus cost calculations, and removes legacy commands. Meanwhile, the Cardano Node API enhances governance credential handling, deprecates outdated functions, and resolves auto-balancing bugs.
This is a pre-release version of the node - it is not recommended for Mainnet use at this point in time.
Benchmarking reports relevant to the 10.5.0 release can be found in this post on Cardano Updates.
Breaking changes
- Removed
legacy governancecommand group: usecompatibleinstead - Deleted
governance...-pollcommands
Known issues
- There is a known bug when starting from a Byron snapshot. The node will reject the snapshot and replay the chain from the start. However the time it takes to replay byron is small, and the chance of users starting the node from a Byron snapshot is also low. Therefore the issue will be fixed in 10.6.0.
- An unsupported socket option is set by the diffusion layer on a Windows deployment which results in
WSAENOPROTOOPT(bad protocol option) error returned by the syscall leading to connection tear down.
Technical Specification
Minimum System Requirements
- An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
- Or, for MacOS, an Apple Silicon (M1, M2, M3 or M4) processor
- 24GB of RAM when running with the
InMemorybackend, 8GB when running with theOnDiskbackend (pending confirmation) - 300GB of free storage (350GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS; Mint 20, 21, 21.1, 21.2, 21.3, 22, 22.1; Debian 11, 12)
- Windows 64-bit (10, 11)
- MacOS 10.15, 11 (Big Sur), 12 (Monterey), 13 (Ventura), 14 (Sonoma), 15 (Sequioa)
GHC/Cabal supported versions
- GHC 9.6
- Cabal 3.8/3.12
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- Cardano Node documentation
- For details about changes to configuration for
UTxO-HDplease refer to the Consensus docs on UTxO-HD - The getting started guide may also be helpful for general queries.
- Networking options and related changes are listed on the P2P section
- For details about changes to configuration for
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign-off
| Role | Approval |
|---|---|
| Technical Steering Committee (Intersect) | 🟢 |
| Product Committee (Intersect) | 🟢 |
| Test Engineer | N/A |
| Performance Engineer | 🟢 |
| Site Reliability Engineer | N/A |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
Node
- Expose
MaxReadersconfig option for LMDB. - Set Preview and Preprod network configurations to use Ouroboros Genesis mode by default.
- Set node configuration's
LedgerDBQueryBatchSizeto match the UTXO-HD migration guide default.
Tracing
Consensus
- Bug fix in Ouroboros Genesis. Added the
GsmStateargument to theregisterClientfunction for the ChainSync Jumping optimization. If the node is in theGSM.CaughtUpstate, new peers now immediately disengage from CSJ. - Drop GHC 8.10 support.
- Use
HeaderWithTimefor the ChainSync candidates. - Remove
SlotForgeTimeOracleand its use in the BlockFetch client interface, as we no longer translate time in the BlockFetch client. - Rename
GetLedgerConfigtoDebugLedgerConfig, indicating that it is a debug query, meaning that compatibility across node versions is not guaranteed. Please let us know if you want to rely on this query and would benefit from proper backwards-compatibility guarantees. - Removed reference to deleted
NodeToNodeV_13fromSupportedNetworkProtocolVersion.
Ledger
- No changes
Network
- Removed support for legacy node-to-node protocol version 13 for clients unable to cross past Chang HF.
- To diminish socket usage, the default peer selection target for established outbound connections was lowered from 40 to 30 in deadline/caught up node. Also lowered the same parameter from 50 to 40 for a node syncing in Genesis mode.
- These peer selection targets are also propagated to the default values used by
cardano-node, default mainnet configuration file; cardano-book will be updated for the next release (rather than a pre-release).
- These peer selection targets are also propagated to the default values used by
- Implemented mux egress buffering via configurable polling parameter (
EgressPollIntervalkey in the node configuration file) which lets operators tune latency vs. network efficiency to their preference. The default value is 0 [s] effectively disabling this feature, but values up to 0.200 (200 ms) are currently supported, which trades network latency for expected gains in network efficiency under high load conditions where many downstream peers are served. See IntersectMBO/ouroboros-network#5113 - Fixed churn regression introduced in node 10.3 affecting a node syncing in Genesis mode.
- The default value of
PeerSharingin the node has changed totrue; this follows the published configuration, which has been using peer sharing for a while now.
CLI
Release Notes for cardano-cli (10.9.0.0 to 10.11.0.0)
Main changes
-
Standardized output format parameters and output across the
cardano-cliand added support for new formats, especiallyyamlandjson:-
New
--output-yamloption for the following commands:conway query ledger-stateconway query ref-script-sizeconway query stake-distributionconway query stake-poolsconway query utxoconway text-view decode-cborconway transaction calculate-min-feeconway transaction txidlatest query ledger-statelatest query ref-script-sizelatest query stake-distributionlatest query stake-poolslatest query utxolatest text-view decode-cborlatest transaction calculate-min-feelatest transaction txidquery ledger-statequery stake-distributionquery stake-poolsquery utxo
(compatible)
PR 1192 -
New
--output-jsonand--output-yamlflags for the following commands:conway query committee-stateconway query constitutionconway query drep-stake-distributionconway query drep-stateconway query future-pparamsconway query gov-stateconway query proposalsconway query ratify-statelatest query committee-statelatest query constitutionlatest query drep-stake-distributionlatest query drep-statelatest query future-pparamslatest query gov-statelatest query proposalslatest query ratify-state
(compatible)
PR 1188 -
The following commands have been updated to take output format:
conway query kes-period-infoconway query ledger-peer-snapshotconway query pool-paramsconway query pool-state
*...
-
10.4.1
Node 10.4.1 integrates UTxO-HD into the Cardano node. UTxO-HD is a rework of the Consensus layer of the node which allows the UTxO set to be stored either fully in-memory (as with previous node versions) or else on some external storage medium (e.g. SSD or HD). The latter lowers the memory requirements of the running node at the cost of some speed. This first version of UTxO-HD provides an LMDB backend, but future releases will incorporate a more fine-tailored backend based on LSM trees. More information on UTxO-HD can be found in the consensus website.
This release also provides fixes and enhancements to the tracing system, to the location of LedgerDB configuration options, and to the node CLI and API. It also updates the dependency on Plutus to 1.45.
System testing results for the 10.4.1 release can be found on the corresponding tag testing page.
Benchmarking reports relevant to the 10.4.1 release can be found in this post on Cardano Updates.
Important
Users migrating from a previous version of the node should read the migration guide to properly configure the node and convert the database such that a replay from genesis can be avoided. Mainnet block producers and associated relays should only use the V2InMemory UTXO-HD backend.
This version of the node is mainnet ready. It is recommended for production use using the in-memory backend only.
Warning
The LMDB backend has not yet been benchmarked. While it may provide sufficient performance for edge nodes (wallets, explorers, exchanges etc.) at a valuable reduction in memory usage, it should not be used for block producer or relay nodes on mainnet.
Known Issues
There is a known bug with the experimental Ouroboros Genesis feature that is not yet recommended for mainnet use.
ChainSync Jumping (CSJ) is not disabled once a node is caught up. This should not affect normal operation of the syncing node, but does risk a DoS attack for the caught-up node. It will be corrected in a future release (Issue IntersectMBO/ouroboros-consensus#1490).
There is also a known bug when starting from a Byron snapshot. The node will reject the snapshot and replay the chain from the start. However the time it takes to replay byron is small, and the chance of users starting the node from a Byron snapshot is also low. Therefore the issue will be fixed in 10.6.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, M3 or M4) processor
- 24GB of RAM when running with the InMemory backend, 8GB when running with the OnDisk backend (pending confirmation)
- 300GB of free storage (350GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS, 22.04 LTS; Mint 19.3, 20; Debian 10.3)
- Windows 64-bit (8.1, 10, 11)
- MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
- GHC 9.6
- Cabal 3.8/3.12
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- Cardano Node documentation
- For details about changes to configuration for
UTxO-HDplease refer to the Consensus docs on UTxO-HD - The getting started guide may also be helpful for general queries.
- Networking options and related changes are listed on the P2P section
- For details about changes to configuration for
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign-off
| Role | Approval |
|---|---|
| Technical Steering Committee (Intersect) | 🟢 |
| Product Committee (Intersect) | 🟢 |
| Test Engineer | 🟢 |
| Performance Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
Node
- Relocate configuration options related to the LedgerDB under a new
"LedgerDB"key in the configuration file. See Consensus' webpage for more information.
Tracing
-
New tracing: fix the following faulty metrics:
connectionManager_*,slotsMissed. -
Old Tracing: rename metric
connectionManager.prunableConnstoconnectionManager.fullDuplexConnsfor incerased consistency. -
Reworded human description of some traces to be more explanatory.
-
Relocate
LedgerDBrelated traces under theLedgerEventnamespace.
Consensus
- Release UTxO-HD rework. For more information check the webpage.
- Decrease the maximum permissible clock skew from 5s to 2s.
Ledger
- No changes
Network
- No changes
CLI
-
Corrected the flipped text & JSON output format for
query stake-poolscommand.
(bugfix)
PR 1139 -
Make the output format flag for the
query utxocommand only have one default: JSON (rather than a different default depending on whether the output file is specified).
(breaking, refactoring)
PR 1133 -
Add canonical CBOR output toggle for transaction building and signing commands.
(feature, compatible)
PR 1092
API
Submit API
- No changes
Plutus
- No changes
Detailed Changelogs
Individual packages' changelogs
| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.1 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| byron-spec-chain | 1.0.1.0 | CHANGELOG.md |
| byron-spec-ledger | 1.1.0.0 | CHANGELOG.md |
| cardano-api | 10.14.1.0 | CHANGELOG.md |
| cardano-binary | 1.7.1.0 | CHANGELOG.md |
| cardano-cli | 10.8.0.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.6.0.0 | [CHANGELOG.md](https://github.com/intersectmbo/carda... |
10.3.1
Node 10.3.1 primarily improves on performance: it improves execution speed, reduces memory usage and gives faster synchronisation times. In addition, it provides several enhancements to the new tracing system. It also provides support for light-weight checkpointing that is needed to enable ouroboros-genesis. Finally, it includes bug-fixes for a number of CLI commands. The docker images for node and submit-api have also received improvements to streamline operations.
System testing results for the 10.3.1 release can be found on the corresponding tag testing page.
Benchmarking reports relevant to the 10.3.1 release can be found in this post on Cardano Updates.
Known Issues
-
New tracing system:
connectionManager_*metrics are incorrect; the underlying trace messageConnectionManagerCountershowever logs the correct values. -
New tracing system:
slotsMissedmetric is incorrect; it falsely counts slots since the most recent block production as missed. However, the block producer does not actually miss a slot. -
GenesisMode: the optional
peerSnapshotFiledeclaration in the topology file interprets relative paths with respect to node's binary directory rather than the topology file directory. -
There is a known bug with the experimental Ouroboros Genesis feature that is not yet recommended for mainnet use.
ChainSync Jumping (CSJ) is not disabled once a node is caught up. This should not affect normal operation of the syncing node, but does risk a DoS attack for the caught-up node. It will be corrected in a future release (Issue IntersectMBO/ouroboros-consensus#1490).
Technical Specification
Minimum System Requirements
- An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
- Or, for MacOS, an Apple Silicon (M1, M2, M3 or M4) processor
- 24GB of RAM
- 200GB of free storage (250GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS, 22.04 LTS; Mint 19.3, 20; Debian 10.3)
- Windows 64-bit (8.1, 10, 11)
- MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
- GHC 9.6
- Cabal 3.8/3.12
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- Cardano Node documentation
- For details about changes to configuration for
ouroboros-genesisplease refer to the Cardano Book - The getting started guide may also be helpful for general queries.
- Networking options and related changes are listed on the P2P section
- For details about changes to configuration for
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign-off
| Role | Approval |
|---|---|
| Technical Steering Committee (Intersect) | 🟢 |
| Product Committee (Intersect) | 🟢 |
| Test Engineer | 🟢 |
| Performance Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
Node
-
Update the default compiler version from
8.10.xto9.6.x. -
Add
ForkPolicyto the configuration (this is an experimental option for network behaviour) -
Optionally support light-weight check-pointing for
ouroboros-genesis. -
Tracing
- New
PrometheusSimplebackend which runs a simple TCP server for direct exposition of metrics, without forwarding, under the URL/metrics. - New
maxReconnectDelayconfig option inTraceOptionForwarder: Specifies maximum delay (seconds) between (re-)connection attempts of a forwarder (default: 60s). - Fix: change semantics of several
Forge.*metrics to counters - to match semantics of legacy tracing. - Fix: correct
blockdelay_cdf*metric - Fix: correct
blockReplayProgressmetric - Optimizations to trace + metrics forwarding, aimed at reducing CPU usage when under low / idle load.
- New
-
Docker
- Add baseline network configuration references for the node image
- Add a new
mergemode for the node image - Reduce default path inconsistencies within and between the node and submit-api images
- Improve documentation
- Implemented in PR#6110 where breaking changes are also noted
Consensus
- Queries and mini-protocols
- Removed legacy
{HardForkSpecific,Shelley,Cardano}NodeToClientVersionsand related code. - Export new function
querySupportedVersions. For this, add methodblockQueryIsSupportedOnVersiontoBlockSupportsLedgerQuery. - Use
NodeToClientV_20.- Expose new query QueryStakePoolDefaultVote.
- Query
GetProposedPParamsUpdateshas been deprecated and is not supported inShelleyNodeToClientV12(NodeToClientV_20).
- Removed legacy
- Tracers
- Added a new CSJ tracer to ChainSync client interface.
- Renamed the existing tracer in
Ouroboros.Consensus.Node.Tracers.Tracers. - Added peer sharing tracer to NTN tracers.
- Renaming and relocation
- Move
Ouroboros.Consensus.Cardano.ByronHFCtoOuroboros.Consensus.Byron.ByronHFC.
- Move
- Expose blockchain time as
getBlockchainTime :: BlockchainTime min the NodeKernel - Deprecate the
StandardXtype aliases for eras.
Ledger
- Removed crypto-parametrization from ledger eras, which finally allowed us to avoid regression in
ghc-9and stop usingghc-8.10.7for buildingcardano-nodereleases. - Improve performance of ledger snapshot creation by changing how we serialize
UTxOin the ledger state. This should sove an issue with missed leadership checks due to snapshot creation problemouroboros-consensus#868 - Add cli to
plutus-debugexecutable and provide ability for overridding different parts used for script execution. - Much cleanup, re-organization of the code and various minor performance optimizations
Network
keep-alivemini-protocol receiver is always (re)started, when we receive traffic on any othernode-to-nodemini-protocol- experimental option which binds mini-protocol threads to lower capabilities, leaving two capabilities free for other threads
CLI
-
Bump cardano-api to include bug fixes for:
- Silently dropping simple scripts in transaction construction
- Not selecting the highest protocol version in a given era. This resulted in erroneous plutus script decoding failures.
(compatible, bugfix)
PR 1127 -
Bump to cardano-api-10.13.0.0 - Fix bug in the construction of the redeemer pointer map
(bugfix)
PR 1124 -
Delete top level
babbagecommand group
(breaking)
PR 1117 -
Source import of the
varypackage
(feature)
PR 1121 -
Bumped ledger and dependencies for node 10.3 release.
- Removed use of parameterised crypto (
EraCrypto c, this enables many other data types to become mono-morphic overStandardCrypto) - Added
query stake-pool-default-vote - Ensured security parameter is non-zero
(breaking, feature)
PR 1075
- Removed use of parameterised crypto (
-
Add a new query for stake-pool default vote
(feature, release)
PR 1081 -
Delete top-level
shelleycommand group and delete associated tests
(breaking)
PR 1111 -
Parallelised help golden test generation and validation
(optimisation)
PR 1103 -
Added support for mnemonic sentence generation and extended key derivation from mnemonic sentences.
(feature)
[PR 975](https://github.com/...
10.2.1
Node 10.2.1 provides support for the new tracing system and an initial integration of Ouroboros Genesis, a new feature which enables nodes to bootstrap from the network. It also provides a number of bug fixes and enhancements, including fixes and improvements to a number of CLI commands.
Benchmarking reports relevant to the 10.2.x release series can be found in this post on Cardano Updates.
Limitations
Note that lightweight checkpoints are not integrated into node 10.2.1, so it is recommended to only use Ouroboros Genesis for testing purposes (on e.g. Preview or PreProd) and not on Mainnet.
Known Issues
There is a known bug with the experimental Ouroboros Genesis feature that is not yet recommended for mainnet use.
ChainSync Jumping (CSJ) is not disabled once a node is caught up. This should not affect normal operation of the syncing node, but does risk a DoS attack for the caught-up node. It will be corrected in a future release (Issue IntersectMBO/ouroboros-consensus#1490).
Technical Specification
Minimum System Requirements
- An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
- Or, for MacOS, an Apple Silicon (M1, M2, M3 or M4) processor
- 24GB of RAM
- 200GB of free storage (250GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS, 22.04 LTS; Mint 19.3, 20; Debian 10.3)
- Windows 64-bit (8.1, 10, 11)
- MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
- GHC 8.10.7
- Cabal 3.8/3.12
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Sign-off
| Role | Approval |
|---|---|
| Technical Steering Committee (Intersect) | 🟢 |
| Product Committee (Intersect) | 🟢 |
| Test Engineer | 🟢 |
| Performance Engineer | 🟢 |
| Site Reliability Engineer | 🟢 |
| Release Engineer | 🟢 |
Legend
- 🟢 - signed / agreed / supported
- 🟥 - not agreed / unsupported
Changelogs
Node
cardano-node
-
Ledger peer snapshot path entry added to topology JSON parser,
which a new decoder functionreadPeerSnapshotFileprocesses
at startup and SIGHUP. Data is available to the diffusion layer
via TVar. -
Configuration changes:
- Add
ConsensusModeandMinBigLedgerPeersForTrustedState - Add Genesis config
- Add
diffusionModeto local root peers group configuration - Add
DoDiskSnapshotChecksum
- Add
-
Use new tracing system by default. To continue using the current system, explicitly set
"UseTraceDispatcher": falsein the config. -
Change fallback node name for trace forwarding from
host:porttohost_port -
Replace
snap-serverbased web stack inside the Node withwarp / wai -
Tracing updates:
- Add support for
ChainSelStarvationEvent,ExtValidationError - Add support for
KeepAliveprotocol - Add support for
LocalStateQueryprotocol - Add support for
UsingBigLedgerPeerSnapshot,VerifyPeerSnapshot - Add support for
ConnectionError - Add support for
AddNewNodeIdMapping - Add support for
PeerFetchandPeerStarvedUs - Add support for
SnapshotMissingChecksum - Add support for stateful messages
- Add
maximumKesEvolutionstoInvalidKesSignatureOCERTevent - Rename kind field of all
MuxXxxtrace messages to beMux.Xxx - Rename fields in
RotatedDynamoevent tooldPeer,newPeer - Rename
ConnectTotoConnect - Change format of
GenesisPoint,LabelPeer,DecisionEvent - Change format of
ConnectionManagerState - Change format of
AddedToCurrentChain - Drop support for
ClientAgency,ServerAgency - Drop support for
FetchDecision declined,FetchDecision results - Drop support for
StakeKeyInRewardsDELEG - Drop support for
ChainSelectionForFutureBlock,BlockInTheFuture,
CandidateContainsFutureBlocks,CandidateContainsFutureBlocksExceedingClockSkew,
InvalidBlockReason
- Add support for
-
Drop NodeToClient versions 9 through 15, and add 19
-
Increase minor protocol version to
10.3
Consensus
- Snapshots are now CRC-checksum checked (link).
- Drop NodeToClient versions < 16 (link).
- Remove
cdbFutureBlocksas headers now will be delayed until they are no
longer "from the future" (link). - Implement new bulk sync logic for BlockFetch for Genesis (link).
- Update to
typed-protocols-0.3.0.0API and addKeepAlivetracer (link). - Fixed a bug where a valid tx with less than 4 bytes less than the max tx size
would be incorrectly rejected by the mempool (link). TestXxxHardForkAtVersionwas removed in favor ofCardanoHardForkTriggers(link).
Ledger
- Add registered DRep stake distribution query
Network
- Genesis support, see cardano developer portal.
- New bulk sync algorithm for Genesis mode: PR4919
- Diffusion mode for local root peers: PR5020, see cardano developer portal.
- Improvements to connection handshake which enable enforcement of running only agreed upon miniprotocols: PR5061
- Changes in error handling for IOErrors.
cardano-cli
Release Notes for cardano-cli (10.2.0.0 to 10.4.0.0)
Main changes
-
Added
cardano-cli latest query ledger-peer-snapshotfor a snapshot of big ledger peers used when syncing in Genesis
(feature)
PR 727A new query subcommand
ledger-peer-snapshotwas introduced to serialize a snapshot of big ledger peers. These relays will be relied on by network layer when a node is syncing up in Genesis consensus mode, since a node may not have any or up to date information from its own ledger which are the big ledger peer relays. -
Added the
debug check-node-configuration --node-configuration-file node-config.jsoncommand
that readsnode-config.jsonand checks that the hashes of genesis files are correct.
(feature)
PR 923 based on ADR 5 -
Added anchor data hash checks to
transaction build
(feature)
PR 951This version adds a built-in check that allows
cardano-clito verify anchor data linked by a transaction at the time it is being built if using the commandtransaction build. Thecardano-cliwill automatically try to download the referenced anchor data, hash it, and check the obtained hash against the one in the transaction, letting the user know if there is a mismatch.
Other features
-
Added
cardano-cli conway query future-pparams
(feature, compatible)
PR 1038 -
Added the ratify-state query
(feature, compatible)
PR 1036 -
Added certificates to CLI interface in
compatible transaction-sign
(feature, compatible)
PR 972 -
DRep ID: support key hash as input
(compatible)
PR 1009 -
transaction id: added
--output-[json,text]flag to control format of the output
(feature, compatible)
[PR 1005](https...
10.1.4
It is required that all Cardano stake pools and relays upgrade to this node version in order to mitigate a potential DoS attack following a hard fork to Protocol Version 10 ("Plomin" hard fork on mainnet). It is recommended that all other node users upgrade to this version. Node users who do not upgrade put themselves at risk of a potential DoS attack following the hard fork.
Node 10.1.4 is a mainnet-ready release of the Cardano node that is capable of crossing the Chang#2 ("Plomin") hard fork.
It adds safeguards at the mempool level to block specific types of transaction that could lead to a DoS attack following the hard fork.
For further details about cardano-node 10.1.4 please see the release notes for node versions 10.1.1, 10.1.2 and 10.1.3.
Benchmarking reports relevant to the 10.1.4 release can be found in this post on Cardano Updates.
Technical Specification
Minimum System Requirements
- An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
- Or, for MacOS, an Apple Silicon (M1, M2, M3 or M4) processor
- 24GB of RAM
- 200GB of free storage (250GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
- Windows 64-bit (8.1, 10, 11)
- MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
- GHC 8.10.7/Cabal 3.8.1.0
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- 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
Individual packages' changelogs
Package changelogs| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.0 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| byron-spec-chain | 1.0.1.0 | CHANGELOG.md |
| byron-spec-ledger | 1.0.1.0 | CHANGELOG.md |
| cardano-api | 10.1.0.0 | CHANGELOG.md |
| cardano-binary | 1.7.1.0 | CHANGELOG.md |
| cardano-cli | 10.1.1.0 | CHANGELOG.md |
| cardano-crypto | 1.1.2 | |
| cardano-crypto-class | 2.1.5.0 | CHANGELOG.md |
| cardano-crypto-praos | 2.2.0.0 | CHANGELOG.md |
| cardano-crypto-test | 1.5.0.2 | |
| cardano-crypto-tests | 2.1.2.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.5.1.3 | CHANGELOG.md |
| cardano-data | 1.2.3.1 | CHANGELOG.md |
| cardano-git-rev | 0.2.2.0 | |
| cardano-ledger-allegra | 1.6.0.1 | CHANGELOG.md |
| cardano-ledger-alonzo | 1.11.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo-test | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-api | 1.9.4.0 | CHANGELOG.md |
| cardano-ledger-babbage | 1.10.0.0 | CHANGELOG.md |
| cardano-ledger-babbage-test | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-binary | 1.4.0.0 | CHANGELOG.md |
| cardano-ledger-byron | 1.0.1.0 | CHANGELOG.md |
| cardano-ledger-byron-test | 1.5.2.0 | CHANGELOG.md |
| cardano-ledger-conway | 1.17.4.0 | CHANGELOG.md |
| cardano-ledger-conway-test | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-core | 1.15.0.0 | [CHANGELOG.md](https://github.com/input-output-hk/cardano-ledger/blob/0ba8e73c418... |
10.1.3
This version of the node has been superseded by version 10.1.4, which has a critical fix. 10.1.3 users on Mainnet should upgrade to node version 10.1.4 prior to the Plomin (Chang#2) hard fork to avoid the risk of a potential DoS attack.
Node 10.1.3 is a mainnet-ready release of the Cardano node that is capable of crossing the Chang#2 hard fork. This update addresses a ledger issue where DRep delegations could be removed under some conditions. This inadvertently affected the ability to withdraw rewards in Protocol Version 10, and changed the stake distribution for some DReps.
For further details about cardano-node 10.1.3 please see the release notes for 10.1.1, since significant upgrades were performed compared to previous versions of the node.
Technical Specification
Minimum System Requirements
- An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
- Or, for MacOS, an Apple Silicon (M1, M2 or M3) processor
- 24GB of RAM
- 200GB of free storage (250GB recommended for future growth)
Platforms
- Linux 64-bit (Ubuntu 18.04 LTS, 20.04 LTS; Mint 19.3, 20; Debian 10.3)
- Windows 64-bit (8.1, 10, 11)
- MacOS 10.13, 10.14, 10.15, 11
GHC/Cabal supported versions
- GHC 8.10.7/Cabal 3.8.1.0
Supported roles
| Platform | Block Production | Relay | Client (Desktop) |
|---|---|---|---|
| Linux | 🟢 | 🟢 | 🟢 |
| Windows | 🟥 | 🟥 | 🟢 |
| MacOS | 🟥 | 🟥 | 🟢 |
Downloads
Documentation
- 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
Ledger
- Fix buggy behavior of DRep delegations #4772
Individual packages' changelogs
Package changelogs| Package | Version | Changelog |
|---|---|---|
| Win32-network | 0.2.0.0 | ChangeLog.md |
| base-deriving-via | 0.1.0.2 | CHANGELOG.md |
| byron-spec-chain | 1.0.1.0 | CHANGELOG.md |
| byron-spec-ledger | 1.0.1.0 | CHANGELOG.md |
| cardano-api | 10.1.0.0 | CHANGELOG.md |
| cardano-binary | 1.7.1.0 | CHANGELOG.md |
| cardano-cli | 10.1.1.0 | CHANGELOG.md |
| cardano-crypto | 1.1.2 | |
| cardano-crypto-class | 2.1.5.0 | CHANGELOG.md |
| cardano-crypto-praos | 2.1.2.0 | CHANGELOG.md |
| cardano-crypto-test | 1.5.0.2 | |
| cardano-crypto-tests | 2.1.2.0 | CHANGELOG.md |
| cardano-crypto-wrapper | 1.5.1.3 | CHANGELOG.md |
| cardano-data | 1.2.3.1 | CHANGELOG.md |
| cardano-git-rev | 0.2.2.0 | |
| cardano-ledger-allegra | 1.6.0.1 | CHANGELOG.md |
| cardano-ledger-alonzo | 1.11.0.0 | CHANGELOG.md |
| cardano-ledger-alonzo-test | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-api | 1.9.4.0 | CHANGELOG.md |
| cardano-ledger-babbage | 1.10.0.0 | CHANGELOG.md |
| cardano-ledger-babbage-test | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-binary | 1.4.0.0 | CHANGELOG.md |
| cardano-ledger-byron | 1.0.1.0 | CHANGELOG.md |
| cardano-ledger-byron-test | 1.5.1.1 | CHANGELOG.md |
| cardano-ledger-conway | 1.17.3.0 | CHANGELOG.md |
| cardano-ledger-conway-test | 1.3.0.0 | CHANGELOG.md |
| cardano-ledger-core | 1.15.0.0 | CHANGELOG.md |
| cardano-ledger-mary | 1.7.0.1 | [CHANGELOG.md](http... |
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
GetFuturePParamsquery - Updated N2C part of
latestReleasedNodeVersiontoNodeToClientV_18. - Updated N2N part of
latestReleasedNodeVersiontoNodeToNodeV_14 - Decrease the maximum permissible clock skew from 5s to 2s.
Ledger
- Translation of
RegTxCertandUnRegTxCerttoPlutusV3scripts 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
ppuCoinsPerUTxOBytescannot 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
maxMajorPVfromGlobals, 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,nodeetc. -
The majority of the
legacycommands have been removed and we intend to fully remove thelegacycommand 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_certandvote_reg_deleg_certandstake_vote_reg_deleg_certas:- 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-datanow 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 actioncommands
(feature, breaking, test)
PR 915 -
Adding support for script stake credentials and stake address in
create-treasury-withdrawaland improving help text. New options are:--funds-receiving-stake-script-fileand--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... |