NOTE: THIS RELEASE IS ONLY RECOMMENDED FOR USE ON THE SANCHONET AND PREVIEW PUBLIC TEST ENVIRONMENTS AT THIS TIME. IT IS NOT RECOMMENDED FOR USE ON THE PREPROD TEST ENVIRONMENT OR MAINNET.
Node 8.2.0 is a major release of the Cardano node. Updates to the ledger packages extend progress on the Conway ledger era to support new governance features via CIP-1694. Updates to the networking packages prepare the road for peer sharing. This release is phase 1 of the SanchoNet roll out that was referenced in the CIP-1694 workshop in Edinburgh on July 12 2023. It allows SPOs to vote on changes to the on-chain constitution. This release also adds the ability to start the node in block production mode with no secrets loaded using the --non-producing-node
flag. This can be used to promote a backup block producer without having to restart the node, for example.
This version also fixes an issue with the ledger TICKF rule that caused loss of block producer synchronisation on SanchoNet.
Known Issues
- Please see list of 8.2.0 issues
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)
- 24GB of RAM
- 150GB 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
NOTE: Linux is showing a git revision of 0000000000000000000000000000000000000000
in --version
because of a corruption issue in set-git-rev that only affects static musl
built binaries. This is expected, and if it concerns you, please build from source.
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 pre-release |
Site Reliability Engineer | N/A for pre-release |
Release Engineer | ✔️ |
Changelogs
Node
NONE
Consensus
*NONE*Ledger
- Restructure certificate interface
- Conway related changes:
- Introduction of a
DRep
with pre-defined DReps that vote No and Abstain. - Change
DCert
type to aTxCert
type family and introduce new certificates - Implement voting on
NewConstitution
by StakePools as the most basic example of voting. - Implement query for getting
Constitution
hash from the ledger state. - Change structure of Governance Procedures in the TxBody
- Fix
TICKF
rule, avoiding VRF verification and syncing issues - Clear out TxOuts with zero value from the UTxO upon translation into Conway
- Introduction of a
Network
- Added
--start-as-non-producing-node
flag and implemented a way to enable block production dynamically: #5383, #5399. Note: we haven't yet verified if the performance regression of P2P BP nodes was fixed (ref). - Implemented an optional explicit warm valency for local root peers: #5409.
- Implemented bootstraping for peer sharing (also known as light peer sharing): input-output-hk/ouroboros-network#3596; new trace is included:
TraceKnownInboundConnection
which is emitted when an inbound peer is shared with the outbound governor (and thus it could be used as an upstream peer). - Renamed
FetchDeclineChainNoIntersection
asFetchDeclineChainIntersectionTooDeep
: input-output-hk/ouroboros-network#4608. - We limit concurrency used by dns resolution in P2P mode. We only resolve up to
8
dns names
concurrently for public / ledger peers and up to2
for local root peers.
This will affect how quickly node connects to ledger peers when it starts. input-output-hk/ouroboros-network#4596. - Improved memory footprint of peer metrics: input-output-hk/ouroboros-network#4620.
Cardano-cli
-
cardano-cli
split out to a separate repository -
Era-sensitive command structure
-
Set default era to Babbage in stake-address, stake-pool and governance commands
-
CARDANO_ERA
environment variable support -
Make it build with ghc-9.6
-
Add a query for the hash of the constitution
-
Update
cardano-cli
with the ability to create votes and governance actions.
Updatetransaction build
with the ability to specify votes and governance actions. -
The
--protocol-params-file
option of thetransaction build
command is
now marked as deprecated in Usage help. The option was already deprecated
and ignored. -
cardano-cli ping
changes:- timestamp format changed to
ISO8601
- added
--query-versions
flag, instread of doing version negotiation the remote
side will reply with its set of supported versions. - fixed support for
node-to-client
mini-protocol over Unix socket.
- timestamp format changed to
-
Add
--conway-era
flag.
Cardano-api
*NONE*Submit-api
*NONE*Individual packages' changelogs
Package | Version | Changelog |
---|---|---|
byron-spec-chain | 1.0.0.1 | CHANGELOG.md |
byron-spec-ledger | 1.0.0.1 | CHANGELOG.md |
cardano-cli | 8.4.0.0 | CHANGELOG.md |
cardano-binary | 1.7.0.1 | CHANGELOG.md |
cardano-crypto | 1.1.2 | |
cardano-crypto-class | 2.1.2.0 | CHANGELOG.md |
cardano-crypto-praos | 2.1.2.0 | CHANGELOG.md |
cardano-crypto-wrapper | 1.5.1.0 | CHANGELOG.md |
cardano-data | 1.1.0.0 | CHANGELOG.md |
cardano-ledger-babbage | 1.4.2.0 | CHANGELOG.md |
cardano-ledger-binary | 1.1.1.1 | CHANGELOG.md |
cardano-ledger-byron | 1.0.0.2 | CHANGELOG.md |
cardano-ledger-conway | 1.6.3.0 | CHANGELOG.md |
cardano-ledger-core | 1.4.1.0 | CHANGELOG.md |
cardano-ledger-allegra | 1.2.1.0 | CHANGELOG.md |
cardano-ledger-alonzo | 1.3.3.0 | CHANGELOG.md |
cardano-ledger-mary | 1.3.1.0 | CHANGELOG.md |
cardano-ledger-api | 1.3.1.0 | CHANGELOG.md |
cardano-ledger-pretty | 1.2.1.2 | CHANGELOG.md |
cardano-ledger-shelley | 1.4.2.0 | CHANGELOG.md |
cardano-api | 8.8.1.2 | CHANGELOG.md |
cardano-ping | 0.2.0.5 | CHANGELOG.md |
cardano-prelude | 0.1.0.2 | ChangeLog.md |
cardano-protocol-tpraos | 1.0.3.3 | CHANGELOG.md |
cardano-slotting | 0.1.1.1 | CHANGELOG.md |
cardano-strict-containers | 0.1.2.1 | CHANGELOG.md |
network-mux | 0.4.0.0 | CHANGELOG.md |
plutus-core | 1.7.0.0 | CHANGELOG.md |
plutus-ledger-api | 1.7.0.1 | CHANGELOG.md |
plutus-tx | 1.7.0.0 | CHANGELOG.md |
plutus-tx-plugin | 1.7.0.0 | CHANGELOG.md |
ouroboros-consensus | 0.9.0.0 | CHANGELOG.md |
ouroboros-consensus-cardano | 0.7.0.0 | CHANGELOG.md |
ouroboros-consensus-diffusion | 0.7.0.0 | CHANGELOG.md |
ouroboros-consensus-protocol | 0.5.0.4 | CHANGELOG.md |
ouroboros-network | 0.8.2.0 | CHANGELOG.md |
ouroboros-network-framework | 0.7.0.0 | CHANGELOG.md |
ouroboros-network-mock | 0.1.0.1 | CHANGELOG.md |
ouroboros-network-api | 0.5.0.0 | CHANGELOG.md |
ouroboros-network-protocols | 0.5.1.0 | CHANGELOG.md |
ouroboros-network-testing | 0.3.0.0 | CHANGELOG.md |
small-steps | 1.0.0.0 | CHANGELOG.md |
set-algebra | 1.1.0.1 | CHANGELOG.md |
typed-protocols | 0.1.0.6 | CHANGELOG.md |
typed-protocols-cborg | 0.1.0.4 | CHANGELOG.md |
vector-map | 1.0.1.0 | CHANGELOG.md |