Cardano Node version 1.32.1 introduces a number of improvements and enhancements to improve the usability of the Cardano node. Native asset name rendering has been changed in order to eliminate problems caused by non-printing characters, CLI commands now default to the Alonzo era, and default values have been added to simplify startup where a genesis file is not supplied (eg in test or standalone settings). Additional logging is available during node startup, enabling progress to be tracked more easily, and statistics counting has been disabled in order to reduce noise. Limits have been added to mini protocols. There is better rendering of some trace messages.
Documentation has also been improved in various areas.
This version also adds experimental support for peer-to-peer network. It is unverified and unsupported, and hence not recommended to be enabled in production.
Breaking Changes
- Asset Name Format Change. Note that asset names are now output in hex format when querying UTxO entries. Any user who is relying on asset names to be represented as ASCII text will need to change their tooling. As a temporary transitional solution, it is possible to use Cardano-cli version 1.31 with node version 1.32.1 if desired, or to continue to use node version 1.31. This will not be possible following the next hard fork (which is expected in early 2022).
- CLI default era change. CLI commands now default to the Alonzo era (previously Mary era). Tooling may need to be revised if it was relying on the default.
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
- 30GB 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
- Cardano Node documentation
- Cardano CLI
- Internal API docs for ledger, consensus and network
- Compatibility matrix
Changelogs
Node
- Miscellaneous documentation updates. (#3138, #3286, #3323, #3342, #3343, #3348)
- Update a number of scripts to use the $NETWORK_MAGIC environment variable. (#3148)
- Integrate p2p networking functionality. (#3363)
- Add additional logging to node startup. (#3380)
- Note that the existing "nodeStartTime" counter still exists, but will ultimately be deprecated. The startup time is now logged in the following format:
{ "thread": "5", "sev": "Notice", "data": { "startupTime": "1638866965" }, "loc": null, "env": "1.31.0:be123", "msg": "", "app": [], "host": "waldorf", "at": "2021-12-07T08:49:24.22Z", "ns": [ "cardano.node.nodeconfig" ], "pid": "33952" } - Block delay counters are now not collected until the node has finished starting. Statistics collected during node startup would only add noise to the delay CDF. (#3386)
Consensus
Ledger
Network
- Early, unverified and unsupported p2p networking capabilities. Do NOT use in production. (#3467)
Cardano-cli
Cardano-api
- Asset names are now rendered in a more consistent fashion in JSON output. Previously names which happened to be valid ASCII were rendered as such, and ones which were not resulted in unprintable characters. Now all names are rendered as hex. Future clients may choose to additionally render ASCII names if plausible to do so. (#3211)
- Expose ledger events via the ledger state API. (#3374)
Deprecated features
Fixed issues
- Fix the rendering of
RemoteConnectionIdin trace messages. (#3199)
Sign off
| Role | Approval |
|---|---|
| Technical Lead | ✔️ |
| QA Engineer | ✔️ |
| Ops | ✔️ |
| Release Manager | ✔️ |