diff --git a/src/engine/amsterdam.md b/src/engine/amsterdam.md index a8be13552..e798cc8fc 100644 --- a/src/engine/amsterdam.md +++ b/src/engine/amsterdam.md @@ -83,7 +83,7 @@ This structure has the syntax of [`ExecutionPayloadBodyV1`](./shanghai.md#execut ### PayloadAttributesV4 -This structure has the syntax of [`PayloadAttributesV3`](./cancun.md#payloadattributesv3) and appends a single field: `slotNumber`. +This structure has the syntax of [`PayloadAttributesV3`](./cancun.md#payloadattributesv3) and appends two new fields: `slotNumber` and `targetGasLimit`. - `timestamp`: `QUANTITY`, 64 Bits - value for the `timestamp` field of the new payload - `prevRandao`: `DATA`, 32 Bytes - value for the `prevRandao` field of the new payload @@ -91,6 +91,7 @@ This structure has the syntax of [`PayloadAttributesV3`](./cancun.md#payloadattr - `withdrawals`: `Array of WithdrawalV1` - Array of withdrawals, each object is an `OBJECT` containing the fields of a `WithdrawalV1` structure. - `parentBeaconBlockRoot`: `DATA`, 32 Bytes - Root of the parent beacon block. - `slotNumber`: `QUANTITY`, 64 Bits - value for the `slotNumber` field of the new payload +- `targetGasLimit`: `QUANTITY`, 64 Bits - target value for the `gasLimit` field of the new payload ### BlobCellsAndProofsV1 @@ -234,6 +235,8 @@ This method follows the same specification as [`engine_forkchoiceUpdatedV3`](./c 4. If any of the above checks fails, the `forkchoiceState` update **MUST NOT** be rolled back. +2. Client software **MUST** use the target gas limit supplied in `payloadAttributes.targetGasLimit` when constructing a payload. + 3. If `custodyColumns` is provided (non-null), the following rules apply: 1. `custodyColumns` **MUST** be a 16-byte `DATA` value. If it is not, the client software **MUST** return `-32602: Invalid params`. diff --git a/src/engine/openrpc/schemas/forkchoice.yaml b/src/engine/openrpc/schemas/forkchoice.yaml index b5f6da4cc..af9f7d067 100644 --- a/src/engine/openrpc/schemas/forkchoice.yaml +++ b/src/engine/openrpc/schemas/forkchoice.yaml @@ -95,6 +95,7 @@ PayloadAttributesV4: - withdrawals - parentBeaconBlockRoot - slotNumber + - targetGasLimit properties: timestamp: $ref: '#/components/schemas/PayloadAttributesV3/properties/timestamp' @@ -108,4 +109,7 @@ PayloadAttributesV4: $ref: '#/components/schemas/PayloadAttributesV3/properties/parentBeaconBlockRoot' slotNumber: title: Slot number - $ref: '#/components/schemas/uint64' \ No newline at end of file + $ref: '#/components/schemas/uint64' + targetGasLimit: + title: Target gas limit + $ref: '#/components/schemas/uint64'