Cardano Updates

Adds .github/workflows/pr-preview.yaml. On every PR opened against
main (and on workflow_dispatch), the workflow:

- builds the mkdocs site with --strict
- deploys it to https://cf-cna-pr-<N>.surge.sh
- upserts a single hidden-marker comment on the PR with the URL,
  so subsequent pushes update the same comment instead of spamming

Subdomain alias cf-cna keeps the host label under the 63-char DNS
limit; the full org+repo prefix would overrun once PR numbers grow.

Concurrency group cancels stale runs. Workflow fails loudly with an
actionable message if SURGE_TOKEN is missing.

Manual one-time setup is documented on the issue: generate a surge
token via 'surge token' and set it as the SURGE_TOKEN repo secret.

Replaces the 2023-style design pitch with what the adversary actually
is today (chain-sync downstream client, env vars, composer driver,
exit semantics, source layout) and what it is not (no upstream-peer
mode, no other mini-protocols, no Antithesis-steered randomness).

Adds adversary-roadmap.md as the north star: tx-generator-shaped
long-running daemon with control socket and parallel-driver fan-out,
tier list of misbehaviour archetypes, planned home in
lambdasistemi/cardano-node-clients, sequenced PR plan.

Updates docs/index.md and the master testnet page to reflect today's
component set (adversary, asteria-player, tx-generator).

gRPC: Add searchUtxos method

doc: correct Full preset description

CRON_TZ is silently ignored on the dune host; entries fire in server
local time. Document the conversion and the DST drift, and mention it
in the bootstrap step so a new operator edits the times for their
server's timezone.

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

Debian's cron silently ignores CRON_TZ=UTC on some installs. Verified
on dune (Europe/Zurich): entries with non-zero minutes never fire when
CRON_TZ is set, while \"0 \" entries fire at LOCAL even hours (which
look correct only because *2 lines up cleanly with the 2h tz offset).

Switch to local CEST times (04:00 CEST = 02:00 UTC) and document the
DST behaviour. The retry polling absorbs the 1h drift during CET.

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

Dune is in CEST (UTC+2). Without CRON_TZ, an entry like "0 2 * * *"
fires at 02:00 CEST = 00:00 UTC — two hours before yaci-store writes
the new daily parquet at 02:00 UTC, causing the retry loop to
exhaust before files arrive.

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

- Updated unit test command in package.json to include additional proxy-related tests.
- Added new steps for proxy row recovery and orphan adoption in CI workflows.
- Enhanced README documentation for proxy bot API, clarifying required parameters and transaction flows.
- Improved API descriptions to reflect changes in handling DRep registration and proxy transactions.
- Adjusted test cases to validate new lifecycle steps for proxy management.

This commit adds serialization roundtrip tests for the concrete Peras
votes and certificate types.

Co-authored-by: Agustin Mista <[email protected]>
Co-authored-by: Thomas BAGREL <[email protected]>
Co-authored-by: Nicolas BACQUEY <[email protected]>

This commit implements BLS-based crypto helpers to simplify the
implementation of crypto schemes used for voting committees. It includes
both single and aggregate signature and VRF signing and verification, as
well as swap-attack-resistant aggregate VRF verification via
linearization.

Co-authored-by: Nicolas BACQUEY <[email protected]>
Co-authored-by: Thomas BAGREL <[email protected]>
Co-authored-by: Agustin Mista <[email protected]>