This crate requires a nightly (unstable, experimental) compiler version. To switch to it, you must have Rust installed via Rustup, and run:

rustup default nightly

Run rustup default stable to switch back.

Adding `pwasm_std` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add pwasm-std

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

pwasm-std = "0.13.1"

The pwasm_std library will be automatically available globally. Read the pwasm_std library documentation.

Back to the crate overview.

Readme

pwasm-std

Parity WASM contracts standard library for Rust

Documentation

pwasm-std is a limited subset of the Rust standard library, along with a custom allocator which delegates the allocation to the runtime-defined externs.

Use

Just add a dependency

[dependencies]
pwasm-std = "0.13"

Test pwasm-std with

cargo test --features=test

The crate is supposed to be used on nightly Rust only, until the custom allocator api stablizes in Rust.

no_std

pwasm-std is itself compiled with no_std and expected to be used within no_std-crates/binaries, since it defines lang_item-s on it's own, which will conflict with standard library.

But for test scenarios it can be compiled with feature "std" and auxiliary crate "pwasm-test" to support testing of contracts' internal logic.

License

pwasm-std 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 pwasm-std by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Adding pwasm_std library as a dependency

Adding `pwasm_std` library as a dependency