The WebAssembly binary file decoder in Rust
A Bytecode Alliance project
The decoder library provides lightweight and fast decoding/parsing of WebAssembly binary files.
The other goal is minimal memory footprint. For this reason, there is no AST or IR of WebAssembly data.
See also its sibling at https://github.com/wasdk/wasmparser
Documentation
The documentation and examples can be found at the https://docs.rs/wasmparser/
Example
{ println!(" Export {} {:?}", get_name(field), kind); } ParserState::ImportSectionEntry { module, field, .. } => { println!(" Import {}::{}", get_name(module), get_name(field)) } ParserState::EndWasm => break, _ => ( /* println!(" Other {:?}", state) */ ) } } }">
use wasmparser::WasmDecoder; use wasmparser::Parser; use wasmparser::ParserState; fn get_name(bytes: &[u8]) -> &str { str::from_utf8(bytes).ok().unwrap() } fn main() { let ref buf: Vec<u8> = read_wasm_bytes(); let mut parser = Parser::new(buf); loop { let state = parser.read(); match *state { ParserState::BeginWasm { .. } => { println!("====== Module"); } ParserState::ExportSectionEntry { field, ref kind, .. } => { println!(" Export {} {:?}", get_name(field), kind); } ParserState::ImportSectionEntry { module, field, .. } => { println!(" Import {}::{}", get_name(module), get_name(field)) } ParserState::EndWasm => break, _ => ( /* println!(" Other {:?}", state) */ ) } } }
Fuzzing
To fuzz test wasmparser.rs, switch to a nightly Rust compiler and install cargo-fuzz:
cargo install cargo-fuzz
Then, from the root of the repository, run:
cargo fuzz run parse
If you want to use files as seeds for the fuzzer, add them to fuzz/corpus/parse/ and restart cargo-fuzz.
16 Aug 28, 2022
129 Dec 28, 2022
7 Apr 18, 2022
12 Dec 12, 2022
14.1k Jan 8, 2023
2 Jan 4, 2022
6 Nov 24, 2021
5 Oct 5, 2021
103 Dec 25, 2022
2 Dec 17, 2022
6 Oct 11, 2022
30 Nov 25, 2022
11 Nov 27, 2022
5 Feb 18, 2024
26 Sep 23, 2022
6.1k Dec 30, 2022
1.2k Jan 5, 2023
19 Oct 28, 2022