Cardano Updates

## Summary

Hotfix release **2.1.2** bundling a yaci upgrade and improved gateway
logging.

## Commits

-
**[#742](https://github.com/cardano-foundation/cardano-rosetta-java/pull/742)
— fix: raise `SYNC_GRACE_SLOTS_COUNT` default to 200 and enrich gateway
error logs**
- Bumps the default sync grace window from 100 to 200 slots across env
files, Spring config, Helm values, and docs. The previous value caused
the `synced` flag on `/network/status` to flap when the HTTP link
between `rosetta-api` and `yaci-indexer` was briefly unstable.
- Enriches logs in `YaciHttpGatewayImpl` for both
`getStakeAccountRewards` and `getDiscoveredPeers`: non-2xx branches now
include the target URL and response body alongside the status code;
`IOException`/`InterruptedException` branches include the URL plus the
full cause chain so SSL and connection errors are visible.
-
**[#743](https://github.com/cardano-foundation/cardano-rosetta-java/pull/743)
— fix: bump yaci to 0.4.1 to fix chain sync on blocks with >23 txs**
- Picks up upstream [yaci
v0.4.1](https://github.com/bloxbean/yaci/releases/tag/v0.4.1), which
fixes a CBOR parsing error for blocks encoded with definite-length
arrays (>23 txs) that broke chain sync on preview. Also adds
configurable `TipFinder` timeouts.

update code

update code

feat: Spike: replace 'apply indexes' with a native solution

Yaci 0.4.1 fixes a CBOR parsing error for blocks using definite-length
arrays (>23 txs), which broke chain sync on preview. Also adds
configurable TipFinder timeouts.

Co-authored-by: Mateusz Czeladka <[email protected]>
Co-authored-by: Claude Opus 4.7 (1M context) <[email protected]>

Yaci 0.4.1 fixes a CBOR parsing error for blocks using definite-length
arrays (>23 txs), which broke chain sync on preview. Also adds
configurable TipFinder timeouts.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

Bumps the default sync grace window from 100 to 200 slots across env files,
Spring config, Helm values, and docs. The previous value caused the synced
flag on /network/status to flap when the HTTP link between rosetta-api and
yaci-indexer was briefly unstable.

Enriches the logs in YaciHttpGatewayImpl for both getStakeAccountRewards
and getDiscoveredPeers: non-2xx branches now include the target URL and
response body alongside the status code, and IOException/InterruptedException
branches include the URL plus the exception (full cause chain) so SSL and
connection errors are visible in the logs.

Co-authored-by: Mateusz Czeladka <[email protected]>
Co-authored-by: Claude Opus 4.7 (1M context) <[email protected]>

Aligns MetadataReferenceNftEntity, TokenLogoEntity and TokenMetadataEntity
with the JPA entity convention used across the codebase: identity is
defined by @Id fields only, using Lombok's
@EqualsAndHashCode(onlyExplicitlyIncluded = true) plus @EqualsAndHashCode.Include
on each @Id. This avoids proxy/lazy-loading pitfalls and matches the
upstream yaci-store style.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

Bumps the default sync grace window from 100 to 200 slots across env files,
Spring config, Helm values, and docs. The previous value caused the synced
flag on /network/status to flap when the HTTP link between rosetta-api and
yaci-indexer was briefly unstable.

Enriches the logs in YaciHttpGatewayImpl for both getStakeAccountRewards
and getDiscoveredPeers: non-2xx branches now include the target URL and
response body alongside the status code, and IOException/InterruptedException
branches include the URL plus the exception (full cause chain) so SSL and
connection errors are visible in the logs.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

  cardano-node 10.7.x peer-snapshot format

  cardano-node 10.7.x dropped the legacy
  "domain" relay field — all relay
  addresses (both hostnames and IPs) now use
  the "address" key. The port
  field is also optional in the new format.

  - Detect relay type (domain/IPv4/IPv6) by
  inspecting the address value
    instead of checking for a non-null
  "domain" field
  - Default port to 3001 when the relay entry
  omits the port field
  - Retain "domain" field handling for
  backwards compatibility with
    older snapshot formats

Drops an /etc/apt/apt.conf.d/99-retries file into every ubuntu:24.04
stage before the first apt call:

  Acquire::Retries "5";
  Acquire::http::Timeout "30";
  Acquire::https::Timeout "30";
  Acquire::http::No-Cache "true";

Motivation: docker compose builds on shared hosts have been hitting
"File has unexpected size" errors from security.ubuntu.com when a
mirror edge is mid-sync. Retries + No-Cache let apt transparently
re-fetch from a fresh mirror instance instead of failing the whole
build. Does not help when the mirror is serving a permanently-wrong
file (nothing does), but cleans up the common transient case.

Applied to:
- api/Dockerfile                          (build-common)
- yaci-indexer/Dockerfile                 (build-common)
- docker/dockerfiles/mithril/Dockerfile   (cardano-builder + mithril-runner)
- docker/dockerfiles/node/Dockerfile      (cardano-builder + node-runner)
- docker/dockerfiles/postgres/Dockerfile

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

Drops an /etc/apt/apt.conf.d/99-retries file into every ubuntu:24.04
stage before the first apt call:

  Acquire::Retries "5";
  Acquire::http::Timeout "30";
  Acquire::https::Timeout "30";
  Acquire::http::No-Cache "true";

Motivation: docker compose builds on shared hosts have been hitting
"File has unexpected size" errors from security.ubuntu.com when a
mirror edge is mid-sync. Retries + No-Cache let apt transparently
re-fetch from a fresh mirror instance instead of failing the whole
build. Does not help when the mirror is serving a permanently-wrong
file (nothing does), but cleans up the common transient case.

Applied to:
- api/Dockerfile                          (build-common)
- yaci-indexer/Dockerfile                 (build-common)
- docker/dockerfiles/mithril/Dockerfile   (cardano-builder + mithril-runner)
- docker/dockerfiles/node/Dockerfile      (cardano-builder + node-runner)
- docker/dockerfiles/postgres/Dockerfile

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>