Skip to content

Cardano Node 8.2.0-pre

Pre-release
Pre-release
Compare
Choose a tag to compare
@disassembler disassembler released this 28 Jul 11:25
· 1219 commits to master since this release
408d8ae

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

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

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 a TxCert 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
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): IntersectMBO/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 as FetchDeclineChainIntersectionTooDeep: IntersectMBO/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 to 2 for local root peers.
    This will affect how quickly node connects to ledger peers when it starts. IntersectMBO/ouroboros-network#4596.
  • Improved memory footprint of peer metrics: IntersectMBO/ouroboros-network#4620.
  • We turned on by default the following traces:
    • LocalConnectionManagerTracer
    • LocalInboundGovernor
    • LocalHandshake
    • LocalServer
    • Server
      See #5353
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.
    Update transaction build with the ability to specify votes and governance actions.

  • The --protocol-params-file option of the transaction 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.
  • 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