Skip to main content

DEFAULT_FINALIZED_BLOCKS_RETENTION

Constant DEFAULT_FINALIZED_BLOCKS_RETENTION 

Source
pub(crate) const DEFAULT_FINALIZED_BLOCKS_RETENTION: u64 = 16_384;
Expand description

Default number of finalized blocks (relative to reth’s finalized watermark) to keep cached in the prunable archive.

Beyond this depth, Hybrid falls back to looking up blocks from the execution layer.

The prunable archive evicts in PRUNABLE_ITEMS_PER_SECTION-sized batches (see hybrid’s “Section-rounding” docs). When reth is caught up to the marshal’s tip the cache holds between RETENTION and RETENTION + PRUNABLE_ITEMS_PER_SECTION − 1 items; if reth is lagging the marshal, the cache can hold more (it never drops blocks reth doesn’t yet have). The assertion below keeps the section overshoot small relative to RETENTION (current ratio: 4×).