Skip to content

update selections endpoint description - #368

Merged
rolfyone merged 5 commits into
ethereum:masterfrom
ObolNetwork:update-selections
Nov 5, 2023
Merged

update selections endpoint description#368
rolfyone merged 5 commits into
ethereum:masterfrom
ObolNetwork:update-selections

Conversation

@xenowits

Copy link
Copy Markdown
Contributor

Update endpoint descriptions for the following selections endpoints:

  • /eth/v1/validator/beacon_committee_selections
  • /eth/v1/validator/sync_committee_selections

This PR updates selection endpoint descriptions to explicitly state when to call these endpoints:

  • For sync committee selections, validator clients must query this endpoint at the start of each slot in the sync committee period.
  • For beacon committee selections, validator clients must query this endpoint at the start of each epoch for attester duties in the current and next epochs.

Note: This change eliminates confusion among client teams implementing these endpoints on when to query the selection endpoints.

xenowits added 3 commits July 5, 2023 10:47
* edit api descriptions

* cleanup

* edit message
* update to mention lookahead epochs

* clarify current and lookahead epochs

* review comments

@OisinKyne OisinKyne left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we add my suggestion to make it apparent it doesn't have to be default behaviour, only when the VC is part of a cluster?

Comment thread apis/validator/beacon_committee_selections.yaml Outdated
Comment thread apis/validator/sync_committee_selections.yaml Outdated
xenowits and others added 2 commits October 27, 2023 15:35
Co-authored-by: Oisín Kyne <4981644+OisinKyne@users.noreply.github.com>
Co-authored-by: Oisín Kyne <4981644+OisinKyne@users.noreply.github.com>

@rolfyone rolfyone left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@rolfyone
rolfyone merged commit 4c080a9 into ethereum:master Nov 5, 2023
nflaig added a commit to ChainSafe/lodestar that referenced this pull request Dec 19, 2025
…8669)

**Motivation**

Closes #8606

**Description**

This updates our implementation to be compliant with latest spec
ethereum/beacon-APIs#368.

For sync committee aggregation selection (unchanged)
-  we call `submitSyncCommitteeSelections` at the start of the slot
- the timeout is still based on `CONTRIBUTION_DUE_BPS` into the slot (8
seconds)
-  we call the endpoint for all duties of this slot
-  logic has been moved to duties service


For attestation aggregation selection
- we call `submitBeaconCommitteeSelections` at the start of the epoch
for current and next epoch (2 separate calls)
- the timeout uses default which is based on `SLOT_DURATION_MS` (12
seconds)
- we only call `prepareBeaconCommitteeSubnet` once the above call either
resolved or failed, this should be fine as it's not that time sensitive
(one epoch lookahead)
- if duties are reorged, we will call `submitBeaconCommitteeSelections`
with duties of affected epoch
- logic has been moved to duties service


Previous PR #5344
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.

3 participants