Add SSZ support to attestation apis (#527)

Co-authored-by: Paul Harris <[email protected]>

Author: nflaig

apis/beacon/pool/attestations.v2.yaml

@@ -85,6 +85,9 @@ post:
             - type: array
               items:
                 $ref: '../../../beacon-node-oapi.yaml#/components/schemas/Phase0.Attestation'
+      application/octet-stream:
+        schema:
+          description: "SSZ serialized `List[Attestation, MAX_VALIDATORS_PER_COMMITTEE * MAX_COMMITTEES_PER_SLOT]` or `List[SingleAttestation, MAX_VALIDATORS_PER_COMMITTEE * MAX_COMMITTEES_PER_SLOT]` bytes. Use content type header to indicate that SSZ data is contained in the request body."
   responses:
     "200":
       description: Attestations are stored in pool and broadcast on the appropriate subnet
@@ -94,5 +97,7 @@ post:
         application/json:
           schema:
             $ref: "../../../beacon-node-oapi.yaml#/components/schemas/IndexedErrorMessage"
+    "415":
+      $ref: '../../../beacon-node-oapi.yaml#/components/responses/UnsupportedMediaType'
     "500":
       $ref: '../../../beacon-node-oapi.yaml#/components/responses/InternalError'

apis/validator/aggregate_and_proofs.v2.yaml

@@ -24,10 +24,15 @@ post:
             - type: array
               items:
                 $ref: '../../beacon-node-oapi.yaml#/components/schemas/Phase0.SignedAggregateAndProof'
+      application/octet-stream:
+        schema:
+          description: "SSZ serialized `List[SignedAggregateAndProof, MAX_COMMITTEES_PER_SLOT * TARGET_AGGREGATORS_PER_COMMITTEE]` bytes. Use content type header to indicate that SSZ data is contained in the request body."
   responses:
     "200":
       description: "Successful response"
     "400":
       $ref: '../../beacon-node-oapi.yaml#/components/responses/InvalidRequest'
+    "415":
+      $ref: '../../beacon-node-oapi.yaml#/components/responses/UnsupportedMediaType'
     "500":
       $ref: '../../beacon-node-oapi.yaml#/components/responses/InternalError'

apis/validator/aggregate_attestation.v2.yaml

@@ -51,9 +51,14 @@ get:
                 anyOf:
                   - $ref: '../../beacon-node-oapi.yaml#/components/schemas/Electra.Attestation'
                   - $ref: '../../beacon-node-oapi.yaml#/components/schemas/Phase0.Attestation'
+        application/octet-stream:
+          schema:
+            description: "SSZ serialized `Attestation` bytes. Use Accept header to choose this response type"
     "400":
       $ref: '../../beacon-node-oapi.yaml#/components/responses/InvalidRequest'
     "404":
       $ref: '../../beacon-node-oapi.yaml#/components/responses/NotFound'
+    "406":
+      $ref: "../../beacon-node-oapi.yaml#/components/responses/NotAcceptable"
     "500":
       $ref: '../../beacon-node-oapi.yaml#/components/responses/InternalError'

apis/validator/attestation_data.yaml

@@ -36,8 +36,13 @@ get:
             properties:
               data:
                 $ref: '../../beacon-node-oapi.yaml#/components/schemas/Phase0.AttestationData'
+        application/octet-stream:
+          schema:
+            description: "SSZ serialized `AttestationData` bytes. Use Accept header to choose this response type"
     "400":
       $ref: '../../beacon-node-oapi.yaml#/components/responses/InvalidRequest'
+    "406":
+      $ref: '../../beacon-node-oapi.yaml#/components/responses/NotAcceptable'
     "500":
       $ref: '../../beacon-node-oapi.yaml#/components/responses/InternalError'
     "503":