Use versioned_hashes instead of indices for filtering

Author: nflaig

apis/beacon/blobs/blobs.yaml

@@ -5,8 +5,8 @@ get:
     Retrieves blobs for a given block id.
     Depending on `Accept` header it can be returned either as json or as bytes serialized by SSZ.
 
-    If the `indices` parameter is specified, only the blobs with the specified indices will be returned. There are no guarantees
-    for the returned blobs in terms of ordering.
+    If the `versioned_hashes` parameter is specified, only the blobs with the specified versioned hashes will be returned. Blobs are 
+    returned as an ordered list matching the order of their corresponding KZG commitments in the block.
 
     After the Fulu fork, only supernodes (which custody all data columns) are required to return blobs. Clients may implement
     blob reconstruction logic for non-super nodes.
@@ -17,15 +17,15 @@ get:
       in: path
       required: true
       $ref: "../../../beacon-node-oapi.yaml#/components/parameters/BlockId"
-    - name: indices
+    - name: versioned_hashes
       in: query
-      description: Array of indices for blobs to request for in the specified block. Returns all blobs in the block if not specified.
+      description: Array of versioned hashes for blobs to request for in the specified block. Returns all blobs in the block if not specified.
       required: false
       schema:
         type: array
         uniqueItems: true
         items:
-          $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Uint64"
+          $ref: "../../../beacon-node-oapi.yaml#/components/schemas/VersionedHash"
   responses:
     "200":
       description: "Successful response"

beacon-node-oapi.yaml

@@ -385,6 +385,8 @@ components:
       $ref: './types/primitive.yaml#/Blob'
     Blobs:
       $ref: './types/deneb/block_contents.yaml#/Deneb/Blobs'
+    VersionedHash:
+      $ref: './types/primitive.yaml#/VersionedHash'
     Deneb.BlobSidecars:
       $ref: './types/deneb/blob_sidecar.yaml#/Deneb/BlobSidecars'
     Electra.BeaconState:

types/primitive.yaml

@@ -141,3 +141,10 @@ KZGProof:
   format: hex
   pattern: "^0x[a-fA-F0-9]{96}$"
   description: "A G1 curve point. Used for verifying that the `KZGCommitment` for a given `Blob` is correct."
+
+VersionedHash:
+  type: string
+  format: hex
+  pattern: "^0x[a-fA-F0-9]{64}$"
+  description: "A versioned hash used to identify a blob."
+  example: "0x01cf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"