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.
enum WireError
Section titled “enum WireError”pub
Errors that can occur during wire serialization or deserialization.
Variants
Section titled “Variants”Bincode- Bincode serialization/deserialization error.
Functions
Section titled “Functions”fn serialize
Section titled “fn serialize”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)}fn deserialize
Section titled “fn deserialize”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)}fn serialized_size
Section titled “fn serialized_size”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)}fn serialize_into
Section titled “fn serialize_into”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)}