github cardano-foundation/cardano-rosetta-java 2.2.0

pre-release8 hours ago

Cardano Rosetta Java v2.2.0

Cardano Rosetta Java v2.2.0 is the Van Rossem hard-fork-ready release: it upgrades the bundled Cardano Node to 11.0.1 so deployments can safely cross the Van Rossem hard fork boundary.

⚠️ This is a mandatory upgrade. Cardano Node 11.0.1 is required to cross the Van Rossem hard fork boundary. Operators running older releases must upgrade before the hard fork activates, otherwise the node will not progress past the boundary.

⚠️ Still on the 1.x line? Do not upgrade to 2.x solely for the hard fork. A separate 1.5.0 release (upcoming) will provide the hard-fork-ready node for customers who have not yet migrated to the 2.x line. If you are already on 2.x, upgrade to 2.2.0.

Key Improvements

  • Cardano Node upgraded to 11.0.1, making deployments ready for the Van Rossem hard fork
  • Mithril upgraded to 2617.0, with a one-time automatic migration from the Mithril v1 snapshot backend to v2 that preserves existing node data
  • Yaci Store upgraded to 2.0.1 and Yaci to 0.4.4
  • Peer snapshot parsing updated for the Cardano Node 10.7.x+ snapshot format

Upgrade / Compatibility

  • From v2.0.0 / v2.1.x: Compatible, no resync required. This is a mandatory node upgrade — set CARDANO_NODE_VERSION to 11.0.1 (rebuilding the node image if you build from source) and redeploy before the hard fork activates.
  • From v1.x.x: Do not migrate to 2.x solely to cross the hard fork — a dedicated 1.5.0 release (upcoming) provides the hard-fork-ready node for the 1.x line. Migrating 1.x → 2.x still requires a full yaci-indexer resync (Cardano Node data can be kept); see the resync procedure.
  • The Mithril client performs a one-time --allow-override download to migrate a pre-existing /node directory from the v1 to the v2 backend, then writes a marker so later restarts never re-download over an already-synced node. No manual action is required.
  • Operators who build the Cardano Node image from source will pull node 11.0.1 and the new cardano-submit-api trace-dispatcher config (required since node 10.7.x) automatically.

API / Configuration

  • /network/options: reported versions updated.
    • version.node_version is now 11.0.1 and version.middleware_version is now 2.2.0. There are no schema, operation type, or error code changes in this release.

Environment updates:

  • CARDANO_NODE_VERSION: 10.5.411.0.1
  • MITHRIL_VERSION: 2543.1-hotfix2617.0
  • RELEASE_VERSION: 2.1.22.2.0

What's Changed

  • chore: prepare 2.2.0 (hard fork ready) in #741

Full Changelog: 2.1.2...2.2.0

Don't miss a new cardano-rosetta-java release

NewReleases is sending notifications on new releases.