Struct WasmtimeEngine 

pub struct WasmtimeEngine { /* private fields */ }

Wasmtime-based Wasm engine implementation.

Wraps a wasmtime::Engine configured per WasmtimeEngineConfig. Thread-safe: the inner wasmtime::Engine is Send + Sync and can be shared across async tasks.

COLD PATH — constructed once at host startup.

Examples

use torvyn_engine::{WasmtimeEngine, WasmtimeEngineConfig};

let config = WasmtimeEngineConfig::default();
let engine = WasmtimeEngine::new(config).expect("engine creation");

Implementations

impl WasmtimeEngine

pub fn new(config: WasmtimeEngineConfig) -> Result<Self, EngineError>

Create a new WasmtimeEngine with the given configuration.

COLD PATH — called once at host startup.

Errors

Returns EngineError::Internal if the Wasmtime Config is invalid.

pub fn inner(&self) -> &Engine

Returns a reference to the underlying Wasmtime engine.

Useful for downstream crates that need to create linkers or other engine-dependent objects.

pub fn config(&self) -> &WasmtimeEngineConfig

Returns a reference to the engine configuration.

Trait Implementations

impl WasmEngine for WasmtimeEngine

fn set_fuel( &self, instance: &mut ComponentInstance, fuel: u64, ) -> Result<(), EngineError>

WARM PATH — called before each invocation.

fn fuel_remaining(&self, instance: &ComponentInstance) -> Option<u64>

HOT PATH — called after each invocation.

fn memory_usage(&self, instance: &ComponentInstance) -> usize

WARM PATH

fn compile_component( &self, bytes: &[u8], ) -> Result<CompiledComponent, EngineError>

Compile a Wasm component binary to native code.

fn serialize_component( &self, compiled: &CompiledComponent, ) -> Result<Vec<u8>, EngineError>

Serialize a compiled component for disk caching.

unsafe fn deserialize_component( &self, bytes: &[u8], ) -> Result<Option<CompiledComponent>, EngineError>

Deserialize a previously compiled component from cached bytes.

fn instantiate<'life0, 'life1, 'async_trait>( &'life0 self, compiled: &'life1 CompiledComponent, imports: ImportBindings, component_id: ComponentId, ) -> Pin<Box<dyn Future<Output = Result<ComponentInstance, EngineError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Instantiate a compiled component with the given import bindings.