Skip to content

fidius-guest::wire

Rust

Wire format serialization for Fidius plugin FFI boundary.

Fidius uses bincode as the single wire format for all FFI data. Prior to 0.1.0 the format varied by build profile (JSON in debug, bincode in release) — that was removed because profile-mixed host/plugin load rejections caused repeated dev-loop friction with no real inspection benefit to offset them.

pub

Errors that can occur during wire serialization or deserialization.

  • Bincode - Bincode serialization/deserialization error.

pub

fn serialize<T: Serialize>(val: &T) -> Result<Vec<u8>, WireError>

Serialize a value as bincode for transport across the FFI boundary.

Source
pub fn serialize<T: Serialize>(val: &T) -> Result<Vec<u8>, WireError> {
bincode::serialize(val).map_err(WireError::Bincode)
}

pub

fn deserialize<T: DeserializeOwned>(
bytes: &[u8],
) -> Result<T, WireError>

Deserialize a value from bincode bytes received across the FFI boundary.

Source
pub fn deserialize<T: DeserializeOwned>(bytes: &[u8]) -> Result<T, WireError> {
bincode::deserialize(bytes).map_err(WireError::Bincode)
}

pub

fn serialized_size<T: Serialize>(val: &T) -> Result<u64, WireError>

The exact serialized size of val in bytes, without allocating. Matches serialize’s output length. Used to size/validate a buffer before serialize_into (e.g. the cdylib streaming arena path, FIDIUS-T-0138).

Source
pub fn serialized_size<T: Serialize>(val: &T) -> Result<u64, WireError> {
bincode::serialized_size(val).map_err(WireError::Bincode)
}

pub

fn serialize_into<T: Serialize>(
buf: &mut [u8]) -> Result<(,
val: &T) -> Result<(,
) -> Result<(), WireError>

Serialize val directly into a caller-provided buffer — no intermediate Vec allocation. buf must be at least serialized_size bytes (bincode errors otherwise). Byte-identical to serialize.

Source
pub fn serialize_into<T: Serialize>(buf: &mut [u8], val: &T) -> Result<(), WireError> {
bincode::serialize_into(buf, val).map_err(WireError::Bincode)
}