[Epic] Track B — Validator API + tracker

[varex83]

Track B — Validator API + tracker

Parent: #394

This epic covers the validator-client-facing surface (REST API), the post-flight inclusion tracker, and supporting signature aggregation/storage. It also owns the testutil mocks (largest consumer is validatorapi) and the operational pluto exit CLI which interacts with the same code paths.

Scope

Mocks (prerequisite for the whole track)

• Implement testutil/beaconmock #37 testutil/beaconmock
• Implement testutil/validatormock #38 testutil/validatormock

API & tracking

• Implement core/validatorapi #180 core/validatorapi (~3.6k Go LOC — the long pole)
• Implement core/tracker #179 core/tracker (incl. inclusion + reason)

Signature aggregation & storage

• Implement core/sigagg #178 core/sigagg
• Implement core/aggsigdb #169 core/aggsigdb

Operational CLI (exits)

• Implement cmd/exit (CLI command group) #404 cmd/exit umbrella, with 5 children:
  • Implement cmd/exit broadcast #405 cmd/exit broadcast
  • Implement cmd/exit delete #406 cmd/exit delete
  • Implement cmd/exit fetch #407 cmd/exit fetch
  • Implement cmd/exit list #408 cmd/exit list
  • Implement cmd/exit sign #409 cmd/exit sign

Sequencing

1. Mocks (Implement testutil/beaconmock #37, Implement testutil/validatormock #38) first — every test in this track needs them
2. Implement core/sigagg #178 core/sigagg + Implement core/aggsigdb #169 core/aggsigdb in parallel — small, self-contained
3. Implement core/validatorapi #180 core/validatorapi — start with eth2types.rs, then router, then handler groups
4. Implement core/tracker #179 core/tracker — needs core/bcast (Implement core/bcast #170, Track A) events to subscribe to
5. Exits — can start any time after eth2util is stable (already is)

Acceptance

• All sub-issues closed
• Validator API passes integration test against validatormock (Implement testutil/validatormock #38)
• Tracker correctly reports inclusion/exclusion in a 4-node compose smoke
• pluto exit * subcommands verified against a real BN

[emlautarom1-agent]

Track B status rollup — 2026-06-15 (source audit)

✅ Done (merged): #37 testutil/beaconmock (#416) · #38 testutil/validatormock (#418) · #169 core/aggsigdb (#452, 515 Rust LOC)

✅* Code-complete but issue still open (recommend verify + close):

• Implement core/sigagg #178 core/sigagg — crates/core/src/sigagg.rs, 793 Rust LOC, 0 stubs, merged in feat: sigagg #426
• Implement core/tracker #179 core/tracker — ~3,974 Rust LOC, inclusion checker landed (feat: tracker module skeleton #444/feat(core): additional tracker modules #455/feat(core): tracker inclusion ported from charon #472); parity-check vs Charon (1,715 non-test LOC) then close

🟡 In flight: #180 core/validatorapi — ~80%; handler groups in review (PRs #457/#459/#460/#462), fixture-replay harness #474. Remaining router stubs detailed on that issue.

🔴 Not started: #404 cmd/exit group (+ children #405–409). Dependency app/obolapi is already ported (crates/app/src/obolapi/*), so this is unblocked and independent of cmd/run.

Note: core/parsigdb (497 LOC) and core/parsigex (867 LOC) — both pipeline components used by this track — are merged but untracked; consider adding sub-issues for completeness.

---

Automated progress audit (2026-06-15). New comment only — no existing issue content was modified.