Struct RangeFrame 

pub struct RangeFrame {
    pub offset: u64,
    pub length: u64,
    pub bytes: String,
    pub complete: bool,
    pub total_length: Option<u64>,
    pub chunk_lens: Option<Vec<u64>>,
    pub chunk_index: Option<u64>,
    pub inclusion_proof: Option<String>,
    pub root: Option<HexId>,
    pub range_proof: Option<Vec<String>>,
    pub first_chunk_index: Option<u64>,
}

One range frame of a resource. The first frame (offset == 0) carries the per-resource verification metadata; later frames carry only the window.

Fields

offset: u64

The window start offset (echoed).

length: u64

This window’s byte length.

bytes: String

This window’s ciphertext, base64.

complete: bool

Whether this frame ends the resource.

total_length: Option<u64>

The full resource ciphertext length. First frame only.

chunk_lens: Option<Vec<u64>>

Per-chunk ciphertext lengths of the full resource. First frame only.

chunk_index: Option<u64>

This frame’s chunk index. First frame only (0).

inclusion_proof: Option<String>

Whole-resource merkle proof, base64. First frame only.

root: Option<HexId>

The chain-anchored root (64-hex). First frame only.

Advisory ECHO only. A verifier MUST NOT trust this value: it substitutes its OWN URN-pinned root when folding range_proof and rejects any frame whose proof does not reach that pinned root (NC-9 fail-closed).

range_proof: Option<Vec<String>>

Per-chunk merkle inclusion proofs for the chunks this frame covers, in ascending chunk order — present on ANY frame, unlike the first-frame-only whole-resource inclusion_proof.

Each entry is base64 of an opaque per-chunk merkle proof blob (the canonical node emits dig_capsule::MerkleProof::encode). This crate is a pure level-00 wire type and MUST NOT depend on the merkle primitive, so the proof stays an opaque string here; the consumer decodes each blob and folds its leaf → the client’s PINNED root (never the peer’s echoed root) to verify the chunk.

The server expands a requested byte range to the covering whole-chunk span, so a frame’s chunks align with chunk_lens; range_proof.len() equals the number of chunks in this frame and pairs index-for-index with first_chunk_index...

first_chunk_index: Option<u64>

The chunk index of the first chunk in this frame (0-based, into the resource’s chunk sequence described by chunk_lens).

With range_proof.len() this pins each entry of range_proof to an absolute chunk index, giving the full byte↔chunk↔proof mapping.

Trait Implementations

impl Clone for RangeFrame

fn clone(&self) -> RangeFrame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RangeFrame

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RangeFrame

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RangeFrame

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RangeFrame

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 RangeFrame