externref CLI

externref CLI app allows transforming WASM modules that use externref shims to use real externref types. This is a mandatory step to get the module to work correctly.

Usage

The executable provides the same functionality as the WASM [processor] from the externref crate. See its docs and the output of externref --help for a detailed description of available options.

Warning

The processor should run before WASM optimization tools such as wasm-opt from binaryen.

The terminal capture below demonstrates transforming a test WASM module. The capture includes the tracing output, which was switched on by setting the RUST_LOG env variable. Tracing info includes each transformed function and some other information that could be useful for debugging.

Installation options

• Use a pre-built binary for popular targets (x86_64 for Linux / macOS / Windows and AArch64 for macOS) from the master branch.
• Use a pre-built binary for popular targets from GitHub Releases.
• Use the app Docker image.
• Build from sources using Rust / cargo.

Downloads

Important

The binaries are updated on each push to the git repo branch. Hence, they may contain more bugs than the release binaries mentioned above.