Struct StateSnapshot 

pub struct StateSnapshot { /* private fields */ }

A snapshot of state store contents for checkpointing.

Snapshots can be serialized for persistence and restored later. They capture the complete state at a point in time.

Uses rkyv for zero-copy deserialization on the hot path.

Implementations

impl StateSnapshot

pub fn new(data: Vec<(Vec<u8>, Vec<u8>)>) -> Self

Create a new snapshot from key-value pairs.

pub fn data(&self) -> &[(Vec<u8>, Vec<u8>)]

Get the snapshot data.

pub fn timestamp_ns(&self) -> u64

Get the snapshot timestamp.

pub fn len(&self) -> usize

Get the number of entries in the snapshot.

pub fn is_empty(&self) -> bool

Check if the snapshot is empty.

pub fn size_bytes(&self) -> usize

Get the approximate size in bytes.

pub fn to_bytes(&self) -> Result<AlignedVec, StateError>

Serialize the snapshot to bytes using rkyv.

Returns an aligned byte vector for optimal zero-copy access.

Errors

Returns an error if serialization fails.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, StateError>

Deserialize a snapshot from bytes using rkyv.

Uses zero-copy access internally for performance.

Errors

Returns an error if deserialization fails.

Trait Implementations

impl Archive for StateSnapshot

where Vec<(Vec<u8>, Vec<u8>)>: Archive, u64: Archive, u32: Archive,

const COPY_OPTIMIZATION: CopyOptimization<Self>

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize.

type Archived = ArchivedStateSnapshot

The archived representation of this type.

type Resolver = StateSnapshotResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve(&self, resolver: Self::Resolver, out: Place<Self::Archived>)

Creates the archived version of this value at the given position and writes it to the given output.

impl Clone for StateSnapshot

fn clone(&self) -> StateSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateSnapshot

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

Formats the value using the given formatter.

impl<__D: Fallible + ?Sized> Deserialize<StateSnapshot, __D> for Archived<StateSnapshot>

where Vec<(Vec<u8>, Vec<u8>)>: Archive, <Vec<(Vec<u8>, Vec<u8>)> as Archive>::Archived: Deserialize<Vec<(Vec<u8>, Vec<u8>)>, __D>, u64: Archive, <u64 as Archive>::Archived: Deserialize<u64, __D>, u32: Archive, <u32 as Archive>::Archived: Deserialize<u32, __D>,

fn deserialize( &self, deserializer: &mut __D, ) -> Result<StateSnapshot, <__D as Fallible>::Error>

Deserializes using the given deserializer

impl<__S: Fallible + ?Sized> Serialize<__S> for StateSnapshot

where Vec<(Vec<u8>, Vec<u8>)>: Serialize<__S>, u64: Serialize<__S>, u32: Serialize<__S>,

fn serialize( &self, serializer: &mut __S, ) -> Result<<Self as Archive>::Resolver, <__S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.