Skip to content

Commit 4aca1d7

Browse files
mkalininmkalinin
authored
engine: Remove engine_getPayloadBodiesBy{Hash|Range}V2 (#586)
Remove engine_getPayloadBodiesBy{Hash|Range}V2
1 parent 71260dd commit 4aca1d7

File tree

3 files changed

+0
-270
lines changed

3 files changed

+0
-270
lines changed

‎src/engine/openrpc/methods/payload.yaml‎

Lines changed: 0 additions & 168 deletions
Original file line numberDiff line numberDiff line change
@@ -631,89 +631,6 @@
631631
validatorIndex: '0xf3'
632632
address: '0x00000000000000000000000000000000000010f3'
633633
amount: '0x1'
634-
- name: engine_getPayloadBodiesByHashV2
635-
summary: Given block hashes returns bodies of the corresponding execution payloads
636-
externalDocs:
637-
description: Method specification
638-
url: https://github.com/ethereum/execution-apis/blob/main/src/engine/prague.md#engine_getpayloadbodiesbyhashv2
639-
params:
640-
- name: Array of block hashes
641-
required: true
642-
schema:
643-
type: array
644-
items:
645-
$ref: '#/components/schemas/hash32'
646-
result:
647-
name: Execution payload bodies
648-
schema:
649-
type: array
650-
items:
651-
$ref: '#/components/schemas/ExecutionPayloadBodyV2'
652-
errors:
653-
- code: -38004
654-
message: Too large request
655-
examples:
656-
- name: engine_getPayloadBodiesByHashV2 example
657-
params:
658-
- name: Array of block hashes
659-
value:
660-
- '0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c'
661-
- '0xfe88c94d860f01a17f961bf4bdfb6e0c6cd10d3fda5cc861e805ca1240c58553'
662-
result:
663-
name: Execution payload bodies
664-
value:
665-
- transactions:
666-
- '0xf865808506fc23ac00830124f8940101010101010101010101010101010101010101018031a02c4d88bfdc2f6dbf82c33d235c4e785e9fc23b2d0fc7b9d20fc5e9674f1f9d15a016d6d69b925cf26128683ab4a096e196fbb1142d6c6d4e8d3481b9bef1bd0f65'
667-
- '0x02f86c0701843b9aca008506fc23ac00830124f89402020202020202020202020202020202020202020180c080a039409b4e5603dd8c3cf38232348661a8e99ac518396eeaa128ec9ec2a3eb8127a06b21ab956f5f138cb44fda1a9055bd08980ea4f8040d877c00dac025608d0d95'
668-
withdrawals:
669-
- index: '0xf0'
670-
validatorIndex: '0xf0'
671-
address: '0x00000000000000000000000000000000000010f0'
672-
amount: '0x1'
673-
- index: '0xf1'
674-
validatorIndex: '0xf1'
675-
address: '0x00000000000000000000000000000000000010f1'
676-
amount: '0x1'
677-
depositRequests:
678-
- pubkey: '0x96a96086cff07df17668f35f7418ef8798079167e3f4f9b72ecde17b28226137cf454ab1dd20ef5d924786ab3483c2f9'
679-
withdrawalCredentials: '0x003f5102dabe0a27b1746098d1dc17a5d3fbd478759fea9287e4e419b3c3cef2'
680-
amount: '0x1'
681-
signature: '0xb1acdb2c4d3df3f1b8d3bfd33421660df358d84d78d16c4603551935f4b67643373e7eb63dcb16ec359be0ec41fee33b03a16e80745f2374ff1d3c352508ac5d857c6476d3c3bcf7e6ca37427c9209f17be3af5264c0e2132b3dd1156c28b4e9'
682-
index: '0xf0'
683-
withdrawalRequests:
684-
- sourceAddress: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b'
685-
validatorPubkey: '0x85103a5617937691dfeeb89b86a80d5dc9e3c9d3a1a0e7ce311e26e0bb732eabaa47ffa288f0d54de28209a62a7d29d0'
686-
amount: '0x0'
687-
consolidationRequests:
688-
- sourceAddress: '0x00000000000000000000000000000000000010f6'
689-
sourcePubkey: '0x96a96086cff07df17668f35f7418ef8798079167e3f4f9b72ecde17b28226137cf454ab1dd20ef5d924786ab3483c2f9'
690-
targetPubkey: '0xa5c85a60ba2905c215f6a12872e62b1ee037051364244043a5f639aa81b04a204c55e7cc851f29c7c183be253ea1510b'
691-
- transactions:
692-
- '0xf865108506fc23ac00830124f8940101010101010101010101010101010101010101018031a0d9712a3c40ae85aea4ad1bd95a0b7cc7bd805189a9e2517403b11a00a1530f81a053b53b0267a6dcfe9f9a1652307b396b3e8a65e65707a450e60c92baefdbcfbe'
693-
- '0x02f86c0711843b9aca008506fc23ac00830124f89402020202020202020202020202020202020202020180c080a071d36bc93c7ae8cc5c01501e51e5e97a51aa541d1a89c809a2af7eb40e9bc2cba071644230e21c075c1da08916aff5efe9f95a6f6a4f94dc217f6c1bb4a3240b29'
694-
withdrawals:
695-
- index: '0xf2'
696-
validatorIndex: '0xf2'
697-
address: '0x00000000000000000000000000000000000010f2'
698-
amount: '0x1'
699-
- index: '0xf3'
700-
validatorIndex: '0xf3'
701-
address: '0x00000000000000000000000000000000000010f3'
702-
amount: '0x1'
703-
depositRequests:
704-
- pubkey: '0xa5c85a60ba2905c215f6a12872e62b1ee037051364244043a5f639aa81b04a204c55e7cc851f29c7c183be253ea1510b'
705-
withdrawalCredentials: '0x001db70c485b6264692f26b8aeaab5b0c384180df8e2184a21a808a3ec8e86ca'
706-
amount: '0x1'
707-
signature: '0x9561731785b48cf1886412234531e4940064584463e96ac63a1a154320227e333fb51addc4a89b7e0d3f862d7c1fd4ea03bd8eb3d8806f1e7daf591cbbbb92b0beb74d13c01617f22c5026b4f9f9f294a8a7c32db895de3b01bee0132c9209e1'
708-
index: '0xf1'
709-
withdrawalRequests:
710-
- sourceAddress: '0x00000000000000000000000000000000000010f6'
711-
validatorPubkey: '0x98daeed734da114470da559bd4b4c7259e1f7952555241dcbc90cf194a2ef676fc6005f3672fada2a3645edb297a7553'
712-
amount: '0x1'
713-
consolidationRequests:
714-
- sourceAddress: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b'
715-
sourcePubkey: '0x85103a5617937691dfeeb89b86a80d5dc9e3c9d3a1a0e7ce311e26e0bb732eabaa47ffa288f0d54de28209a62a7d29d0'
716-
targetPubkey: '0x98daeed734da114470da559bd4b4c7259e1f7952555241dcbc90cf194a2ef676fc6005f3672fada2a3645edb297a7553'
717634
- name: engine_getPayloadBodiesByRangeV1
718635
summary: Given a range of block numbers returns bodies of the corresponding execution payloads
719636
externalDocs:
@@ -771,88 +688,3 @@
771688
validatorIndex: '0xf3'
772689
address: '0x00000000000000000000000000000000000010f3'
773690
amount: '0x1'
774-
- name: engine_getPayloadBodiesByRangeV2
775-
summary: Given a range of block numbers returns bodies of the corresponding execution payloads
776-
externalDocs:
777-
description: Method specification
778-
url: https://github.com/ethereum/execution-apis/blob/main/src/engine/prague.md#engine_getpayloadbodiesbyrangev2
779-
params:
780-
- name: Starting block number
781-
required: true
782-
schema:
783-
$ref: '#/components/schemas/uint64'
784-
- name: Number of blocks to return
785-
required: true
786-
schema:
787-
$ref: '#/components/schemas/uint64'
788-
result:
789-
name: Execution payload bodies
790-
schema:
791-
type: array
792-
items:
793-
$ref: '#/components/schemas/ExecutionPayloadBodyV2'
794-
errors:
795-
- code: -38004
796-
message: Too large request
797-
examples:
798-
- name: engine_getPayloadBodiesByRangeV2 example
799-
params:
800-
- name: Starting block number
801-
value: '0x20'
802-
- name: Number of blocks to return
803-
value: '0x2'
804-
result:
805-
name: Execution payload bodies
806-
value:
807-
- transactions:
808-
- '0xf865808506fc23ac00830124f8940101010101010101010101010101010101010101018031a02c4d88bfdc2f6dbf82c33d235c4e785e9fc23b2d0fc7b9d20fc5e9674f1f9d15a016d6d69b925cf26128683ab4a096e196fbb1142d6c6d4e8d3481b9bef1bd0f65'
809-
- '0x02f86c0701843b9aca008506fc23ac00830124f89402020202020202020202020202020202020202020180c080a039409b4e5603dd8c3cf38232348661a8e99ac518396eeaa128ec9ec2a3eb8127a06b21ab956f5f138cb44fda1a9055bd08980ea4f8040d877c00dac025608d0d95'
810-
withdrawals:
811-
- index: '0xf0'
812-
validatorIndex: '0xf0'
813-
address: '0x00000000000000000000000000000000000010f0'
814-
amount: '0x1'
815-
- index: '0xf1'
816-
validatorIndex: '0xf1'
817-
address: '0x00000000000000000000000000000000000010f1'
818-
amount: '0x1'
819-
depositRequests:
820-
- pubkey: '0x96a96086cff07df17668f35f7418ef8798079167e3f4f9b72ecde17b28226137cf454ab1dd20ef5d924786ab3483c2f9'
821-
withdrawalCredentials: '0x003f5102dabe0a27b1746098d1dc17a5d3fbd478759fea9287e4e419b3c3cef2'
822-
amount: '0x1'
823-
signature: '0xb1acdb2c4d3df3f1b8d3bfd33421660df358d84d78d16c4603551935f4b67643373e7eb63dcb16ec359be0ec41fee33b03a16e80745f2374ff1d3c352508ac5d857c6476d3c3bcf7e6ca37427c9209f17be3af5264c0e2132b3dd1156c28b4e9'
824-
index: '0xf0'
825-
withdrawalRequests:
826-
- sourceAddress: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b'
827-
validatorPubkey: '0x85103a5617937691dfeeb89b86a80d5dc9e3c9d3a1a0e7ce311e26e0bb732eabaa47ffa288f0d54de28209a62a7d29d0'
828-
amount: '0x0'
829-
consolidationRequests:
830-
- sourceAddress: '0x00000000000000000000000000000000000010f6'
831-
sourcePubkey: '0x96a96086cff07df17668f35f7418ef8798079167e3f4f9b72ecde17b28226137cf454ab1dd20ef5d924786ab3483c2f9'
832-
targetPubkey: '0xa5c85a60ba2905c215f6a12872e62b1ee037051364244043a5f639aa81b04a204c55e7cc851f29c7c183be253ea1510b'
833-
- transactions:
834-
- '0xf865108506fc23ac00830124f8940101010101010101010101010101010101010101018031a0d9712a3c40ae85aea4ad1bd95a0b7cc7bd805189a9e2517403b11a00a1530f81a053b53b0267a6dcfe9f9a1652307b396b3e8a65e65707a450e60c92baefdbcfbe'
835-
- '0x02f86c0711843b9aca008506fc23ac00830124f89402020202020202020202020202020202020202020180c080a071d36bc93c7ae8cc5c01501e51e5e97a51aa541d1a89c809a2af7eb40e9bc2cba071644230e21c075c1da08916aff5efe9f95a6f6a4f94dc217f6c1bb4a3240b29'
836-
withdrawals:
837-
- index: '0xf2'
838-
validatorIndex: '0xf2'
839-
address: '0x00000000000000000000000000000000000010f2'
840-
amount: '0x1'
841-
- index: '0xf3'
842-
validatorIndex: '0xf3'
843-
address: '0x00000000000000000000000000000000000010f3'
844-
amount: '0x1'
845-
depositRequests:
846-
- pubkey: '0xa5c85a60ba2905c215f6a12872e62b1ee037051364244043a5f639aa81b04a204c55e7cc851f29c7c183be253ea1510b'
847-
withdrawalCredentials: '0x001db70c485b6264692f26b8aeaab5b0c384180df8e2184a21a808a3ec8e86ca'
848-
amount: '0x1'
849-
signature: '0x9561731785b48cf1886412234531e4940064584463e96ac63a1a154320227e333fb51addc4a89b7e0d3f862d7c1fd4ea03bd8eb3d8806f1e7daf591cbbbb92b0beb74d13c01617f22c5026b4f9f9f294a8a7c32db895de3b01bee0132c9209e1'
850-
index: '0xf1'
851-
withdrawalRequests:
852-
- sourceAddress: '0x00000000000000000000000000000000000010f6'
853-
validatorPubkey: '0x98daeed734da114470da559bd4b4c7259e1f7952555241dcbc90cf194a2ef676fc6005f3672fada2a3645edb297a7553'
854-
amount: '0x1'
855-
consolidationRequests:
856-
- sourceAddress: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b'
857-
sourcePubkey: '0x85103a5617937691dfeeb89b86a80d5dc9e3c9d3a1a0e7ce311e26e0bb732eabaa47ffa288f0d54de28209a62a7d29d0'
858-
targetPubkey: '0x98daeed734da114470da559bd4b4c7259e1f7952555241dcbc90cf194a2ef676fc6005f3672fada2a3645edb297a7553'

‎src/engine/openrpc/schemas/payload.yaml‎

Lines changed: 0 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -332,44 +332,6 @@ ExecutionPayloadBodyV1:
332332
- 'null'
333333
items:
334334
$ref: '#/components/schemas/WithdrawalV1'
335-
ExecutionPayloadBodyV2:
336-
title: Execution payload body object V2
337-
type: object
338-
required:
339-
- transactions
340-
properties:
341-
transactions:
342-
title: Transactions
343-
type: array
344-
items:
345-
$ref: '#/components/schemas/bytes'
346-
withdrawals:
347-
title: Withdrawals
348-
type:
349-
- array
350-
- 'null'
351-
items:
352-
$ref: '#/components/schemas/WithdrawalV1'
353-
depositRequests:
354-
title: Deposit requests
355-
type:
356-
- array
357-
- 'null'
358-
items:
359-
$ref: '#/components/schemas/DepositRequestV1'
360-
withdrawalRequests:
361-
title: Withdrawals requests
362-
type:
363-
- array
364-
- 'null'
365-
items:
366-
$ref: '#/components/schemas/WithdrawalRequestV1'
367-
consolidationRequests:
368-
title: Consolidation requests
369-
- array
370-
- 'null'
371-
items:
372-
$ref: '#/components/schemas/ConsolidationRequestV1'
373335
BlobsBundleV1:
374336
title: Blobs bundle object V1
375337
type: object

‎src/engine/prague.md‎

Lines changed: 0 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ This specification is based on and extends [Engine API - Cancun](./cancun.md) sp
1414
- [WithdrawalRequestV1](#withdrawalrequestv1)
1515
- [ConsolidationRequestV1](#consolidationrequestv1)
1616
- [ExecutionPayloadV4](#executionpayloadv4)
17-
- [ExecutionPayloadBodyV2](#executionpayloadbodyv2)
1817
- [Methods](#methods)
1918
- [engine_newPayloadV4](#engine_newpayloadv4)
2019
- [Request](#request)
@@ -24,14 +23,6 @@ This specification is based on and extends [Engine API - Cancun](./cancun.md) sp
2423
- [Request](#request-1)
2524
- [Response](#response-1)
2625
- [Specification](#specification-1)
27-
- [engine_getPayloadBodiesByHashV2](#engine_getpayloadbodiesbyhashv2)
28-
- [Request](#request-2)
29-
- [Response](#response-2)
30-
- [Specification](#specification-2)
31-
- [engine_getPayloadBodiesByRangeV2](#engine_getpayloadbodiesbyrangev2)
32-
- [Request](#request-3)
33-
- [Response](#response-3)
34-
- [Specification](#specification-3)
3526
- [Update the methods of previous forks](#update-the-methods-of-previous-forks)
3627

3728
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
@@ -93,16 +84,6 @@ This structure has the syntax of [`ExecutionPayloadV3`](./cancun.md#executionpay
9384
- `withdrawalRequests`: `Array of WithdrawalRequestV1` - Array of withdrawal requests, each object is an `OBJECT` containing the fields of a `WithdrawalRequestV1` structure.
9485
- `consolidationRequests`: `Array of ConsolidationRequestV1` - Array of consolidation requests, each object is an `OBJECT` containing the fields of a `ConsolidationRequestV1` structure.
9586

96-
### ExecutionPayloadBodyV2
97-
98-
This structure has the syntax of [`ExecutionPayloadBodyV1`](./shanghai.md#executionpayloadv1) and appends the new fields: `depositRequests`, `withdrawalRequests` and `consolidationRequests`.
99-
100-
- `transactions`: `Array of DATA` - Array of transaction objects, each object is a byte list (`DATA`) representing `TransactionType || TransactionPayload` or `LegacyTransaction` as defined in [EIP-2718](https://eips.ethereum.org/EIPS/eip-2718)
101-
- `withdrawals`: `Array of WithdrawalV1` - Array of withdrawals, each object is an `OBJECT` containing the fields of a `WithdrawalV1` structure.
102-
- `depositRequests`: `Array of DepositRequestV1` - Array of deposits, each object is an `OBJECT` containing the fields of a `DepositRequestV1` structure.
103-
- `withdrawalRequests`: `Array of WithdrawalRequestV1` - Array of withdrawal requests, each object is an `OBJECT` containing the fields of a `WithdrawalRequestV1` structure.
104-
- `consolidationRequests`: `Array of ConsolidationRequestV1` - Array of consolidation requests, each object is an `OBJECT` containing the fields of a `ConsolidationRequestV1` structure.
105-
10687
## Methods
10788

10889
### engine_newPayloadV4
@@ -153,51 +134,6 @@ This method follows the same specification as [`engine_getPayloadV3`](./cancun.m
153134

154135
1. Client software **MUST** return `-38005: Unsupported fork` error if the `timestamp` of the built payload does not fall within the time frame of the Prague fork.
155136

156-
### engine_getPayloadBodiesByHashV2
157-
158-
The response of this method is updated with [`ExecutionPayloadBodyV2`](#executionpayloadbodyv2).
159-
160-
#### Request
161-
162-
* method: `engine_getPayloadBodiesByHashV2`
163-
* params:
164-
1. `Array of DATA`, 32 Bytes - Array of `block_hash` field values of the `ExecutionPayload` structure
165-
* timeout: 10s
166-
167-
#### Response
168-
169-
* result: `Array of ExecutionPayloadBodyV2` - Array of [`ExecutionPayloadBodyV2`](#executionpayloadbodyv2) objects.
170-
* error: code and message set in case an exception happens while processing the method call.
171-
172-
#### Specification
173-
174-
This method follows the same specification as [`engine_getPayloadBodiesByHashV1`](./shanghai.md#engine_getpayloadbodiesbyhashv1) with the addition of the following:
175-
176-
1. Client software **MUST** set `depositRequests`, `withdrawalRequests` and `consolidationRequests` fields to `null` for bodies of pre-Prague blocks.
177-
178-
### engine_getPayloadBodiesByRangeV2
179-
180-
The response of this method is updated with [`ExecutionPayloadBodyV2`](#executionpayloadbodyv2).
181-
182-
#### Request
183-
184-
* method: `engine_getPayloadBodiesByRangeV2`
185-
* params:
186-
1. `start`: `QUANTITY`, 64 bits - Starting block number
187-
1. `count`: `QUANTITY`, 64 bits - Number of blocks to return
188-
* timeout: 10s
189-
190-
#### Response
191-
192-
* result: `Array of ExecutionPayloadBodyV2` - Array of [`ExecutionPayloadBodyV2`](#executionpayloadbodyv2) objects.
193-
* error: code and message set in case an exception happens while processing the method call.
194-
195-
#### Specification
196-
197-
This method follows the same specification as [`engine_getPayloadBodiesByRangeV2`](./shanghai.md#engine_getpayloadbodiesbyrangev1) with the addition of the following:
198-
199-
1. Client software **MUST** set `depositRequests`, `withdrawalRequests` and `consolidationRequests` fields to `null` for bodies of pre-Prague blocks.
200-
201137
### Update the methods of previous forks
202138

203139
This document defines how Prague payload should be handled by the [`Cancun API`](./cancun.md).

0 commit comments

Comments
 (0)