1 个不稳定版本

0.46.0 2023 年 2 月 4 日

#922 in WebAssembly


wasmut 中使用

MIT/Apache

315KB
9K SLoC

wasmut-wasm

低级别 WebAssembly 格式库。这是从 paritytech/parity-wasm 分支出来的,并且专门针对 wasmut 进行了增强。

crates.io link

文档

Rust WebAssembly 格式序列化/反序列化

添加到 Cargo.toml

[dependencies]
wasmut-wasm = "0.42"

然后

let module = wasmut_wasm::deserialize_file("./res/cases/v1/hello.wasm").unwrap();
assert!(module.code_section().is_some());

let code_section = module.code_section().unwrap(); // Part of the module with functions code

println!("Function count in wasm file: {}", code_section.bodies().len());

Wabt 测试套件

wasmut-wasm 支持完整的 wasm 测试套件,运行涉及反序列化的断言。

要运行测试套件

  • 使用子模块检出 (git submodule update --init --recursive)
  • 运行 cargo test --release --workspace

解码器可以使用 cargo-fuzzwasm-opt 进行模糊测试

  • 确保您已安装所有构建 binaryencargo-fuzz 的先决条件(cmake 和 C++11 工具链)
  • 使用子模块检出 (git submodule update --init --recursive)
  • 使用 cargo fuzz 子命令安装 cargo install cargo-fuzz
  • 将 rustup 设置为使用夜间工具链,因为 cargo fuzz 使用 rust 编译器插件:rustup override set nightly
  • 运行 cargo fuzz run deserialize

no_std crates

这个包有一个默认启用的特性 std。要在 no_std 环境中使用此包,请将以下内容添加到您的 Cargo.toml 文件中(尽管仍然需要分配器)

[dependencies]
wasmut-wasm = { version = "0.41", default-features = false }

许可证

wasmut-wasm 主要在 MIT 许可证和 Apache 许可证(版本 2.0)的条款下分发,您可以选择其中之一。

请参阅 LICENSE-APACHE 和 LICENSE-MIT 以获取详细信息。

贡献

除非您明确声明,否则根据 Apache-2.0 许可证定义,您提交的任何有意包含在 wasmut-wasm 中的贡献将按照上述方式双许可,不附加任何额外条款或条件。

无运行时依赖