Skip to content

Commit 6d17705

Browse files
authored
Scope shouldOverrideBuilder flag for Cancun (ethereum#425)
* Include shouldOverrideBuilder to Cancun scope * Cosmetic fix
1 parent 447e4f3 commit 6d17705

File tree

2 files changed

+7
-0
lines changed

2 files changed

+7
-0
lines changed

src/engine/cancun.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,7 @@ and proofs corresponding to the `versioned_hashes` included in the blob transact
146146
- `executionPayload`: [`ExecutionPayloadV3`](#ExecutionPayloadV3)
147147
- `blockValue` : `QUANTITY`, 256 Bits - The expected value to be received by the `feeRecipient` in wei
148148
- `blobsBundle`: [`BlobsBundleV1`](#BlobsBundleV1) - Bundle with data corresponding to blob transactions included into `executionPayload`
149+
- `shouldOverrideBuilder` : `BOOLEAN` - Suggestion from the execution layer to use this `executionPayload` instead of an externally provided one
149150
* error: code and message set in case an exception happens while getting the payload.
150151

151152
#### Specification
@@ -161,6 +162,8 @@ Refer to the specification for [`engine_getPayloadV2`](./shanghai.md#engine_getp
161162

162163
4. Client software **MUST** return `-38005: Unsupported fork` error if the `timestamp` of the built payload is less than the Cancun activation timestamp.
163164

165+
5. Client software **MAY** use any heuristics to decide whether to set `shouldOverrideBuilder` flag or not. If client software does not implement any heuristic this flag **SHOULD** be set to `false`.
166+
164167
### Deprecate `engine_exchangeTransitionConfigurationV1`
165168

166169
This document introduces deprecation of [`engine_exchangeTransitionConfigurationV1`](./paris.md#engine_exchangetransitionconfigurationv1). The deprecation is specified as follows:

src/engine/openrpc/methods/payload.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,7 @@
124124
- executionPayload
125125
- blockValue
126126
- blobsBundle
127+
- shouldOverrideBuilder
127128
properties:
128129
executionPayload:
129130
title: Execution payload
@@ -134,6 +135,9 @@
134135
blobsBundle:
135136
title: Blobs bundle
136137
$ref: '#/components/schemas/BlobsBundleV1'
138+
shouldOverrideBuilder:
139+
title: Should override builder flag
140+
type: boolean
137141
errors:
138142
- code: -38001
139143
message: Unknown payload

0 commit comments

Comments
 (0)