Struct PluginRuntime 

pub struct PluginRuntime { /* private fields */ }

Preconfigured Wasmtime runtime environment for loading plugins.

The engine is shared across instances; the linker is configured once with the WASIp1 imports and Martensite host functions.

Examples

use martensite_plugin::{CapabilitySet, PluginRuntime};

let runtime = PluginRuntime::new().unwrap();
// The empty capability set gives the plugin no host access.
let _ = runtime.load(b"\0asm\x01\0\0\0", CapabilitySet::empty());
// (Loading a real wasm module would succeed; a minimal header is shown here.)

Implementations

impl PluginRuntime

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

Creates a new runtime with the default fuel budget.

Errors

Returns an error if the Wasmtime engine cannot be initialized.

Examples

use martensite_plugin::PluginRuntime;

let runtime = PluginRuntime::new().unwrap();

pub fn with_fuel_budget(fuel_budget: u64) -> Result<Self, PluginError>

Creates a new runtime with a custom fuel budget.

Errors

Returns an error if the Wasmtime engine cannot be initialized.

Examples

use martensite_plugin::PluginRuntime;

let runtime = PluginRuntime::with_fuel_budget(50_000).unwrap();

pub fn engine(&self) -> &Engine

Returns the Wasmtime engine used by this runtime.

Epoch interruption is configured for every plugin store. The host must call Engine::increment_epoch on this engine on a 5 ms cadence to enforce the wall-clock deadline in addition to the fuel budget.

Examples

use martensite_plugin::PluginRuntime;

let runtime = PluginRuntime::new().unwrap();
let _engine = runtime.engine();

pub fn load( &self, wasm_bytes: &[u8], caps: CapabilitySet, ) -> Result<PluginInstance, PluginError>

Loads and instantiates a plugin with the given capability set.

The returned PluginInstance is independent from the runtime and can be invoked repeatedly until its fuel budget is exhausted.

Errors

Returns an error if compilation, instantiation, or fuel setup fails.

Examples

use martensite_plugin::{CapabilitySet, PluginRuntime};

let runtime = PluginRuntime::new().unwrap();
// Loading invalid bytes returns an error.
assert!(runtime.load(b"not wasm", CapabilitySet::empty()).is_err());