Enum TimeRangeSelector 

pub enum TimeRangeSelector {
    Newest,
    Oldest,
    ByStart {
        start_ms: u64,
    },
}

Which window of a timeRange grid an IN_TIME_RANGE selection resolves to. Time-range queries are a v1-only feature; the v0 query surface is unaffected.

The two relative selectors are resolved against an authoritative “now” (block time on the server, the quorum-signed metadata time on the verifier); Self::ByStart names a window absolutely, so its resolution reads the query alone and needs no clock at all — which is what makes historic windows addressable.

Variants

Newest

The freshest started range (largest start ≤ now). Covers the latest partial slice (0..step of history).

Oldest

The oldest range still active at now. Covers a near-full trailing window of ~range of history. Best for “trending over the last window”.

ByStart

The range starting exactly at start_ms (a millisecond timestamp). Must lie on the grid — phase + k * step, the same values [TimeRangeTransform::containing_buckets] produces and the storage keys spell — or resolution rejects it (see [TimeRangeTransform::is_bucket_start]). A window with no documents, including one that has not started yet, is a provable empty answer rather than an error.

Fields

start_ms: u64

The selected window’s start on the millisecond timeline.

Implementations

impl TimeRangeSelector

pub fn as_str(&self) -> &'static str

The selector’s JSON spelling — the selector string of the wasm-sdk query surface. The single source of truth for the string form: the wasm-sdk JSON parser and every error message quote these spellings. (The gRPC wire does not use them: since the typed TimeRangeSelection operand, the selector rides as a proto enum.)

Self::ByStart names its kind only — the start_ms payload rides in a separate JSON field, so Self::from_string cannot construct it and parsers of the full shape handle it themselves.

pub fn from_string(value: &str) -> Option<Self>

Parses the spelling of the payload-free selectors. Returns None for anything else — including "byStart", whose start_ms payload a bare string cannot carry (see Self::as_str).

Trait Implementations

impl Clone for TimeRangeSelector

fn clone(&self) -> TimeRangeSelector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TimeRangeSelector

impl Debug for TimeRangeSelector

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TimeRangeSelector

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TimeRangeSelector

impl PartialEq for TimeRangeSelector

fn eq(&self, other: &TimeRangeSelector) -> 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 Serialize for TimeRangeSelector

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TimeRangeSelector