Struct FileHeader 

pub struct FileHeader {
    pub magic: [u8; 4],
    pub version: u16,
    pub flags: u16,
    pub data_length: u64,
    pub crc32: u32,
    pub blake3_hash: [u8; 32],
}

File header for .acomm format.

Supports both v2 (CRC32, 20-byte header) and v3 (Blake3, 48-byte header).

Fields

magic: [u8; 4]

version: u16

flags: u16

data_length: u64

crc32: u32

CRC32 checksum (used in v2 only).

blake3_hash: [u8; 32]

Blake3 hash (used in v3+).

Implementations

impl FileHeader

pub const SIZE_V3: usize

Header size for v3 (Blake3): magic(4) + version(2) + flags(2) + data_length(8) + blake3(32) = 48.

pub const SIZE_V2: usize

Header size for v2 (CRC32): magic(4) + version(2) + flags(2) + data_length(8) + crc32(4) = 20.

pub const SIZE: usize = Self::SIZE_V3

Default header size (current version = v3).

pub fn new(data: &[u8]) -> Self

Create a new v3 header (Blake3) for the given data.

pub fn new_with_flags(data: &[u8], flags: u16) -> Self

Create a new v3 header (Blake3) with explicit flags.

pub fn new_legacy(data: &[u8]) -> Self

Create a legacy v2 header (CRC32) for the given data.

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

Serialize header to bytes.

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

Parse header from bytes, auto-detecting version for correct layout.

pub fn header_size(&self) -> usize

Return the header size for this version.

pub fn verify(&self, data: &[u8]) -> bool

Verify integrity of data against the stored hash/checksum.

pub fn verify_crc(&self, data: &[u8]) -> bool

Verify CRC32 of data matches header (v2 legacy).

pub fn verify_blake3(&self, data: &[u8]) -> bool

Verify Blake3 hash of data matches header (v3+).

pub fn is_zstd(&self) -> bool

Returns true if the payload is Zstd-compressed (FLAG_ZSTD set).

Trait Implementations

impl Clone for FileHeader

fn clone(&self) -> FileHeader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileHeader

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

Formats the value using the given formatter.