Function sc_executor_common::sandbox::instantiate

source · [−]
pub fn instantiate<'a, FE: SandboxCapabilities>(
    supervisor_externals: &mut FE, 
    dispatch_thunk: FE::SupervisorFuncRef, 
    wasm: &[u8], 
    host_env: GuestEnvironment, 
    state: u32
) -> Result<UnregisteredInstance<FE::SupervisorFuncRef>, InstantiationError>
Expand description

Instantiate a guest module and return it’s index in the store.

The guest module’s code is specified in wasm. Environment that will be available to guest module is specified in raw_env_def (serialized version of EnvironmentDefinition). dispatch_thunk is used as function that handle calls from guests.

Errors

Returns Err if any of the following conditions happens:

  • raw_env_def can’t be deserialized as a EnvironmentDefinition.
  • Module in wasm is invalid or couldn’t be instantiated.