Struct Config 

pub struct Config { /* private fields */ }

Runtime configuration for zwasm modules.

Allows fine-grained control over memory allocation, fuel, timeouts, and resource limits. Used to customize the execution environment for a Module.

Implementations

impl Config

pub fn new() -> Result<Self, ZwasmError>

Creates a new runtime configuration for zwasm modules.

Use this to control memory allocation, fuel, timeouts, and other resource limits.

pub fn set_allocator<F, G>(&mut self, alloc_fn: F, free_fn: G)

where F: Fn(usize, usize) -> *mut c_void + Send + Sync + 'static, G: Fn(*mut c_void, usize, usize) + Send + Sync + 'static,

Sets custom memory allocation hooks for the zwasm runtime.

Allows you to override all memory allocation for Wasm execution. Useful for sandboxing or tracking allocations.

Safety

The provided callbacks must obey allocator semantics for all (size, align) pairs that the runtime may request. Returning invalid pointers or violating alignment/ deallocation contracts can cause undefined behavior in native code.

pub fn set_fuel(&mut self, fuel: u64)

Sets the execution fuel limit for the module.

Fuel limits restrict the number of instructions a module can execute before trapping.

pub fn set_timeout(&mut self, timeout_ms: u64)

Sets the execution timeout (in milliseconds) for the module.

Execution will be interrupted if the timeout is exceeded.

pub fn set_max_memory(&mut self, max_memory: u64)

Sets the maximum linear memory (in bytes) for the module.

Prevents Wasm modules from growing memory beyond this limit.

pub fn set_force_interpreter(&mut self, force: bool)

Forces interpreter mode (disables JIT) when true.

Useful for debugging or running on unsupported platforms.

pub fn set_cancelable(&mut self, cancelable: bool)

Enables or disables cancellation support for the module.

When enabled, execution can be cancelled via Module::cancel.

Trait Implementations

impl Drop for Config

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.