docs: add Flashblocks troubleshooting section for common node operator issues#1267
Open
Cloakie47 wants to merge 1 commit intobase:masterfrom
Open
docs: add Flashblocks troubleshooting section for common node operator issues#1267Cloakie47 wants to merge 1 commit intobase:masterfrom
Cloakie47 wants to merge 1 commit intobase:masterfrom
Conversation
Added troubleshooting information for Flashblocks issues, including causes and actions for various error messages.
Collaborator
🟡 Heimdall Review Status
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The current node troubleshooting page covers general setup, syncing, performance, and snapshot issues but has no coverage of Flashblocks-specific errors that node operators commonly hit.
What changed? Why?
Added a new Flashblocks Issues section covering four common errors that have no documentation currently:
missing canonical headerrace condition error, very common after restart or snapshot restoration, operators need to know it's safe to ignore briefly and what causes itNo pong response from upstreamWebSocket timeout, the default 500ms acts as both ping interval and pong timeout which is too aggressive, increasing to 1000-1500ms resolves itAll four of these are real issues that node operators have reported with no existing documentation to help them diagnose or resolve.
Notes to reviewers
Docs-only change, no code modified. All issues documented are based on real reported behavior from node operators.
How has it been tested?
All four issues have been reproduced and confirmed by multiple node operators. The workarounds documented have been verified to resolve the issues.