Skip to content

Releases: IntersectMBO/cardano-node

Cardano Node 8.1.2

26 Jul 12:17
d2d90b4
Compare
Choose a tag to compare

This Cardano node release is mainnet ready and updates the Plutus interpreter. All SPOs are encouraged to update, especially ones that are currently running Cardano node version 8.1.1.

Node 8.1.2 is a minor release of the Cardano node, which updates the Plutus interpreter.

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
  • Docker image
  • Static binaries: See release artifacts. This section will be removed in future releases as are now part of the GH release artifacts.
  • Configuration files

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 ✔️
Site Reliability Engineer ✔️
Release Engineer ✔️

Changelogs

Node
  • Update plutus-ledger-api
Consensus *NONE*
Ledger *NONE*
Network

NONE

Cardano-cli *NONE*
Cardano-api *NONE*
Submit-api *NONE*
Individual packages' changelogs Package 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.0 CHANGELOG.md
byron-spec-ledger 1.0.0.0 CHANGELOG.md
cardano-api 8.2.0.0 CHANGELOG.md
cardano-api-gen 8.1.0.2 ChangeLog.md
cardano-binary 1.7.0.1 CHANGELOG.md
cardano-crypto 1.1.2
cardano-crypto-class 2.1.1.0 CHANGELOG.md
cardano-crypto-praos 2.1.2.0 CHANGELOG.md
cardano-crypto-test 1.5.0.0
cardano-crypto-tests 2.1.1.0 CHANGELOG.md
cardano-crypto-wrapper 1.5.1.0 CHANGELOG.md
cardano-data 1.1.0.0 CHANGELOG.md
cardano-ledger-allegra 1.1.1.0 CHANGELOG.md
cardano-ledger-alonzo 1.2.1.0 CHANGELOG.md
cardano-ledger-alonzo-test 1.1.1.0
cardano-ledger-api 1.2.0.0 CHANGELOG.md
cardano-ledger-babbage 1.2.1.0 CHANGELOG.md
cardano-ledger-babbage-test 1.1.1.0
cardano-ledger-binary 1.1.1.0 CHANGELOG.md
cardano-ledger-byron 1.0.0.0 CHANGELOG.md
cardano-ledger-byron-test 1.5.0.0
cardano-ledger-conway 1.2.0.0 CHANGELOG.md
cardano-ledger-conway-test 1.1.1.0
cardano-ledger-core 1.2.0.0 CHANGELOG.md
cardano-ledger-mary 1.2.0.0 CHANGELOG.md ...
Read more

Cardano Node 8.1.1

19 Jun 17:55
6f79e5c
Compare
Choose a tag to compare

This release is mainnet ready and has significant improvements at epoch boundary. All SPOs are strongly encouraged to update.

Node 8.1.1 is a minor release of the Cardano node. This contains a fix from ouroboros-network for P2P topologies that don't contain DNS names in local roots.

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
  • Docker image
  • Static binaries: See release artifacts. This section will be removed in future releases as are now part of the GH release artifacts.
  • Configuration files

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

Changelogs

Node

NONE

Consensus *NONE*
Ledger *NONE*
Network
  • fix for P2P topology containing only IP addresses
Cardano-cli *NONE*
Cardano-api - cardano-api split out from cardano-node repository.
Submit-api *NONE*

Sign off

Role Approval
Cardano Head of Engineering ✔️
Cardano Head of Product ✔️
Test Engineer ✔️
Site Reliability Engineer ✔️
Release Engineer ✔️

Cardano Node 8.1.0

08 Jun 12:11
93c0307
Compare
Choose a tag to compare
Cardano Node 8.1.0 Pre-release
Pre-release

