Struct DeserializerConfig 

pub struct DeserializerConfig { /* private fields */ }

Configuration for CBOR deserializer to prevent DoS attacks.

This struct provides configurable limits for deserialization to protect against malicious inputs that could consume excessive memory or CPU resources.

Examples

use multi_cbor::config::DeserializerConfig;

let config = DeserializerConfig::default()
    .max_array_size(1000)
    .max_map_size(500)
    .max_recursion_depth(64);

Implementations

impl DeserializerConfig

pub const fn unlimited() -> Self

Creates a new configuration with no limits (use with caution).

This is potentially dangerous as it allows unbounded resource consumption. Only use this when you have full control over the input data.

pub const fn strict() -> Self

Creates a strict configuration with conservative limits for untrusted input.

Strict limits:

• Max array size: 1,000 elements
• Max map size: 1,000 key-value pairs
• Max recursion depth: 32 levels
• Max indefinite iterations: 1,000

pub const fn max_array_size(self, limit: usize) -> Self

Sets the maximum number of elements allowed in an array.

Pass None to disable this limit (not recommended for untrusted input).

pub const fn unlimited_array_size(self) -> Self

Removes the limit on array size (use with caution).

pub const fn max_map_size(self, limit: usize) -> Self

Sets the maximum number of key-value pairs allowed in a map.

Pass None to disable this limit (not recommended for untrusted input).

pub const fn unlimited_map_size(self) -> Self

Removes the limit on map size (use with caution).

pub const fn max_recursion_depth(self, depth: u8) -> Self

Sets the maximum recursion depth for nested structures.

Lower values provide better DoS protection but may reject legitimate deeply nested data.

pub const fn max_indefinite_iterations(self, limit: usize) -> Self

Sets the maximum number of iterations for indefinite-length structures.

This prevents attackers from sending indefinite-length arrays or maps with extremely large numbers of elements.

pub const fn unlimited_indefinite_iterations(self) -> Self

Removes the limit on indefinite-length iterations (use with caution).

pub const fn get_max_array_size(&self) -> Option<usize>

Returns the maximum array size limit.

pub const fn get_max_map_size(&self) -> Option<usize>

Returns the maximum map size limit.

pub const fn get_max_recursion_depth(&self) -> u8

Returns the maximum recursion depth.

pub const fn get_max_indefinite_iterations(&self) -> Option<usize>

Returns the maximum indefinite iterations limit.

Trait Implementations

impl Clone for DeserializerConfig

fn clone(&self) -> DeserializerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DeserializerConfig

impl Debug for DeserializerConfig

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

Formats the value using the given formatter.

impl Default for DeserializerConfig

fn default() -> Self

Creates a default configuration with reasonable limits.

Default limits:

• Max array size: 100,000 elements
• Max map size: 100,000 key-value pairs
• Max recursion depth: 128 levels
• Max indefinite iterations: 100,000