feat: add trueblocks support

[MysticRyuujin]

Summary

Adds trueblocks as an additional_services option that runs chifra daemon — the TrueBlocks REST API — against a participant EL on container port 8080. Per-chain trueBlocks.toml is rendered for the active network (network_params.network / network_id), and allocs.csv is pre-staged for unknown chains so chifra's archive check passes. Image is published from ethpandaops/eth-client-docker-image-builder#384.

The package runs chifra daemon only. The scraper isn't started automatically — POST /scrape on the daemon (or run chifra scrape against the same data dir) when you want to build the local Unchained Index. The other chifra endpoints (/status, /blocks, /receipts, /transactions, /traces, /logs) work without an index — they're chifra-flavored RPC pass-through.

Configuration

trueblocks_params:
  image: "ethpandaops/trueblocks:v5.9.3"
  # Verbatim RPC URL chifra should target. Leave empty to use
  # all_el_contexts[target_index] (the in-cluster participant).
  target_rpc_url: ""
  target_index: 0
  scrape:                # written into trueBlocks.toml; 0 = network-aware default
    apps_per_chunk: 0
    snap_to_grid: 0
    first_snap: 0
    unripe_dist: 0
  env: {}

Devnet example:

participants:
  - el_type: erigon
    cl_type: lighthouse
additional_services:
  - trueblocks

Notes

chifra's IsNodeArchive does a CSV-vs-RPC consistency check rather than a real archive probe, so it returns false on chains we don't ship a bundled allocs.csv for. The launcher works around it by writing a self-consistent allocs.csv for the active chain in a one-shot plan.run_sh bootstrap (probes the first prefund's actual block-0 balance, drops the rendered toml in alongside the image's bundled per-chain configs, stores the result as a files artifact mounted into the daemon container). Filed upstream: TrueBlocks/trueblocks-core#4044.

We considered khedra (the official chifra daemon + chifra scrape unified successor) but its startup Configured() check requires a reachable mainnet RPC returning chainId 1, which doesn't fit hermetic devnets. Filed upstream: TrueBlocks/trueblocks-khedra#22 — if a headless mode lands, we can migrate.

Test plan

• Erigon + Lighthouse devnet: daemon comes up healthy, /status returns isArchive: true, isTracing: true, trueblocksVersion: GHC-TrueBlocks//5.9.3; /blocks?blocks=0 returns genesis; /list?addrs=<prefund> returns appearances after a POST /scrape; /chunks?mode=index reflects the new chunk.
• bal-devnet-7 client images (Erigon + Reth × Lighthouse + Lodestar matrix, fulu @ 0, gloas @ 9): same checks pass against chifra v5.9.3 + erigon 3.5.0.
• kurtosis lint --format clean; kurtosis run --dry-run clean.

[barnabasbusa]

this looks a bit too vibe cody, even for me

[MysticRyuujin]

Pushed 8589219 addressing review feedback:

• Dockerfile deleted — chifra image is now built in eth-client-docker-image-builder (companion: ethpandaops/eth-client-docker-image-builder#384)
• ImageBuildSpec path removed; the service now just pulls ethpandaops/trueblocks:v5.9.3
• Bootstrap shell logic (chifra config setup, allocs.csv probe, scrape retry loop, daemon exec) moved out of the launcher and into the image's entrypoint.sh — the launcher just renders trueBlocks.toml and sets a handful of TB_* env vars
• Comment block in _build_entrypoint_cmd deleted (function itself is gone); a single 4-line comment remains explaining the one chifra quirk we still work around
• version param dropped from trueblocks_params (it was only for the now-removed source build); image is the only knob

Net diff vs the original commit: -219/+28 lines across 7 files (launcher trimmed from ~280 → 162 lines).

On the IsNodeArchive workaround you flagged ("don't we know if a node is archive or not?") — turns out the function is misnamed: it does a CSV-vs-RPC consistency check rather than a real archive-mode probe. Filed upstream with a proposed fix: TrueBlocks/trueblocks-core#4044. The workaround now lives in entrypoint.sh in the image-builder PR and can be removed once that lands upstream.

End-to-end re-tested with the new image + simplified launcher on an Erigon + Lighthouse devnet: isArchive: true, isTracing: true, scraper produced the first finalized chunk, /status / /blocks / /list / /chunks all return expected data.

[MysticRyuujin]

Pushed 33dc5ff. Simplified further on top of the prior round:

• The image is now just chifra + bundled per-chain configs; no entrypoint script, no env-var contract. Companion PR was simplified to match — vanilla Dockerfile only (#384).
• Bootstrap moved out of the image and into a plan.run_sh step in the launcher: probes the prefund balance, drops the rendered trueBlocks.toml in, produces a single files artifact, mounts it into the daemon.
• Dropped auto-scrape entirely. The package runs chifra daemon only; users POST /scrape (or run chifra scrape against the data dir) when they want indexing. Removes the scrape retry loop and the sleep_seconds knob.

Also filed TrueBlocks/trueblocks-khedra#22 — khedra would be the cleaner long-term answer (single-process daemon+scraper), but its startup requires a reachable mainnet RPC returning chainId 1, which doesn't fit hermetic devnets. If that lands we can migrate.