THIS RELEASE IS NOT RECOMMENDED FOR USE ON ANY NETWORKS
Node 8.1.0 is a major release of the Cardano node. Updates to the ledger packages extend progress on the Conway ledger era, including the introduction of Plutus V3. They also improve performance at the epoch boundary, resolving a long-standing issue where a large computation was disrupting the block leader check (see #4421). Updates to the networking packages introduce a new query to the handshake, which is helpful for debugging. The cardano-api has been moved to a separate repository.

NOTE Because of P2P bug fix, this is superseded by 8.1.1

The release also includes a number of bug fixes and further performance improvements.
In particular, a DNS issue was partially resolved which affected peer-to-peer networking.

Please note that this version contains breaking changes

  • The ledger state serialization has been changed to accommodate the Conway ledger era
  • The Ping command now takes a new parameter, query.

Known Issues

  • Please see list of 8.1.0 issues
  • If there's no DNS name in any of the local root groups of P2P topology, then all ip addresses will be ignored

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

Changelogs

Node

NONE

Consensus
  • Fix query serialization for backwards compatibility. The GetCurrentPParams query now uses the legacy en-/decoding for its result again when the NodeToClientVersion is <15, restoring compatibility with older clients.
  • Optimise GetStakeSnapshots query to not traverse all delegations
    per stake pool, but instead compute the total stake per pool in a
    map and do a lookup
  • Fix performance regression of GetFilteredDelegationsAndRewardAccounts query.
  • Introduce NodeToClientV_15 that enables the deposits query.
  • Increase the minimum reconnection delay from 0s to 10s.
Ledger
  • Plutus V3 support, only available in the conway ledger era.
  • PState is now parametric in era, not crypto.
  • Adjust for new conway era certificates.
  • Ledger UMapCompact is now UMap
  • Ledger types with names involving DState are renamed to CertState.
Network - Change how DNS for local root peers works
Cardano-cli *NONE*
Cardano-api *NONE*
Submit-api *NONE*

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

Cardano Node 8.0.0

09 May 17:18
69a117b
Compare
Choose a tag to compare

Node 8.0.0 is a major release of the Cardano node that adds initial, experimental, support for the Conway ledger era (Protocol Version 9.0).
It includes some additional CLI commands, bug fixes, and network configuration options. SPOs are recommended to deploy this version on all their nodes. This version of the Cardano node:

  • Introduces the Conway era (Voltaire) as a developmental hard fork. Note: the node does not have any Voltaire features yet, this just prepares the way by creating the transaction formats and providing the ability to hard fork into the era.
  • Adds a governance action for SPO polls (cardano-cli governance poll) that the Cardano Foundation will use to conduct an SPO survey
  • Introduces a fairness improvement into the mempool logic
  • Adds query commands to inspect metrics and data in mempool
  • Allows the network to be defined via CARDANO_NODE_NETWORK_ID instead of needing to be passed in every CLI query
  • Adds more detailed output in the query tip CLI command
  • Allows modification via configuration file of connection limits
  • Provides versioned serialization formats for ledger
  • Provides a ledger API
  • Changes the tracking of deposits

It also includes some bug fixes and performance improvements.

IMPORTANT: On mainnet, P2P networking is only intended to be ran on a single relay at this time. Please continue to run any other relays with P2P disabled using the legacy topology.

Please note that this version contains breaking changes

  • Needs newer libsodium-vrf revision dbb48cce5429cb6585c9034f002568964f1ce567

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

Changelogs

Node

NONE

Consensus
  • The transactions in the mempool are now guaranteed to be processed irrespective of their sizes. This change also caused tryAddTxs to be removed in favour of a new addTx function.
Ledger
  • The provenance for the reward calculation has been removed. The type signature to the API function getRewardProvenance has not changed, it just returns an empty provenance value.
  • We have created a Ledger API, with the aim of providing a user-friendly interface to the ledger libraries. See here.
  • The initial funds and staking in the Shelley genesis type (used only for testing) now use ListMap instead of Map.
  • There is a new calculatePoolDistr' function which is similar to calculatePoolDistr but has a new filter argument to only include the stake pool ids (stake pool key hashes) that are needed.
  • The ledger events are not guaranteed to appear in any given order within a block. For this reason, motivated by the use case in db-sync, the TotalDeposits event now includes a transaction ID and emits the change in deposits instead of the value.
  • We changed the way deposits are tracked. See here for the details.
  • We changed the API function Cardano.Ledger.Shelley.API.Wallet(evaluateTransactionBalance) to take DPState as input. This can no longer be computed without the DPState
  • Some noticeable changes have been made which will only become apparent starting at major protocol version 9:
    • There is a new ledger era, namely conway.
    • We now have the ability to more easily change serializations when the major protocol version changes. Though this change is not immediately visible to the node, it enables visible changes in the future. See CIP-80 For the deprecation cycle.
    • Pointer addresses will no longer accrue rewards starting with version 9.
    • We fixed the incorrect conversion of the validity interval's upper bound in transVITime.
    • Starting in version 9, duplicate keys in CBOR maps and sets are no longer allowed.
    • Starting in version 9, CostModels can now be deserialized from any map of Word8 values to lists of integers. Only valid cost models are actually converted to evaluation contexts that can be used. Errors and unrecognized language versions are stored in the CostModel type so that:
      • They can accept cost models that they do not yet understand.
      • Upon deserializing after a software update, new cost models are available from the prior serialization.
Network
Cardano-cli
  • cardano-cli provides ping command, which previous was available as a standalone cardano-ping executable.
  • Rename TestEnableDevelopmentHardForkEras to ExperimentalHardForksEnabled and TestEnableDevelopmentNetworkProtocols to ExperimentalProtocolsEnabled
  • Auto-balance multi asset transactions
  • Default to the ledger's CDDL format for transaction body creation by removing flags --cddl-format and --cli-format from build and build-raw
  • Update create-staked with the ability to specify relays for all created stake pools
Cardano-api
  • Append, not prepend change output when balancing a transaction
  • Preserve ScriptData bytes with HashableScriptData
  • Remove distinction between multisig and timelock scripts
Submit-api

NONE

Sign off

Role Approval
Cardano Head of Engineering ✔️
Cardano Head of Product ✔️
Test Engineer ✔️
Site Reliability Engineer ✔️
Release Engineer ✔️

Cardano Node 1.35.7

04 Apr 18:06
f0b4ac8
Compare
Choose a tag to compare

Node 1.35.7 is a bug fix release that addresses an issue with the legacy network stack connecting to a P2P relay. SPOs are recommended to deploy this version on all their nodes.

IMPORTANT: P2P on mainnet is only intended to be ran on a single relay at this time. Continue to run any other relays with P2P disabled using the legacy topology.

NOTICE Minimum resources were adjusted in this release due to chain growth.

Please note that this version contains no breaking changes

Known Issues

  • Shelley ledger era Tx body in CDDL format is not supported by some CLI commands (#3688)

  • Cardano-cli computes wrong collateral return output for multiple occurrences of collateral inputs (#4744)

  • A hot -> warm -> hot busy demotion / promotion cycle is not fixed in this release (#4385)

  • cardano-submit-api can't handle transactions (#4829)

  • Please see here for other known issues. None of these is considered to be a blocker.
    They will be addressed in future releases.

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
Supported roles
Platform Block Production Relay Client (Desktop)
Linux ✔️ ✔️ ✔️
Windows ✔️
MacOS ✔️
Downloads

Documentation

Changelogs

Node

NONE

Consensus

NONE

Ledger

NONE

Network
Cardano-cli

NONE

Cardano-api

NONE

Submit-api

NONE

Sign off

Role Approval
Cardano Head of Engineering ✔️
Cardano Head of Product ✔️
Test Engineer ✔️
Site Reliability Engineer ✔️
Release Engineer ✔️

Cardano Node 1.35.6

16 Mar 14:01
1.35.6
07b0c71
Compare
Choose a tag to compare

Node 1.35.6 is a release adding P2P support without need of development network protocols when EnableP2P is set to true. The legacy topology is still supported as a parallel mode of operation. This release is based on the release/1.35 branch so has no changes not related to P2P included.

IMPORTANT: P2P on mainnet is only intended to be ran on a single relay at this time. Continue to run any other relays with P2P disabled using the legacy topology.

P2P Configuration

To run a node in P2P mode set EnableP2P to true (the default is False) in the configuration file. You will also need to specify the topology in a new format which is described here. There are a few new tracers and configuration options which you can set (listed below by component):

Outbound Governor

The outbound governor is responsible for satisfying targets of root peers, known (cold, warm and hot), established (warm & hot) and active peers (synonym for hot peers) and local root peers. The primary way to configure them is by setting the following options:

  • TargetNumberOfRootPeers (default value: 100) - a minimal number of root peers (unlike other targets this one is one sided, e.g. a node might have more root peers
  • TargetNumberOfKnownPeers (default value: 100) - a target of known peers (must be larger or equal to TargetNumberOfRootPeers)
  • TargetNumberOfEstablishedPeers (default value: 50) - a target of all established peers (including local roots, ledger peers)
  • TargetNumberOfActivePeers (default value: 20) - a target for hot peers which engage in the consensus protocol

Let us note two more targets. In the topology file you may include local root peers. This is a list of groups of peers, each group comes with its own valency. The outbound governor will maintain a connection with every local root peer, and will enforce that at least the specified number of them (the valency) are hot. Thus the TargetNumberOfKnownPeers , TargetNumberOfEstablishedPeers and TargetNumberOfActivePeers must be large enough to accommodate local root peers.

The following traces can be enabled:

  • TracePeerSelection (by default on) - tracks selection of upstream peers done by the outbound-governor. Warm peers are ones with which we have an open connection but don't engage in consensus protocol, hot peers are peers which engage in consensus protocol (via chain-sync, block-fetch and tx-submission mini-protocols), cold peers are ones which we know about but the node doesn't have an established connection. Note that the notions of hot, warm and cold are only related to usage of initiator sides of mini-protocols in a connection (which can be either inbound or outbound).
  • TracePeerSelectionCounters (by default on) - traces how many cold / warm / hot / local root peers the node has, it's also available via ekg.
  • TracePeerStateActions (by default on) - includes traces from a component which executes peer promotion / demotions between cold / warm & hot states.
  • TracePublicRootPeers (by default off) - traces information about root / ledger peers (e.g. ip addresses or dns names of ledger peers, dns resolution)
  • DebugPeerSelectionInitiator and DebugPeerSelectionInitiatorResponder (by default off) - a debug tracers which log the information about current state of the outbound governor.

At this point haddock documentation of the outbound governor is available.

Inbound Governor

The inbound governor is maintaining responder side of all mini-protocols. Unlike the outbound governor it is a purely responsive component which reacts to actions of remote peer (its outbound governor).

  • TraceInboundGovernor (by default on) - traces information about inbound connection, e.g. we track if the remote side is using our node as warm or hot peer, traces when we restart a responder.
  • TraceInboundGovernorCounters (by default on) - traces number of peers which use the node as cold, warm or hot (which we call remote cold, remote warm or remote hot). Note that we only know if a peer is in the remote cold state if we connected to that peer and it's not using the connection. This information is also available via ekg.
  • TraceInboundGovernorTransitions (by default on) - a debug tracer which traces transitions between remote cold, remote warm and remote hot states.

The inbound governor is documented in The Shelley Networking Protocol (section 4.5).

Connection Manager

Connection manager tracks the state of all tcp connections, and enforces various timeouts, e.g. when the connection is not used by either of the sides. The following traces are available:

  • TraceConnectionManager (by default on) - traces information about new inbound or outbound connection, connection errors.
  • TraceConnectionManagerCounters (by default on) - traces the number of inbound, outbound, duplex (connections which negotiated P2P mode and can use a connection in full duplex mode), full duplex (connections which run mini-protocols in both directions, e.g. at least warm and remote warm at the same time), unidirectional connections (connections with non p2p nodes, or p2p nodes which configured themselves as initiator only nodes).
  • TraceConnectionManagerTransitions (by default on) - a low level traces which traces connection state changes in the connection manager state machine.

The connection manager is documented in The Shelley Networking Protocol (section 4).

Ledger Peers

Ledger peers are the relays registered on the chain. Currently we use square of the stake distribution to randomly pick new ledger peers. You can enable TraceLedgerPeers (by default off) to log actions taken by this component.

Server

The accept loop. You can enable TraceServer to log its actions or errors it encounters (by default it is off, however we suggest to turn it on) .

Please note that this version contains no breaking changes

Known Issues

  • Shelley ledger era Tx body in CDDL format is not supported by some CLI commands (#3688)

  • Cardano-cli computes wrong collateral return output for multiple occurrences of collateral inputs (#4744)

  • A hot -> warm -> hot busy demotion / promotion cycle is not fixed in this release (#4385)

  • Please see here for other known issues. None of these is considered to be a blocker.
    They will be addressed in future releases.

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)
  • 16GB of RAM
  • 120GB of free storage (200GB 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
Supported roles
Platform Block Production Relay Client (Desktop)
Linux ✔️ ✔️ ✔️
Windows ✔️
MacOS ✔️
Downloads

Documentation

Changelogs

Node

NONE

Consensus
  • Report consensus initialisation errors (#4015).
Ledger

NONE

Network
  • Split WarningDevelopmentNetworkProtocolVersions into WarningDevelopmentNodeToNodeVersions and WarningDevelopmentNodeToClientVersions (#4691).
  • Provided NodeToNodeVersion and NodeToClientVersion JSON instances (#4691).
  • Modified P2PWarning, it now sais: You are using an early release of peer-to-peer capabilities, please report any issues. (#4691).
  • Removed not needed P2PWarningDevelopmentNetworkProtocols (#4691).
  • New p2p topology file format (#4559).
  • Fixed warm -> cold demotion (IntersectMBO/ouroboros-network#4163).
  • Added PeerGSV to [SendFetchRequest](https://input-output-hk.gi...
Read more

Cardano Node 1.35.5

27 Jan 13:01
8762a10
Compare
Choose a tag to compare

Node 1.35.5 is a maintenance release addressing a fix in ledger internal data structures.

Please note that this version contains no breaking changes

Known Issues

  • Shelley ledger era Tx body in CDDL format is not supported by some CLI commands (#3688)

  • Cardano-cli computes wrong collateral return output for multiple occurrences of collateral inputs (#4744)

  • Please see here for other known issues. None of these is considered to be a blocker.
    They will be addressed in future releases.

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)
  • 16GB of RAM
  • 120GB of free storage (200GB 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
Supported roles
Platform Block Production Relay Client (Desktop)
Linux ✔️ ✔️ ✔️
Windows ✔️
MacOS ✔️
Downloads

Documentation

Changelogs

Node

NONE

Consensus

*NONE

Ledger
  • Fixes internal data structure representation
Network

NONE

Cardano-cli

NONE*

Cardano-api

NONE

Submit-api

NONE

Sign off

Role Approval
Cardano Head of Engineering ✔️
Test Engineer ✔️
Site Reliability Engineer ✔️
Release Engineer ✔️

Cardano Node 1.35.4

07 Nov 18:06
Compare
Choose a tag to compare

Node 1.35.4 supports the use of SECP256K1 elliptic curves via new Plutus primitives at protocol version 8. It also includes some CLI improvements, including changing the default ledger era to Babbage for transaction commands.

Please note that this version contains breaking changes, as listed below:

Breaking Changes

  • With this version, all transactions are created in the Babbage ledger era format if --<ledger-era>-era is not passed as an option.

Known Issues

  • Shelley ledger era Tx body in CDDL format is not supported by some CLI commands (#3688)

  • Please see here for other known issues. None of these is considered to be a blocker.
    They will be addressed in future releases.

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)
  • 16GB of RAM
  • 120GB of free storage (200GB 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
Supported roles
Platform Block Production Relay Client (Desktop)
Linux ✔️ ✔️ ✔️
Windows ✔️
MacOS ✔️
Downloads

Documentation

Changelogs

Node
  • Update Plutus to version 1.0.0.1 to enable SECP256K1 primitives at protocol version 8
    Benchmark results for SECP256K1 Primitive
  • Update cardano-crypto-class to version 2.0.0.0.1 to add SECP256K1 crypto primitives
  • Update block header advertised version in babbage to 8.0
Consensus
  • The maximum major protocol version of the Cardano protocol is now correctly
    based off of Babbage instead of Alonzo.
Ledger

NONE

Network

NONE

Cardano-cli
  • Improve memory efficiency of query ledger-state command (PR4205)
  • Update transaction build command to automatically calculate total and return collateral values(PR4198)
  • Allow reading and writing text envelope files from pipes(PR4384)
  • Update transaction view command to render inline datums and reference inputs (PR4089)
  • Switch default era in cardano-cli from Alonzo to Babbage (PR4485)
  • For the transaction build and transaction build-raw commands, always use ledger's CDDL format for transaction body creation.
    Remove the cli-format flag and make --cddl-format deprecated and hidden
    (PR 4303 PR 4617)
  • Allow reading signing keys from a pipe (PR 4342)
Cardano-api
  • Expose Key interface via Cardano.Api.Shelley (PR4048)

  • Append, not prepend change output when balancing a transaction (PR4343)

  • Expose convenience functions executeQueryCardanoMode, determineEra, constructBalancedTx and queryStateForBalancedTx (PR 4446)

Submit-api

NONE

Sign off

Role Approval
Cardano Head of Engineering ✔️
Test Engineer ✔️
Site Reliability Engineer ✔️
Release Engineer ✔️

Cardano Node 1.35.3

11 Aug 17:12
950c4e2
Compare
Choose a tag to compare

Node 1.35.3 fixes some important issues with previous versions of the node and provides some CLI enhancements. The node provides full Vasil era capabilities.

Node 1.35.3 adds important functionality that will enable the use of new Plutus capabilities
following the Vasil hard fork, including node and CLI support for:

It also includes significant improvements to the logging/monitoring, and networking codebases, as well as significant memory and time performance improvements, including the first implementation of diffusion pipelining, and reduced VRF checks, as well as several improvements to the ledger.

Please note that this version contains breaking changes, as listed below, specifically with respect to operational certificates
on the CLI. Stake pool operators may need to update their management scripts to accommodate this change.

Breaking Changes

  • With this version, the ledger state will need to be replayed from the genesis block, meaning that the initial synchronisation may be slow. Users should account for this when deploying the node.
  • Restricted opcert issue number increment, as of Babbage. Previously op cert issue numbers could be anything, provided it was larger than previously used numbers. Now the op cert counter must be exactly one more than the previously used op cert.
  • The decentralisation ('d') updatable protocol parameter has been removed, as of Babbage. It will no longer be possible to change this from its current setting (fully decentralised).
  • Bugfix: transaction validity intervals will actually be limited, as of Babbage.

Known Issues

  • Shelley era Tx body in CDDL format is not supported by some CLI commands (#3688)

  • Please see here for known issues.

None of these issues are considered to be blockers for the mainnet hard fork;
they will be addressed in future releases.

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)
  • 16GB of RAM
  • 100GB of free storage (150GB 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
Supported roles
Platform Block Production Relay Client (Desktop)
Linux ✔️ ✔️ ✔️
Windows ✔️
MacOS ✔️
Downloads

Documentation

Changelogs

Node
  • RTS workaround converting SIGTERM into SIGINT (#3641)
  • Install a dummy SIGHUP handler for non p2p mode (#3896)
  • Add --shutdown-on-slot-synced test and ensure ExitSuccess (#3670)
  • cardano-node: implement --shutdown-on-block-synced (#3932)
  • Update dependencies and pins. (#3700)
  • Propagate protocol in block type (#3818)
  • Create VRF signing key file with correct permissions (#1948)
  • Fix for eliding of the ChainDB tracer (#4038)
  • Tracing infra updates:
    • Configuration structure rework, for better UX: (#3867)
    • Rework implementation to eliminate prototypes from trace definitions (#3731)
    • Fix tracing config to allow selection of the new tracing system (#3655)
    • Register GC metrics. (#3858)
    • Metrics are no longer impacted by severities and frequency limits (#3876)
    • Porting ekg-direct metrics to new-tracing (#3873)
    • Node state data point extensions and fixes: (#3854, #3656)
    • Old peers tracing was erroneously called in new tracing (#3880)
    • Remove unused constraints from TraceConstraints (#3822)
    • Properly init trace forwarding when needed. (#3634)
  • cardano-tracer:
    • Format fixes for forwarded traces: (#3640, #3654, #3660, #3671).
    • Test fixes: (#3714)
    • Remove symlink, fix logs cut off. (#3930)
    • Fix bug with empty line (#3962)
    • RTView, a web performance dashboard, as part of cardano-tracer (#3852)
    • RTView: CPU usage (GC + App) as pct, https by default, errors export (#3934)
  • Documentation updates;
    • Update Haskell installation method and mention libsecp256k1 (#3796)
    • Update cardano-node-cli-reference.md (#3630)
    • Documentation improvements for new tracing. (#3834, #3842)
    • Recommended system requirements. (#4005)
    • Further explain the libsodium installation (#4000)
  • Various workbench, build, testing and benchmarking infrastructure improvements. (#3638, #3643, #3705, #3789, #3812, #3824, #3941, #3851)
  • Bump block header protocol version (#4260, #4211)
  • Update dependencies (#4242, #4220, #4146)
Consensus
  • The obsolete node check in the new 'Praos' protocol was not performing the check that was intended. It is supposed to check that the current protocol version is no greater than the max major protocol version. It was instead checking that the max major protocol version was not greater than the protocol version listed in the block header (which is currently not supposed to have any semantic meaning, and is used to manually check the readiness of the network for a hard fork). Note that this mistake is only in the Praos protocol, not in TPraos. The consequence of this incorrect check is that nodes will not properly halt after a hard fork when they do not have the required software for the hard fork. (#3891)
  • Block diffusion pipelining (#3688, #3742, #3752, #3688)
  • Moving from two VRF checks to one, as of Babbage (#3595)
  • Restricted opcert issue number increment, as of Babbage (#3595)
  • New function getOpCertCounters (#3781)
  • Bugfix: transaction validity intervals will actually be limited, as of Babbage (#3754)
  • Simplification: Babbage will run proper Praos protocol instead of Transitional Praos, since d will remain at 0 (#3595)
  • protocol: add PraosProtocolSupportsNode class (#3758)
  • Provide an EpochInfo that can fail to ledger. (#3770)
  • Add COMPLETE pragma for FallingEdge pattern synonym (#3766)
  • Simplification: remove stale handshake versions (#3696, #3699)
Ledger
Read more

Cardano Node 1.34.1

07 Mar 15:40
73f9a74
Compare
Choose a tag to compare

Node version 1.34.1 is a minor release that fixes two issues:

  1. the tracer configuration settings were not respected, meaning that tracing was always enabled;
  2. the node start time and basic information (version etc) were not recorded in EKG logs.

Known Issues

To avoid increased synchronisation times, we recommended that Windows users DO NOT upgrade to this node version. We recommend instead that they continue to run node 1.33.0. Future releases will address this issue which is specific to 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)
  • 12GB of RAM
  • 50GB of free storage
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
Supported roles
Platform Block Production Relay Client (Desktop)
Linux ✔️ ✔️ ✔️
Windows ✔️
MacOS ✔️
Downloads

Documentation

Changelogs

Fixed issues
  • Fix tracer config mismatches #3668
  • Fix #3664: Restore legacy metrics #3676

Sign off

Role Approval
Technical Lead ✔️
QA Engineer ✔️
Ops ✔️
Release Manager ✔️