chore(spec-specs): Add Amsterdam docstring; update prepare msg

Author: fselmo

src/ethereum/forks/amsterdam/__init__.py

@@ -1,3 +1,14 @@
+"""
+The Amsterdam fork ([EIP-7773]) includes block-level access lists.
+
+### Changes
+
+- [EIP-7928: Block-Level Access Lists][EIP-7928]
+
+### Releases
+
+[EIP-7928]: https://eips.ethereum.org/EIPS/eip-7928
+"""  # noqa: E501
 
 from ethereum.fork_criteria import Unscheduled
 

src/ethereum/forks/amsterdam/fork.py

@@ -993,9 +993,12 @@ def process_transaction(
         tx_hash=get_transaction_hash(encode_transaction(tx)),
     )
 
-    message = prepare_message(block_env, tx_env, tx)
-    # Set transaction frame so call frames become children of it
-    message.transaction_state_changes = tx_state_changes
+    message = prepare_message(
+        block_env,
+        tx_env,
+        tx,
+        tx_state_changes,
+    )
 
     tx_output = process_message_call(message)
 

src/ethereum/forks/amsterdam/utils/message.py

@@ -17,6 +17,7 @@
 
 from ..fork_types import Address
 from ..state import get_account
+from ..state_tracker import StateChanges
 from ..transactions import Transaction
 from ..vm import BlockEnvironment, Message, TransactionEnvironment
 from ..vm.precompiled_contracts.mapping import PRE_COMPILED_CONTRACTS
@@ -27,6 +28,7 @@ def prepare_message(
     block_env: BlockEnvironment,
     tx_env: TransactionEnvironment,
     tx: Transaction,
+    transaction_state_changes: StateChanges,
 ) -> Message:
     """
     Execute a transaction against the provided environment.
@@ -39,6 +41,8 @@ def prepare_message(
         Environment for the transaction.
     tx :
         Transaction to be executed.
+    transaction_state_changes :
+        State changes specific to this transaction.
 
     Returns
     -------
@@ -87,4 +91,5 @@ def prepare_message(
         accessed_storage_keys=set(tx_env.access_list_storage_keys),
         disable_precompiles=False,
         parent_evm=None,
+        transaction_state_changes=transaction_state_changes,
     )

src/ethereum/forks/amsterdam/vm/__init__.py

@@ -142,7 +142,7 @@ class Message:
     accessed_storage_keys: Set[Tuple[Address, Bytes32]]
     disable_precompiles: bool
     parent_evm: Optional["Evm"]
-    transaction_state_changes: Optional[StateChanges] = None
+    transaction_state_changes: StateChanges
 
 
 @dataclass

src/ethereum/forks/amsterdam/vm/instructions/system.py

@@ -144,6 +144,7 @@ def generic_create(
         accessed_storage_keys=evm.accessed_storage_keys.copy(),
         disable_precompiles=False,
         parent_evm=evm,
+        transaction_state_changes=evm.message.transaction_state_changes,
     )
 
     child_evm = process_create_message(child_message)