github cardano-foundation/cardano-rosetta-java 2.4.0

pre-release6 hours ago

Cardano Rosetta Java v2.4.0 (pre-release)

Cardano Rosetta Java v2.4.0 introduces initial support for programmable-token integrations.

Key Improvements

  • Derive CIP-113 smart-wallet addresses from public keys or resolve them from supported Cardano addresses. Programmable-token transfer construction is outside this release.
  • Zero-value script withdrawals no longer appear in transaction operation lists as reward withdrawals.

Upgrade / Compatibility

  • From v2.x: No resync is expected. Preserve the existing indexer database and Cardano Node data.

API / Configuration

  • Breaking: zero-value withdrawals omitted (/block, /block/transaction, /search/transactions).

    • Transactions containing zero-value script withdrawals now have fewer operations, which can shift subsequent operation indexes. Clients relying on the previous operation lists must account for this change. See querying programmable addresses.
  • /construction/derive: new CIP-113 address type.

    • Set metadata.address_type to CIP-113 to derive a smart-wallet address from a public key.
  • /call: new resolve_smart_wallet_addr method.

    • Accepts parameters.address and returns the resolved smart-wallet address in result.account_identifier.address.
  • /network/options now lists resolve_smart_wallet_addr and the new CIP-113 validation errors.

Environment updates:

  • RELEASE_VERSION and Helm global.releaseVersion: 2.3.3 → 2.4.0 in the source defaults. Use 2.4.0-pre-release for the prerelease images.
  • CIP113_BASE_SCRIPT_HASH (new): network-specific programmable logic base script hash required for CIP-113 derivation and resolution. Values are included in the shipped Mainnet and Preprod configuration; custom deployments must configure the hash for their network. See the configuration reference.
  • Helm rosetta-api.env.cip113BaseScriptHash (new): equivalent setting for Helm deployments.

What's Changed

Full Changelog: 2.3.3...2.4.0

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

NewReleases is sending notifications on new releases.