Trait Deserializable

Source

pub trait Deserializable: Sized {
    // Required method
    fn read_from<R>(source: &mut R) -> Result<Self, DeserializationError>
       where R: ByteReader;

    // Provided methods
    fn min_serialized_size() -> usize { ... }
    fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError> { ... }
    fn read_from_bytes_with_budget(
        bytes: &[u8],
        budget: usize,
    ) -> Result<Self, DeserializationError> { ... }
}

Expand description

Re-export the entire miden_client crate so external projects can use a single dependency. Defines how to deserialize Self from bytes.

Required Methods§

Source

fn read_from<R>(source: &mut R) -> Result<Self, DeserializationError>
where R: ByteReader,

Reads a sequence of bytes from the provided source, attempts to deserialize these bytes into Self, and returns the result.

§Errors

Returns an error if:

The source does not contain enough bytes to deserialize Self.
Bytes read from the source do not represent a valid value for Self.

Provided Methods§

Source

fn min_serialized_size() -> usize

Returns the minimum serialized size for one instance of this type.

This is used by ByteReader::max_alloc to estimate how many elements can be deserialized from the remaining budget, preventing denial-of-service attacks from malicious length prefixes.

The default implementation returns size_of::<Self>(), which is conservative: it may reject valid input for types where the serialized size is smaller than the in-memory size (e.g., structs with computed/cached fields that aren’t serialized).

Override this method for types where the serialized representation is smaller than the in-memory representation to allow more elements to be deserialized.

Source

fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

Attempts to deserialize the provided bytes into Self and returns the result.

§Errors

Returns an error if:

The bytes do not contain enough information to deserialize Self.
The bytes do not represent a valid value for Self.

Note: if bytes contains more data than needed to deserialize self, no error is returned.

Source

fn read_from_bytes_with_budget( bytes: &[u8], budget: usize, ) -> Result<Self, DeserializationError>

Deserializes Self from bytes with a byte budget limit.

This is the recommended method for deserializing untrusted input. The budget limits how many bytes can be consumed during deserialization, preventing denial-of-service attacks that exploit length fields to cause huge allocations.

§Errors

Returns an error if:

The budget is exhausted before deserialization completes.
The bytes do not contain enough information to deserialize Self.
The bytes do not represent a valid value for Self.

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Trait Deserializable Copy item path

Required Methods§

fn read_from<R>(source: &mut R) -> Result<Self, DeserializationError>where R: ByteReader,

§Errors

Provided Methods§

fn min_serialized_size() -> usize

fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

§Errors

fn read_from_bytes_with_budget( bytes: &[u8], budget: usize, ) -> Result<Self, DeserializationError>

§Errors

Dyn Compatibility§

Implementations on Foreign Types§

impl Deserializable for Attribute

fn read_from<R>(source: &mut R) -> Result<Attribute, DeserializationError>where R: ByteReader,

impl Deserializable for MetaExpr

fn read_from<R>(source: &mut R) -> Result<MetaExpr, DeserializationError>where R: ByteReader,

impl Deserializable for ConstantOp

fn read_from<R>(source: &mut R) -> Result<ConstantOp, DeserializationError>where R: ByteReader,

impl Deserializable for HashKind

fn read_from<R>(source: &mut R) -> Result<HashKind, DeserializationError>where R: ByteReader,

impl Deserializable for ConstantValue

fn read_from<R>(source: &mut R) -> Result<ConstantValue, DeserializationError>where R: ByteReader,

impl Deserializable for IntValue

fn read_from<R>(source: &mut R) -> Result<IntValue, DeserializationError>where R: ByteReader,

impl Deserializable for DebugVarLocation

fn read_from<R>( source: &mut R, ) -> Result<DebugVarLocation, DeserializationError>where R: ByteReader,

impl Deserializable for Operation

fn min_serialized_size() -> usize

fn read_from<R>(source: &mut R) -> Result<Operation, DeserializationError>where R: ByteReader,

impl Deserializable for HashFunction

fn read_from<R>(source: &mut R) -> Result<HashFunction, DeserializationError>where R: ByteReader,

impl Deserializable for SealingKey

fn read_from<R>(source: &mut R) -> Result<SealingKey, DeserializationError>where R: ByteReader,

impl Deserializable for UnsealingKey

fn read_from<R>(source: &mut R) -> Result<UnsealingKey, DeserializationError>where R: ByteReader,

impl Deserializable for NodeMutation

fn read_from<R>(source: &mut R) -> Result<NodeMutation, DeserializationError>where R: ByteReader,

impl Deserializable for DebugTypeInfo

fn read_from<R>(source: &mut R) -> Result<DebugTypeInfo, DeserializationError>where R: ByteReader,

impl Deserializable for Linkage

fn read_from<R>(source: &mut R) -> Result<Linkage, DeserializationError>where R: ByteReader,

impl Deserializable for WordSchema

