Struct Record 

pub struct Record { /* private fields */ }

A single record in the event log.

Records are the on-disk representation of events. Each record contains an offset (logical position), a record kind, compression kind, the event payload, and is serialized with a CRC32 checksum for integrity.

Record Kinds

• RecordKind::Data: Normal application data
• RecordKind::Checkpoint: Periodic verification anchor
• RecordKind::Tombstone: Logical deletion marker

Implementations

impl Record

pub fn new(offset: Offset, prev_hash: Option<ChainHash>, payload: Bytes) -> Self

Creates a new data record with the given offset and payload (uncompressed).

pub fn with_kind( offset: Offset, prev_hash: Option<ChainHash>, kind: RecordKind, payload: Bytes, ) -> Self

Creates a new record with a specific kind (uncompressed).

pub fn with_compression( offset: Offset, prev_hash: Option<ChainHash>, kind: RecordKind, compression: CompressionKind, payload: Bytes, ) -> Self

Creates a new record with a specific kind and compression.

pub fn offset(&self) -> Offset

Returns the offset of this record.

pub fn prev_hash(&self) -> Option<ChainHash>

Returns the hash of the previous record, if any.

pub fn kind(&self) -> RecordKind

Returns the kind of this record.

pub fn compression(&self) -> CompressionKind

Returns the compression kind used for the payload.

pub fn payload(&self) -> &Bytes

Returns the payload of this record.

pub fn is_checkpoint(&self) -> bool

Returns true if this is a checkpoint record.

pub fn compute_hash(&self) -> ChainHash

Computes the hash of this record for chain linking.

The hash covers the kind byte and payload to ensure the record kind is part of the tamper-evident chain. The hash is computed over the original (uncompressed) payload.

pub fn to_bytes(&self) -> Vec<u8>

Serializes the record to bytes.

Format: [offset:u64][prev_hash:32B][kind:u8][compression:u8][length:u32][payload][crc32:u32]

All integers are little-endian.

pub fn to_bytes_into(&self, buf: &mut BytesMut)

Serializes the record into an existing BytesMut buffer (zero-copy path).

pub fn from_bytes(data: &Bytes) -> Result<(Self, usize), StorageError>

Deserializes a record from bytes.

Returns the parsed record and the number of bytes consumed. Uses zero-copy slicing for the payload via Bytes::slice.

AUDIT-2026-03 M-8: Detects torn writes via RECORD_END sentinel check.

Errors

• StorageError::UnexpectedEof if the data is truncated
• StorageError::CorruptedRecord if the CRC doesn’t match
• StorageError::TornWrite if RECORD_START or RECORD_END sentinel is missing
• StorageError::InvalidRecordKind if the kind byte is invalid
• StorageError::InvalidCompressionKind if the compression byte is invalid

Trait Implementations

impl Clone for Record

fn clone(&self) -> Record

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Record

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

Formats the value using the given formatter.

impl Hash for Record

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Record

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Record

impl StructuralPartialEq for Record