tests: adds builder simulation test harness

[dylanlott]

tests: adds builder simulation test harness

• adds a builder test harness for simulating blocks that doesn't require network
  access and doesn't use alloy for test setup
• adds test scenario helpers for future setup and use
• updates claude files with specifics about using the test harness

[dylanlott]

• perf: add benchmarks for sim_round #242
• tests: add load tests to the cache ingestion and simulation loop #236
• tests: adds builder simulation test harness #219 👈 (View in Graphite)
• chore: adds claude setup #218
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[dylanlott]

This is a branch that claude had previously hammered out before samwise was introduced. Pushing this up to review so that samwise has a more established framework to add tests with.

[prestwich]

i like this direction :)

[prestwich]

what of these tools belong in the SDK to help direct testing of sim?

[dylanlott]

what of these tools belong in the SDK to help direct testing of sim?

​Most of this could go into the SDK. The parts I'd keep in the builder specifically are just around the test setup. The SDK has the test-utils crate, which would be a good place for the scenario code and generalized test harness code from this PR, taking steps towards making it more opinionated. The rest of the db and block code would go in signet-sim, I think.

[Fraser999]

We should probably gate the whole test_utils mod behind #[cfg(test)].

[prestwich]

[Claude Code]

Linking to Linear: ENG-1386 — Create a test harness for the builder

[dylanlott]

@Fraser999 I gated the test_utils mod behind #[cfg(test)] and have updated the other tests to match the convention instead of using the previous ignored convention.