fn read_from<R>(source: &mut R) -> Result<WordSchema, DeserializationError>where R: ByteReader,

impl Deserializable for AccountUpdateDetails

fn read_from<R>( source: &mut R, ) -> Result<AccountUpdateDetails, DeserializationError>where R: ByteReader,

impl Deserializable for StorageSlotDelta

fn read_from<R>( source: &mut R, ) -> Result<StorageSlotDelta, DeserializationError>where R: ByteReader,

impl Deserializable for AssetCallbackFlag

fn read_from<R>( source: &mut R, ) -> Result<AssetCallbackFlag, DeserializationError>where R: ByteReader,

impl Deserializable for NoteAttachmentContent

fn read_from<R>( source: &mut R, ) -> Result<NoteAttachmentContent, DeserializationError>where R: ByteReader,

impl Deserializable for Type

fn read_from<R>(source: &mut R) -> Result<Type, DeserializationError>where R: ByteReader,

impl Deserializable for u8

fn read_from<R>(source: &mut R) -> Result<u8, DeserializationError>where R: ByteReader,

impl Deserializable for u16

fn read_from<R>(source: &mut R) -> Result<u16, DeserializationError>where R: ByteReader,

impl Deserializable for u32

fn read_from<R>(source: &mut R) -> Result<u32, DeserializationError>where R: ByteReader,

impl Deserializable for u64

fn read_from<R>(source: &mut R) -> Result<u64, DeserializationError>where R: ByteReader,

impl Deserializable for u128

fn read_from<R>(source: &mut R) -> Result<u128, DeserializationError>where R: ByteReader,

impl Deserializable for ()

fn read_from<R>(_source: &mut R) -> Result<(), DeserializationError>where R: ByteReader,

impl Deserializable for usize

fn read_from<R>(source: &mut R) -> Result<usize, DeserializationError>where R: ByteReader,

fn min_serialized_size() -> usize

impl Deserializable for String

fn read_from<R>(source: &mut R) -> Result<String, DeserializationError>where R: ByteReader,

fn min_serialized_size() -> usize

impl Deserializable for PublicInputs

fn read_from<R>(source: &mut R) -> Result<PublicInputs, DeserializationError>where R: ByteReader,

impl Deserializable for MetaKeyValue

fn read_from<R>(source: &mut R) -> Result<MetaKeyValue, DeserializationError>where R: ByteReader,

impl Deserializable for MetaList

fn read_from<R>(source: &mut R) -> Result<MetaList, DeserializationError>where R: ByteReader,

impl Deserializable for Ident

fn read_from<R>(source: &mut R) -> Result<Ident, DeserializationError>where R: ByteReader,

impl Deserializable for PathBuf

Trait Deserializable

fn read_from<R>(source: &mut R) -> Result<Self, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Attribute, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<MetaExpr, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<ConstantOp, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<HashKind, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<ConstantValue, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<IntValue, DeserializationError>
where R: ByteReader,

fn read_from<R>( source: &mut R, ) -> Result<DebugVarLocation, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Operation, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<HashFunction, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<SealingKey, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<UnsealingKey, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<NodeMutation, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<DebugTypeInfo, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Linkage, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<WordSchema, DeserializationError>
where R: ByteReader,

fn read_from<R>( source: &mut R, ) -> Result<AccountUpdateDetails, DeserializationError>
where R: ByteReader,

fn read_from<R>( source: &mut R, ) -> Result<StorageSlotDelta, DeserializationError>
where R: ByteReader,

fn read_from<R>( source: &mut R, ) -> Result<AssetCallbackFlag, DeserializationError>
where R: ByteReader,

fn read_from<R>( source: &mut R, ) -> Result<NoteAttachmentContent, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Type, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<u8, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<u16, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<u32, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<u64, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<u128, DeserializationError>
where R: ByteReader,

fn read_from<R>(_source: &mut R) -> Result<(), DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<usize, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<String, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<PublicInputs, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<MetaKeyValue, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<MetaList, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Ident, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<PathBuf, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<KernelLibrary, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<WordValue, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<EcdsaRequest, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<EddsaRequest, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<EventId, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<EventName, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<DebugVarId, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<DebugInfo, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<AsmOpId, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<DecoratorId, DeserializationError>
where R: ByteReader,

fn read_from<R>( source: &mut R, ) -> Result<UntrustedMastForest, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<DebugVarInfo, DeserializationError>
where R: ByteReader,

fn read_from<R>( source: &mut R, ) -> Result<PrecompileRequest, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Kernel, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<StackInputs, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<StackOutputs, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<ProgramInfo, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<ExecutionProof, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<EncryptedData, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Nonce, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<SecretKey, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<EncryptedData, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Nonce, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<SecretKey, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<PublicKey, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<SecretKey, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<Signature, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<PublicKey, DeserializationError>
where R: ByteReader,

fn read_from<R>(source: &mut R) -> Result<SecretKey, DeserializationError>
where R: ByteReader,