Struct WasmtimeEngineConfig 

pub struct WasmtimeEngineConfig {
    pub fuel_enabled: bool,
    pub default_fuel: u64,
    pub fuel_yield_interval: u64,
    pub max_memory_bytes: usize,
    pub max_table_elements: u32,
    pub max_instances: u32,
    pub strategy: CompilationStrategy,
    pub simd_enabled: bool,
    pub multi_memory: bool,
    pub cache_dir: Option<PathBuf>,
    pub compilation_threads: Option<usize>,
    pub stack_size: usize,
}

Configuration for the Wasmtime-based Wasm engine.

Per Doc 02, Section 3.2: controls fuel, memory limits, compilation strategy, SIMD, caching, and parallelism.

Invariants

• default_fuel must be > 0 when fuel_enabled is true.
• max_memory_bytes must be > 0.

Examples

use torvyn_engine::WasmtimeEngineConfig;

let config = WasmtimeEngineConfig::default();
assert!(config.fuel_enabled);
assert_eq!(config.max_memory_bytes, 16 * 1024 * 1024);

Fields

fuel_enabled: bool

Enable fuel-based CPU budgeting.

When enabled, each component invocation is given a fuel allocation. Components that exceed their budget are preempted.

default_fuel: u64

Default fuel budget per component invocation.

Per Doc 02, Section 3.2: default is 1,000,000.

fuel_yield_interval: u64

Fuel yield interval for async cooperative preemption.

When set, Wasmtime yields back to the async executor after consuming this many fuel units, enabling cooperative multitasking. A value of 0 disables yield-on-fuel.

max_memory_bytes: usize

Maximum linear memory per component instance (bytes).

Per Doc 02, Section 3.2: default is 16 MiB.

max_table_elements: u32

Maximum number of Wasm table elements per component instance.

max_instances: u32

Maximum number of instances per store.

strategy: CompilationStrategy

Compilation strategy.

simd_enabled: bool

Enable Wasm SIMD instructions.

multi_memory: bool

Enable Wasm multi-memory proposal.

cache_dir: Option<PathBuf>

Compilation cache directory for serialized native code.

When Some, compiled components are serialized to disk and deserialized on subsequent loads, avoiding recompilation.

compilation_threads: Option<usize>

Number of parallel compilation threads.

None uses Wasmtime’s default (number of CPUs).

stack_size: usize

Stack size for Wasm execution (bytes).

Default: 1 MiB. Controls the maximum call stack depth.

Implementations

impl WasmtimeEngineConfig

pub fn validate(&self) -> Vec<String>

Validate the configuration, returning a list of problems.

COLD PATH — called once at startup.

Examples

use torvyn_engine::WasmtimeEngineConfig;

let config = WasmtimeEngineConfig::default();
assert!(config.validate().is_empty());

Trait Implementations

impl Clone for WasmtimeEngineConfig

fn clone(&self) -> WasmtimeEngineConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WasmtimeEngineConfig

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

Formats the value using the given formatter.

impl Default for WasmtimeEngineConfig

fn default() -> Self

Returns the default engine configuration.

COLD PATH — called once at startup.