update selections endpoint description (#6)

* edit api descriptions * cleanup * edit message
ethereum · Jul 5, 2023 · 9e8f228 · 9e8f228
1 parent e46bd0c
commit 9e8f228
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 5 deletions.
diff --git a/apis/validator/beacon_committee_selections.yaml b/apis/validator/beacon_committee_selections.yaml
@@ -5,8 +5,9 @@ post:
     This endpoint should be used by a validator client running as part of a distributed validator cluster, and is 
     implemented by a distributed validator middleware client. This endpoint is used to exchange partial 
     selection proofs for combined/aggregated selection proofs to allow a validator client 
-    to correctly determine if one of its validators has been selected to perform an aggregation duty in this slot. 
-    Consensus clients need not support this endpoint and may return a 501.
+    to correctly determine if one of its validators has been selected to perform an aggregation duty in a slot. 
+    Validator clients must query this endpoint at the start of an epoch for all validators that have attester duties 
+    in that epoch. Consensus clients need not support this endpoint and may return a 501.
   tags:
     - Validator
   requestBody:

diff --git a/apis/validator/sync_committee_selections.yaml b/apis/validator/sync_committee_selections.yaml
@@ -6,9 +6,10 @@ post:
     committee selection. This endpoint should be used by a validator client running as part of a distributed 
     validator cluster, and is implemented by a distributed validator middleware client. This endpoint is 
     used to exchange partial selection proof slot signatures for combined/aggregated selection proofs to 
-    allow a validator client to correctly determine if one of its validators has been selected to perform 
-    a sync committee contribution (sync aggregation) duty in this slot. Consensus clients need not support 
-    this endpoint and may return a 501.
+    allow a validator client to correctly determine if one of its validators has been selected to perform a 
+    sync committee contribution (sync aggregation) duty in a slot. Validator clients must query this endpoint
+    at the start of an epoch for all validators that have sync committee contribution duties in that epoch. 
+    Consensus clients need not support this endpoint and may return a 501.
   tags:
     - Validator
   requestBody: