Add blob signing endpoints

apis/beacon/blocks/blinded_block.yaml

@@ -25,7 +25,7 @@ get:
             properties:
               version:
                 type: string
-                enum: [phase0, altair, bellatrix, capella]
+                enum: [phase0, altair, bellatrix, capella, deneb]
                 example: "phase0"
               execution_optimistic:
                 $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ExecutionOptimistic"
@@ -37,6 +37,7 @@ get:
                   - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Altair.SignedBeaconBlock"
                   - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Bellatrix.SignedBlindedBeaconBlock"
                   - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Capella.SignedBlindedBeaconBlock"
+                  - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Deneb.SignedBlindedBeaconBlock"
         application/octet-stream:
           schema:
             description: "SSZ serialized block bytes. Use Accept header to choose this response type"

apis/beacon/blocks/blinded_blocks.yaml

@@ -13,7 +13,8 @@ post:
     successful. The beacon node is expected to integrate the new block into its state, and
     therefore validate the block internally, however blocks which fail the validation are still
     broadcast but a different status code is returned (202). Pre-Bellatrix, this endpoint will accept 
-    a `SignedBeaconBlock`.
+    a `SignedBeaconBlock`. After Deneb, this additionally instructs the beacon node to broadcast all given
+    signed blobs.
   parameters:
     - in: header
       schema:
@@ -32,6 +33,7 @@ post:
             - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Altair.SignedBeaconBlock"
             - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Bellatrix.SignedBlindedBeaconBlock"
             - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Capella.SignedBlindedBeaconBlock"
+            - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Deneb.SignedBlindedBlockContents"
       application/octet-stream:
         schema:
           description: "SSZ serialized block bytes. Use content type header to indicate that SSZ data is contained in the request body."

apis/beacon/blocks/block.v2.yaml

@@ -25,7 +25,7 @@ get:
             properties:
               version:
                 type: string
-                enum: [phase0, altair, bellatrix, capella]
+                enum: [phase0, altair, bellatrix, capella, deneb]
                 example: "phase0"
               execution_optimistic:
                 $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ExecutionOptimistic"
@@ -37,6 +37,7 @@ get:
                   - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Altair.SignedBeaconBlock"
                   - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Bellatrix.SignedBeaconBlock"
                   - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Capella.SignedBeaconBlock"
+                  - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Deneb.SignedBeaconBlock"
         application/octet-stream:
           schema:
 

apis/beacon/blocks/blocks.yaml

@@ -11,7 +11,8 @@ post:
     The beacon node is also expected to integrate the block into state, but may broadcast it
     before doing so, so as to aid timely delivery of the block. Should the block fail full
     validation, a separate success response code (202) is used to indicate that the block was
-    successfully broadcast but failed integration.
+    successfully broadcast but failed integration. After Deneb, this additionally instructs
+    the beacon node to broadcast all given signed blobs.
   parameters:
     - in: header
       schema:
@@ -30,6 +31,7 @@ post:
             - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Altair.SignedBeaconBlock"
             - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Bellatrix.SignedBeaconBlock"
             - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Capella.SignedBeaconBlock"
+            - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Deneb.SignedBlockContents"
       application/octet-stream:
         schema:
           description: "SSZ serialized block bytes. Use content type header to indicate that SSZ data is contained in the request body."

apis/debug/state.v2.yaml

@@ -25,7 +25,7 @@ get:
             properties:
               version:
                 type: string
-                enum: [ phase0, altair, bellatrix, capella ]
+                enum: [ phase0, altair, bellatrix, capella, deneb ]
                 example: "phase0"
               execution_optimistic:
                 $ref: "../../beacon-node-oapi.yaml#/components/schemas/ExecutionOptimistic"
@@ -37,6 +37,7 @@ get:
                  - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Altair.BeaconState"
                  - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Bellatrix.BeaconState"
                  - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Capella.BeaconState"
+                 - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Deneb.BeaconState"
         application/octet-stream:
           schema:
             description: "SSZ serialized state bytes. Use Accept header to choose this response type"

apis/validator/blinded_block.yaml

@@ -54,14 +54,15 @@ get:
             properties:
               version:
                 type: string
-                enum: [ phase0, altair, bellatrix, capella ]
+                enum: [ phase0, altair, bellatrix, capella, deneb ]
                 example: "bellatrix"
               data:
                 oneOf:
                   - $ref: '../../beacon-node-oapi.yaml#/components/schemas/BeaconBlock'
                   - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Altair.BeaconBlock"
                   - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Bellatrix.BlindedBeaconBlock"
                   - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Capella.BlindedBeaconBlock"
