payload attestation post should support an array in the request

Author: shane-moore

apis/beacon/pool/payload_attestations.yaml

@@ -47,13 +47,15 @@ post:
   operationId: submitPayloadAttestationMessage
   summary: Submit payload attestation message
   description: |
-    Submits a payload attestation message to the beacon node.
+    Submits payload attestation messages to the beacon node.
 
-    The beacon node will validate the payload attestation message according to the gossip validation rules
+    The beacon node will validate each payload attestation message according to the gossip validation rules
     and, if valid, store it in the pool and broadcast it globally to the network.
 
     A success response indicates that the payload attestation message passed validation and was
     successfully stored and broadcast.
+
+    If one or more payload attestation messages fail validation, the node MUST return a 400 error with details of which messages have failed, and why.
   parameters:
     - in: header
       schema:
@@ -65,28 +67,26 @@ post:
     - Beacon
     - ValidatorRequiredApi
   requestBody:
-    description: "The PayloadAttestationMessage object to be submitted."
+    description: "Array of PayloadAttestationMessage objects to be submitted."
     required: true
     content:
       application/json:
         schema:
-          $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Gloas.PayloadAttestationMessage"
+          type: array
+          items:
+            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Gloas.PayloadAttestationMessage"
       application/octet-stream:
         schema:
-          description: "SSZ serialized PayloadAttestationMessage bytes. Use Content-Type header to indicate that SSZ data is contained in the request body."
+          description: "SSZ serialized array of PayloadAttestationMessage bytes. Use Content-Type header to indicate that SSZ data is contained in the request body."
   responses:
     "200":
-      description: "The payload attestation message was stored in the pool and has been broadcast."
-      content:
-        text/plain:
-          schema:
-            type: string
+      description: "Payload attestation messages are stored in pool and broadcasted to the network"
     "400":
-      description: "The PayloadAttestationMessage object is invalid or failed gossip validation"
+      description: "Errors with one or more payload attestation messages"
       content:
         application/json:
           schema:
-            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
+            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/IndexedErrorMessage"
     "415":
       $ref: "../../../beacon-node-oapi.yaml#/components/responses/UnsupportedMediaType"
     "500":