12 releases (4 breaking)

✓ Uses Rust 2018 edition

new 0.5.5 Jul 10, 2019
0.4.2 May 16, 2019
0.4.0 Apr 29, 2019
0.3.0 Apr 12, 2019
0.1.4 Jan 25, 2019

#20 in WebAssembly

Download history 88/week @ 2019-03-27 116/week @ 2019-04-03 428/week @ 2019-04-10 445/week @ 2019-04-17 400/week @ 2019-04-24 324/week @ 2019-05-01 219/week @ 2019-05-08 411/week @ 2019-05-15 630/week @ 2019-05-22 711/week @ 2019-05-29 539/week @ 2019-06-05 552/week @ 2019-06-12 495/week @ 2019-06-19 538/week @ 2019-06-26 558/week @ 2019-07-03

2,058 downloads per month
Used in 3 crates (2 directly)

MIT license

434KB
11K SLoC

Wasmer logo

Build Status License Join the Wasmer Community Number of downloads from crates.io Read our API documentation

Wasmer Runtime

Wasmer is a standalone JIT WebAssembly runtime, aiming to be fully compatible with Emscripten, Rust and Go. Learn more.

This crate represents the high-level runtime API, making embedding WebAssembly in your application easy, efficient, and safe.

How to use Wasmer Runtime

The easiest way is to use the instantiate function to create an Instance. Then you can use call or func and then call to call an exported function safely.

Example

Given this WebAssembly:

(module
  (type $t0 (func (param i32) (result i32)))
  (func $add_one (export "add_one") (type $t0) (param $p0 i32) (result i32)
    get_local $p0
    i32.const 1
    i32.add))

compiled into Wasm bytecode, we can call the exported add_one function:

static WASM: &'static [u8] = &[
    // The module above compiled to bytecode goes here.
    0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00, 0x01, 0x06, 0x01, 0x60,
    0x01, 0x7f, 0x01, 0x7f, 0x03, 0x02, 0x01, 0x00, 0x07, 0x0b, 0x01, 0x07,
    0x61, 0x64, 0x64, 0x5f, 0x6f, 0x6e, 0x65, 0x00, 0x00, 0x0a, 0x09, 0x01,
    0x07, 0x00, 0x20, 0x00, 0x41, 0x01, 0x6a, 0x0b, 0x00, 0x1a, 0x04, 0x6e,
    0x61, 0x6d, 0x65, 0x01, 0x0a, 0x01, 0x00, 0x07, 0x61, 0x64, 0x64, 0x5f,
    0x6f, 0x6e, 0x65, 0x02, 0x07, 0x01, 0x00, 0x01, 0x00, 0x02, 0x70, 0x30,
];

use wasmer_runtime::{
    instantiate,
    Value,
    imports,
    error,
};

fn main() -> error::Result<()> {
    // We're not importing anything, so make an empty import object.
    let import_object = imports! {};

    let mut instance = instantiate(WASM, &import_object)?;

    let values = instance
        .func("add_one")?
        .call(&[Value::I32(42)])?;

    assert_eq!(values[0], Value::I32(43));
    
    Ok(())
}

Additional Notes

The wasmer-runtime crate is build to support multiple compiler backends. Currently, we support the Cranelift compiler with the wasmer-clif-backend crate by default.

You can specify the compiler you wish to use with the compile_with function.

Dependencies

~6.5MB
~124K SLoC