ssz-encoding: add target_gas_limit to PayloadAttributesV4

barnabasbusa · barnabasbusa · commit 949d6a836002 · 2026-05-18T15:29:46.000+02:00
Aligns the SSZ schema with PR ethereum#796 (a22fbd4), which added targetGasLimit to PayloadAttributesV4 in the JSON spec but left this SSZ doc behind. Without it, CLs sending the alpha-8 field over SSZ get rejected by EL SSZ decoders that still use the old 6-field layout (off-by-8 withdrawals offset -> malformed SSZ body).
diff --git a/src/engine/ssz-encoding.md b/src/engine/ssz-encoding.md
@@ -387,7 +387,7 @@ class PayloadAttributesV3(Container):
 
 ### PayloadAttributesV4
 
-Introduced in [Amsterdam](./amsterdam.md#payloadattributesv4). Extends `PayloadAttributesV3` with `slot_number`.
+Introduced in [Amsterdam](./amsterdam.md#payloadattributesv4). Extends `PayloadAttributesV3` with `slot_number` and `target_gas_limit`.
 
 ```python
 class PayloadAttributesV4(Container):
@@ -397,6 +397,7 @@ class PayloadAttributesV4(Container):
     withdrawals: List[WithdrawalV1, MAX_WITHDRAWALS_PER_PAYLOAD]
     parent_beacon_block_root: Bytes32
     slot_number: uint64
+    target_gas_limit: uint64
 ```
 
 ### ForkchoiceUpdatedResponseV1
