1  post:
 2    operationId: "prepareBeaconCommitteeSubnet"
 3    summary: Signal beacon node to prepare for a committee subnet
 4    description: |
 5      After beacon node receives this request,
 6      search using discv5 for peers related to this subnet
 7      and replace current peers with those ones if necessary
 8      If validator `is_aggregator`, beacon node must:
 9      - announce subnet topic subscription on gossipsub
10      - aggregate attestations received on that subnet
11    tags:
12      - ValidatorRequiredApi
13      - Validator
14    requestBody:
15      content:
16        application/json:
17          schema:
18            title: SubscribeToBeaconCommitteeSubnetRequestBody
19            type: array
20            items:
21              type: object
22              properties:
23                validator_index:
24                  $ref: '../../beacon-node-oapi.yaml#/components/schemas/Uint64'
25                committee_index:
26                  $ref: '../../beacon-node-oapi.yaml#/components/schemas/Uint64'
27                committees_at_slot:
28                  allOf:
29                    - $ref: '../../beacon-node-oapi.yaml#/components/schemas/Uint64'
30                    - description: "Number of committees at the returned slot"
31                slot:
32                  allOf:
33                    - $ref: '../../beacon-node-oapi.yaml#/components/schemas/Uint64'
34                    - description: "Should be slot at which validator is assigned to attest"
35                is_aggregator:
36                  type: boolean
37                  description: "Signals to BN that a validator on the VC has been chosen for aggregator role."
38  
39    responses:
40      "200":
41        description: |
42          Slot signature is valid and beacon node has prepared the attestation subnet.
43  
44          Note that, we cannot be certain Beacon node will find peers for that subnet for various reasons,"
45      "400":
46        $ref: '../../beacon-node-oapi.yaml#/components/responses/InvalidRequest'
47      "500":
48        $ref: '../../beacon-node-oapi.yaml#/components/responses/InternalError'
49      "503":
50        $ref: '../../beacon-node-oapi.yaml#/components/responses/CurrentlySyncing'