Update relay specs for Fulu

apis/relay/builder/blocks.yaml

@@ -41,6 +41,7 @@ post:
             - $ref: "../../../relay-oapi.yaml#/components/schemas/Capella.SubmitBlockRequest"
             - $ref: "../../../relay-oapi.yaml#/components/schemas/Deneb.SubmitBlockRequest"
             - $ref: "../../../relay-oapi.yaml#/components/schemas/Electra.SubmitBlockRequest"
+            - $ref: "../../../relay-oapi.yaml#/components/schemas/Fulu.SubmitBlockRequest"
         examples:
           bellatrix:
             $ref: "../../../relay-oapi.yaml#/components/examples/Bellatrix.SubmitBlockRequest"
@@ -50,6 +51,8 @@ post:
             $ref: "../../../relay-oapi.yaml#/components/examples/Deneb.SubmitBlockRequest"
           electra:
             $ref: "../../../relay-oapi.yaml#/components/examples/Electra.SubmitBlockRequest"
+          fulu:
+            $ref: "../../../relay-oapi.yaml#/components/examples/Fulu.SubmitBlockRequest"
       application/octet-stream:
         schema:
           description: "SSZ serialized request. Use content type header to indicate that SSZ data is contained in the request body."

relay-oapi.yaml

@@ -57,6 +57,8 @@ components:
       $ref: "./types/deneb/requests.yaml#/Deneb/SubmitBlockRequest"
     Electra.SubmitBlockRequest:
       $ref: "./types/electra/requests.yaml#/Electra/SubmitBlockRequest"
+    Fulu.SubmitBlockRequest:
+      $ref: "./types/fulu/requests.yaml#/Fulu/SubmitBlockRequest"
     ValidatorsResponse:
       $ref: "./types/responses.yaml#/ValidatorsResponse"
     DeliveredPayloadsResponse:
@@ -77,3 +79,5 @@ components:
       $ref: "./examples/deneb/submit_block_request.json"
     Electra.SubmitBlockRequest:
       $ref: "./examples/electra/submit_block_request.json"
+    Fulu.SubmitBlockRequest:
+      $ref: "./examples/fulu/submit_block_request.json"

specs/fulu/builder.md

@@ -0,0 +1,58 @@
+
+
+## Introduction
+
+This document presents the `mev-boost` relay specification for Fulu.
+
+[`mev-boost`](https://boost.flashbots.net/) is an out-of-protocol mechanism to
+connect Ethereum Proof-of-Stake validators to the external block-building
+market. The [validator-side](https://github.com/flashbots/mev-boost) API is
+specified in the [builder specs](https://github.com/ethereum/builder-specs). The
+[relay-side](https://github.com/flashbots/mev-boost-relay) API is specified here
+in the relay specs.
+
+## Constants
+
+The following values are (non-configurable) constants used throughout the
+specification.
+
+| Name | Value |
+| - | - |
+| `FIELD_ELEMENTS_PER_EXT_BLOB` | `uint64(2**13)` (= 8192)| Number of field elements in a Reed-Solomon extended blob |
+
+
+## Containers
+
+### Modified `BlobsBundle`
+
+```python
+class BlobsBundle(Container):
+    commitments: List[KZGCommitment, MAX_BLOB_COMMITMENTS_PER_BLOCK]
+    # [Modified in Fulu:EIP7594]
+    proofs: List[KZGProof, FIELD_ELEMENTS_PER_EXT_BLOB * MAX_BLOB_COMMITMENTS_PER_BLOCK]
+    blobs: List[Blob, MAX_BLOB_COMMITMENTS_PER_BLOCK]
+```
+
+### Modified `SubmitBlockRequest`
+
+*Note*: `SubmitBlockRequest` is modified to include the update in `BlobsBundle`.
+
+```python
+class SubmitBlockRequest(Container):
+    message: BidTrace
+    execution_payload: ExecutionPayload
+    # [Modified in Fulu:EIP7594]
+    blobs_bundle: BlobsBundle
+    execution_requests: ExecutionRequests
+    signature: BLSSignature
+```
+
+#### Modified `BuilderSubmitNewBlockRequest`
+
+*Note*: `BuilderSubmitNewBlockRequest` is modified by replacing the `bellatrix`
+field with a new `fulu` field.
+
+```python
+class BuilderSubmitNewBlockRequest(Container):
+     fulu: SubmitBlockRequest
+```

types/fulu/requests.yaml

@@ -0,0 +1,6 @@
+Fulu:
+  SubmitBlockRequest:
+    allOf:
+      - $ref: '../bellatrix/requests.yaml#/Bellatrix/SubmitBlockRequestCommon'
+      - $ref: "../../builder-specs/types/fulu/execution_payload_and_blobs_bundle.yaml#/Fulu/ExecutionPayloadAndBlobsBundle"
+      - $ref: "../../beacon-apis/types/electra/execution_requests.yaml#/Electra/ExecutionRequests"

wordlist.txt

@@ -33,4 +33,5 @@ vc
 wei
 deneb
 kzg
-electra
+electra
+fulu