Struct BlockHasher 

pub struct BlockHasher { /* private fields */ }

Hashes blocks for one (model, extra_keys) identity. Cheap to build; the root is computed once and reused for every chain.

Implementations

impl BlockHasher

pub fn new<S: AsRef<str>>(model: impl Into<String>, extra_keys: &[S]) -> Self

model should identify the weights, not the file path – two servers on different machines must agree on it for a shared or restored cache to be reusable at all.

extra_keys are ordered: they are hashed in the order given, so callers must be consistent (sort them if the source is a set).

pub fn root(&self) -> BlockHash

The seed every chain starts from: the identity of “no tokens yet, under this model and these extra keys”. A chain rooted here can never be confused with one rooted under a different model or a different LoRA.

pub fn model(&self) -> &str

pub fn extra_keys(&self) -> &[String]

pub fn block(&self, parent: &BlockHash, token_ids: &[usize]) -> BlockHash

Hashes one block: this token run, following parent.

model and extra_keys are folded in again even though the parent chain already carries them, so a single block hash is verifiable from (parent, tokens) alone without walking back to the root.

pub fn chain(&self, tokens: &[usize], block_size: usize) -> Vec<BlockHash>

Hashes tokens as a chain of block_size-token blocks, rooted at root.

Only whole blocks are hashed. A trailing partial block gets no hash: its content is still growing, so any identity assigned to it now would name a different token run a moment later. full_blocks reports how many hashes a length yields.

Because each block’s hash covers its parent, the chain of a prompt is a strict prefix of the chain of anything that extends it – which is exactly the lookup a prefix cache needs.

Trait Implementations

impl Clone for BlockHasher

fn clone(&self) -> BlockHasher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlockHasher

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

Formats the value using the given formatter.