Merge pull request #135 from rolfyone/sync_committees

add POST `/eth/v1/beacon/pool/sync_committees`

apis/beacon/pool/sync_committees.yaml

@@ -0,0 +1,34 @@
+post:
+  operationId: submitPoolSyncCommitteeSignatures
+  summary: Submit sync committee signatures to node
+  description: |
+    Submits sync committee signature objects to the node.
+
+    Sync committee signatures are not present in phase0, but are required for Altair networks.
+
+    If a sync committee signature is validated successfully the node MUST publish that sync committee signature on all applicable subnets.
+
+    If one or more sync committee signatures fail validation the node MUST return a 400 error with details of which sync committee signatures have failed, and why.
+
+  tags:
+    - Beacon
+    - ValidatorRequiredApi
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: array
+          items:
+            $ref: '../../../beacon-node-oapi.yaml#/components/schemas/Altair.SyncCommitteeSignature'
+  responses:
+    "200":
+      description: Sync committee signatures are stored in pool and broadcast on appropriate subnet
+    "400":
+      description: "Errors with one or more sync committee signatures"
+      content:
+        application/json:
+          schema:
+            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/IndexedErrorMessage"
+    "500":
+      $ref: '../../../beacon-node-oapi.yaml#/components/responses/InternalError'

beacon-node-oapi.yaml

@@ -84,6 +84,8 @@ paths:
     $ref: "./apis/beacon/pool/attester_slashings.yaml"
   /eth/v1/beacon/pool/proposer_slashings:
     $ref: "./apis/beacon/pool/proposer_slashings.yaml"
+  /eth/v1/beacon/pool/sync_committees:
+    $ref: "./apis/beacon/pool/sync_committees.yaml"
   /eth/v1/beacon/pool/voluntary_exits:
     $ref: "./apis/beacon/pool/voluntary_exists.yaml"
 
@@ -217,6 +219,8 @@ components:
       $ref: './types/altair/block.yaml#/Altair/BeaconBlock'
     Altair.BeaconState:
       $ref: './types/altair/state.yaml#/Altair/BeaconState'
+    Altair.SyncCommitteeSignature:
+      $ref: './types/altair/sync_committee.yaml#/Altair/SyncCommitteeSignature'
     Altair.SyncCommitteeSubscription:
       $ref: './types/altair/sync_committee.yaml#/Altair/SyncCommitteeSubscription'
     Altair.ContributionAndProof:

types/altair/sync_committee.yaml

@@ -16,6 +16,17 @@ Altair:
             - $ref: '../primitive.yaml#/Pubkey'
         minItems: 16
         maxItems: 16
+  SyncCommitteeSignature:
+      type: object
+      properties:
+        slot:
+          $ref: '../primitive.yaml#/Uint64'
+        beacon_block_root:
+          $ref: '../primitive.yaml#/Root'
+        validator_index:
+          $ref: '../primitive.yaml#/Uint64'
+        signature:
+          $ref: '../primitive.yaml#/Signature'
   SyncCommitteeSubscription:
     type: object
     properties: