Module executor 

A crate that provides means of executing/dispatching calls into the runtime.

There are a few responsibilities of this crate at the moment:

• It provides an implementation of a common entrypoint for calling into the runtime, both wasm and compiled.
• It defines the environment for the wasm execution, namely the host functions that are to be provided into the wasm runtime module.
• It also provides the required infrastructure for executing the current wasm runtime (specified by the current value of :code in the provided externalities), i.e. interfacing with wasm engine used, instance cache.

Re-exports

pub use self::wasmtime::InstantiationStrategy as WasmtimeInstantiationStrategy;

pub use common::error;

pub use common::wasm_runtime::HeapAllocStrategy;

pub use common::wasm_runtime::DEFAULT_HEAP_ALLOC_PAGES;

pub use common::wasm_runtime::DEFAULT_HEAP_ALLOC_STRATEGY;

Modules

common

A set of common definitions that are needed for defining execution engines.

polkavm

wasmtime

Defines a WasmRuntime that uses the Wasmtime JIT to execute.

Structs

NativeElseWasmExecutorDeprecated

A generic CodeExecutor implementation that uses a delegate to determine wasm code equivalence and dispatch to native code when possible, falling back on WasmExecutor when not.

NativeVersion

The version of the native runtime.

RuntimeVersion

Runtime version. This should not be thought of as classic Semver (major/minor/tiny). This triplet have different semantics and mis-interpretation could cause problems. In particular: bug fixes should result in an increment of spec_version and possibly authoring_version, absolutely not impl_version since they change the semantics of the runtime.

WasmExecutor

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

Enums

WasmExecutionMethod

Specification of different methods of executing the runtime Wasm code.

Traits

Codec

Trait that allows zero-copy read/write of value-references to/from slices in LE format.

HostFunctions

Something that provides implementations for host functions.

NativeExecutionDispatch

Delegate for dispatching a CodeExecutor call.

RuntimeVersionOf

Extracts the runtime version of a given runtime code.

Functions

read_embedded_version

Take the runtime blob and scan it for the custom wasm sections containing the version information and construct the RuntimeVersion from them.

with_externalities_safe

Set up the externalities and safe calling environment to execute runtime calls.