wasmer/lib/api/README.md

Wasmer

Wasmer is the most popular WebAssembly runtime for Rust (...and also the fastest!). It supports JIT (Just in Time) and AOT (Ahead of time) compilation as well as pluggable compilers suited to your needs.

It's designed to be safe and secure, and runnable in any kind of environment.

Usage

Add to your Cargo.toml

[dependencies]
wasmer = "0.16.2"

use wasmer::{Instance, Function, Value, imports, DefaultStore as _};

fn main() -> anyhow::Result<()> {
    let module_wat = r#"
    (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))
    "#;

    let module = Module::new(&module_wat);
    // The module doesn't import anything, so we create an empty import object.
    let import_object = imports! {};
    let instance = Instance::new(module, &import_object)?;

    let add_one = instance.exports.get_function("add_one")?;
    let result = add_one.call([Value::I32(42)])?;
    assert_eq!(result[0], Value::I32(43));

    Ok(())
}

Features

Wasmer is not only fast, but also designed to be highly customizable:

• Pluggable Engines: do you have a fancy dlopen implementation? This is for you!
• Pluggable Compilers: you want to emit code with DynASM or other compiler? We got you!
• Headless mode: that means that no compilers will be required to run a serialized Module (via Module::deserialize()).
• Cross-compilation: You can pre-compile a module and serialize it to then run it in other platform (via Module::serialize()).

Config flags

Wasmer has the following configuration flags:

• wat (enabled by default): It allows to read WebAssembly files in their text format. This feature is normally used only in development environments
• Compilers (mutually exclusive):
  • singlepass: it will use wasmer-compiler-singlepass as the default compiler.
  • cranelift: it will use wasmer-compiler-cranelift as the default compiler.
  • llvm: it will use wasmer-compiler-llvm as the default compiler.

Note: if you want to use multiple compilers at the same time, it's also possible! You will need to import them directly via each of the compiler crates.

---

Made with ❤️ by the Wasmer team, for the community