`ic-wasm`

A library for transforming Wasm canisters running on the Internet Computer

Executable

To install the ic-wasm executable, run

$ cargo install ic-wasm

Manage metadata in the Wasm module.

Usage: ic-wasm <input.wasm> [-o <output.wasm>] metadata [name] [-d <text content> | -f <file content>] [-v <public|private>]

List current metadata sections $ ic-wasm input.wasm metadata
List a specific metadata content $ ic-wasm input.wasm metadata candid:service
Add/overwrite a private metadata section $ ic-wasm input.wasm -o output.wasm metadata new_section -d "hello, world"
Add/overwrite a public metadata section from file $ ic-wasm input.wasm -o output.wasm metadata candid:service -f service.did -v public

Print information about the Wasm canister

Usage: ic-wasm <input.wasm> info

Remove unused functions and debug info

Usage: ic-wasm <input.wasm> -o <output.wasm> shrink

Instrument canister method to emit execution trace to stable memory. Doesn't apply to nested Wasm modules generated by Motoko.

Usage: ic-wasm <input.wasm> -o <output.wasm> instrument

To use ic-wasm as a library, add this to your Cargo.toml:

toml [dependencies.ic-wasm] default-features = false

See our CONTRIBUTING to get started.