Skip to main content

RESTORE_FUEL

Constant RESTORE_FUEL 

Source
const RESTORE_FUEL: i64 = 1_000_000;
Expand description

Fuel for restoring the bucket chain invariant after peeling.

Bounds the restoration work per buffer operation. The bucket chain remains functional when restoration is incomplete – peeling and finding work on ill-formed chains, at the cost of more in-line splitting – so leftover restoration is simply picked up by the next operation.

restore spends one unit of fuel per bucket split, and a single peel leaves at most BucketTimestamp::DOMAIN (64) buckets to re-split, so this budget completes restoration in one call for any realistic buffer. It is deliberately generous: the “incomplete restoration is picked up next op” path is a correctness safety net for pathological bucket counts, not a hot path we expect to exercise. Lower it if restoration ever needs to interleave with other work.