Struct WasmToolRunner 

pub struct WasmToolRunner { /* private fields */ }

WASM tool runner.

When the wasm-sandbox feature is enabled, this uses Wasmtime for actual WASM execution. Without the feature, all tool loads are rejected with WasmError::RuntimeUnavailable.

Implementations

impl WasmToolRunner

pub fn new(config: WasmSandboxConfig) -> Self

Create a new WASM tool runner with the given configuration.

pub fn set_chain_manager(&mut self, cm: Arc<ChainManager>)

Attach a chain manager for exochain event logging.

pub fn set_governance_engine(&mut self, ge: Arc<GovernanceEngine>)

Attach a governance engine for pre-execution gating.

pub fn config(&self) -> &WasmSandboxConfig

Get the sandbox configuration.

pub fn validate_wasm( &self, wasm_bytes: &[u8], ) -> Result<WasmValidation, WasmError>

Validate a WASM module’s bytes without loading it.

Checks module size, magic bytes, and (when the runtime is available) uses wasmtime::Module::validate() for full validation.

pub fn load_tool( &self, name: &str, wasm_bytes: &[u8], ) -> Result<WasmTool, WasmError>

Load a WASM tool from bytes.

Validates the module, computes a SHA-256 hash, and (with wasm-sandbox) compiles it with the Wasmtime engine.

pub fn execute( &self, _tool: &WasmTool, _input: Value, ) -> Result<WasmToolResult, WasmError>

Execute a loaded WASM tool synchronously.

Creates an isolated store with fuel metering and memory limits, compiles the tool’s module bytes, and calls _start or execute. No host filesystem access is provided – the instance receives an empty set of imports.

For WASI-aware execution with stdio pipes, use [execute_bytes].

pub fn execute_sync( &self, name: &str, wasm_bytes: &[u8], _input: Value, ) -> Result<WasmToolResult, WasmError>

Execute raw WASM bytes synchronously without WASI.

This is the sync K3 execution path. It creates a fresh Wasmtime store with fuel metering and memory limits, instantiates the module with no imports (no filesystem, no network), and calls _start or run.

Returns WasmToolResult on success or a typed WasmError on fuel exhaustion, memory overflow, or compilation failure.

pub async fn execute_bytes( &self, name: &str, wasm_bytes: &[u8], input: Value, ) -> Result<WasmToolResult, WasmError>

Compile and execute WASM bytes in one shot.

This is the primary execution path for K3. It accepts raw WASM bytes (binary or WAT text), compiles them with the engine, creates an isolated WASI store with fuel metering, serializes input as JSON to the module’s stdin, calls _start (WASI preview1) or execute, and reads stdout/stderr.

For cached execution with pre-compiled modules, see K4.

pub fn engine(&self) -> &Engine

Get a reference to the Wasmtime engine.