#sdk #wapc #webassembly #wasm #wasi

wapc

An engine-pluggable WebAssembly Host Runtime implementing the waPC Standard

20 releases (9 breaking)

0.10.1 Oct 6, 2020
0.9.0 Aug 3, 2020
0.8.1 Jul 16, 2020
0.5.0 Mar 30, 2020
0.0.4 Nov 5, 2019

#310 in WebAssembly

Download history 217/week @ 2021-01-13 176/week @ 2021-01-20 289/week @ 2021-01-27 211/week @ 2021-02-03 335/week @ 2021-02-10 213/week @ 2021-02-17 132/week @ 2021-02-24 98/week @ 2021-03-03 231/week @ 2021-03-10 200/week @ 2021-03-17 501/week @ 2021-03-24 178/week @ 2021-03-31 259/week @ 2021-04-07 367/week @ 2021-04-14 374/week @ 2021-04-21 292/week @ 2021-04-28

770 downloads per month
Used in 6 crates (5 directly)

Apache-2.0

29KB
336 lines

Rust crates.io license

waPC

This is the Rust implementation of the waPC standard for WebAssembly host runtimes. It allows any WebAssembly module to be loaded as a guest and receive requests for invocation as well as to make its own function requests of the host. This library allows for both "pure" (completely isolated) wasm modules as well as WASI modules

This crate defines the protocol for RPC exchange between guest (WebAssembly) modules and the host runtime. That protocol can be satisfied by any engine that implements the right trait. This allows you to choose the WebAssembly low-level "driver" that best suits your needs, whether it be JITted or interpreted or bespoke.

Example

The following is a simple example of synchronous, bi-directional procedure calls between a WebAssembly host runtime and the guest module.

extern crate wapc;
use wasmtime_provider::WasmtimeEngineProvider;
use wapc::prelude::*;

pub fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    let module = load_file();
    let engine = WasmtimeEngineProvider::new(&module, None);
    let mut host = WapcHost::new(
       engine,
       |id: u64, bd: &str, ns: &str, op: &str, payload: &str|{
        println!("Guest {} invoked '{}->{}:{}' with payload of {} bytes", id, bd, ns, op, payload.len());
        Ok(vec![])
    }, &module, None)?;

    let res = host.call("wapc:sample!Hello", b"this is a test")?;
    assert_eq!(res, b"hello world!");
    Ok(())
}

For running examples, take a look at the examples available in the individual engine provider repositories:

Dependencies

~2.2–3.5MB
~84K SLoC