Trait Runtime

pub trait Runtime
where
    Self: Debug,
{
    // Required methods
    fn networking(&self) -> &DynVirtualNetworking;
    fn task_manager(&self) -> &Arc<dyn VirtualTaskManager>;
    fn source(&self) -> Arc<dyn Source + Send + Sync>;

    // Provided methods
    fn package_loader(&self) -> Arc<dyn PackageLoader + Send + Sync> { ... }
    fn module_cache(&self) -> Arc<dyn ModuleCache + Send + Sync> { ... }
    fn engine(&self) -> Engine { ... }
    fn new_store(&self) -> Store { ... }
    fn http_client(&self) -> Option<&DynHttpClient> { ... }
    fn tty(&self) -> Option<&(dyn TtyBridge + Send + Sync)> { ... }
    fn load_module<'a>(
        &'a self,
        wasm: &'a [u8],
    ) -> BoxFuture<'a, Result<Module, SpawnError>> { ... }
    fn load_module_sync(&self, wasm: &[u8]) -> Result<Module, SpawnError> { ... }
    fn on_taint(&self, _reason: TaintReason) { ... }
    fn journals(&self) -> &Vec<Arc<DynJournal>> { ... }
    fn active_journal(&self) -> Option<&DynJournal> { ... }
}

Runtime components used when running WebAssembly programs.

Think of this as the “System” in “WebAssembly Systems Interface”.

Required Methods

fn networking(&self) -> &DynVirtualNetworking

Provides access to all the networking related functions such as sockets.

fn task_manager(&self) -> &Arc<dyn VirtualTaskManager>

Retrieve the active VirtualTaskManager.

fn source(&self) -> Arc<dyn Source + Send + Sync>

The package registry.

Provided Methods

fn package_loader(&self) -> Arc<dyn PackageLoader + Send + Sync>

A package loader.

fn module_cache(&self) -> Arc<dyn ModuleCache + Send + Sync>

A cache for compiled modules.

fn engine(&self) -> Engine

Get a wasmer::Engine for module compilation.

fn new_store(&self) -> Store

Create a new wasmer::Store.

fn http_client(&self) -> Option<&DynHttpClient>

Get a custom HTTP client

fn tty(&self) -> Option<&(dyn TtyBridge + Send + Sync)>

Get access to the TTY used by the environment.

fn load_module<'a>( &'a self, wasm: &'a [u8], ) -> BoxFuture<'a, Result<Module, SpawnError>>

Load a a Webassembly module, trying to use a pre-compiled version if possible.

fn load_module_sync(&self, wasm: &[u8]) -> Result<Module, SpawnError>

Load a a Webassembly module, trying to use a pre-compiled version if possible.

Non-async version of Self::load_module.

fn on_taint(&self, _reason: TaintReason)

Callback thats invokes whenever the instance is tainted, tainting can occur for multiple reasons however the most common is a panic within the process

fn journals(&self) -> &Vec<Arc<DynJournal>>

Available on crate feature journal only.

The list of journals which will be used to restore the state of the runtime at a particular point in time

fn active_journal(&self) -> Option<&DynJournal>

Available on crate feature journal only.

The snapshot capturer takes and restores snapshots of the WASM process at specific points in time by reading and writing log entries

Implementors

impl Runtime for OverriddenRuntime

impl Runtime for PluggableRuntime