Struct Request 

pub struct Request { /* private fields */ }

Canonical Request used to derive a deterministic sequence of block hashes.

Construction validates mm_info (no overlap, no out-of-bounds, no zero-length) and sorts it by offset. The validated/sorted state is the only way to construct a Request, so all downstream block-formation code can trust the invariant.

Built via the owned RequestBuilder (no clones on the build path):

let request = Request::builder()
    .tokens(tokens)
    .lora_name(Some("lora-x".into()))
    .salt(Some("model-tag".into()))
    .mm_info(vec![/* RequestMmObjectInfo ... */])
    .build()?;

Implementations

impl Request

pub fn salt_hash(&self) -> Result<SaltHash, KvHashingError>

Returns the canonical SaltHash for this request.

pub fn into_blocks( &self, block_size: u32, ) -> Result<Vec<UniversalBlock>, KvHashingError>

Returns the rich per-block result.

One UniversalBlock per complete block_size-sized window in the request’s token stream (placeholder slots count toward block_size). A trailing partial block — fewer than block_size slots — is not hashed and not returned.

pub fn block_hashes( &self, block_size: u32, ) -> Result<Vec<BlockHash>, KvHashingError>

Projection: per-block BlockHash.

pub fn sequence_hashes( &self, block_size: u32, ) -> Result<Vec<SequenceHash>, KvHashingError>

Projection: per-block SequenceHash (parent-chained, derived from PLH).

pub fn positional_lineage_hashes( &self, block_size: u32, ) -> Result<Vec<PositionalLineageHash>, KvHashingError>

Projection: per-block PositionalLineageHash (the universal identifier).

impl Request

pub fn builder() -> RequestBuilder

Returns a fresh owned RequestBuilder.

pub fn tokens(&self) -> &[Token]

Returns the request tokens.

pub fn lora_name(&self) -> Option<&str>

Returns the LoRA adapter name, if any.

pub fn salt(&self) -> Option<&str>

Returns the free-form caller salt, if any.

pub fn mm_info(&self) -> &[RequestMmObjectInfo]

Returns the validated, sorted multimodal runs.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.