refactor(all): modernize codebase with python 3.11 features

[danceratopz]

🗒️ Description

This PR modernizes the EEST codebase to leverage Python 3.11+ language features (and some neglected 3.10 features) for improved performance, readability, type safety, and security.

🔧 Python 3.11+ Specific Features

1. TypeVar → Self Pattern (7 instances)

Benefits: Eliminates boilerplate TypeVar declarations, improves type safety, and makes method signatures cleaner and more intuitive.

Replace TypeVar bound patterns with Self type for cleaner method signatures:

# Before
T = TypeVar("T", bound="BaseTest")
def from_test(cls: Type[T], **kwargs) -> T:

# After  
def from_test(cls: Type[Self], **kwargs) -> Self:

2. String removeprefix/removesuffix (6 instances)

Benefits: More readable and explicit about intent, slightly more performant (avoids len() calculations), and reduces potential off-by-one errors in manual slicing.

Replace manual string slicing with explicit prefix/suffix removal:

# Before
if pattern.startswith("collectonly:"):
    return pattern[len("collectonly:"):]

# After
if pattern.startswith("collectonly:"):
    return pattern.removeprefix("collectonly:")

3. dataclass slots=True Optimization (3 instances)

Benefits: Reduces memory footprint (up to 40% less memory per instance), faster attribute access, and prevents accidental dynamic attribute assignment.

Add memory-efficient slots to high-frequency dataclasses:

# Before
@dataclass
class Trie(Generic[K, V]):

# After
@dataclass(slots=True) 
class Trie(Generic[K, V]):

4. Enum → StrEnum (4 enum classes)

Benefits: Better type safety for string-based enums, cleaner string conversion without .value, and more explicit semantics for enums that represent string constants.

Convert string-based enums for better type safety:

# Before
class ExecutionContext(Enum):
    BLOCK = "Block"

# After
class ExecutionContext(StrEnum):
    BLOCK = "Block"

5. LiteralString for Security (3 critical areas)

Benefits: Prevents command injection vulnerabilities, enhances static analysis for security-sensitive code, and provides compile-time validation of subprocess arguments.

Secure subprocess command construction with LiteralString validation:

# Before
check_cmd = ["docker", "exec", container_id, "test", "-f", container_path]
result = subprocess.run(check_cmd, capture_output=True)

# After
def safe_docker_exec(container_id: str, command: LiteralString, *args: LiteralString) -> list[str]:
    return ["docker", "exec", container_id, command] + list(args)

check_cmd = safe_docker_exec(container_id, "test", "-f", container_path)
result = subprocess.run(check_cmd, capture_output=True)

🔄 Other Modern Python Improvements Applied

isinstance → match-case (2 functions, Python 3.10+)

Benefits: More readable pattern matching, better performance for complex type checking, and enables exhaustiveness checking for better maintainability.

Convert type checking chains to pattern matching:

# Before
if isinstance(node, LeafNode):
    # handle LeafNode
elif isinstance(node, ExtensionNode):
    # handle ExtensionNode

# After
match node:
    case LeafNode():
        # handle LeafNode
    case ExtensionNode():
        # handle ExtensionNode

Union type syntax modernization (25+ instances, Python 3.10+)

Benefits: More concise and readable type annotations, reduced import dependencies, and more intuitive union syntax.

Convert Union types to modern pipe syntax:

# Before
from typing import Union
BlockNumberType = Union[int, Literal["latest", "earliest", "pending"]]

# After
BlockNumberType = int | Literal["latest", "earliest", "pending"]

📊 Summary Stats

• Files Modified: 12+ files across the codebase
• Type Annotations: 30+ modern type hints applied
• Security Patterns: 3 critical subprocess areas secured (Docker, Solc, T8N)
• Performance Optimizations: 3 dataclass slots applied
• String Operations: 6 removeprefix/removesuffix modernizations
• Pattern Matching: 2 isinstance chains converted to match-case
• Enum Improvements: 4 string-based enums converted to StrEnum
• Union Syntax: 25+ Union type annotations modernized

🔗 Related Issues or PRs

Follow-up to:

• chore(all): remove python 3.10 support #1808

✅ Checklist

• All: Ran fast tox checks to avoid unnecessary CI fails, see also Code Standards and Enabling Pre-commit Checks:

  uvx --with=tox-uv tox -e lint,typecheck,spellcheck,markdownlint

• All: PR title adheres to the repo standard - it will be used as the squash commit message and should start type(scope):.
• All: Considered adding an entry to CHANGELOG.md.
• All: Considered updating the online docs in the ./docs/ directory.
• All: Set appropriate labels for the changes (only maintainers can apply labels).

[marioevz]

Awesome, thanks!

I've added the coverage_missed and rebased, so CI should pass now.