Skip to content

Add IL production to the VC - #8

Open
conache wants to merge 15 commits into
focil-vc-il-duties-pollingfrom
focil-vc-il-duties-service
Open

Add IL production to the VC#8
conache wants to merge 15 commits into
focil-vc-il-duties-pollingfrom
focil-vc-il-duties-service

Conversation

@conache

@conache conache commented Aug 13, 2026

Copy link
Copy Markdown
Owner

Issue Addressed

This PR adds inclusion list production to the validator client per spec.

Note: stacks on sigp#9799 (IL committee duties polling).

Proposed Changes

  • Add a new InclusionListService to the VC, which only starts when the Heze fork is scheduled and idles for whole epochs until Heze activates
  • Each slot, the service checks the slot's IL duties and fetches the IL transactions from the BN, using GET validator/inclusion_list?slot={slot}
  • For each duty, it builds a SignedInclusionList
  • Each signed IL is published individually using POST validator/inclusion_list (beacon api spec), SSZ first, using JSON as fallback
  • This PR also includes tests for the service against MockBeaconNode and adds IL mock helpers to validator_test_rig

Additional Info

  • The BN side of this (the missing endpoints) will come in follow-up PRs
  • Heze types don't exist in remote-signing-api yet, so Web3Signer path is defined ahead of the upstream spec. This only follows the existing message-type setup and may need adjusting later, once the Heze support lands
  • The IL production could potentially be optimized by producing ILs right after the payload reveal, instead of at the start of the slot. This could be done in a follow-up PR - left a TODO in the code

@conache conache changed the title Draft: Add IL production to the VC Add IL production to the VC Aug 16, 2026
@conache
conache marked this pull request as ready for review August 16, 2026 10:34
@conache
conache changed the base branch from unstable to focil-poll-il-duties August 16, 2026 10:40
@conache
conache changed the base branch from focil-poll-il-duties to focil-vc-il-duties-polling August 16, 2026 10:40
@conache
conache force-pushed the focil-vc-il-duties-service branch from 6e5360a to d651d8e Compare August 21, 2026 16:32
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.

1 participant