Skip to content

kona-node: add verifier L1 confirmation depth - #23696

Merged
joshklop merged 4 commits into
developfrom
codex/kona-verifier-l1-confs
Oct 29, 2026
Merged

joshklop merged 4 commits into
developfrom
codex/kona-verifier-l1-confs

Conversation

@joshklop

@joshklop joshklop commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Kona derives through the L1 tip and lacks op-node’s configurable delay, so shallow L1 reorgs can trigger recovery while Go peers configured with confirmations continue deriving. Add --verifier.l1-confs / KONA_NODE_VERIFIER_L1_CONFS to delay online derivation in both validator and sequencer modes. The default is 0, matching op-node; setting it to 4 keeps derivation four blocks behind the observed L1 head.

This PR is independent of #23548 and replaces the checkpoint-retention approach in #23673. Recovery correctness remains in #23548. Related to protocol-team#328.

The Go/Kona acceptance test replaces a consumed L1 tip at zero confirmations and an unconsumed tip at four confirmations, then checks canonical derivation, reset behavior, and safe-chain recovery. Standard acceptance-suite discovery runs both clients together in the op-node CI variant; the Kona variant skips the duplicate fixed fixture. No CI configuration changes are needed. Reset initialization retains canonical L1 resolution even inside the confirmation window.

Validation: all 491 affected Rust tests pass with all features and zero skips, along with full Rust lint and all proof-platform/no_std checks. The live Go/Kona reorg acceptance test passes on this PR alone: each client resets once at depth 0 and neither resets at depth 4. Full Go lint and upstream API checks pass; independent Rust, Go, and CI reviews find no remaining issues.

teddyknox
teddyknox previously approved these changes Oct 29, 2026
@joshklop

Copy link
Copy Markdown
Contributor Author

@OptimismBot re-approve

OptimismBot
OptimismBot previously approved these changes Oct 29, 2026

@OptimismBot OptimismBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-approved after reviewing the semantic delta since the latest eligible human approval.

@joshklop

Copy link
Copy Markdown
Contributor Author

@OptimismBot re-approve

@OptimismBot OptimismBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-approved after reviewing the semantic delta since the latest eligible human approval.

@joshklop
joshklop requested a review from teddyknox October 29, 2026 16:38
@joshklop
joshklop enabled auto-merge October 29, 2026 16:59
@joshklop
joshklop disabled auto-merge October 29, 2026 19:20
@joshklop
joshklop added this pull request to the merge queue Oct 29, 2026
Merged via the queue into develop with commit 7e4c551 Oct 29, 2026
122 checks passed
@joshklop
joshklop deleted the codex/kona-verifier-l1-confs branch October 29, 2026 19:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants