Gloas vc ptc duty

[shane-moore]

Changes

• added polling of ptc duties to the VC per spec

How This Works

• The VC is currently checking whether one of its registered validators are in a voting committee, such as sync or attestation, or if they are the proposer for a slot. With epbs, it's possible for a validator to also be in a ptc committee for at most one slot of the epoch. More context on how validators are selected to be in a ptc was discussed on discord.

Implemented in the PR

duties_service will now spawn a background polling task for the current and next epoch to check whether any of the registered validators are in a ptc committee. Since re-org is possible, we also poll every slot. The beacon node querying is performed by new request endpoint POST validator/duties/ptc/{epoch} per beacon api spec.

To save on bandwidth similar to attestation committee polling, the ptc polling will make a tiny initial requests to learn the dependent_root, compare with the cached dependent_root, and only fetch full duties for the epoch if the root has changed (or if the root is unknown like for a new epoch). Old duties are pruned based on HISTORICAL_DUTIES_EPOCHS.

Todo

• add tests noted in the diffs
• create beacon node (server side) response that will send the ptc duties to the VC. Some of this work has already been done in other PR's such as the get_ptc helper, but the warp implementation still needs to be complete as to send the response to the VC

@ethDreamer
@eserilev

[ethDreamer]

Since re-org is possible, we also poll every slot.

I don't believe this is correct. Have a look at get_ptc()

def get_ptc(state: BeaconState, slot: Slot) -> Vector[ValidatorIndex, PTC_SIZE]:
    """
    Get the payload timeliness committee for the given ``slot``.
    """
    epoch = compute_epoch_at_slot(slot)
    seed = hash(get_seed(state, epoch, DOMAIN_PTC_ATTESTER) + uint_to_bytes(slot))
    indices: List[ValidatorIndex] = []
    # Concatenate all committees for this slot in order
    committees_per_slot = get_committee_count_per_slot(state, epoch)
    for i in range(committees_per_slot):
        committee = get_beacon_committee(state, slot, CommitteeIndex(i))
        indices.extend(committee)
    return compute_balance_weighted_selection(
        state, indices, seed, size=PTC_SIZE, shuffle_indices=False
    )

The committee selection appears constant for the same seed, and the seed is constant over MIN_SEED_LOOKAHEAD = 1 epoch

[ethDreamer]

ohhh you just mean that you check the cache every slot to ensure we have the same dependent root.

[eserilev]

LGTM!

[mergify]

Some required checks have failed. Could you please take a look @shane-moore? 🙏

[pawanjay176]

LGTM. Just a question

[eserilev]

@mergify requeue

[mergify]

Merge Queue Status

• 🟠 Waiting for queue conditions
• ⏳ Enter queue
• ⏳ Run checks
• ⏳ Merge

Required conditions to enter a queue

• -closed [📌 queue requirement]
• -conflict [📌 queue requirement]
• -draft [📌 queue requirement]
• any of [📌 queue -> configuration change requirements]:
  • -mergify-configuration-changed
  • check-success = Configuration changed
• any of [🔀 queue conditions]:
  • all of [📌 queue conditions of queue rule default]:
    • #approved-reviews-by >= 1
    • #approved-reviews-by >= 1 [🛡 GitHub branch protection]
    • #changes-requested-reviews-by = 0 [🛡 GitHub branch protection]
    • check-success=license/cla
    • check-success=target-branch-check
    • label!=do-not-merge

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-04-16 09:53 UTC · Rule: default
• ✅ Checks passed · on draft merge queue: embarking unstable (a9f43f9) and #8338 together #9140
• ✅ Merged — 2026-04-16 10:23 UTC · at 3fcedf005c8056036a582b0bbe9b138de43183bc

This pull request spent 29 minutes 45 seconds in the queue, including 28 minutes 8 seconds running CI.

Required conditions to merge

• #approved-reviews-by >= 1 [🛡 GitHub branch protection]
  • Gloas vc ptc duty #8338
• #changes-requested-reviews-by = 0 [🛡 GitHub branch protection]
  • Gloas vc ptc duty #8338
• check-success=local-testnet-success
• check-success=test-suite-success

[mergify]

requeue

☑️ This pull request is already queued