Struct Stamper 

pub struct Stamper { /* private fields */ }

Client-side stamper that tracks per-bucket utilisation and signs envelopes for individual chunks.

Construct with Stamper::from_blank for a fresh batch or with Stamper::from_state to resume from previously persisted bucket counters.

Implementations

impl Stamper

pub fn from_blank( signer: PrivateKey, batch_id: BatchId, depth: u8, ) -> Result<Self, Error>

New stamper with empty buckets.

pub fn from_state( signer: PrivateKey, batch_id: BatchId, buckets: Vec<u32>, depth: u8, ) -> Result<Self, Error>

Resume a stamper from previously persisted bucket counters. buckets.len() must equal NUM_BUCKETS.

pub fn stamp(&mut self, chunk_addr: &[u8]) -> Result<Envelope, Error>

Stamp a chunk address. Increments the per-bucket counter and returns a freshly signed Envelope. Errors with Error::Argument if the bucket is full or the address length is wrong.

pub fn state(&self) -> &[u32]

Snapshot of the current bucket counters. Useful for persisting and resuming via Stamper::from_state.

pub fn depth(&self) -> u8

Configured depth.

pub fn max_slot(&self) -> u32

Maximum height per bucket (2^(depth - 16)).

pub fn batch_id(&self) -> &BatchId

Configured batch ID.

Trait Implementations

impl Clone for Stamper

fn clone(&self) -> Stamper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Stamper

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

Formats the value using the given formatter.