feat(checklists): add EIPChecklist enum to specify EIP checklist items (ethereum#1718)

* fix: move unit test

* Create Enums - Incomplete/broken attempt

* fix(filler/checklist): Template copying bug

* fix: EIPChecklist usage

* docs: Update usage

* refactor(eip_checklist): Remove new_* from all IDs

* fix: tox (minus spellcheck)

* fix: typing

* fix(docs,checklists): Rename section to be more descriptive

* docs: remove references to string EIP checklist notation

* docs: backtick `EIPChecklist` instances

* docs: update changelog

* docs: fix title

* fix(checklists): allow ommission of parentheses in checklist markers

* style(checklists): add stubs to solve mypy issues using checklist markers

* test(checkmarks): add fw tests that apply EIPChecklists in pytest.param

* fix(docs): fix bad links to exception tests

* fix(checklists): update test markers to use correct checklist IDs

Update test files to use the correct checklist IDs that match the template:
- Change 'new_precompile' prefix to 'precompile'
- This fixes mkdocs build warnings about missing checklist items

The checklist template uses 'precompile/test/*' IDs but tests were using
'new_precompile/test/*' IDs, causing template lookup failures during
documentation generation.

Also add missing docstrings to fix linting errors.

---------

Co-authored-by: danceratopz <[email protected]>

Author: marioevz

osaka/eip7951_p256verify_precompiles/test_p256verify.py

@@ -31,8 +31,8 @@
     # Source: https://github.com/C2SP/wycheproof/blob/main/testvectors/ecdsa_secp256r1_sha256_test.json
 )
 @pytest.mark.parametrize("precompile_address", [Spec.P256VERIFY], ids=[""])
-@pytest.mark.eip_checklist("new_precompile/test/call_contexts/normal")
-@pytest.mark.eip_checklist("new_precompile/test/inputs/valid")
+@pytest.mark.eip_checklist("precompile/test/call_contexts/normal")
+@pytest.mark.eip_checklist("precompile/test/inputs/valid")
 def test_valid(state_test: StateTestFiller, pre: Alloc, post: dict, tx: Transaction):
     """Test P256Verify precompile."""
     state_test(env=Environment(), pre=pre, post=post, tx=tx)
@@ -94,13 +94,13 @@ def test_valid(state_test: StateTestFiller, pre: Alloc, post: dict, tx: Transact
 )
 @pytest.mark.parametrize("expected_output", [Spec.INVALID_RETURN_VALUE], ids=[""])
 @pytest.mark.parametrize("precompile_address", [Spec.P256VERIFY], ids=[""])
-@pytest.mark.eip_checklist("new_precompile/test/inputs/all_zeros")
-@pytest.mark.eip_checklist("new_precompile/test/inputs/invalid")
-@pytest.mark.eip_checklist("new_precompile/test/inputs/invalid/crypto")
-@pytest.mark.eip_checklist("new_precompile/test/inputs/invalid/corrupted")
-@pytest.mark.eip_checklist("new_precompile/test/input_lengths/static/correct")
-@pytest.mark.eip_checklist("new_precompile/test/input_lengths/static/too_short")
-@pytest.mark.eip_checklist("new_precompile/test/input_lengths/static/too_long")
+@pytest.mark.eip_checklist("precompile/test/inputs/all_zeros")
+@pytest.mark.eip_checklist("precompile/test/inputs/invalid")
+@pytest.mark.eip_checklist("precompile/test/inputs/invalid/crypto")
+@pytest.mark.eip_checklist("precompile/test/inputs/invalid/corrupted")
+@pytest.mark.eip_checklist("precompile/test/input_lengths/static/correct")
+@pytest.mark.eip_checklist("precompile/test/input_lengths/static/too_short")
+@pytest.mark.eip_checklist("precompile/test/input_lengths/static/too_long")
 def test_invalid(state_test: StateTestFiller, pre: Alloc, post: dict, tx: Transaction):
     """Negative tests for the P256VERIFY precompile."""
     state_test(env=Environment(), pre=pre, post=post, tx=tx)
@@ -126,8 +126,8 @@ def test_invalid(state_test: StateTestFiller, pre: Alloc, post: dict, tx: Transa
     ],
 )
 @pytest.mark.parametrize("precompile_address", [Spec.P256VERIFY], ids=[""])
-@pytest.mark.eip_checklist("new_precompile/test/gas_usage/constant/exact")
-@pytest.mark.eip_checklist("new_precompile/test/gas_usage/constant/oog")
+@pytest.mark.eip_checklist("precompile/test/gas_usage/constant/exact")
+@pytest.mark.eip_checklist("precompile/test/gas_usage/constant/oog")
 def test_gas(state_test: StateTestFiller, pre: Alloc, post: dict, tx: Transaction):
     """Test P256Verify precompile gas requirements."""
     state_test(env=Environment(), pre=pre, post=post, tx=tx)
@@ -152,9 +152,9 @@ def test_gas(state_test: StateTestFiller, pre: Alloc, post: dict, tx: Transactio
     ],
 )
 @pytest.mark.parametrize("precompile_address", [Spec.P256VERIFY], ids=[""])
-@pytest.mark.eip_checklist("new_precompile/test/call_contexts/delegate")
-@pytest.mark.eip_checklist("new_precompile/test/call_contexts/static")
-@pytest.mark.eip_checklist("new_precompile/test/call_contexts/callcode")
+@pytest.mark.eip_checklist("precompile/test/call_contexts/delegate")
+@pytest.mark.eip_checklist("precompile/test/call_contexts/static")
+@pytest.mark.eip_checklist("precompile/test/call_contexts/callcode")
 def test_call_types(
     state_test: StateTestFiller,
     pre: Alloc,
@@ -176,7 +176,7 @@ def test_call_types(
         ),
     ],
 )
-@pytest.mark.eip_checklist("new_precompile/test/call_contexts/tx_entry")
+@pytest.mark.eip_checklist("precompile/test/call_contexts/tx_entry")
 def test_precompile_as_tx_entry_point(
     state_test: StateTestFiller,
     pre: Alloc,

osaka/eip7951_p256verify_precompiles/test_p256verify_before_fork.py

@@ -27,7 +27,7 @@
     ],
 )
 @pytest.mark.parametrize("expected_output,call_succeeds", [pytest.param(b"", True, id="")])
-@pytest.mark.eip_checklist("new_precompile/test/fork_transition/before/invalid_input")
+@pytest.mark.eip_checklist("precompile/test/fork_transition/before/invalid_input")
 def test_precompile_before_fork(
     state_test: StateTestFiller,
     pre: Alloc,

prague/eip7702_set_code_tx/test_set_code_txs.py

@@ -2522,7 +2522,7 @@ def test_set_code_to_log(
 
 @pytest.mark.with_all_call_opcodes
 @pytest.mark.with_all_precompiles
-@pytest.mark.eip_checklist("new_precompile/test/call_contexts/set_code", eips=[7951])
+@pytest.mark.eip_checklist("precompile/test/call_contexts/set_code", eips=[7951])
 def test_set_code_to_precompile(
     state_test: StateTestFiller,
     pre: Alloc,