docs: archive node shapes and configuration for 2.0 - #356
Merged
Conversation
LukaszRozmej
approved these changes
Sep 1, 2026
damian-orzechowski
approved these changes
Sep 1, 2026
stdevMac
approved these changes
Sep 1, 2026
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.
Documents the archive functionality shipping in 2.0 (NethermindEth/nethermind#12943), including the log and block query behavior below the pruning boundary from NethermindEth/nethermind#13036.
What it adds
fundamentals/archive-nodes.md: the three archive shapes (full, windowed, address-slice), howFlatDb.History*(historical state) andHistory.*(historical blocks and receipts) compose, a per-shape configuration table, fail-closed query semantics below the window, the receiptless variant (Receipt.DeriveFromState), and operational notes (fresh flat history requirement, slice depth validation, pruner pacing, every-block verification).fundamentals/history-pruning.md: short additions - sliced addresses keep receipts and bodies beyond the rolling window, rolling pruning publishes the boundary first and reclaims space in the background, and a pointer thatHistory.Pruningcovers blocks and receipts only while historical state has its own retention.performance-tuning.mdandprivate-networks.mdto make room for the new page after History pruning.Notes
release/2.0.0-rcbranch, not the PR description; the query behavior below the pruning boundary comes from Log index backfill through sliced receipt islands nethermind#13036, which lands in the release. Defaults are not duplicated into the pages; they stay in the generated options reference.FlatDb.History*andReceipt.DeriveFromStateanchors inconfiguration.mdthat will exist once the options reference is regenerated for 2.0 (same category of warning as the existing#sync-fastsynccatchupheightdeltaand#sync-nonvalidatornodeones).