Skip to content

Commit 36f2d3e

Browse files
committed
drop BlobAndProofV3 alias; use BlobAndProofV2 type for engine_getBlobsV3.
1 parent 1859a6e commit 36f2d3e

File tree

3 files changed

+4
-13
lines changed

3 files changed

+4
-13
lines changed

src/engine/openrpc/methods/blob.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -224,7 +224,7 @@
224224
- type: array
225225
items:
226226
anyOf:
227-
- $ref: '#/components/schemas/BlobAndProofV3'
227+
- $ref: '#/components/schemas/BlobAndProofV2'
228228
- type: 'null'
229229
- type: 'null'
230230
description: |

src/engine/openrpc/schemas/blob.yaml

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,3 @@ BlobAndProofV2:
2727
type: array
2828
items:
2929
$ref: "#/components/schemas/bytes48"
30-
31-
BlobAndProofV3:
32-
title: Blob and proof object V3
33-
$ref: '#/components/schemas/BlobAndProofV2'

src/engine/osaka.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,6 @@ This specification is based on and extends [Engine API - Prague](./prague.md) sp
1111
- [Structures](#structures)
1212
- [BlobsBundleV2](#blobsbundlev2)
1313
- [BlobAndProofV2](#blobandproofv2)
14-
- [BlobAndProofV3](#blobandproofv3)
1514
- [Methods](#methods)
1615
- [engine_getPayloadV5](#engine_getpayloadv5)
1716
- [Request](#request)
@@ -52,10 +51,6 @@ The fields are encoded as follows:
5251

5352
`proofs` **MUST** contain exactly `CELLS_PER_EXT_BLOB` cell proofs.
5453

55-
### BlobAndProofV3
56-
57-
Alias for `BlobAndProofV2`.
58-
5954
## Methods
6055

6156
### engine_getPayloadV5
@@ -137,15 +132,15 @@ Consensus layer clients **MAY** use this method to fetch blobs from the executio
137132

138133
#### Response
139134

140-
* result: `Array of BlobAndProofV3` - Array of [`BlobAndProofV3`](#BlobAndProofV2), inserting `null` only at the positions of the missing blobs, or a `null` literal in the designated cases specified below.
135+
* result: `Array of BlobAndProofV2` - Array of [`BlobAndProofV2`](#BlobAndProofV2), inserting `null` only at the positions of the missing blobs, or a `null` literal in the designated cases specified below.
141136
* error: code and message set in case an error occurs during processing of the request.
142137

143138
#### Specification
144139

145140
> To assist the reader, we highlight differences against `engine_getBlobsV2` using italic.
146141
147-
1. Given an array of blob versioned hashes client software **MUST** respond with an array of _`BlobAndProofV3`_ objects with matching versioned hashes, respecting the order of versioned hashes in the input array.
148-
2. Given an array of blob versioned hashes, if client software has every one of the requested blobs, it **MUST** return an array of _`BlobAndProofV3`_ objects whose order exactly matches the input array. For instance, if the request is `[A_versioned_hash, B_versioned_hash, C_versioned_hash]` and client software has `A`, `B` and `C` available, the response **MUST** be `[A, B, C]`.
142+
1. Given an array of blob versioned hashes client software **MUST** respond with an array of _`BlobAndProofV2`_ objects with matching versioned hashes, respecting the order of versioned hashes in the input array.
143+
2. Given an array of blob versioned hashes, if client software has every one of the requested blobs, it **MUST** return an array of _`BlobAndProofV2`_ objects whose order exactly matches the input array. For instance, if the request is `[A_versioned_hash, B_versioned_hash, C_versioned_hash]` and client software has `A`, `B` and `C` available, the response **MUST** be `[A, B, C]`.
149144
3. If one or more of the requested blobs are unavailable, _the client **MUST** return an array of the same length and order, inserting `null` only at the positions of the missing blobs._ For instance, if the request is `[A_versioned_hash, B_versioned_hash, C_versioned_hash]` and client software has data for blobs `A` and `C`, but doesn't have data for `B`, _the response **MUST** be `[A, null, C]`. If all blobs are missing, the client software must return an array of matching length, filled with `null` at all positions._
150145
4. Client software **MUST** support request sizes of at least 128 blob versioned hashes. The client **MUST** return `-38004: Too large request` error if the number of requested blobs is too large.
151146
5. Client software **MUST** return `null` if syncing or otherwise unable to generally serve blob pool data.

0 commit comments

Comments
 (0)