+                  - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Deneb.BlindedBlockContents"
         application/octet-stream:
           schema:
             description: "SSZ serialized block bytes. Use Accept header to choose this response type, version string is sent in header `Eth-Consensus-Version`."

apis/validator/block.v2.yaml

@@ -51,14 +51,15 @@ get:
             properties:
               version:
                 type: string
-                enum: [ phase0, altair, bellatrix, capella ]
+                enum: [ phase0, altair, bellatrix, capella, deneb ]
                 example: "phase0"
               data:
                 oneOf:
                  - $ref: '../../beacon-node-oapi.yaml#/components/schemas/BeaconBlock'
                  - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Altair.BeaconBlock"
                  - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Bellatrix.BeaconBlock"
                  - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Capella.BeaconBlock"
+                 - $ref: "../../beacon-node-oapi.yaml#/components/schemas/Deneb.BlockContents"
         application/octet-stream:
           schema:
             description: "SSZ serialized block bytes. Use Accept header to choose this response type, version string is sent in header `Eth-Consensus-Version`."

beacon-node-oapi.yaml

@@ -324,7 +324,7 @@ components:
     Bellatrix.SignedBlindedBeaconBlock:
       $ref: './types/bellatrix/block.yaml#/Bellatrix/SignedBlindedBeaconBlock'
     ConsensusVersion:
-      enum: [phase0, altair, bellatrix, capella]
+      enum: [phase0, altair, bellatrix, capella, deneb]
       example: "phase0"
     SignedValidatorRegistration:
       $ref: './types/registration.yaml#/SignedValidatorRegistration'
@@ -348,6 +348,34 @@ components:
       $ref: './types/capella/light_client.yaml#/Capella/LightClientOptimisticUpdate'
     Capella.Withdrawal:
       $ref: './types/withdrawal.yaml#/Withdrawal'
+    Deneb.BeaconState:
+      $ref: './types/deneb/state.yaml#/Deneb/BeaconState'
+    Deneb.BeaconBlock:
+      $ref: './types/deneb/block.yaml#/Deneb/BeaconBlock'
+    Deneb.BlockContents:
+      $ref: './types/deneb/block_contents.yaml#/Deneb/BlockContents'
+    Deneb.SignedBeaconBlock:
+      $ref: './types/deneb/block.yaml#/Deneb/SignedBeaconBlock'
+    Deneb.SignedBlockContents:
+      $ref: './types/deneb/block_contents.yaml#/Deneb/SignedBlockContents'
+    Deneb.BlindedBeaconBlock:
+      $ref: './types/deneb/block.yaml#/Deneb/BlindedBeaconBlock'
+    Deneb.SignedBlindedBlockContents:
+      $ref: './types/deneb/block_contents.yaml#/Deneb/SignedBlindedBlockContents'
+    Deneb.BlindedBlockContents:
+      $ref: './types/deneb/block_contents.yaml#/Deneb/BlindedBlockContents'
+    Deneb.SignedBlindedBeaconBlock:
+      $ref: './types/deneb/block.yaml#/Deneb/SignedBlindedBeaconBlock'
+    Blob:
+      $ref: './types/primitive.yaml#/Blob'
+    Deneb.BlobSidecar:
+      $ref: './types/deneb/blob_sidecar.yaml#/Deneb/BlobSidecar'
+    Deneb.SignedBlobSidecar:
+      $ref: './types/deneb/blob_sidecar.yaml#/Deneb/SignedBlobSidecar'
+    Deneb.BlindedBlobSidecar:
+      $ref: './types/deneb/blob_sidecar.yaml#/Deneb/BlindedBlobSidecar'
+    Deneb.SignedBlindedBlobSidecar:
+      $ref: './types/deneb/blob_sidecar.yaml#/Deneb/SignedBlindedBlobSidecar'
     Node:
       $ref: './types/fork_choice.yaml#/Node'
     ExtraData:

types/bellatrix/execution_payload.yaml

@@ -45,6 +45,7 @@ Bellatrix:
     allOf:
       - $ref: '#/Bellatrix/ExecutionPayloadCommon'
       - type: object
+        additionalProperties: false
         properties:
           transactions_root:
             $ref: '../primitive.yaml#/Root'

types/capella/block.yaml

@@ -34,6 +34,10 @@ Capella:
           $ref: '../voluntary_exit.yaml#/SignedVoluntaryExit'
       sync_aggregate:
         $ref: '../altair/sync_aggregate.yaml#/Altair/SyncAggregate'
+      bls_to_execution_changes:
+        type: array
+        items:
+          $ref: '../bls_to_execution_change.yaml#/SignedBLSToExecutionChange'
 
   BeaconBlockBody:
     allOf:
