fix(docs): Fix issues with toxenvs: lint, doc, json_infra

Author: fselmo

pyproject.toml

@@ -495,6 +495,9 @@ ignore = [
 "src/ethereum_spec_tools/evm_tools/t8n/evm_trace.py" = [
     "N815"          # The traces must use camel case in JSON property names
 ]
+"src/ethereum/amsterdam/blocks.py" = [
+    "E501"          # Line too long - needed for long ref links
+]
 
 [tool.ruff.lint.mccabe]
 # Set the maximum allowed cyclomatic complexity. C901 default is 10.

src/ethereum/amsterdam/block_access_lists/builder.py

@@ -305,7 +305,6 @@ def add_code_change(
 
     [`CREATE`]: ref:ethereum.amsterdam.vm.instructions.system.create
     [`CREATE2`]: ref:ethereum.amsterdam.vm.instructions.system.create2
-    [`SETCODE`]: ref:ethereum.amsterdam.vm.instructions.system.setcode
     """
     ensure_account(builder, address)
 

src/ethereum/amsterdam/block_access_lists/tracker.py

@@ -311,7 +311,6 @@ def track_code_change(
 
     [`CREATE`]: ref:ethereum.amsterdam.vm.instructions.system.create
     [`CREATE2`]: ref:ethereum.amsterdam.vm.instructions.system.create2
-    [`SETCODE`]: ref:ethereum.amsterdam.vm.instructions.system.setcode
     """
     track_address_access(tracker, address)
     add_code_change(
@@ -323,7 +322,7 @@ def track_code_change(
 
 
 def finalize_transaction_changes(
-    tracker: StateChangeTracker, state: "State"  # noqa: U100
+    tracker: StateChangeTracker, state: "State"
 ) -> None:
     """
     Finalize changes for the current transaction.

src/ethereum/amsterdam/blocks.py

@@ -8,6 +8,7 @@
 history of all state transitions that have happened since the genesis of the
 chain.
 """
+
 from dataclasses import dataclass
 from typing import Tuple
 
@@ -243,10 +244,14 @@ class Header:
 
     bal_hash: Hash32
     """
-    Hash of the Block Access List containing all accounts and storage
-    locations accessed during block execution. Introduced in [EIP-7928].
+    [SHA2-256] hash of the Block Access List containing all accounts and
+    storage locations accessed during block execution. Introduced in
+    [EIP-7928]. See [`compute_block_access_list_hash`][cbalh] for more
+    details.
 
     [EIP-7928]: https://eips.ethereum.org/EIPS/eip-7928
+    [cbalh]: ref:ethereum.amsterdam.block_access_lists.rlp_utils.compute_block_access_list_hash  # noqa: E501
+    [SHA2-256]: https://en.wikipedia.org/wiki/SHA-2
     """
 
 

src/ethereum/amsterdam/fork.py

@@ -30,10 +30,10 @@
 )
 
 from . import vm
-from .block_access_lists import (
+from .block_access_lists.builder import build
+from .block_access_lists.rlp_utils import compute_block_access_list_hash
+from .block_access_lists.tracker import (
     StateChangeTracker,
-    build,
-    compute_block_access_list_hash,
     set_transaction_index,
     track_balance_change,
 )

src/ethereum/amsterdam/vm/__init__.py

@@ -22,17 +22,15 @@
 from ethereum.crypto.hash import Hash32
 from ethereum.exceptions import EthereumException
 
-from ..block_access_lists import BlockAccessListBuilder
+from ..block_access_lists.builder import BlockAccessListBuilder
 from ..blocks import Log, Receipt, Withdrawal
 from ..fork_types import Address, Authorization, VersionedHash
 from ..state import State, TransientStorage
 from ..transactions import LegacyTransaction
 from ..trie import Trie
 
 if TYPE_CHECKING:
-    from ..block_access_lists import StateChangeTracker
-
-__all__ = ("Environment", "Evm", "Message")
+    from ..block_access_lists.tracker import StateChangeTracker  # noqa: F401
 
 
 @dataclass

src/ethereum/genesis.py

@@ -233,6 +233,7 @@ def add_genesis_block(
         "timestamp": genesis.timestamp,
         "extra_data": genesis.extra_data,
         "nonce": genesis.nonce,
+
     }
 
     if has_field(hardfork.Header, "mix_digest"):
@@ -258,6 +259,9 @@ def add_genesis_block(
     if has_field(hardfork.Header, "requests_hash"):
         fields["requests_hash"] = Hash32(b"\0" * 32)
 
+    if has_field(hardfork.Header, "bal_hash"):
+        fields["bal_hash"] = Hash32(b"\0" * 32)
+
     genesis_header = hardfork.Header(**fields)
 
     block_fields = {
@@ -272,6 +276,9 @@ def add_genesis_block(
     if has_field(hardfork.Block, "requests"):
         block_fields["requests"] = ()
 
+    if has_field(hardfork.Block, "block_access_list"):
+        block_fields["block_access_list"] = rlp.encode([])
+
     genesis_block = hardfork.Block(**block_fields)
 
     chain.blocks.append(genesis_block)