refactor(test-benchmark): organize stateful benchmark folder structure (#3152)

* chore: relocate balance stateful benchmark

 - Rename test_bloatnet_balance_opcode to test_balance_query for readability
 - Move `test_balance_query` from `test_multi_opocode` to `test_account_query` folder

* refactor: rename test_create2_access to test_create_operation

* chore: organize call related stateful benchmark
 - create test_call_operation file
 - move test_call_value_existing and test_call_value_new_account
 - rename test name

* refactor: relocate erc20 elated benchmark

 - add test_erc20_operation file
 - move test_sload_erc20_generic, test_sstore_erc20_generic, test_mixed_sload_sstore to same file

* refactor: relocate sload benchmark

 - add test_sload file
 - move sload related benchmark

* refactor: relocate sstore benchmark

 - add test_sstore file
 - move test_sstore_bloated, test_sstore_dirty_transitions to new file

* chore: move test_extcodesize_bytecode_sizes to test_account_query

* chore: docstring, comment refactor

* docs: update stub-dependent test examples after benchmark reorg

* chore(tests): fix markdown rendering in bloatnet benchmark docstrings

* refactor(test-benchmark): file renaming, remove _operation suffix

---------

Co-authored-by: danceratopz <danceratopz@gmail.com>

Author: 2 people

docs/filling_tests/fill_stateful.md

@@ -149,7 +149,7 @@ Each `pre_run/<start_block_hash>.json` (a `StatefulPreRunFixture`) is replayed o
 
 ## Stub-dependent tests
 
-Some stateful tests (e.g. `test_single_opcode.py`, `test_multi_opcode.py`) target on-chain accounts the snapshot already contains. They reach them two ways:
+Some stateful tests (e.g. `test_erc20_operation.py`, `test_sload.py`) target on-chain accounts the snapshot already contains. They reach them two ways:
 
 - `@pytest.mark.stub_parametrize("name", "prefix_")` — parametrize values pulled from `--address-stubs` matching `prefix_`.
 - `pre.deploy_contract(stub="<label>", ...)` — direct runtime lookup.

tests/benchmark/stateful/bloatnet/README.md

@@ -15,7 +15,7 @@ The test measures the performance impact of state root recomputation and IO when
 
 ## Contract Sources
 
-- **Pre-mined assets** (depth\__.sol, s_\_acc\*.json): https://github.com/CPerezz/worst_case_miner/tree/master/mined_assets
+- **Pre-mined assets** (`depth_*.sol`, `s*_acc*.json`): https://github.com/CPerezz/worst_case_miner/tree/master/mined_assets
 
 For complete deployment setup and instructions, see the gist: https://gist.github.com/CPerezz/44d521c0f9e6adf7d84187a4f2c11978
 

tests/benchmark/stateful/bloatnet/depth_benchmarks/README.md

@@ -1,3 +1 @@
-"""
-abstract: BloatNet worst-case attack benchmark for maximum SSTORE stress.
-"""
+"""BloatNet worst-case attack benchmark for maximum SSTORE stress."""

tests/benchmark/stateful/bloatnet/depth_benchmarks/__init__.py

@@ -1,12 +1,13 @@
 """
-abstract: BloatNet worst-case depth benchmarks for deep SSTORE and SLOAD.
+BloatNet worst-case depth benchmarks for deep SSTORE and SLOAD.
 
 This test implements a worst-case scenario for Ethereum block processing
 that exploits the computational complexity of Patricia Merkle Trie
 operations. It uses CREATE2 to deploy contracts at pre-mined addresses
 with shared prefixes, maximizing trie traversal depth.
 
 Key features:
+
 - Accesses pre-deployed contracts via CREATE2 address derivation
 - Each contract has deep storage slots with configurable trie depth
 - Includes both a mutating `attack(uint256)` benchmark and a read-only
@@ -15,11 +16,13 @@
 - Verifies correctness via post-state checks or receipt-status validation
 
 Test parameters:
+
 - storage_depth: Depth of storage slots (e.g., 10, 11)
 - account_depth: Account address prefix sharing depth (e.g., 6, 7)
 
 Contract sources:
-- Pre-mined assets (depth_*.sol, s*_acc*.json):
+
+- Pre-mined assets (`depth_*.sol`, `s*_acc*.json`):
   https://github.com/CPerezz/worst_case_miner/tree/master/mined_assets
 """
 
@@ -500,6 +503,7 @@ def test_worst_depth_stateroot_recomp(
     BloatNet worst-case SSTORE attack benchmark with pre-deployed contracts.
 
     This test:
+
     1. Derives CREATE2 addresses from initcode_hash + Nick's deployer
     2. Deploys AttackOrchestrator that calls attack() on each target
     3. Fills blocks with 16M gas transactions attacking contracts