github cardano-foundation/cardano-rosetta-java 2.3.3

latest release: 1.5.3
3 hours ago

Cardano Rosetta Java v2.3.3

Cardano Rosetta Java v2.3.3 is a maintenance release that upgrades Yaci to 0.4.7 to fix lost transactions in one mainnet block.

Caution

This is a mandatory upgrade for mainnet. Yaci 0.4.6 and earlier read mainnet block 14,053,493 as having 0 transactions when it has 137. Rosetta keeps syncing past it, so a mainnet database that synced past slot 200,136,161 (2026-10-11 07:07 UTC) is missing those 137 transactions. Upgrading alone does not fix data that is already stored. Follow the mainnet repair guide.

Key Improvements

  • Yaci upgraded to 0.4.7, which correctly decodes mainnet block 14,053,493. Same fix as Yaci Store 2.0.7, which flagged it as a critical mainnet upgrade.
  • New one-time repair script for mainnet databases that already stored the block without its transactions. It moves the sync cursor back one block so the indexer fetches the block again with the fixed parser. See scripts/repair/README.md.

Upgrade / Compatibility

  • From v2.x, mainnet: No full resync needed. Stop the stack, Upgrade, run repair-mainnet-block-14053493.sql, then start the stack again. The repair guide has the full steps for Docker Compose and Kubernetes / Helm.
  • From v2.x, preprod / preview: Not affected. Compatible, no resync or repair needed.
  • From v1.x: Requires a full yaci-indexer resync only (Cardano Node data can be kept). See the resync procedure.

API / Configuration

  • /network/options: reported middleware version updated.
    • version.middleware_version is now 2.3.3. Request and response schemas, operation types and error codes are unchanged.
  • /block, /block/transaction, /search/transactions, /account/balance, /account/coins: mainnet block 14,053,493 data.
    • On repaired or freshly synced mainnet databases, these endpoints return the block's 137 transactions and the balances and UTXOs that follow from them.

Environment updates:

  • RELEASE_VERSION: 2.3.2 → 2.3.3
  • Helm global.releaseVersion: "2.3.2" → "2.3.3"

What's Changed

Full Changelog: 2.3.2...2.3.3

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

NewReleases is sending notifications on new releases.