Skip to content

Added SSZ REST for Engine API#21203

Merged
taratorio merged 7 commits into
mainfrom
sszrest-updated-spec
May 15, 2026
Merged

Added SSZ REST for Engine API#21203
taratorio merged 7 commits into
mainfrom
sszrest-updated-spec

Conversation

@Giulio2002

@Giulio2002 Giulio2002 commented May 15, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds an authenticated SSZ-REST transport for the Engine API alongside the existing JSON-RPC path.

  • Adds /engine/v*/payloads, /engine/v*/forkchoice, /engine/v*/blobs, /engine/v1/client/version, and /engine/v1/capabilities handlers.
  • Advertises SSZ endpoint capabilities through engine_exchangeCapabilities while preserving JSON-RPC fallback.
  • Implements Erigon-native SSZ wire types using cl/ssz encode/decode patterns.
  • Adds focused SSZ-REST handler/wire tests.
  • Adds Kurtosis devnet material for Prysm + Erigon + Spamoor with 4s slots.

Verification

  • Agent verifier completed all checks under /root/gevm-erigon/agi/sszrest_verifier.
  • Live Kurtosis interop run completed with Prysm + Erigon + Spamoor.
  • Devnet used 4 second slots (seconds_per_slot = 4, slot_duration_ms = 4000).
  • Erigon logs showed SSZ-REST getPayload, newPayload, and forkchoice traffic.
  • Prysm synced blocks and issued forkchoice updates.
  • Spamoor confirmed transactions.
  • Final verifier scan found no fatal Engine API errors.

@taratorio taratorio enabled auto-merge May 15, 2026 01:51
@taratorio taratorio added this pull request to the merge queue May 15, 2026
Merged via the queue into main with commit 9f42f01 May 15, 2026
68 checks passed
@taratorio taratorio deleted the sszrest-updated-spec branch May 15, 2026 03:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants