Skip to content

docs: add troubleshooting section for MissingL1InfoDeposit error with pruned snapshots#1126

Open
Kewe63 wants to merge 4 commits into
base:mainfrom
Kewe63:fix-snapshot-consensus-l1info
Open

docs: add troubleshooting section for MissingL1InfoDeposit error with pruned snapshots#1126
Kewe63 wants to merge 4 commits into
base:mainfrom
Kewe63:fix-snapshot-consensus-l1info

Conversation

@Kewe63
Copy link
Copy Markdown

@Kewe63 Kewe63 commented Jun 6, 2026

Description

Adds a new troubleshooting subsection to the README covering the EngineReset(SyncStart(FromBlock(MissingL1InfoDeposit(...)))) error that users may encounter when syncing a Base node from a pruned snapshot that lacks sufficient historical data for consensus client initialization.


Problem

Users syncing from an older pruned snapshot may experience a consensus client crash with a MissingL1InfoDeposit error for a specific block hash. Pruned snapshots discard historic state, and if the snapshot predates the early blocks required for deposit contract verification, the consensus client cannot complete initialization.


Solution

The added subsection explains the root cause and provides clear, actionable remediation steps:

  1. Check the block number associated with the snapshot to determine its age.
  2. If the snapshot is older than ~40 days (approximately block 45,000,000 as of mid-2026), download a fresh snapshot from the official snapshots page.
  3. Alternatively, delete the snapshot data directory and allow the node to sync from genesis — slower, but guarantees completeness.
  4. Confirm that both execution and consensus clients point to the same data directory (/data by default).

An example command block for clearing data and restarting the node is included.


Test Results

  • Documentation-only change; no code or configuration is modified.
  • New subsection renders correctly (verified locally via cat and visual inspection).
  • No broken links or formatting issues introduced.
  • Existing document structure and styling remain intact.

Risk

None. This is a documentation addition only and has no effect on the node software, build process, or runtime behavior.

@cb-heimdall
Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

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.

2 participants