From b01952b54d92dd9f586d9e1b4e1d28ce42ef2922 Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Thu, 25 Jun 2026 15:34:32 +0000 Subject: [PATCH 01/12] feat(monad_next): implement EIP-7708 ETH transfer/burn logs Emit LOG3/LOG2 from SYSTEM_ADDRESS for value transfers, selfdestruct beneficiary transfers/burns, and finalization burns of deleted accounts. Co-Authored-By: Claude --- src/ethereum/forks/monad_next/fork.py | 29 ++++++- src/ethereum/forks/monad_next/vm/__init__.py | 82 ++++++++++++++++++- .../monad_next/vm/instructions/system.py | 11 +++ .../forks/monad_next/vm/interpreter.py | 6 +- 4 files changed, 122 insertions(+), 6 deletions(-) diff --git a/src/ethereum/forks/monad_next/fork.py b/src/ethereum/forks/monad_next/fork.py index 653f05d030f..ebe71312adf 100644 --- a/src/ethereum/forks/monad_next/fork.py +++ b/src/ethereum/forks/monad_next/fork.py @@ -33,6 +33,7 @@ ) from ethereum.state import EMPTY_CODE_HASH, Address from ethereum.state_paged import State, apply_changes_to_state +from ethereum.utils.byte import left_pad_zero_bytes from . import vm from .blocks import Block, Header, Log, Receipt, Withdrawal, encode_receipt @@ -973,15 +974,32 @@ def process_transaction( # transfer miner fees create_ether(tx_state, block_env.coinbase, U256(transaction_fee)) - for address in tx_output.accounts_to_delete: - destroy_account(tx_state, address) + # EIP-7708: Emit burn logs for balances held by accounts marked for + # deletion AFTER miner fee transfer. + finalization_logs: List[Log] = [] + for address in sorted(tx_output.accounts_to_delete): + balance = get_account(tx_state, address).balance + if balance > U256(0): + padded_address = left_pad_zero_bytes(address, 32) + finalization_logs.append( + Log( + address=vm.SYSTEM_ADDRESS, + topics=( + vm.BURN_TOPIC, + Hash32(padded_address), + ), + data=balance.to_be_bytes32(), + ) + ) + + all_logs = tx_output.logs + tuple(finalization_logs) # block_output.block_gas_used += tx_gas_used_after_refund block_output.block_gas_used += tx.gas block_output.blob_gas_used += tx_blob_gas_used receipt = make_receipt( - tx, tx_output.error, block_output.block_gas_used, tx_output.logs + tx, tx_output.error, block_output.block_gas_used, all_logs ) receipt_key = rlp.encode(Uint(index)) @@ -993,7 +1011,10 @@ def process_transaction( receipt, ) - block_output.block_logs += tx_output.logs + block_output.block_logs += all_logs + + for address in tx_output.accounts_to_delete: + destroy_account(tx_state, address) incorporate_tx_into_block(tx_state) diff --git a/src/ethereum/forks/monad_next/vm/__init__.py b/src/ethereum/forks/monad_next/vm/__init__.py index 15c53bc75b6..9ebf92dd9f5 100644 --- a/src/ethereum/forks/monad_next/vm/__init__.py +++ b/src/ethereum/forks/monad_next/vm/__init__.py @@ -18,10 +18,11 @@ from ethereum_types.bytes import Bytes, Bytes0, Bytes32 from ethereum_types.numeric import U64, U256, Uint -from ethereum.crypto.hash import Hash32 +from ethereum.crypto.hash import Hash32, keccak256 from ethereum.exceptions import EthereumException from ethereum.merkle_patricia_trie import Trie from ethereum.state import Address +from ethereum.utils.byte import left_pad_zero_bytes from ..blocks import Log, Receipt, Withdrawal from ..fork_types import Authorization, VersionedHash @@ -30,6 +31,12 @@ __all__ = ("Environment", "Evm", "Message") +TRANSFER_TOPIC = keccak256(b"Transfer(address,address,uint256)") +BURN_TOPIC = keccak256(b"Burn(address,uint256)") +SYSTEM_ADDRESS = Address( + bytes.fromhex("fffffffffffffffffffffffffffffffffffffffe") +) + @final @dataclass @@ -237,3 +244,76 @@ def incorporate_child_on_error(evm: Evm, child_evm: Evm) -> None: # NOTE: absence of `evm.memory`, in particular of its high watermark # is intended for memory to deallocate on call frame exit. + + +def emit_transfer_log( + evm: Evm, + sender: Address, + recipient: Address, + transfer_amount: U256, +) -> None: + """ + Emit a LOG3 for all ETH transfers satisfying EIP-7708. + + Parameters + ---------- + evm : + The state of the ethereum virtual machine + sender : + The account address sending the transfer + recipient : + The account address receiving the transfer + transfer_amount : + The amount of ETH transacted + + """ + if transfer_amount == 0: + return + + padded_sender = left_pad_zero_bytes(sender, 32) + padded_recipient = left_pad_zero_bytes(recipient, 32) + log_entry = Log( + address=SYSTEM_ADDRESS, + topics=( + TRANSFER_TOPIC, + Hash32(padded_sender), + Hash32(padded_recipient), + ), + data=transfer_amount.to_be_bytes32(), + ) + + evm.logs = evm.logs + (log_entry,) + + +def emit_burn_log( + evm: Evm, + account: Address, + amount: U256, +) -> None: + """ + Emit a LOG2 for ETH burn per EIP-7708. + + Parameters + ---------- + evm : + The state of the ethereum virtual machine + account : + The account address whose ETH is being burned + amount : + The amount of ETH being burned + + """ + if amount == 0: + return + + padded_account = left_pad_zero_bytes(account, 32) + log_entry = Log( + address=SYSTEM_ADDRESS, + topics=( + BURN_TOPIC, + Hash32(padded_account), + ), + data=amount.to_be_bytes32(), + ) + + evm.logs = evm.logs + (log_entry,) diff --git a/src/ethereum/forks/monad_next/vm/instructions/system.py b/src/ethereum/forks/monad_next/vm/instructions/system.py index 7b8634c5d7e..99e31fc1a1b 100644 --- a/src/ethereum/forks/monad_next/vm/instructions/system.py +++ b/src/ethereum/forks/monad_next/vm/instructions/system.py @@ -35,6 +35,8 @@ from .. import ( Evm, Message, + emit_burn_log, + emit_transfer_log, incorporate_child_on_error, incorporate_child_on_success, ) @@ -584,6 +586,15 @@ def selfdestruct(evm: Evm) -> None: originator_balance, ) + # EIP-7708: Emit transfer or burn log for the beneficiary transfer + if ( + originator in evm.message.tx_env.state.created_accounts + and beneficiary == originator + ): + emit_burn_log(evm, originator, originator_balance) + elif beneficiary != originator: + emit_transfer_log(evm, originator, beneficiary, originator_balance) + # register account for deletion only if it was created # in the same transaction if originator in evm.message.tx_env.state.created_accounts: diff --git a/src/ethereum/forks/monad_next/vm/interpreter.py b/src/ethereum/forks/monad_next/vm/interpreter.py index 13089bc8125..f72394c5745 100644 --- a/src/ethereum/forks/monad_next/vm/interpreter.py +++ b/src/ethereum/forks/monad_next/vm/interpreter.py @@ -56,7 +56,7 @@ from ..vm.gas import GasCosts, charge_gas, page_index from ..vm.precompiled_contracts import MONAD_PRECOMPILE_ADDRESSES from ..vm.precompiled_contracts.mapping import PRE_COMPILED_CONTRACTS -from . import Evm, EvmMemory +from . import Evm, EvmMemory, emit_transfer_log from .exceptions import ( AddressCollision, ExceptionalHalt, @@ -412,6 +412,10 @@ def process_message(message: Message) -> Evm: message.current_target, message.value, ) + if message.caller != message.current_target: + emit_transfer_log( + evm, message.caller, message.current_target, message.value + ) try: if evm.message.code_address in PRE_COMPILED_CONTRACTS: From 57b3fbc9c5bfea1858ce213ddfac3dbcfcdd76ec Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Thu, 25 Jun 2026 15:36:37 +0000 Subject: [PATCH 02/12] feat(monad_next): implement EIP-7843 SLOTNUM opcode Add SLOTNUM (0x4b, gas BASE) pushing the block slot number, a slot_number U64 field on the header and block environment, and fork.py plumbing. Co-Authored-By: Claude --- src/ethereum/forks/monad_next/blocks.py | 8 +++++ src/ethereum/forks/monad_next/fork.py | 1 + src/ethereum/forks/monad_next/vm/__init__.py | 1 + src/ethereum/forks/monad_next/vm/gas.py | 1 + .../monad_next/vm/instructions/__init__.py | 2 ++ .../forks/monad_next/vm/instructions/block.py | 33 +++++++++++++++++++ 6 files changed, 46 insertions(+) diff --git a/src/ethereum/forks/monad_next/blocks.py b/src/ethereum/forks/monad_next/blocks.py index f6745f79de3..4d83d39df9e 100644 --- a/src/ethereum/forks/monad_next/blocks.py +++ b/src/ethereum/forks/monad_next/blocks.py @@ -248,6 +248,14 @@ class Header: [SHA2-256]: https://en.wikipedia.org/wiki/SHA-2 """ + slot_number: U64 + """ + The slot number of this block as provided by the consensus layer. + Introduced in [EIP-7843]. + + [EIP-7843]: https://eips.ethereum.org/EIPS/eip-7843 + """ + @final @slotted_freezable diff --git a/src/ethereum/forks/monad_next/fork.py b/src/ethereum/forks/monad_next/fork.py index ebe71312adf..5c4bb5c1fc2 100644 --- a/src/ethereum/forks/monad_next/fork.py +++ b/src/ethereum/forks/monad_next/fork.py @@ -247,6 +247,7 @@ def state_transition(chain: BlockChain, block: Block) -> None: prev_randao=block.header.prev_randao, excess_blob_gas=block.header.excess_blob_gas, parent_beacon_block_root=block.header.parent_beacon_block_root, + slot_number=block.header.slot_number, ) block_output = apply_body( diff --git a/src/ethereum/forks/monad_next/vm/__init__.py b/src/ethereum/forks/monad_next/vm/__init__.py index 9ebf92dd9f5..381db45cad9 100644 --- a/src/ethereum/forks/monad_next/vm/__init__.py +++ b/src/ethereum/forks/monad_next/vm/__init__.py @@ -56,6 +56,7 @@ class BlockEnvironment: prev_randao: Bytes32 excess_blob_gas: U64 parent_beacon_block_root: Hash32 + slot_number: U64 @final diff --git a/src/ethereum/forks/monad_next/vm/gas.py b/src/ethereum/forks/monad_next/vm/gas.py index 870cee592ac..708ec866fb0 100644 --- a/src/ethereum/forks/monad_next/vm/gas.py +++ b/src/ethereum/forks/monad_next/vm/gas.py @@ -189,6 +189,7 @@ class GasCosts: OPCODE_CHAINID: Final[Uint] = BASE OPCODE_BASEFEE: Final[Uint] = BASE OPCODE_BLOBBASEFEE: Final[Uint] = BASE + OPCODE_SLOTNUM: Final[Uint] = BASE OPCODE_BLOBHASH: Final[Uint] = Uint(3) OPCODE_PUSH: Final[Uint] = VERY_LOW OPCODE_PUSH0: Final[Uint] = BASE diff --git a/src/ethereum/forks/monad_next/vm/instructions/__init__.py b/src/ethereum/forks/monad_next/vm/instructions/__init__.py index 0da72c8ea5c..d858b5053f0 100644 --- a/src/ethereum/forks/monad_next/vm/instructions/__init__.py +++ b/src/ethereum/forks/monad_next/vm/instructions/__init__.py @@ -99,6 +99,7 @@ class Ops(enum.Enum): BASEFEE = 0x48 BLOBHASH = 0x49 BLOBBASEFEE = 0x4A + SLOTNUM = 0x4B # Control Flow Ops STOP = 0x00 @@ -251,6 +252,7 @@ class Ops(enum.Enum): Ops.PREVRANDAO: block_instructions.prev_randao, Ops.GASLIMIT: block_instructions.gas_limit, Ops.CHAINID: block_instructions.chain_id, + Ops.SLOTNUM: block_instructions.slot_number, Ops.MLOAD: memory_instructions.mload, Ops.MSTORE: memory_instructions.mstore, Ops.MSTORE8: memory_instructions.mstore8, diff --git a/src/ethereum/forks/monad_next/vm/instructions/block.py b/src/ethereum/forks/monad_next/vm/instructions/block.py index baa589c4395..4f9f9e5d5c3 100644 --- a/src/ethereum/forks/monad_next/vm/instructions/block.py +++ b/src/ethereum/forks/monad_next/vm/instructions/block.py @@ -259,3 +259,36 @@ def chain_id(evm: Evm) -> None: # PROGRAM COUNTER evm.pc += Uint(1) + + +def slot_number(evm: Evm) -> None: + """ + Push the current slot number onto the stack. + + The slot number is provided by the consensus layer and passed to the + execution layer through the engine API. + + Parameters + ---------- + evm : + The current EVM frame. + + Raises + ------ + :py:class:`~ethereum.forks.monad_next.vm.exceptions.StackOverflowError` + If `len(stack)` is equal to `1024`. + :py:class:`~ethereum.forks.monad_next.vm.exceptions.OutOfGasError` + If `evm.gas_left` is less than `2`. + + """ + # STACK + pass + + # GAS + charge_gas(evm, GasCosts.OPCODE_SLOTNUM) + + # OPERATION + push(evm.stack, U256(evm.message.block_env.slot_number)) + + # PROGRAM COUNTER + evm.pc += Uint(1) From 24e4bb825137f9f26c03dbbdd09ec25184ee9763 Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Thu, 25 Jun 2026 15:39:01 +0000 Subject: [PATCH 03/12] feat(monad_next): implement EIP-8024 SWAPN, DUPN, EXCHANGE Add DUPN (0xe6), SWAPN (0xe7), EXCHANGE (0xe8) stack instructions with a 1-byte immediate, gas VERY_LOW, plus immediate-aware jumpdest analysis. Co-Authored-By: Claude --- src/ethereum/forks/monad_next/vm/gas.py | 3 + .../monad_next/vm/instructions/__init__.py | 8 ++ .../forks/monad_next/vm/instructions/stack.py | 107 +++++++++++++++++- src/ethereum/forks/monad_next/vm/runtime.py | 26 +++++ src/ethereum/forks/monad_next/vm/stack.py | 79 ++++++++++++- 5 files changed, 219 insertions(+), 4 deletions(-) diff --git a/src/ethereum/forks/monad_next/vm/gas.py b/src/ethereum/forks/monad_next/vm/gas.py index 708ec866fb0..461f0f79a27 100644 --- a/src/ethereum/forks/monad_next/vm/gas.py +++ b/src/ethereum/forks/monad_next/vm/gas.py @@ -195,6 +195,9 @@ class GasCosts: OPCODE_PUSH0: Final[Uint] = BASE OPCODE_DUP: Final[Uint] = VERY_LOW OPCODE_SWAP: Final[Uint] = VERY_LOW + OPCODE_DUPN: Final[Uint] = VERY_LOW + OPCODE_SWAPN: Final[Uint] = VERY_LOW + OPCODE_EXCHANGE: Final[Uint] = VERY_LOW # Dynamic Opcodes OPCODE_RETURNDATACOPY_BASE: Final[Uint] = VERY_LOW diff --git a/src/ethereum/forks/monad_next/vm/instructions/__init__.py b/src/ethereum/forks/monad_next/vm/instructions/__init__.py index d858b5053f0..06295ec86f1 100644 --- a/src/ethereum/forks/monad_next/vm/instructions/__init__.py +++ b/src/ethereum/forks/monad_next/vm/instructions/__init__.py @@ -189,6 +189,11 @@ class Ops(enum.Enum): SWAP15 = 0x9E SWAP16 = 0x9F + # EIP-8024: Stack access instructions + DUPN = 0xE6 + SWAPN = 0xE7 + EXCHANGE = 0xE8 + # Memory Operations MLOAD = 0x51 MSTORE = 0x52 @@ -352,6 +357,9 @@ class Ops(enum.Enum): Ops.SWAP14: stack_instructions.swap14, Ops.SWAP15: stack_instructions.swap15, Ops.SWAP16: stack_instructions.swap16, + Ops.DUPN: stack_instructions.dupn, + Ops.SWAPN: stack_instructions.swapn, + Ops.EXCHANGE: stack_instructions.exchange, Ops.LOG0: log_instructions.log0, Ops.LOG1: log_instructions.log1, Ops.LOG2: log_instructions.log2, diff --git a/src/ethereum/forks/monad_next/vm/instructions/stack.py b/src/ethereum/forks/monad_next/vm/instructions/stack.py index ce94af6ce8e..0e72bd01f31 100644 --- a/src/ethereum/forks/monad_next/vm/instructions/stack.py +++ b/src/ethereum/forks/monad_next/vm/instructions/stack.py @@ -14,7 +14,7 @@ from functools import partial from typing import Callable -from ethereum_types.numeric import U256, Uint +from ethereum_types.numeric import U8, U256, Uint from .. import Evm, stack from ..exceptions import StackUnderflowError @@ -23,6 +23,7 @@ charge_gas, ) from ..memory import buffer_read +from ..stack import decode_pair, decode_single def pop(evm: Evm) -> None: @@ -210,3 +211,107 @@ def swap_n(evm: Evm, item_number: int) -> None: swap14: Callable[[Evm], None] = partial(swap_n, item_number=14) swap15: Callable[[Evm], None] = partial(swap_n, item_number=15) swap16: Callable[[Evm], None] = partial(swap_n, item_number=16) + + +def dupn(evm: Evm) -> None: + """ + Duplicate the Nth stack item (from top of the stack) to the top of stack. + The item number is read from the immediate byte following the opcode and + decoded using the EIP-8024 index shifting rules. + + Parameters + ---------- + evm : + The current EVM frame. + + """ + # STACK + pass + + # GAS + charge_gas(evm, GasCosts.OPCODE_DUPN) + + # OPERATION + immediate_data = U8( + buffer_read(evm.code, U256(evm.pc + Uint(1)), U256(1))[0] + ) + item_number = decode_single(immediate_data) + if int(item_number) > len(evm.stack): + raise StackUnderflowError + data_to_duplicate = evm.stack[-item_number] + stack.push(evm.stack, data_to_duplicate) + + # PROGRAM COUNTER + evm.pc += Uint(2) + + +def swapn(evm: Evm) -> None: + """ + Swap the top stack item with the Nth stack item. + The value N is read from the immediate byte following the opcode and + decoded using the EIP-8024 index shifting rules. + + Parameters + ---------- + evm : + The current EVM frame. + + """ + # STACK + pass + + # GAS + charge_gas(evm, GasCosts.OPCODE_SWAPN) + + # OPERATION + immediate_data = U8( + buffer_read(evm.code, U256(evm.pc + Uint(1)), U256(1))[0] + ) + item_number = decode_single(immediate_data) + # SWAPN with decoded value n swaps top (position 1) with position (n+1) + if int(item_number) + 1 > len(evm.stack): + raise StackUnderflowError + # stack[-1] is top (position 1), stack[-(item_number+1)] is position (n+1) + evm.stack[-1], evm.stack[-(item_number + U8(1))] = ( + evm.stack[-(item_number + U8(1))], + evm.stack[-1], + ) + + # PROGRAM COUNTER + evm.pc += Uint(2) + + +def exchange(evm: Evm) -> None: + """ + Exchange the Nth stack item with the Mth stack item. + The values N and M are decoded from the immediate byte using the + EIP-8024 index shifting rules. + + Parameters + ---------- + evm : + The current EVM frame. + + """ + # STACK + pass + + # GAS + charge_gas(evm, GasCosts.OPCODE_EXCHANGE) + + # OPERATION + immediate_data = U8( + buffer_read(evm.code, U256(evm.pc + Uint(1)), U256(1))[0] + ) + n, m = decode_pair(immediate_data) + # EXCHANGE swaps position (n+1) with position (m+1) + depth = max(n, m) + U8(1) + if int(depth) > len(evm.stack): + raise StackUnderflowError + evm.stack[-(n + U8(1))], evm.stack[-(m + U8(1))] = ( + evm.stack[-(m + U8(1))], + evm.stack[-(n + U8(1))], + ) + + # PROGRAM COUNTER + evm.pc += Uint(2) diff --git a/src/ethereum/forks/monad_next/vm/runtime.py b/src/ethereum/forks/monad_next/vm/runtime.py index 0aa5ddd5e20..60fd42b52c9 100644 --- a/src/ethereum/forks/monad_next/vm/runtime.py +++ b/src/ethereum/forks/monad_next/vm/runtime.py @@ -28,6 +28,8 @@ def get_valid_jump_destinations(code: Bytes) -> Set[Uint]: * The jump destination should have the `JUMPDEST` opcode (0x5B). * The jump destination shouldn't be part of the data corresponding to `PUSH-N` opcodes. + * The jump destination shouldn't be part of the immediate byte + corresponding to `DUPN`, `SWAPN`, or `EXCHANGE` opcodes (EIP-8024). Note - Jump destinations are 0-indexed. @@ -63,6 +65,30 @@ def get_valid_jump_destinations(code: Bytes) -> Set[Uint]: # opcodes. push_data_size = current_opcode.value - Ops.PUSH1.value + 1 pc += Uint(push_data_size) + elif current_opcode in (Ops.DUPN, Ops.SWAPN): + # EIP-8024: DUPN/SWAPN invalid immediate range is + # 90 < x < 128, i.e. 0x5B (91) to 0x7F (127). + # Invalid immediates are not skipped so the byte + # remains at an instruction boundary. + if ( + pc + Uint(1) < ulen(code) + and 0x5B <= code[pc + Uint(1)] <= 0x7F + ): + pass + else: + pc += Uint(1) + elif current_opcode == Ops.EXCHANGE: + # EIP-8024: EXCHANGE invalid immediate range is + # 81 < x < 128, i.e. 0x52 (82) to 0x7F (127). + # Invalid immediates are not skipped so the byte + # remains at an instruction boundary. + if ( + pc + Uint(1) < ulen(code) + and 0x52 <= code[pc + Uint(1)] <= 0x7F + ): + pass + else: + pc += Uint(1) pc += Uint(1) diff --git a/src/ethereum/forks/monad_next/vm/stack.py b/src/ethereum/forks/monad_next/vm/stack.py index a87b0a47079..98ba815cb73 100644 --- a/src/ethereum/forks/monad_next/vm/stack.py +++ b/src/ethereum/forks/monad_next/vm/stack.py @@ -11,11 +11,84 @@ Implementation of the stack operators for the EVM. """ -from typing import List +from typing import List, Tuple -from ethereum_types.numeric import U256 +from ethereum_types.numeric import U8, U256 -from .exceptions import StackOverflowError, StackUnderflowError +from .exceptions import ( + InvalidParameter, + StackOverflowError, + StackUnderflowError, +) + + +def decode_single(x: U8) -> U8: + """ + Decode the immediate byte for DUPN/SWAPN to get the stack index. + + Return n with 17 <= n <= 235. + + Parameters + ---------- + x : int + The immediate byte value (0-90 or 128-255). + + Returns + ------- + int + The stack index n, where 17 <= n <= 235. + + Raises + ------ + InvalidParameter + If x is in the forbidden range (90 < x < 128 or x > 255). + + """ + if not (U8(0) <= x <= U8(90) or U8(128) <= x <= U8(255)): + raise InvalidParameter( + f"DUPN/SWAPN immediate byte {x} is out of range. " + "Valid range: 0 <= x <= 90 or 128 <= x <= 255" + ) + + return U8((int(x) + 145) % 256) + + +def decode_pair(x: U8) -> Tuple[U8, U8]: + """ + Decode the immediate byte for EXCHANGE to get two stack indices. + + Return (n, m) with 1 <= n <= 14 and n < m <= 30 - n. + + Parameters + ---------- + x : int + The immediate byte value (0-81 or 128-255). + + Returns + ------- + Tuple[int, int] + The two stack indices (n, m), where + 1 <= n <= 14 and n < m <= 30 - n. + + Raises + ------ + InvalidParameter + If x is in the forbidden range (81 < x < 128 or x > 255). + + """ + if not (U8(0) <= x <= U8(81) or U8(128) <= x <= U8(255)): + raise InvalidParameter( + f"EXCHANGE immediate byte {x} is in the forbidden " + "range 82 <= x <= 127\n" + "Valid range: 0 <= x <= 81 or 128 <= x <= 255" + ) + + k = U8(int(x) ^ 143) + q, r = divmod(k, U8(16)) + if q < r: + return q + U8(1), r + U8(1) + else: + return r + U8(1), U8(29) - q def pop(stack: List[U256]) -> U256: From fe8abdac47720ed3c67ea8bec134e23b420e4dde Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Mon, 27 Jul 2026 16:12:36 +0000 Subject: [PATCH 04/12] feat(forks): make MONAD_NEXT an Amsterdam fork inheriting 3 EIPs Inherit MONAD_NEXT from Amsterdam, taking only EIP-7708/7843/8024 changes (opcodes, slot number header) and pinning EIP-7928/7954/7976/7981 members back to MONAD_TEN. Relocated after Amsterdam to resolve the base reference. Co-Authored-By: Claude --- .../execution_testing/forks/forks/forks.py | 72 +++++++++++++++++-- 1 file changed, 66 insertions(+), 6 deletions(-) diff --git a/packages/testing/src/execution_testing/forks/forks/forks.py b/packages/testing/src/execution_testing/forks/forks/forks.py index ecf3b02f3ae..7fab30a6306 100644 --- a/packages/testing/src/execution_testing/forks/forks/forks.py +++ b/packages/testing/src/execution_testing/forks/forks/forks.py @@ -1805,12 +1805,6 @@ def _calculate_sstore_gas_mip8( return gas_cost -class MONAD_NEXT(MONAD_TEN): # noqa: N801 - """MONAD_NEXT fork, a placeholder identical to MONAD_TEN.""" - - pass - - class BPO1( Osaka, bpo_fork=True, @@ -1904,3 +1898,69 @@ def engine_payload_attribute_target_gas_limit(cls) -> bool: limit. """ return True + + +class MONAD_NEXT(MONAD_TEN, Amsterdam): # noqa: N801 + """ + MONAD_NEXT fork. + + Amsterdam-based successor to MONAD_TEN. Only the EIP-7708, EIP-7843 + and EIP-8024 changes are inherited from Amsterdam; every other + Amsterdam change is pinned back to the MONAD_TEN parent. + """ + + @classmethod + def valid_opcodes(cls) -> List[Opcodes]: + """ + Inherit the Amsterdam opcode set: SLOTNUM (EIP-7843) and SWAPN, + DUPN, EXCHANGE (EIP-8024) on top of the MONAD_TEN opcodes. + """ + return Amsterdam.valid_opcodes() + + @classmethod + def max_code_size(cls) -> int: + """Return spec from explicit parent (skip EIP-7954).""" + return MONAD_TEN.max_code_size() + + @classmethod + def calldata_gas_calculator(cls) -> CalldataGasCalculator: + """Return spec from explicit parent (skip EIP-7976).""" + return MONAD_TEN.calldata_gas_calculator() + + @classmethod + def transaction_data_floor_cost_calculator( + cls, + ) -> TransactionDataFloorCostCalculator: + """Return spec from explicit parent (skip EIP-7981).""" + return MONAD_TEN.transaction_data_floor_cost_calculator() + + @classmethod + def transaction_intrinsic_cost_calculator( + cls, + ) -> TransactionIntrinsicCostCalculator: + """Return spec from explicit parent (skip EIP-7981).""" + return MONAD_TEN.transaction_intrinsic_cost_calculator() + + @classmethod + def header_bal_hash_required(cls) -> bool: + """Return spec from explicit parent (skip EIP-7928).""" + return MONAD_TEN.header_bal_hash_required() + + @classmethod + def empty_block_bal_item_count(cls) -> int: + """Return spec from explicit parent (skip EIP-7928).""" + return MONAD_TEN.empty_block_bal_item_count() + + @classmethod + def engine_execution_payload_block_access_list(cls) -> bool: + """Return spec from explicit parent (skip EIP-7928).""" + return MONAD_TEN.engine_execution_payload_block_access_list() + + +# MONAD_NEXT adopts EIP-7708, EIP-7843 and EIP-8024 from Amsterdam through the +# MRO rather than by inheriting their mixin classes: inheriting them would +# register MONAD_NEXT as a spurious `enabling_fork` (breaking +# `valid_at_transition_to`) and pull in EIP-7843's engine version bumps. +# Record the adopted EIP numbers on `_enabled_eips` directly so that +# `is_eip_enabled()` reports them without those side effects. +MONAD_NEXT._enabled_eips = MONAD_TEN._enabled_eips | {7708, 7843, 8024} From d4119a45f365064c8ff8c62e8fce9e4cc41bc3d1 Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Fri, 26 Jun 2026 15:02:25 +0000 Subject: [PATCH 05/12] feat(ci): add monad_amsterdam fixture release config Single-fork (--fork MONAD_NEXT) feature covering only the adopted Amsterdam EIP dirs (7708/7843/8024); released via tag tests-monad_amsterdam@v0.1.0. Co-Authored-By: Claude --- .github/configs/feature.yaml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.github/configs/feature.yaml b/.github/configs/feature.yaml index 7fca18fd9ef..8865d8dd458 100644 --- a/.github/configs/feature.yaml +++ b/.github/configs/feature.yaml @@ -11,3 +11,7 @@ monad_runloop: evm-type: eels # Like `monad`, but `--monad-runloop` and eestnet chain id `30143` fill-params: -m blockchain_test --from=MONAD_EIGHT --until=MONAD_TEN --chain-id=30143 --monad-runloop -k "not invalid_header" + +monad_amsterdam: + evm-type: eels + fill-params: -m blockchain_test --fork=MONAD_NEXT --chain-id=143 -k "not invalid_header" tests/amsterdam/eip7708_eth_transfer_logs tests/amsterdam/eip7843_slotnum tests/amsterdam/eip8024_dupn_swapn_exchange From 1466f6aa9f641a207313f23d30babafe3e260cb8 Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Mon, 27 Jul 2026 18:46:45 +0000 Subject: [PATCH 06/12] feat(ci): fill whole test suite for monad_amsterdam release Disable collection of non-adopted Amsterdam EIP tests on Monad forks. Co-Authored-By: Claude --- .github/configs/feature.yaml | 2 +- .../conftest.py | 10 ++++++++++ .../eip7928_block_level_access_lists/conftest.py | 10 ++++++++++ .../eip7954_increase_max_contract_size/conftest.py | 7 +++++++ .../eip7976_increase_calldata_floor_cost/conftest.py | 7 +++++++ .../eip7981_increase_access_list_cost/conftest.py | 7 +++++++ .../eip7928_block_level_access_lists/conftest.py | 10 ++++++++++ .../eip7928_block_level_access_lists/conftest.py | 10 ++++++++++ 8 files changed, 62 insertions(+), 1 deletion(-) create mode 100644 tests/amsterdam/eip7778_block_gas_accounting_without_refunds/conftest.py create mode 100644 tests/amsterdam/eip7928_block_level_access_lists/conftest.py create mode 100644 tests/benchmark/compute/eip7928_block_level_access_lists/conftest.py create mode 100644 tests/benchmark/stateful/eip7928_block_level_access_lists/conftest.py diff --git a/.github/configs/feature.yaml b/.github/configs/feature.yaml index 8865d8dd458..38dce031d7d 100644 --- a/.github/configs/feature.yaml +++ b/.github/configs/feature.yaml @@ -14,4 +14,4 @@ monad_runloop: monad_amsterdam: evm-type: eels - fill-params: -m blockchain_test --fork=MONAD_NEXT --chain-id=143 -k "not invalid_header" tests/amsterdam/eip7708_eth_transfer_logs tests/amsterdam/eip7843_slotnum tests/amsterdam/eip8024_dupn_swapn_exchange + fill-params: -m blockchain_test --fork=MONAD_NEXT --chain-id=143 -k "not invalid_header" diff --git a/tests/amsterdam/eip7778_block_gas_accounting_without_refunds/conftest.py b/tests/amsterdam/eip7778_block_gas_accounting_without_refunds/conftest.py new file mode 100644 index 00000000000..5cbdebdc9ef --- /dev/null +++ b/tests/amsterdam/eip7778_block_gas_accounting_without_refunds/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-7778 tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip7928_block_level_access_lists/conftest.py b/tests/amsterdam/eip7928_block_level_access_lists/conftest.py new file mode 100644 index 00000000000..3bedcfe2651 --- /dev/null +++ b/tests/amsterdam/eip7928_block_level_access_lists/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-7928 tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py b/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py index 78cb66ed14d..b4d596bdc52 100644 --- a/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py +++ b/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py @@ -4,6 +4,13 @@ from execution_testing import Address, Alloc, Bytecode, Fork, Op +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) + + @pytest.fixture def max_code_size_contract( pre: Alloc, diff --git a/tests/amsterdam/eip7976_increase_calldata_floor_cost/conftest.py b/tests/amsterdam/eip7976_increase_calldata_floor_cost/conftest.py index f92a0e003a0..db99cddc93c 100644 --- a/tests/amsterdam/eip7976_increase_calldata_floor_cost/conftest.py +++ b/tests/amsterdam/eip7976_increase_calldata_floor_cost/conftest.py @@ -23,6 +23,13 @@ from .helpers import DataTestType, find_floor_cost_threshold +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) + + @pytest.fixture def to( request: pytest.FixtureRequest, diff --git a/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py b/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py index 104a73e464a..c02d771f5d2 100644 --- a/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py +++ b/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py @@ -22,6 +22,13 @@ from ...cancun.eip4844_blobs.spec import Spec as EIP_4844_Spec +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) + + @pytest.fixture def to( request: pytest.FixtureRequest, diff --git a/tests/benchmark/compute/eip7928_block_level_access_lists/conftest.py b/tests/benchmark/compute/eip7928_block_level_access_lists/conftest.py new file mode 100644 index 00000000000..9dc5216d7ea --- /dev/null +++ b/tests/benchmark/compute/eip7928_block_level_access_lists/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-7928 benchmark tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/benchmark/stateful/eip7928_block_level_access_lists/conftest.py b/tests/benchmark/stateful/eip7928_block_level_access_lists/conftest.py new file mode 100644 index 00000000000..9dc5216d7ea --- /dev/null +++ b/tests/benchmark/stateful/eip7928_block_level_access_lists/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-7928 benchmark tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) From a3d7fd8889e2a50acf6561a9e152b088fc08121d Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Thu, 30 Jul 2026 13:20:29 +0000 Subject: [PATCH 07/12] feat(forks): carry zero EIP-7928 BAL hash slot in MONAD_NEXT headers Header field sits between requests_hash and slot_number and must be zero. Co-Authored-By: Claude --- .../evm_tools/t8n/block_environment.py | 2 +- .../execution_testing/fixtures/blockchain.py | 8 +++++- .../src/execution_testing/forks/base_fork.py | 12 ++++++++ .../forks/forks/eips/amsterdam/eip_7928.py | 7 +++++ .../execution_testing/forks/forks/forks.py | 13 +++++++-- .../src/execution_testing/specs/blockchain.py | 28 +++++++++++-------- src/ethereum/forks/monad_next/__init__.py | 8 ++++-- src/ethereum/forks/monad_next/blocks.py | 10 +++++++ src/ethereum/forks/monad_next/fork.py | 2 ++ .../loaders/fork_loader.py | 14 ++++++++++ 10 files changed, 86 insertions(+), 18 deletions(-) diff --git a/packages/testing/src/execution_testing/evm_tools/t8n/block_environment.py b/packages/testing/src/execution_testing/evm_tools/t8n/block_environment.py index 3a602b9c6c4..ce61b3914f5 100644 --- a/packages/testing/src/execution_testing/evm_tools/t8n/block_environment.py +++ b/packages/testing/src/execution_testing/evm_tools/t8n/block_environment.py @@ -160,7 +160,7 @@ def _resolve_excess_blob_gas( } if fork.has_compute_requests_hash: arguments["requests_hash"] = Hash32(b"\0" * 32) - if fork.has_hash_block_access_list: + if fork.has_block_access_list_hash_header: arguments["block_access_list_hash"] = Hash32(b"\0" * 32) if fork.has_slot_number: arguments["slot_number"] = U64(0) diff --git a/packages/testing/src/execution_testing/fixtures/blockchain.py b/packages/testing/src/execution_testing/fixtures/blockchain.py index a7331378786..7d4269bfd95 100644 --- a/packages/testing/src/execution_testing/fixtures/blockchain.py +++ b/packages/testing/src/execution_testing/fixtures/blockchain.py @@ -377,7 +377,13 @@ def genesis(cls, fork: Fork, env: Environment, state_root: Hash) -> Self: if fork.header_requests_required(): extras["requests_hash"] = Requests() if fork.header_bal_hash_required(): - extras["block_access_list_hash"] = BlockAccessList().rlp_hash + # A fork can require the header field without building block + # access lists (e.g. Monad); the field is then fixed at zero. + extras["block_access_list_hash"] = ( + BlockAccessList().rlp_hash + if fork.supports_block_access_lists() + else Hash(0) + ) if fork.header_slot_number_required(): extras["slot_number"] = ( int(env.slot_number) if env.slot_number is not None else 0 diff --git a/packages/testing/src/execution_testing/forks/base_fork.py b/packages/testing/src/execution_testing/forks/base_fork.py index f842878c42f..aae401d8b08 100644 --- a/packages/testing/src/execution_testing/forks/base_fork.py +++ b/packages/testing/src/execution_testing/forks/base_fork.py @@ -563,6 +563,18 @@ def header_bal_hash_required(cls) -> bool: """Return true if the header must contain block access list hash.""" pass + @classmethod + @abstractmethod + def supports_block_access_lists(cls) -> bool: + """ + Return true if the fork builds block access lists (EIP-7928). + + A fork can require the block access list hash header field without + building block access lists (e.g. Monad); the field is then fixed + at zero. + """ + pass + @classmethod @abstractmethod def empty_block_bal_item_count(cls) -> int: diff --git a/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py b/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py index 1eacd844b21..d7c787eed92 100644 --- a/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py +++ b/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py @@ -29,6 +29,13 @@ def header_bal_hash_required(cls) -> bool: """ return True + @classmethod + def supports_block_access_lists(cls) -> bool: + """ + From EIP-7928, blocks build block access lists. + """ + return True + @classmethod def gas_costs(cls) -> GasCosts: """ diff --git a/packages/testing/src/execution_testing/forks/forks/forks.py b/packages/testing/src/execution_testing/forks/forks/forks.py index 7fab30a6306..1151b29531c 100644 --- a/packages/testing/src/execution_testing/forks/forks/forks.py +++ b/packages/testing/src/execution_testing/forks/forks/forks.py @@ -954,6 +954,11 @@ def header_bal_hash_required(cls) -> bool: """At genesis, header must not contain block access list hash.""" return False + @classmethod + def supports_block_access_lists(cls) -> bool: + """At genesis, no block access lists are built.""" + return False + @classmethod def empty_block_bal_item_count(cls) -> int: """Pre-Amsterdam forks have no block access list.""" @@ -1906,7 +1911,9 @@ class MONAD_NEXT(MONAD_TEN, Amsterdam): # noqa: N801 Amsterdam-based successor to MONAD_TEN. Only the EIP-7708, EIP-7843 and EIP-8024 changes are inherited from Amsterdam; every other - Amsterdam change is pinned back to the MONAD_TEN parent. + Amsterdam change is pinned back to the MONAD_TEN parent. The + EIP-7928 block access list hash header field is carried, but no + block access lists are built, so the field is always zero. """ @classmethod @@ -1942,9 +1949,9 @@ def transaction_intrinsic_cost_calculator( return MONAD_TEN.transaction_intrinsic_cost_calculator() @classmethod - def header_bal_hash_required(cls) -> bool: + def supports_block_access_lists(cls) -> bool: """Return spec from explicit parent (skip EIP-7928).""" - return MONAD_TEN.header_bal_hash_required() + return MONAD_TEN.supports_block_access_lists() @classmethod def empty_block_bal_item_count(cls) -> int: diff --git a/packages/testing/src/execution_testing/specs/blockchain.py b/packages/testing/src/execution_testing/specs/blockchain.py index c7f5398ae2e..8b996720f20 100644 --- a/packages/testing/src/execution_testing/specs/blockchain.py +++ b/packages/testing/src/execution_testing/specs/blockchain.py @@ -986,17 +986,23 @@ def generate_block_data( int(env.slot_number) if env.slot_number is not None else 0 ) + header_fields = transition_tool_output.result.model_dump( + exclude_none=True, + exclude={"blob_gas_used", "transactions_trie"}, + ) | env.model_dump( + exclude_none=True, + exclude={"blob_gas_used", "slot_number"}, + ) + if fork.header_bal_hash_required() and ( + not fork.supports_block_access_lists() + ): + # Fork requires the block access list hash header field but + # doesn't build block access lists (e.g. Monad): fix value at + # zero. + header_fields.setdefault("block_access_list_hash", Hash(0)) + header = FixtureHeader( - **( - transition_tool_output.result.model_dump( - exclude_none=True, - exclude={"blob_gas_used", "transactions_trie"}, - ) - | env.model_dump( - exclude_none=True, - exclude={"blob_gas_used", "slot_number"}, - ) - ), + **header_fields, blob_gas_used=blob_gas_used, transactions_trie=Transaction.list_root(txs), extra_data=( @@ -1059,7 +1065,7 @@ def generate_block_data( if t8n_bal_rlp is not None: t8n_bal = BlockAccessList.from_rlp(t8n_bal_rlp) - if fork.header_bal_hash_required(): + if fork.supports_block_access_lists(): assert t8n_bal is not None, ( "Block access list is required for this block but was not " "provided by the transition tool" diff --git a/src/ethereum/forks/monad_next/__init__.py b/src/ethereum/forks/monad_next/__init__.py index b6c71ab2450..2e989370ce9 100644 --- a/src/ethereum/forks/monad_next/__init__.py +++ b/src/ethereum/forks/monad_next/__init__.py @@ -1,6 +1,10 @@ """ -MONAD_NEXT fork is a placeholder for upcoming Monad changes and is -currently identical to MONAD_TEN. +MONAD_NEXT fork is a placeholder for upcoming Monad changes. It builds on +MONAD_TEN, adopting EIP-7708, EIP-7843 and EIP-8024 from Amsterdam +together with the Amsterdam block header layout; the [EIP-7928] block +access list hash header slot is carried but always zero. + +[EIP-7928]: https://eips.ethereum.org/EIPS/eip-7928 """ from ethereum.fork_criteria import ByTimestamp, ForkCriteria diff --git a/src/ethereum/forks/monad_next/blocks.py b/src/ethereum/forks/monad_next/blocks.py index 4d83d39df9e..7a66282a7ab 100644 --- a/src/ethereum/forks/monad_next/blocks.py +++ b/src/ethereum/forks/monad_next/blocks.py @@ -248,6 +248,16 @@ class Header: [SHA2-256]: https://en.wikipedia.org/wiki/SHA-2 """ + block_access_list_hash: Hash32 + """ + Header slot introduced by [EIP-7928] for the hash of the Block Access + List. Monad does not build block access lists, so this field is always + zero. See [`validate_header`][vh]. + + [EIP-7928]: https://eips.ethereum.org/EIPS/eip-7928 + [vh]: ref:ethereum.forks.monad_next.fork.validate_header + """ + slot_number: U64 """ The slot number of this block as provided by the consensus layer. diff --git a/src/ethereum/forks/monad_next/fork.py b/src/ethereum/forks/monad_next/fork.py index 5c4bb5c1fc2..0288944313f 100644 --- a/src/ethereum/forks/monad_next/fork.py +++ b/src/ethereum/forks/monad_next/fork.py @@ -404,6 +404,8 @@ def validate_header(chain: BlockChain, header: Header) -> None: raise InvalidBlock if header.ommers_hash != EMPTY_OMMER_HASH: raise InvalidBlock + if header.block_access_list_hash != Hash32(b"\x00" * 32): + raise InvalidBlock block_parent_hash = keccak256(rlp.encode(parent_header)) if header.parent_hash != block_parent_hash: diff --git a/src/ethereum_spec_tools/loaders/fork_loader.py b/src/ethereum_spec_tools/loaders/fork_loader.py index d9e02de32f9..70467ed3b88 100644 --- a/src/ethereum_spec_tools/loaders/fork_loader.py +++ b/src/ethereum_spec_tools/loaders/fork_loader.py @@ -154,6 +154,20 @@ def has_hash_block_access_list(self) -> bool: return False return hasattr(module, "hash_block_access_list") + @property + def has_block_access_list_hash_header(self) -> bool: + """ + Check if the fork's header has a `block_access_list_hash` field. + + A fork can carry the header field without building block access + lists (e.g. Monad, where the field is always zero). + """ + try: + header = self._module("blocks").Header + return "block_access_list_hash" in header.__dataclass_fields__ + except (ModuleNotFoundError, AttributeError): + return False + @property def BlockAccessIndex(self) -> Any: """BlockAccessIndex type of the fork.""" From 8796fdd7ed6919710592e66c84aac37344e463ce Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Wed, 19 Aug 2026 14:49:52 +0000 Subject: [PATCH 08/12] refactor(forks): adopt Amsterdam EIPs by mixin, order by succession Inheriting Amsterdam routed its gas schedule and unadopted EIPs into MONAD_NEXT through the MRO; `follows` keeps the fork order without the behavior. Co-Authored-By: Claude --- .../pytest_commands/plugins/forks/forks.py | 4 +- .../src/execution_testing/forks/base_fork.py | 20 ++++- .../execution_testing/forks/forks/forks.py | 73 ++++--------------- 3 files changed, 35 insertions(+), 62 deletions(-) diff --git a/packages/testing/src/execution_testing/cli/pytest_commands/plugins/forks/forks.py b/packages/testing/src/execution_testing/cli/pytest_commands/plugins/forks/forks.py index 6075481806c..29ef4dc86e3 100644 --- a/packages/testing/src/execution_testing/cli/pytest_commands/plugins/forks/forks.py +++ b/packages/testing/src/execution_testing/cli/pytest_commands/plugins/forks/forks.py @@ -1265,7 +1265,9 @@ def _process_with_marker_args( "Missing fork argument with 'valid_at_transition_to' marker." ) - if len(forks) > 1: + # A single EIP argument expands to one fork per enabling fork, so + # the limit is on the arguments rather than on the resolved forks. + if len(fork_args) > 1: raise Exception( "Too many forks specified to 'valid_at_transition_to' marker." ) diff --git a/packages/testing/src/execution_testing/forks/base_fork.py b/packages/testing/src/execution_testing/forks/base_fork.py index aae401d8b08..4767d361e35 100644 --- a/packages/testing/src/execution_testing/forks/base_fork.py +++ b/packages/testing/src/execution_testing/forks/base_fork.py @@ -333,12 +333,23 @@ def _maybe_transitioned(fork_cls: "BaseForkMeta") -> "BaseForkMeta": @staticmethod def _is_subclass_of(a: "BaseForkMeta", b: "BaseForkMeta") -> bool: """ - Check if `a` is a subclass of `b`, taking fork transitions into - account. + Check if `a` is a subclass of `b`, taking fork transitions and + declared succession into account. + + A fork can follow another fork it does not inherit from, which + places it after that fork (and after everything that fork comes + after) in the fork order without adopting its behavior. """ a = BaseForkMeta._maybe_transitioned(a) b = BaseForkMeta._maybe_transitioned(b) - return issubclass(a, b) + if issubclass(a, b): + return True + followed = getattr(a, "_follows", None) + while followed is not None: + if issubclass(followed, b): + return True + followed = followed._follows + return False def __gt__(cls, other: "BaseForkMeta") -> bool: """Compare if a fork is newer than some other fork (cls > other).""" @@ -381,6 +392,7 @@ class BaseFork(ForkOpcodeInterface, metaclass=BaseForkMeta): _fork_by_timestamp: ClassVar[bool] = False _blob_constants: ClassVar[Dict[str, int]] = {} _deployed: ClassVar[bool] = True + _follows: ClassVar[Optional[Type["BaseFork"]]] = None _enabled_eips: ClassVar[Set[int]] = set() _enabling_forks: ClassVar[Set[Type["BaseFork"]]] = set() @@ -396,6 +408,7 @@ def __init_subclass__( transition_tool_name: Optional[str] = None, ignore: bool = False, bpo_fork: bool = False, + follows: Optional[Type["BaseFork"]] = None, ruleset_name: Optional[str] = None, fork_by_timestamp: Optional[bool] = None, deployed: Optional[bool] = None, @@ -410,6 +423,7 @@ def __init_subclass__( forks. """ cls._transition_tool_name = transition_tool_name + cls._follows = follows cls._ignore = ignore cls._bpo_fork = bpo_fork cls._ruleset_name = ruleset_name diff --git a/packages/testing/src/execution_testing/forks/forks/forks.py b/packages/testing/src/execution_testing/forks/forks/forks.py index 1151b29531c..e3e4ffe4932 100644 --- a/packages/testing/src/execution_testing/forks/forks/forks.py +++ b/packages/testing/src/execution_testing/forks/forks/forks.py @@ -1905,69 +1905,26 @@ def engine_payload_attribute_target_gas_limit(cls) -> bool: return True -class MONAD_NEXT(MONAD_TEN, Amsterdam): # noqa: N801 +class MONAD_NEXT( # noqa: N801 + eips.EIP7708, + eips.EIP7843, + eips.EIP8024, + MONAD_TEN, + follows=Amsterdam, +): """ MONAD_NEXT fork. - Amsterdam-based successor to MONAD_TEN. Only the EIP-7708, EIP-7843 - and EIP-8024 changes are inherited from Amsterdam; every other - Amsterdam change is pinned back to the MONAD_TEN parent. The - EIP-7928 block access list hash header field is carried, but no - block access lists are built, so the field is always zero. + Amsterdam-based successor to MONAD_TEN, adopting the EIP-7708, + EIP-7843 and EIP-8024 changes. The Amsterdam changes it does not + adopt stay out of the fork by not being inherited at all; the fork + order still places MONAD_NEXT after Amsterdam through `follows`. """ @classmethod - def valid_opcodes(cls) -> List[Opcodes]: + def header_bal_hash_required(cls) -> bool: """ - Inherit the Amsterdam opcode set: SLOTNUM (EIP-7843) and SWAPN, - DUPN, EXCHANGE (EIP-8024) on top of the MONAD_TEN opcodes. + MONAD_NEXT headers carry the block access list hash field, fixed + at zero, without building block access lists (EIP-7928). """ - return Amsterdam.valid_opcodes() - - @classmethod - def max_code_size(cls) -> int: - """Return spec from explicit parent (skip EIP-7954).""" - return MONAD_TEN.max_code_size() - - @classmethod - def calldata_gas_calculator(cls) -> CalldataGasCalculator: - """Return spec from explicit parent (skip EIP-7976).""" - return MONAD_TEN.calldata_gas_calculator() - - @classmethod - def transaction_data_floor_cost_calculator( - cls, - ) -> TransactionDataFloorCostCalculator: - """Return spec from explicit parent (skip EIP-7981).""" - return MONAD_TEN.transaction_data_floor_cost_calculator() - - @classmethod - def transaction_intrinsic_cost_calculator( - cls, - ) -> TransactionIntrinsicCostCalculator: - """Return spec from explicit parent (skip EIP-7981).""" - return MONAD_TEN.transaction_intrinsic_cost_calculator() - - @classmethod - def supports_block_access_lists(cls) -> bool: - """Return spec from explicit parent (skip EIP-7928).""" - return MONAD_TEN.supports_block_access_lists() - - @classmethod - def empty_block_bal_item_count(cls) -> int: - """Return spec from explicit parent (skip EIP-7928).""" - return MONAD_TEN.empty_block_bal_item_count() - - @classmethod - def engine_execution_payload_block_access_list(cls) -> bool: - """Return spec from explicit parent (skip EIP-7928).""" - return MONAD_TEN.engine_execution_payload_block_access_list() - - -# MONAD_NEXT adopts EIP-7708, EIP-7843 and EIP-8024 from Amsterdam through the -# MRO rather than by inheriting their mixin classes: inheriting them would -# register MONAD_NEXT as a spurious `enabling_fork` (breaking -# `valid_at_transition_to`) and pull in EIP-7843's engine version bumps. -# Record the adopted EIP numbers on `_enabled_eips` directly so that -# `is_eip_enabled()` reports them without those side effects. -MONAD_NEXT._enabled_eips = MONAD_TEN._enabled_eips | {7708, 7843, 8024} + return True From efe211ddebff4d5a6c0d5e623cd158a7db7dc9eb Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Wed, 19 Aug 2026 14:54:45 +0000 Subject: [PATCH 09/12] test(amsterdam): keep the unadopted Amsterdam suites off the Monad forks MONAD_NEXT follows Amsterdam, so its `valid_from` suites select the fork; the seven EIPs it does not adopt now exclude Monad like the rest. Co-Authored-By: Claude --- .../eip2780_reduce_intrinsic_tx_gas/conftest.py | 10 ++++++++++ .../conftest.py | 10 ++++++++++ .../conftest.py | 10 ++++++++++ .../eip8038_state_access_gas_cost_increase/conftest.py | 10 ++++++++++ tests/amsterdam/eip8070_sparse_blobpool/conftest.py | 7 +++++++ .../amsterdam/eip8246_selfdestruct_no_burn/conftest.py | 10 ++++++++++ .../eip8282_builder_execution_requests/conftest.py | 9 +++++++++ 7 files changed, 66 insertions(+) create mode 100644 tests/amsterdam/eip2780_reduce_intrinsic_tx_gas/conftest.py create mode 100644 tests/amsterdam/eip7997_deterministic_factory_predeploy/conftest.py create mode 100644 tests/amsterdam/eip8037_state_creation_gas_cost_increase/conftest.py create mode 100644 tests/amsterdam/eip8038_state_access_gas_cost_increase/conftest.py create mode 100644 tests/amsterdam/eip8246_selfdestruct_no_burn/conftest.py diff --git a/tests/amsterdam/eip2780_reduce_intrinsic_tx_gas/conftest.py b/tests/amsterdam/eip2780_reduce_intrinsic_tx_gas/conftest.py new file mode 100644 index 00000000000..de52075d396 --- /dev/null +++ b/tests/amsterdam/eip2780_reduce_intrinsic_tx_gas/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-2780 tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip7997_deterministic_factory_predeploy/conftest.py b/tests/amsterdam/eip7997_deterministic_factory_predeploy/conftest.py new file mode 100644 index 00000000000..de93abfcfef --- /dev/null +++ b/tests/amsterdam/eip7997_deterministic_factory_predeploy/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-7997 tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip8037_state_creation_gas_cost_increase/conftest.py b/tests/amsterdam/eip8037_state_creation_gas_cost_increase/conftest.py new file mode 100644 index 00000000000..2d16c275db4 --- /dev/null +++ b/tests/amsterdam/eip8037_state_creation_gas_cost_increase/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-8037 tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip8038_state_access_gas_cost_increase/conftest.py b/tests/amsterdam/eip8038_state_access_gas_cost_increase/conftest.py new file mode 100644 index 00000000000..cd29eb50dcb --- /dev/null +++ b/tests/amsterdam/eip8038_state_access_gas_cost_increase/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-8038 tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip8070_sparse_blobpool/conftest.py b/tests/amsterdam/eip8070_sparse_blobpool/conftest.py index cb2a757494c..dc3ee7c3ecd 100644 --- a/tests/amsterdam/eip8070_sparse_blobpool/conftest.py +++ b/tests/amsterdam/eip8070_sparse_blobpool/conftest.py @@ -148,3 +148,10 @@ def txs( ) txs.append(network_wrapped_tx) return txs + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip8246_selfdestruct_no_burn/conftest.py b/tests/amsterdam/eip8246_selfdestruct_no_burn/conftest.py new file mode 100644 index 00000000000..4fb53dba402 --- /dev/null +++ b/tests/amsterdam/eip8246_selfdestruct_no_burn/conftest.py @@ -0,0 +1,10 @@ +"""Pytest (plugin) definitions local to EIP-8246 tests.""" + +import pytest + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) diff --git a/tests/amsterdam/eip8282_builder_execution_requests/conftest.py b/tests/amsterdam/eip8282_builder_execution_requests/conftest.py index e17cee467fc..7a42ba76785 100644 --- a/tests/amsterdam/eip8282_builder_execution_requests/conftest.py +++ b/tests/amsterdam/eip8282_builder_execution_requests/conftest.py @@ -1,8 +1,17 @@ """Fixtures for the EIP-8282 builder execution request tests.""" +import pytest + from ...common.system_contract_request_fixtures import ( blocks, # noqa: F401 included_requests, # noqa: F401 system_contract_interactions_per_block_copy, # noqa: F401 timestamp, # noqa: F401 ) + + +def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: + """Mark all tests in this subdir as not valid for Monad forks.""" + metafunc.definition.add_marker( + pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) + ) From 08ac088efc697c52b9843427b5228b2c5fdaf04b Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Wed, 19 Aug 2026 15:15:37 +0000 Subject: [PATCH 10/12] test(selfdestruct): expect the Burn logs a fork without EIP-8246 emits A fork can enable EIP-7708 without EIP-8246 and still burn a swept or stranded balance, which the sweep helper now accounts for. Co-Authored-By: Claude --- .../eip7708_eth_transfer_logs/spec.py | 13 ++ .../conftest.py | 7 - .../conftest.py | 7 - .../eip6780_selfdestruct/test_selfdestruct.py | 144 +++++++++++------- 4 files changed, 101 insertions(+), 70 deletions(-) diff --git a/tests/amsterdam/eip7708_eth_transfer_logs/spec.py b/tests/amsterdam/eip7708_eth_transfer_logs/spec.py index 56a42e2850a..11ba0ebf214 100644 --- a/tests/amsterdam/eip7708_eth_transfer_logs/spec.py +++ b/tests/amsterdam/eip7708_eth_transfer_logs/spec.py @@ -30,6 +30,7 @@ class Spec: TRANSFER_TOPIC: Hash = Hash( keccak256(b"Transfer(address,address,uint256)") ) + BURN_TOPIC: Hash = Hash(keccak256(b"Burn(address,uint256)")) def transfer_log( @@ -45,3 +46,15 @@ def transfer_log( ], data=Bytes(amount.to_bytes(32, "big")), ) + + +def burn_log(contract_address: Address, amount: int) -> TransactionLog: + """Create an expected Burn log for EIP-7708.""" + return TransactionLog( + address=Spec.SYSTEM_ADDRESS, + topics=[ + Spec.BURN_TOPIC, + Hash(bytes(contract_address).rjust(32, b"\x00")), + ], + data=Bytes(amount.to_bytes(32, "big")), + ) diff --git a/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py b/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py index b4d596bdc52..78cb66ed14d 100644 --- a/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py +++ b/tests/amsterdam/eip7954_increase_max_contract_size/conftest.py @@ -4,13 +4,6 @@ from execution_testing import Address, Alloc, Bytecode, Fork, Op -def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: - """Mark all tests in this subdir as not valid for Monad forks.""" - metafunc.definition.add_marker( - pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) - ) - - @pytest.fixture def max_code_size_contract( pre: Alloc, diff --git a/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py b/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py index c02d771f5d2..104a73e464a 100644 --- a/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py +++ b/tests/amsterdam/eip7981_increase_access_list_cost/conftest.py @@ -22,13 +22,6 @@ from ...cancun.eip4844_blobs.spec import Spec as EIP_4844_Spec -def pytest_generate_tests(metafunc: pytest.Metafunc) -> None: - """Mark all tests in this subdir as not valid for Monad forks.""" - metafunc.definition.add_marker( - pytest.mark.not_valid_for("MONAD_EIGHT", subsequent_forks=True) - ) - - @pytest.fixture def to( request: pytest.FixtureRequest, diff --git a/tests/cancun/eip6780_selfdestruct/test_selfdestruct.py b/tests/cancun/eip6780_selfdestruct/test_selfdestruct.py index 24a80ceca9e..21b2734529f 100644 --- a/tests/cancun/eip6780_selfdestruct/test_selfdestruct.py +++ b/tests/cancun/eip6780_selfdestruct/test_selfdestruct.py @@ -24,12 +24,16 @@ StateTestFiller, Storage, Transaction, + TransactionLog, TransactionReceipt, compute_create_address, ) from execution_testing.forks import MONAD_EIGHT, Cancun -from tests.amsterdam.eip7708_eth_transfer_logs.spec import transfer_log +from tests.amsterdam.eip7708_eth_transfer_logs.spec import ( + burn_log, + transfer_log, +) REFERENCE_SPEC_GIT_PATH = "EIPS/eip-6780.md" REFERENCE_SPEC_VERSION = "1b6a0e94cc47e859b9866e570391cf37dc55059a" @@ -52,6 +56,25 @@ PRE_DEPLOY_CONTRACT_3 = "pre_deploy_contract_3" +def sweep_log( + fork: Fork, + contract_address: Address, + recipient: Address, + amount: int, +) -> TransactionLog | None: + """ + Return the EIP-7708 log a SELFDESTRUCT sweep emits, if any. + + A sweep to another account transfers. A sweep to self burns the + balance, until EIP-8246 keeps it and emits nothing. + """ + if recipient != contract_address: + return transfer_log(contract_address, recipient, amount) + if fork.is_eip_enabled(8246): + return None + return burn_log(contract_address, amount) + + @pytest.fixture def eip_enabled(fork: Fork) -> bool: """Whether the EIP is enabled or not.""" @@ -324,14 +347,14 @@ def test_create_selfdestruct_same_tx( # SELFDESTRUCT emits a Transfer log to a different address, or a Burn # log when sending to self (contract was created in this tx). if selfdestruct_contract_current_balance > 0: - if sendall_recipient != selfdestruct_contract_address: - expected_logs_after_tx_value.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient, - selfdestruct_contract_current_balance, - ) - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient, + selfdestruct_contract_current_balance, + ) + if sweep is not None: + expected_logs_after_tx_value.append(sweep) # Balance is always sent to other contracts if sendall_recipient != selfdestruct_contract_address: @@ -569,13 +592,14 @@ def test_self_destructing_initcode( ) # Initcode SELFDESTRUCT sends pre-existing balance to the recipient. if selfdestruct_contract_initial_balance > 0: - expected_logs.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient_addresses[0], - selfdestruct_contract_initial_balance, - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient_addresses[0], + selfdestruct_contract_initial_balance, ) + if sweep is not None: + expected_logs.append(sweep) # CALLs to the destroyed contract transfer ETH to it. for i in range(call_times): if i > 0: @@ -584,6 +608,12 @@ def test_self_destructing_initcode( entry_code_address, selfdestruct_contract_address, i ) ) + # Whatever the calls left on the account is burned when the + # account is deleted, until EIP-8246 keeps it. + if entry_code_balance > 0 and not fork.is_eip_enabled(8246): + expected_logs.append( + burn_log(selfdestruct_contract_address, entry_code_balance) + ) tx.expected_receipt = TransactionReceipt(logs=expected_logs) state_test(pre=pre, post=post, tx=tx) @@ -657,13 +687,14 @@ def test_self_destructing_initcode_create_tx( transfer_log(sender, selfdestruct_contract_address, tx_value) ) if sendall_amount > 0: - expected_logs.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient_addresses[0], - sendall_amount, - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient_addresses[0], + sendall_amount, ) + if sweep is not None: + expected_logs.append(sweep) tx.expected_receipt = TransactionReceipt(logs=expected_logs) state_test(pre=pre, post=post, tx=tx) @@ -786,17 +817,14 @@ def test_recreate_self_destructed_contract_different_txs( # address with 0 balance (destroyed+cleared), so no log. tx_logs: list = [] if i == 0 and selfdestruct_contract_initial_balance > 0: - if ( - sendall_recipient_addresses[0] - != selfdestruct_contract_address - ): - tx_logs.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient_addresses[0], - selfdestruct_contract_initial_balance, - ) - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient_addresses[0], + selfdestruct_contract_initial_balance, + ) + if sweep is not None: + tx_logs.append(sweep) expected_receipt = TransactionReceipt(logs=tx_logs) txs.append( Transaction( @@ -988,13 +1016,14 @@ def test_selfdestruct_pre_existing( sendall_recipient != selfdestruct_contract_address and selfdestruct_contract_current_balance > 0 ): - expected_logs_after_tx_value.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient, - selfdestruct_contract_current_balance, - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient, + selfdestruct_contract_current_balance, ) + if sweep is not None: + expected_logs_after_tx_value.append(sweep) # Balance is always sent to other contracts if sendall_recipient != selfdestruct_contract_address: @@ -1192,13 +1221,14 @@ def test_selfdestruct_created_same_block_different_tx( ) running_balance += i if running_balance > 0: - tx2_logs.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient_addresses[0], - running_balance, - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient_addresses[0], + running_balance, ) + if sweep is not None: + tx2_logs.append(sweep) running_balance = 0 tx2_receipt = TransactionReceipt(logs=tx2_logs) @@ -1384,13 +1414,14 @@ def test_calling_from_new_contract_to_pre_existing_contract( ) running_balance += i if running_balance > 0: - expected_logs.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient_addresses[0], - running_balance, - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient_addresses[0], + running_balance, ) + if sweep is not None: + expected_logs.append(sweep) running_balance = 0 tx.expected_receipt = TransactionReceipt(logs=expected_logs) @@ -1728,13 +1759,14 @@ def test_create_selfdestruct_same_tx_increased_nonce( # (SELF_ADDRESS is not parametrized here), so a Transfer log is # emitted whenever the contract has a nonzero balance. if selfdestruct_contract_current_balance > 0: - expected_logs_after_tx_value.append( - transfer_log( - selfdestruct_contract_address, - sendall_recipient, - selfdestruct_contract_current_balance, - ) + sweep = sweep_log( + fork, + selfdestruct_contract_address, + sendall_recipient, + selfdestruct_contract_current_balance, ) + if sweep is not None: + expected_logs_after_tx_value.append(sweep) # Balance is always sent to other contracts if sendall_recipient != selfdestruct_contract_address: From 4909497420c98e20708d6f610f727df209181c82 Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Tue, 25 Aug 2026 10:50:59 +0000 Subject: [PATCH 11/12] refactor(forks): declare fork succession as a trait, not a keyword `follows()` sits with the other fork traits, so `__init_subclass__` is untouched and a successor fork inherits the order without restating it. Co-Authored-By: Claude --- .../src/execution_testing/forks/base_fork.py | 20 ++++++++++++++----- .../execution_testing/forks/forks/forks.py | 6 +++++- 2 files changed, 20 insertions(+), 6 deletions(-) diff --git a/packages/testing/src/execution_testing/forks/base_fork.py b/packages/testing/src/execution_testing/forks/base_fork.py index 4767d361e35..30d58136385 100644 --- a/packages/testing/src/execution_testing/forks/base_fork.py +++ b/packages/testing/src/execution_testing/forks/base_fork.py @@ -344,11 +344,13 @@ def _is_subclass_of(a: "BaseForkMeta", b: "BaseForkMeta") -> bool: b = BaseForkMeta._maybe_transitioned(b) if issubclass(a, b): return True - followed = getattr(a, "_follows", None) + # The metaclass sees its instances as plain classes, so the + # trait is reached through a cast, as elsewhere in this class. + followed = cast(Type["BaseFork"], a).follows() while followed is not None: if issubclass(followed, b): return True - followed = followed._follows + followed = followed.follows() return False def __gt__(cls, other: "BaseForkMeta") -> bool: @@ -392,7 +394,6 @@ class BaseFork(ForkOpcodeInterface, metaclass=BaseForkMeta): _fork_by_timestamp: ClassVar[bool] = False _blob_constants: ClassVar[Dict[str, int]] = {} _deployed: ClassVar[bool] = True - _follows: ClassVar[Optional[Type["BaseFork"]]] = None _enabled_eips: ClassVar[Set[int]] = set() _enabling_forks: ClassVar[Set[Type["BaseFork"]]] = set() @@ -408,7 +409,6 @@ def __init_subclass__( transition_tool_name: Optional[str] = None, ignore: bool = False, bpo_fork: bool = False, - follows: Optional[Type["BaseFork"]] = None, ruleset_name: Optional[str] = None, fork_by_timestamp: Optional[bool] = None, deployed: Optional[bool] = None, @@ -423,7 +423,6 @@ def __init_subclass__( forks. """ cls._transition_tool_name = transition_tool_name - cls._follows = follows cls._ignore = ignore cls._bpo_fork = bpo_fork cls._ruleset_name = ruleset_name @@ -1433,6 +1432,17 @@ def enabling_forks(cls) -> Set[Type["BaseFork"]]: raise Exception(f"Class {cls.__name__} is not an EIP.") return cls._enabling_forks + @classmethod + def follows(cls) -> Type["BaseFork"] | None: + """ + Return the fork this one comes after without inheriting it. + + A fork that reuses another lineage's ordering overrides this; + comparisons then place it after that fork, and after everything + that fork comes after, while its behavior stays its own. + """ + return None + @classmethod def parent(cls) -> Type["BaseFork"] | None: """Return the parent fork.""" diff --git a/packages/testing/src/execution_testing/forks/forks/forks.py b/packages/testing/src/execution_testing/forks/forks/forks.py index e3e4ffe4932..974cd31b395 100644 --- a/packages/testing/src/execution_testing/forks/forks/forks.py +++ b/packages/testing/src/execution_testing/forks/forks/forks.py @@ -1910,7 +1910,6 @@ class MONAD_NEXT( # noqa: N801 eips.EIP7843, eips.EIP8024, MONAD_TEN, - follows=Amsterdam, ): """ MONAD_NEXT fork. @@ -1921,6 +1920,11 @@ class MONAD_NEXT( # noqa: N801 order still places MONAD_NEXT after Amsterdam through `follows`. """ + @classmethod + def follows(cls) -> type[BaseFork] | None: + """MONAD_NEXT comes after Amsterdam without inheriting it.""" + return Amsterdam + @classmethod def header_bal_hash_required(cls) -> bool: """ From cfa37f31a6a9f76e52dbe9a20b0285a5a121ff36 Mon Sep 17 00:00:00 2001 From: pdobacz <5735525+pdobacz@users.noreply.github.com> Date: Tue, 25 Aug 2026 10:52:20 +0000 Subject: [PATCH 12/12] refactor(forks): derive block access list support from the EIP A fork builds the lists when EIP-7928 is enabled, so the trait needs no abstract declaration, no genesis default and no mixin override. Co-Authored-By: Claude --- .../testing/src/execution_testing/forks/base_fork.py | 9 ++++----- .../forks/forks/eips/amsterdam/eip_7928.py | 7 ------- .../testing/src/execution_testing/forks/forks/forks.py | 5 ----- 3 files changed, 4 insertions(+), 17 deletions(-) diff --git a/packages/testing/src/execution_testing/forks/base_fork.py b/packages/testing/src/execution_testing/forks/base_fork.py index 30d58136385..21801a25162 100644 --- a/packages/testing/src/execution_testing/forks/base_fork.py +++ b/packages/testing/src/execution_testing/forks/base_fork.py @@ -577,16 +577,15 @@ def header_bal_hash_required(cls) -> bool: pass @classmethod - @abstractmethod def supports_block_access_lists(cls) -> bool: """ Return true if the fork builds block access lists (EIP-7928). - A fork can require the block access list hash header field without - building block access lists (e.g. Monad); the field is then fixed - at zero. + A fork can require the block access list hash header field + without building the lists, and then fixes the field at zero, so + this follows the EIP rather than the header requirement. """ - pass + return cls.is_eip_enabled(7928) @classmethod @abstractmethod diff --git a/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py b/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py index d7c787eed92..1eacd844b21 100644 --- a/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py +++ b/packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_7928.py @@ -29,13 +29,6 @@ def header_bal_hash_required(cls) -> bool: """ return True - @classmethod - def supports_block_access_lists(cls) -> bool: - """ - From EIP-7928, blocks build block access lists. - """ - return True - @classmethod def gas_costs(cls) -> GasCosts: """ diff --git a/packages/testing/src/execution_testing/forks/forks/forks.py b/packages/testing/src/execution_testing/forks/forks/forks.py index 974cd31b395..348901ef328 100644 --- a/packages/testing/src/execution_testing/forks/forks/forks.py +++ b/packages/testing/src/execution_testing/forks/forks/forks.py @@ -954,11 +954,6 @@ def header_bal_hash_required(cls) -> bool: """At genesis, header must not contain block access list hash.""" return False - @classmethod - def supports_block_access_lists(cls) -> bool: - """At genesis, no block access lists are built.""" - return False - @classmethod def empty_block_bal_item_count(cls) -> int: """Pre-Amsterdam forks have no block access list."""