Go to file
Andrew Dirksen 84331a9325 don't make the user reset Interpreter between invocations 2018-11-21 17:12:47 -08:00
benches don't make the user reset Interpreter between invocations 2018-11-21 17:12:47 -08:00
examples Preserve signalling bit in NaNs (#87) 2018-04-25 10:18:14 +03:00
fuzz Travis maintenance (#132) 2018-10-26 15:03:01 +02:00
hfuzz Travis maintenance (#132) 2018-10-26 15:03:01 +02:00
res/fixtures Remove old fixtures. (#54) 2018-02-14 13:33:24 +03:00
src don't make the user reset Interpreter between invocations 2018-11-21 17:12:47 -08:00
tests Bump wabt's version to 0.4 and add two more test cases (#114) 2018-07-30 19:43:18 +03:00
.editorconfig [skip-ci] Add .editorconfig 2018-01-22 20:08:17 +03:00
.gitignore Add spec tests. 2018-01-22 17:55:43 +03:00
.gitmodules Move spec testsuite into tests. (#56) 2018-02-14 18:03:39 +03:00
.travis.yml Allow failures on nightly (#143) 2018-11-15 13:11:10 +01:00
Cargo.toml Bump version to 0.4.2 (#144) 2018-11-15 13:19:53 +01:00
LICENSE-APACHE Update copyrights 2018-01-23 19:51:29 +03:00
LICENSE-MIT Update copyrights 2018-01-23 19:51:29 +03:00
README.md Add no_std support (#122) 2018-10-29 11:16:55 +01:00
check.sh Move spec testsuite into tests. (#56) 2018-02-14 18:03:39 +03:00
doc.sh Add a simple bench (#90) 2018-05-24 16:31:15 +03:00
test.sh Move spec testsuite into tests. (#56) 2018-02-14 18:03:39 +03:00

README.md

crates.io link Build Status

wasmi

WASM interpreter (previously lived in parity-wasm)

Primary purpose of wasmi is to be used with parity (ethereum-like contracts in wasm) and with Polkadot. However, wasmi is designed to be as flexible as possible and might be suited well for other purposes.

At the moment, the API is rather low-level (especially, in the part related to host functions). But some high-level API is on the roadmap.

License

wasmi is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), at your choice.

See LICENSE-APACHE, and LICENSE-MIT for details.

Build & Test

As wasmi contains a git submodule, you need to use --recursive for cloning or to checkout the submodule explicitly, otherwise the testing would fail.

git clone https://github.com/paritytech/wasmi.git --recursive
cd wasmi
cargo build
cargo test

no_std support

This crate supports no_std environments. Enable the core feature and disable default features:

[dependencies]
parity-wasm = {
	version = "0.31",
	default-features = false,
	features = "core"
}

The core feature requires the core and alloc libraries and a nightly compiler. Also, code related to std::error is disabled.

Floating point operations in no_std use libm, which sometimes panics in debug mode (https://github.com/japaric/libm/issues/4). So make sure to either use release builds or avoid WASM with floating point operations, for example by using deny_floating_point.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in wasmi by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.