Cardano Updates

This reverts commit 58320efdc16ce34261fe4202e25304e564639400.

Signed-off-by: Akhil Repala <[email protected]>

A GC tick periodically re-checks each staged entry against the live
ChainSync candidates and evicts entries whose CertRB no live peer
has on its chain anymore — the closure is then unreachable. Parked
BlockFetch client threads register a per-call StrictTMVar with the
staging area; drain fills it with StagedReleased once the closure
arrives, GC fills it with StagedEvicted on giving up, so the client
returns either SuccesfullyAddedBlock or FailedToAddBlock instead of
parking forever.

Folds the rest of the staging machinery into LeiosStagingArea so it
sits in one place: the ChainDbView wrapper, the parent-announcement
lookup, peersThatKnowBlock, and the drain / GC threads all live here
now and are spawned by newLeiosStagingArea on the supplied registry.
The handle's surface shrinks to stagedSnapshot (for the fetch loop)
and wrappedChainDbView (for BlockFetch). NodeKernel passes the
tracer, registry, ChainDB and ChainSyncClientHandleCollection and
plumbs the wrapped view through.

* refactor(api): narrow concrete adapters for blockfrost mesh utxorpc

Signed-off-by: cryptodj413 <[email protected]>

* fix(api): address issues

Signed-off-by: cryptodj413 <[email protected]>

---------

Signed-off-by: cryptodj413 <[email protected]>

Acting on review feedback for the published v2 docs:

- Sidebar order: fix the dataflow ordering (Sources -> Filters -> Sinks, was
  Filters -> Sources -> Sinks), cluster the standalone intro pages at the top
  (Introduction -> How it works -> Quick Start) instead of wedging Quick Start
  between groups, and move Reference below the config section. Added intentional
  intra-group order for Installation and Usage (watch -> dump -> daemon ->
  library).
- Rename the "Advanced Features" group to "Configuration" and position it right
  after the component groups — these pages are all optional daemon.toml config
  blocks. Kept it separate from Usage (CLI entry points) rather than merging.
- Split Examples into "Runnable examples" (the repo projects) and a new
  "Recipes" page (the inline copy-paste daemon.toml snippets).
- Quickstart step 1 now offers the full install-method tabs (Shell / PowerShell
  / Homebrew / npm), matching the Binary Releases page.

Verified with a full local astro build of txpipe/docs: 196 pages built, the
Tabs-in-Steps install block renders, and the new Recipes page builds.

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

Signed-off-by: yHSJ <[email protected]>

added:
* github:input-output-hk/mithril/6f51b1261472feb1b92a564863a6968f6149f38d#mithril-client-cli
* github:input-output-hk/mithril/6f51b1261472feb1b92a564863a6968f6149f38d#mithril-signer
removed:
* github:input-output-hk/mithril/aab34211273e57a3da79a394cc2c604e8f277bc4#mithril-client-cli
* github:input-output-hk/mithril/aab34211273e57a3da79a394cc2c604e8f277bc4#mithril-signer

chunk_for_slot hardcoded 21600 slots per chunk, which only holds for
mainnet and preprod (k = 2160). Preview chunks span 4320 slots (k = 432),
so create-snapshots compared incompatible chunk numbers, wrongly concluded
the local cardano-db covered the target slots and skipped the Mithril
download, then failed to store the ledger snapshot.

The CertRB staging gate consulted both getCurrentChain and the
ChainSync candidate fragments to locate the parent header's
headerLeiosAnnouncement. A BlockFetch-delivered block is by
construction fulfilling some candidate, so the parent must live in
one of the live candidate fragments; the locally selected chain is
incidental. Dropping it keeps the gate's decision aligned with the
candidate it's serving (issue #890 follow-up bullet 1).

- Pin contra-tracer to Russoul/contra-tracer@5ad4ac8 which adds
  INLINE contramap and strict second argument / result, on top of
  the existing INLINE runTracerA and strict (***) fixes.

- Revert the heap limit from 1500M back to 900M and instead set
  TASTY_NUM_THREADS=1 on all platforms. The OOM is caused by Tasty
  running all tests concurrently (one thread per CPU via
  setNumCapabilities), stacking their peak residencies. Each
  individual test fits well within 900 MB; the fix is sequential
  execution, not a larger limit.

Periodically recompute the live-peer set for each staged entry from
current ChainSync candidate fragments; when no live peer's candidate
contains the staged CertRB, the EB closure is unreachable and the
entry is evicted. Eviction wakes the parked BlockFetch client thread
via a per-call StrictTMVar with StagedEvicted so it can surface a
FailedToAddBlock verdict instead of leaking the thread (PR #2058
open point 4). Drain switches to the same TMVar mechanism, signalling
StagedReleased on closure arrival.

The CertRB staging gate consulted both getCurrentChain and the
ChainSync candidate fragments to locate the parent header's
headerLeiosAnnouncement. A BlockFetch-delivered block is by
construction fulfilling some candidate, so the parent must live in
one of the live candidate fragments; the locally selected chain is
incidental. Dropping it keeps the gate's decision aligned with the
candidate it's serving (issue #890 follow-up bullet 1).