You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Josh Triplett c0c7851cb6 Fix fuzz build (#458) 5 years ago
.dependabot Add dependabot configuration 5 years ago
ci Cache configuration documentation 5 years ago
docs Add book documentation skeleton and auto-publish from CI (#435) 5 years ago
filetests Add more trapping testcases. 6 years ago
fuzz Fix fuzz build (#458) 5 years ago
installer/msi Cache configuration documentation 5 years ago
lightbeam Migrate from failure to thiserror and anyhow (#436) 5 years ago
misc Migrate from failure to thiserror and anyhow (#436) 5 years ago
misc_testsuite Implement the remaining valid spec tests. 6 years ago
spec_testsuite@78d896f088 Update SIMD spec tests to latest upstream revision (#444) 5 years ago
src Migrate from failure to thiserror and anyhow (#436) 5 years ago
tests Switch from `wabt` crate to `wast` (#434) 5 years ago
wasmtime-api Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-debug Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-environ Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-interface-types Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-jit Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-obj Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-runtime Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-wasi Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-wasi-c Migrate from failure to thiserror and anyhow (#436) 5 years ago
wasmtime-wast wasmtime-wast: Fix copy-pasted doc comment (#453) 5 years ago
.azure-pipelines.yml Add book documentation skeleton and auto-publish from CI (#435) 5 years ago
.gitignore Add book documentation skeleton and auto-publish from CI (#435) 5 years ago
.gitmodules Remove the Lightbeam submodule. 5 years ago
.rustfmt.toml Update .rustfmt.toml 6 years ago
CACHE_CONFIGURATION.md Cache configuration documentation 5 years ago
CODE_OF_CONDUCT.md Add a CODE_OF_CONDUCT.nd and CONTRIBUTING.md. 6 years ago
CONTRIBUTING.md Add a CODE_OF_CONDUCT.nd and CONTRIBUTING.md. 6 years ago
Cargo.toml Migrate from failure to thiserror and anyhow (#436) 5 years ago
LICENSE Adjust whitespace to match the upstream exception text. 6 years ago
README.md Update the README.md. (#410) 5 years ago
build.rs Add more SIMD spec tests (#388) 5 years ago
clippy.toml More code reorganization and cleanups. 6 years ago
cranelift-version.sh Update cranelift to 0.44.0 5 years ago
format-all.sh Update to cranelift's formatting and testing scripts. 6 years ago
publish-all.sh Topologically sort package ordering in publish-all.sh. 5 years ago
test-all.sh Test Lightbeam. 5 years ago

README.md

Wasmtime: a WebAssembly Runtime.

Wasmtime is a standalone wasm-only optimizing runtime for WebAssembly and WASI. It runs WebAssembly code outside of the Web, and can be used both as a command-line utility or as a library embedded in a larger application.

To get started, visit wasmtime.dev.

Build Status Gitter chat Minimum rustc 1.37

There are Rust, C, and C++ toolchains that can compile programs with WASI. See the WASI intro for more information, and the WASI tutorial for a tutorial on compiling and running programs using WASI and wasmtime, as well as an overview of the filesystem sandboxing system.

Wasmtime passes the WebAssembly spec testsuite. To run it, update the spec_testsuite submodule with git submodule update --remote, and it will be run as part of cargo test.

Wasmtime does not yet implement Spectre mitigations, however this is a subject of ongoing research.

Additional goals for Wasmtime include:

  • Support a variety of host APIs (not just WASI), with fast calling sequences, and develop proposals for additional API modules to be part of WASI.
  • Implement the proposed WebAssembly C API.
  • Facilitate testing, experimentation, and development around the Cranelift and Lightbeam JITs.
  • Develop a native ABI used for compiling WebAssembly suitable for use in both JIT and AOT to native object files.

Including Wasmtime in your project

Wasmtime exposes an API for JIT compilation through the wasmtime-jit subcrate, which depends on wasmtime-environ and wasmtime-runtime for the ABI and runtime support respectively. However, this API is not documented and subject to change. Please use at your own risk!

Build the individual crates as such:

cargo build --package wasmtime-jit

Wasmtime does not currently publish these crates on crates.io. They may be included as a git dependency, like this:

[dependencies]
wasmtime-environ = { git = "https://github.com/CraneStation/wasmtime", rev = "somecommithash" }
wasmtime-runtime = { git = "https://github.com/CraneStation/wasmtime", rev = "somecommithash" }
wasmtime-jit = { git = "https://github.com/CraneStation/wasmtime", rev = "somecommithash" }

All three crates must be specified as dependencies for wasmtime-jit to build correctly, at the moment.

It's Wasmtime.