cardano-foundation/cardano-rosetta-java 2.1.2

on GitHub

Cardano Rosetta Java v2.1.2 is a hotfix release that restores chain synchronization on Preview, stabilizes sync-status reporting under brief indexer connectivity blips, and improves operator-facing error diagnostics.

Cardano-Node compatibility: 10.5.4.

⚠️ This is not a mandatory release.

Key Improvements

• Fixed a chain synchronization failure on Preview caused by a CBOR parsing error on blocks.
• Reduced spurious out-of-sync readings by widening the default sync grace window, so short-lived HTTP instability between the API and the indexer no longer flips the reported sync state.
• Enriched gateway error logging to include the target URL, response body, and full exception chain, making yaci-indexer communication failures easier to diagnose in production.

Upgrade / Compatibility

• From v2.1.1 and v2.1.0: fully compatible, no resync required.
• From v2.0.0: fully compatible, no resync required.
• From v1.x.x: requires a full yaci-indexer resync only (Cardano Node data can be kept). See the resync procedure.
• No deployment method or infrastructure changes. Existing Docker Compose and Helm deployments continue to work; operators only need to update the image tag to 2.1.2.

API / Configuration

• /network/status sync tolerance — SyncStatusService now reports a node as in-sync while it is within 200 slots of tip (previously 100). This only affects the synced flag computation; no endpoint response shape or status code changes.
• Environment updates:
  • SYNC_GRACE_SLOTS_COUNT: 100 → 200 (also reflected in .env.docker-compose, .env.docker-compose-preprod, .env.h2, application.yaml, application-offline.yaml, and Helm values.yaml / values-preprod.yaml / charts/rosetta-api/values.yaml). Override by setting the variable explicitly in your deployment.
  • RELEASE_VERSION: 2.1.1 → 2.1.2 (Docker image tag for API and Indexer).
  • Helm global.releaseVersion: "2.1.1" → "2.1.2".

What's Changed

• fix: raise SYNC_GRACE_SLOTS_COUNT to 200 and enrich gateway error logs by @matiwinnetou in #742
• fix: bump yaci to 0.4.1 by @matiwinnetou in #743
• chore: bump version to 2.1.2 by @linconvidal in #747
• chore: prepare 2.1.2 by @matiwinnetou in #744

Full Changelog: 2.1.1...2.1.2