https://github.com/mesalock-linux/wasmi-sgx

Wasm interpreter in Rust
https://github.com/mesalock-linux/wasmi-sgx

Last synced: 3 months ago
JSON representation

Wasm interpreter in Rust

• Host: GitHub
• URL: https://github.com/mesalock-linux/wasmi-sgx
• Owner: mesalock-linux
• License: apache-2.0
• Fork: true (wasmi-labs/wasmi)
• Created: 2019-05-18T23:55:08.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-06-15T10:32:54.000Z (5 months ago)
• Last Synced: 2024-06-16T04:34:04.857Z (5 months ago)
• Language: Rust
• Homepage: https://paritytech.github.io/wasmi/
• Size: 2.47 MB
• Stars: 10
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

• Awesome-SGX-Open-Source - https://github.com/mesalock-linux/wasmi-sgx

README

        
[![crates.io link](https://img.shields.io/crates/v/wasmi.svg)](https://crates.io/crates/wasmi)

[![Build Status](https://travis-ci.org/paritytech/wasmi.svg?branch=master)](https://travis-ci.org/paritytech/wasmi)

# `wasmi`

`wasmi` - a Wasm interpreter.

`wasmi` was conceived as a component of [parity-ethereum](https://github.com/paritytech/parity-ethereum) (ethereum-like contracts in wasm) and [substrate](https://github.com/paritytech/substrate). 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 compliant execution engine.

With all that said, `wasmi` should be a good option for initial prototyping.

# 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:

```toml

[dependencies]

wasmi = {

	version = "*",

	default-features = false,

	features = "core"

}

```

When the `core` feature is enabled, code related to `std::error` is disabled.

Floating point operations in `no_std` use [`libm`](https://crates.io/crates/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`](https://docs.rs/wasmi/0.4.0/wasmi/struct.Module.html#method.deny_floating_point).

# 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.

## 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.