Crate waxosuit_guest

waxosuit-guest

The waxosuit-guest library provides WebAssembly module developers with access to the Waxosuit host runtime. Each guest module has a single call handler, declared with the call_handler! macro. Inside this call handler, the guest module should check the operation of the delivered message and handle it accordingly, returning any binary payload in response. It is the responsibility of the guest module to ensure that the capability provider will be able to understand whichever messages it sends.

Example

extern crate waxosuit_guest as guest;

use guest::prelude::*;

call_handler!(handle_call);

pub fn handle_call(ctx: &CapabilitiesContext, operation: &str, msg: &[u8]) -> CallResult {
    match operation {
        http::OP_HANDLE_REQUEST => hello_world(ctx, msg),
        core::OP_HEALTH_REQUEST => Ok(vec![]),
        _ => Err("bad dispatch".into()),
    }     
}

fn hello_world(
   _ctx: &CapabilitiesContext,
   _msg: &[u8]) -> CallResult {
    Ok(vec![])
}

Re-exports

• pub extern crate prost;
• pub extern crate wapc_guest as wapc;

Modules

• kv
  Key-Value Store
• msg
  Message Broker
• prelude
  Glob imports for common guest module development
• raw
  Raw capability provider interface

Macros

• call_handler

Structs

• CapabilitiesContext
  The capabilities context is the gateway through which all guest modules communicate with a host runtime. A reference to a capabilities context is passed to the call handler defined by the guest module. Individual capabilities are separated through function calls for each capability provider, including any bound opaque raw providers.

Functions

• protobytes
  Utility function to easily convert a prost Message into a byte vector