Struct ResolvedCheckpointRange 

pub struct ResolvedCheckpointRange {
    pub range: Range<u64>,
    pub exhaustion: RangeExhaustion,
    pub reaches_ledger_tip: bool,
}

A request’s checkpoint window resolved into the checkpoint-sequence interval to scan. Cursors do not narrow it: ResolvedScan::resolve applies them by scan position. Unlike ResolvedScan<u64>/ResolvedScan<IntraTxCoordinate>, the scan domain here is checkpoint space, so the entry and terminal checkpoints derive from range directly and need no extra fields.

Fields

range: Range<u64>

Half-open checkpoint-sequence interval to scan (numeric order; a descending scan walks it from end - 1 down to start).

exhaustion: RangeExhaustion

Why the interval is exhausted once the scan drains it.

reaches_ledger_tip: bool

Whether range.end is this server’s indexed tip rather than a bound the request set, so that a position at or past it is one this server has not indexed.

Implementations

impl ResolvedCheckpointRange

pub fn empty_at( checkpoint: u64, exhaustion: RangeExhaustion, reaches_ledger_tip: bool, ) -> Self

pub fn is_empty(&self) -> bool

pub fn terminal_checkpoint(&self, ordering: Ordering) -> u64

impl ResolvedCheckpointRange

pub fn from_request( start_checkpoint: Option<u64>, end_checkpoint: Option<u64>, checkpoint_hi_exclusive: u64, options: &QueryOptions, ) -> Result<Self, RpcError>

Validate the requested checkpoint window, clamp it to the indexed tip, and attribute the exhaustion reason the scan will report once it drains it.

A descending window that reaches past the tip returns OutOfRange: an end_checkpoint above the tip, or, with end_checkpoint unset, a start_checkpoint at or above it. A descending scan starts at its window’s high end, so answering from this view would skip the checkpoints between the tip and that end; like a cursor past the tip, the request becomes servable once this server catches up. An ascending window past the tip ends at the tip, where the client resumes once this server has caught up, so only an ascending scan ends with LedgerTip.

The request’s cursors do not narrow the window here. A cursor’s checkpoint field is a label whose meaning depends on the scan that issued it, so ResolvedScan::resolve bounds the scan by the cursors’ positions and reads the fields only to label checkpoints.

Trait Implementations

impl Clone for ResolvedCheckpointRange

fn clone(&self) -> ResolvedCheckpointRange

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResolvedCheckpointRange

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ResolvedCheckpointRange

impl PartialEq for ResolvedCheckpointRange

fn eq(&self, other: &ResolvedCheckpointRange) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ResolvedCheckpointRange