Skip to content

sgns::PruneStatus

Queryable pruning status (RECL-04). More...

#include <TxPruner.hpp>

Public Attributes

Name
std::optional< uint64_t > watermark
PruneCycleStats last_cycle

Detailed Description

struct sgns::PruneStatus;

Queryable pruning status (RECL-04).

A COPY is returned under the status mutex — concurrent reads are safe while a cycle runs. There is deliberately NO bytes_reclaimed field: byte reclamation is unmeasured until Phase 20's explicit CompactRange proof (deletes alone reclaim nothing) — the status never carries a fabricated number.

Public Attributes Documentation

variable watermark

std::optional< uint64_t > watermark;

The maxHeight (GlobalDB::GetCRDTHeadList) of the LAST cycle that ran to completion without hard error — monotonic (never regresses). K exhaustion, skips, and per-tx errors never block advancement; aborted/interrupted cycles never advance it. nullopt until the first completed cycle.

variable last_cycle

PruneCycleStats last_cycle;

Counters of the last cycle that updated the status (gate-skipped ticks and interrupted cycles leave the previous value in place).


Updated on 2026-10-22 at 19:28:22 +0000