Cardano Updates

doc: added troubleshooting option for comon issues people have

Ordering /epochs/:number/stakes by stake_address.hash_raw is replica-stable
but pays O(offset) joins on deep pages (page 1000 ~3.5s, deeper pages worse).

Add an optional, config-gated fast path: bf_tbl_epoch_stake_anchor stores
hash_raw at every 1000th position of each epoch's stake snapshot, letting the
query jump to the nearest anchor and keyset-scan from there — any page is then
O(1000 + count) (page 1000: 3.5s -> 44ms, offset 1.2M: ~60ms). Results are
row-identical to the plain query.

- dbSync.epochStakeAnchors config option (BLOCKFROST_CONFIG_DBSYNC_EPOCH_STAKE_ANCHORS);
  default off — vanilla db-sync deployments are unaffected
- startup fails fast when the option is enabled but the table is missing
- table + maintenance trigger documented in README (~60 MB, built once per epoch)
- unpaged variants now order by sa.hash_raw too; the previous
  MIN(delegation.slot_no) ordering tie-broke on replica-local es.addr_id and
  was not stable across instances (up to 98 delegation certs share a slot)

Co-Authored-By: Claude Opus 4.8 <[email protected]>

* fix: validation for payload endpoints max_val_size

fix: validation for payload endpoints max_val_size

* update code

update code

* update code

update code

* fix: add error 5061 to network options golden example snapshot

* test: add golden example test cases for max val size validation

* test: update max_val_size skip test cases

---------

Co-authored-by: Sotatek-DucPhung <[email protected]>
Co-authored-by: matiwinnetou <[email protected]>
Co-authored-by: Sotatek-HenryDo <[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: Mateusz Czeladka <[email protected]>
Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
Co-authored-by: Sotatek-HenryDo <[email protected]>

* fix(search-service): reject lovelace as currency symbol in /search/transactions

* test(data-endpoints): reject lovelace currency in search transactions

---------

Co-authored-by: Sotatek-DucPhung <[email protected]>
Co-authored-by: Lincon Vidal <[email protected]>