Struct CacheSignature 

pub struct CacheSignature {
    pub format_version: u32,
    pub model: String,
    pub n_layers: usize,
    pub n_kv_heads: usize,
    pub head_dim: usize,
    pub dtype: KvDtype,
    pub tokens: usize,
    pub layout: BlockLayout,
}

What a block’s payload is: the shape any reader must match to use it. Construct it from a payload with Self::from_payload, or as a reader’s requirement with Self::expected.

Fields

format_version: u32

model: String

Identifies the weights the KV state was computed under. The one field no payload can prove about itself – which is exactly why it is checked against the reader’s expectation in step 3.

n_layers: usize

n_kv_heads: usize

head_dim: usize

dtype: KvDtype

tokens: usize

Token positions actually stored, per layer. Equal to layout.block_size() for any block this module will stamp or verify.

layout: BlockLayout

How the sequence was cut into blocks, and the sliding window that cut had to line up with. See the module note.

Implementations

impl CacheSignature

pub fn from_payload( model: &str, layout: BlockLayout, layers: &[KvCache], ) -> Result<Self, SignatureError>

Derives a signature by measuring layers. There is deliberately no parameter to fill a gap from: every shape field except model and the sliding window comes from the tensors themselves, and even the declared layout’s block size is checked against the depth the tensors actually have.

Fails if the payload cannot describe itself coherently: no layers at all, layers that disagree with each other, a layer whose buffers do not match its own declared shape, or a token depth that is not the block size the layout claims.

pub fn expected( model: &str, layout: BlockLayout, n_layers: usize, n_kv_heads: usize, head_dim: usize, tokens: usize, ) -> Self

A reader’s requirement: the shape this process would compute itself. Never stamped onto a block – only compared against one.

Trait Implementations

impl Clone for CacheSignature

fn clone(&self) -> CacheSignature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheSignature

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

Formats the value using the given formatter.

impl Eq for CacheSignature

impl PartialEq for CacheSignature

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CacheSignature