perf(op-interop-filter): prefetch blocks during ingestion

[karlfloersch]

Summary

• adds configurable --rpc-concurrency and --fetch-concurrency settings for op-interop-filter ingestion
• adds a bounded block prefetcher that overlaps RPC fetches while returning blocks in number order
• keeps logs DB writes, parent-hash checks, and executing-message processing on the existing sequential write path
• validates positive concurrency values and requires fetch-concurrency <= rpc-concurrency

Notes

• uses the PR perf(op-interop-filter): add concurrent block prefetch pipeline and FetchReceiptsByNumber #19993 CLI/API names and defaults: rpc-concurrency=100, fetch-concurrency=64
• intentionally does not include --linear-scan or startup scan behavior changes

Validation

• go test ./op-interop-filter/...
• go mod tidy -diff
• ./linter/bin/op-golangci-lint run ./...

[karlfloersch]

Tested the prefetch branch against mainnet OP + Unichain RPCs with fresh local DBs. RPC URLs intentionally omitted.

Functional smoke test:

• Filter came up cleanly with --rpc-concurrency 100 --fetch-concurrency 64.
• Backfilled and served queries for OP Mainnet and Unichain Mainnet.
• Spammer checks against the filter passed for unsafe and cross-unsafe query paths.
• No observed 429s, reorg handling errors, panics, failsafe activation, or ingestion failures in the test logs.

10-minute backfill A/B:

• Same binary, same machine, fresh data dirs per run.
• Networks: OP Mainnet + Unichain Mainnet.
• Serial baseline: --fetch-concurrency 1, --rpc-concurrency 100.
• Concurrent run: --fetch-concurrency 64, --rpc-concurrency 100.

Results:

Mode	Fetch concurrency	Backfill target	Time	Throughput
Serial	1	OP 301, Unichain 601	104.966s	8.59 blocks/s
Concurrent	64	OP 301, Unichain 602	3.365s	268.35 blocks/s

Observed speedup: about 31.2x for the backfill phase.

[codecov]

Codecov Report

❌ Patch coverage is 0% with 25 lines in your changes missing coverage. Please review.
✅ Project coverage is 0.5%. Comparing base (484be19) to head (4e52cde).
⚠️ Report is 5 commits behind head on develop.

Files with missing lines	Patch %	Lines
...protocol/derive/src/stages/channel/channel_bank.rs	0.0%	9 Missing ⚠️
rust/kona/crates/protocol/registry/src/lib.rs	0.0%	9 Missing ⚠️
...st/kona/crates/protocol/registry/src/superchain.rs	0.0%	5 Missing ⚠️
...ates/protocol/genesis/src/superchain/chain_list.rs	0.0%	2 Missing ⚠️

❗ There is a different number of reports uploaded between BASE (484be19) and HEAD (4e52cde). Click for more details.

HEAD has 13 uploads less than BASE

Flag	BASE (484be19)	HEAD (4e52cde)
cannon-go-tests-64	1	0
contracts-bedrock-tests	12	0

Additional details and impacted files

@@             Coverage Diff             @@
##           develop   #20398      +/-   ##
===========================================
- Coverage     76.4%     0.5%   -76.0%     
===========================================
  Files          186      487     +301     
  Lines        10691    62411   +51720     
===========================================
- Hits          8175      317    -7858     
- Misses        2372    62094   +59722     
+ Partials       144        0     -144     

Flag	Coverage Δ
cannon-go-tests-64	?
contracts-bedrock-tests	?
unit	0.5% <0.0%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
rust/kona/crates/node/peers/src/nodes.rs	0.0% <ø> (ø)
...ates/protocol/genesis/src/superchain/chain_list.rs	9.6% <0.0%> (ø)
...st/kona/crates/protocol/registry/src/superchain.rs	47.1% <0.0%> (ø)
...protocol/derive/src/stages/channel/channel_bank.rs	0.0% <0.0%> (ø)
rust/kona/crates/protocol/registry/src/lib.rs	38.8% <0.0%> (ø)

... and 668 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.