Struct soroban_wasmi::ResumableInvocation

pub struct ResumableInvocation { /* private fields */ }

State required to resume a Func invocation.

Implementations

impl ResumableInvocation

pub fn host_func(&self) -> Func

Returns the host Func that returned the host error.

Note

When using ResumableInvocation::resume the inputs need to match the results of this host function so that the function invocation can properly resume. For that number and types of the values provided must match.

pub fn host_error(&self) -> &Trap

Returns a shared reference to the encountered host error.

Note

This is guaranteed to never be a Wasm trap.

pub fn resume<T>( self, ctx: impl AsContextMut<UserState = T>, inputs: &[Value], outputs: &mut [Value] ) -> Result<ResumableCall, Error>

Resumes the call to the Func with the given inputs.

The result is written back into the outputs buffer upon success.

Returns a resumable handle to the function invocation upon enountering host errors with which it is possible to handle the error and continue the execution as if no error occured.

Errors

• If the function resumption returned a Wasm Trap.
• If the types or the number of values in inputs does not match the types and number of result values of the errorneous host function.
• If the number of output values does not match the expected number of outputs required by the called function.

Trait Implementations

impl Debug for ResumableInvocation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for ResumableInvocation

fn drop(&mut self)

Executes the destructor for this type.