[−][src]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 |
Functions
protobytes | Utility function to easily convert a prost Message into a byte vector |