7 releases
Uses old Rust 2015
0.4.5 | May 14, 2019 |
---|---|
0.4.4 | May 14, 2019 |
0.3.0 | May 14, 2019 |
#25 in #wasm-bytecode
410KB
10K
SLoC
xwasmi
xwasmi
- a Wasm interpreter.
xwasmi
was conceived as a component of s-sophon (sophon-like contracts in xwasm) and higgsfield. These projects are related to blockchain and require a high degree of correctness, even if that might be over conservative. This specifically means that we are not trying to be involved in any implementation of any of work-in-progress Wasm proposals. We are also trying to be as close as possible to the spec, which means we are trying to avoid features that is not directly supported by the spec. This means that it is flexible on the one hand and on the other hand there shouldn't be a problem migrating to another spec compilant execution engine.
With all that said, xwasmi
should be a good option for initial prototyping.
Build & Test
As xwasmi
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/susytech/xwasmi.git --recursive
cd xwasmi
cargo build
cargo test
no_std
support
This crate supports no_std
environments.
Enable the core
feature and disable default features:
[dependencies]
xwasm = {
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
.
License
xwasmi
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.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in xwasmi
by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Dependencies
~330–660KB
~14K SLoC