wasmer/lib
bors[bot] 2139357021
Merge #709
709: new feature flag: `deterministic` r=MarkMcCaskey a=YaronWittenstein

The motivation for the PR is for introducing a new feature flag called `deterministic`.

When `deterministic` will be enabled (turned-off by default) it'll guarantee deterministic
execution of wasm programs across different hardware/circumstances.

This is critical for Blockchain projects that require execution to be deterministic
in order to reach a consensus of the state transition of each smart-contract transaction.

Co-authored-by: Yaron Wittenstein <yaron.wittenstein@gmail.com>
Co-authored-by: Yaron Wittenstein <yaronwittenstein@users.noreply.github.com>
Co-authored-by: Mark McCaskey <5770194+markmccaskey@users.noreply.github.com>
Co-authored-by: Mark McCaskey <mark@wasmer.io>
2019-12-06 21:24:40 +00:00
..
clif-backend Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
dev-utils Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
emscripten Fix some assorted warnings. 2019-12-02 17:00:37 -08:00
emscripten-tests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
kernel-loader Improved docs with custom logo and favicon 2019-09-03 17:06:31 -07:00
kernel-net Improved docs with custom logo and favicon 2019-09-03 17:06:31 -07:00
llvm-backend Add the ability to pass backend specific options through CompilerConfig. 2019-12-05 12:13:51 -08:00
llvm-backend-tests Add test for debug-crash. 2019-12-02 15:49:33 -08:00
middleware-common Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
middleware-common-tests Fix some assorted warnings. 2019-12-02 17:00:37 -08:00
runtime Remove deterministic flag setting default compiler; add auto logic 2019-12-05 15:04:05 -08:00
runtime-c-api feat(runtime-c-api) Support WasiVersion::Latest. 2019-12-04 15:34:56 +01:00
runtime-core Merge #709 2019-12-06 21:24:40 +00:00
runtime-core-tests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
singlepass-backend Remove wasmparser dep from singlepass 2019-12-05 11:59:26 -08:00
spectests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
wasi Merge branch 'master' into fix-wasi-get-version 2019-12-04 15:25:11 +01:00
wasi-tests test(wasi) Update get_wasi_version signature. 2019-12-06 14:04:30 +01:00
win-exception-handler Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
.gitignore Remove generated spectest codes from repo. 2019-01-12 23:48:21 -05:00
README.md Renamed dynasm backend to singlepass 2019-04-11 12:44:03 -07:00

Wasmer Libraries

Wasmer is modularized into different libraries, separated into three main sections:

Runtime

The core of Wasmer is the runtime, which provides the necessary abstractions to create a good user experience when embedding.

The runtime is divided into two main libraries:

  • runtime-core: The main implementation of the runtime.
  • runtime: Easy-to-use API on top of runtime-core.

Integrations

The integration builds on the Wasmer runtime and allow us to run WebAssembly files compiled for different environments.

Wasmer intends to support different integrations:

  • WASI: run WebAssembly files with the WASI ABI.
  • Emscripten: run Emscripten-generated WebAssembly files, such as Lua or nginx.
  • Go ABI: we will work on this soon! Want to give us a hand?
  • Blazor: research period, see tracking issue

Backends

The Wasmer runtime is designed to support multiple compiler backends, allowing the user to tune the codegen properties (compile speed, performance, etc) to best fit their use case.

Currently, we support multiple backends for compiling WebAssembly to machine code:

  • singlepass-backend: Single pass backend - super fast compilation, slower runtime speed
  • clif-backend: Cranelift backend - slower compilation, normal runtime speed
  • llvm-backend: LLVM backend - slow compilation, native runtime speed