Struct sc_executor::WasmExecutor

pub struct WasmExecutor { /* fields omitted */ }

An abstraction over Wasm code executor. Supports selecting execution backend and manages runtime cache.

Implementations

impl WasmExecutor

pub fn new(
    method: WasmExecutionMethod,
    default_heap_pages: Option<u64>,
    host_functions: Vec<&'static dyn Function>,
    max_runtime_instances: usize,
    cache_path: Option<PathBuf>
) -> Self

Create new instance.

Parameters

method - Method used to execute Wasm code.

default_heap_pages - Number of 64KB pages to allocate for Wasm execution. Defaults to DEFAULT_HEAP_PAGES if None is provided.

host_functions - The set of host functions to be available for import provided by this executor.

max_runtime_instances - The number of runtime instances to keep in memory ready for reuse.

cache_path - A path to a directory where the executor can place its files for purposes of caching. This may be important in cases when there are many different modules with the compiled execution method is used.

Trait Implementations

impl Clone for WasmExecutor

fn clone(&self) -> WasmExecutor

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CodeExecutor for WasmExecutor

type Error = Error

Externalities error type.

fn call<R: Decode + Encode + PartialEq, NC: FnOnce() -> Result<R, Box<dyn Error + Send + Sync>> + UnwindSafe>(
    &self,
    ext: &mut dyn Externalities,
    runtime_code: &RuntimeCode<'_>,
    method: &str,
    data: &[u8],
    _use_native: bool,
    _native_call: Option<NC>
) -> (Result<NativeOrEncoded<R>>, bool)

Call a given method in the runtime. Returns a tuple of the result (either the output data or an execution error) together with a bool, which is true if native execution was used.

impl ReadRuntimeVersion for WasmExecutor

fn read_runtime_version(
    &self,
    wasm_code: &[u8],
    ext: &mut dyn Externalities
) -> Result<Vec<u8>, String>

Reads the runtime version information from the given wasm code.

impl RuntimeVersionOf for WasmExecutor

fn runtime_version(
    &self,
    ext: &mut dyn Externalities,
    runtime_code: &RuntimeCode<'_>
) -> Result<RuntimeVersion>

Extract RuntimeVersion of the given runtime_code.