@@ -42,10 +46,6 @@ Capella:
         properties:
           execution_payload:
             $ref: './execution_payload.yaml#/Capella/ExecutionPayload'
-          bls_to_execution_changes:
-            type: array
-            items:
-              $ref: '../bls_to_execution_change.yaml#/SignedBLSToExecutionChange'
 
   BeaconBlock:
     description: "The [`BeaconBlock`](https://github.com/ethereum/consensus-specs/blob/master/specs/Capella/beacon-chain.md#beaconblock) object from the CL Capella spec."
@@ -73,10 +73,6 @@ Capella:
         properties:
           execution_payload_header:
             $ref: './execution_payload.yaml#/Capella/ExecutionPayloadHeader'
-          bls_to_execution_changes:
-            type: array
-            items:
-              $ref: '../bls_to_execution_change.yaml#/SignedBLSToExecutionChange'
 
   BlindedBeaconBlock:
     description: "A variant of the [`BeaconBlock`](https://github.com/ethereum/consensus-specs/blob/master/specs/capella/beacon-chain.md#beaconblock) object from the CL Capella spec, which contains a `BlindedBeaconBlockBody` rather than a `BeaconBlockBody`."

types/capella/execution_payload.yaml

@@ -47,6 +47,7 @@ Capella:
     allOf:
       - $ref: '#/Capella/ExecutionPayloadCommon'
       - type: object
+        additionalProperties: false
         properties:
           transactions_root:
             $ref: '../primitive.yaml#/Root'

types/deneb/blob_sidecar.yaml

@@ -0,0 +1,90 @@
+Deneb:
+  BlobSidecars:
+    type: array
+    items:
+      $ref: '#/Deneb/BlobSidecar'
+    minItems: 0
+    maxItems: 4
+
+  BlobSidecar:
+    type: object
+    description: "A blob sidecar as defined in the Deneb consensus spec."
+    properties:
+      block_root:
+        $ref: "../primitive.yaml#/Root"
+      index:
+        $ref: "../primitive.yaml#/Uint64"
+      slot:
+        $ref: "../primitive.yaml#/Uint64"
+      block_parent_root:
+        $ref: "../primitive.yaml#/Root"
+      proposer_index:
+        $ref: "../primitive.yaml#/Uint64"
+      blob:
+        $ref: "../primitive.yaml#/Blob"
+      kzg_commitment:
+        $ref: '../primitive.yaml#/KZGCommitment'
+      kzg_proof:
+        $ref: '../primitive.yaml#/KZGProof'
+
+  SignedBlobSidecars:
+    type: array
+    items:
+      $ref: '#/Deneb/SignedBlobSidecar'
+    minItems: 0
+    maxItems: 4
+
+  SignedBlobSidecar:
+    type: object
+    description: "The `SignedBlobSidecar` object envelope from the CL Deneb spec."
+    properties:
+      message:
+        $ref: "#/Deneb/BlobSidecar"
+      signature:
+        $ref: "../primitive.yaml#/Signature"
+
+  BlindedBlobSidecars:
+    type: array
+    items:
+      $ref: '#/Deneb/BlindedBlobSidecar'
+    minItems: 0
+    maxItems: 4
+
+  BlindedBlobSidecar:
+    type: object
+    description: "A blob sidecar with the SSZ root of the blob rather than the full blob."
+    properties:
+      block_root:
+        $ref: "../primitive.yaml#/Root"
+      index:
+        $ref: "../primitive.yaml#/Uint64"
+      slot:
+        $ref: "../primitive.yaml#/Uint64"
+      block_parent_root:
+        $ref: "../primitive.yaml#/Root"
+      proposer_index:
+        $ref: "../primitive.yaml#/Uint64"
+      blob_root:
+        $ref: "../primitive.yaml#/Root"
+      kzg_commitment:
+        $ref: '../primitive.yaml#/KZGCommitment'
+      kzg_proof:
+        $ref: '../primitive.yaml#/KZGProof'
+
+  SignedBlindedBlobSidecars:
+    type: array
+    items:
+      $ref: '#/Deneb/SignedBlindedBlobSidecar'
+    minItems: 0
+    maxItems: 4
+
+  SignedBlindedBlobSidecar:
+    type: object
+    description: "A variant of the `SignedBlobSidecar` object envelope from the CL Deneb spec, which contains a `BlindedBlobSidecar` rather than a `BlobSidecar`."
+    properties:
+      message:
+        $ref: "#/Deneb/BlindedBlobSidecar"
+      signature:
+        $ref: "../primitive.yaml#/Signature"
+
+