Skip to content
pulseenginePublic

About

Loom — WebAssembly optimizer; every rewrite is checked by per-run SMT translation validation. Part of PulseEngine, the WebAssembly Component Model engine.

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

499 Commits

Folders and files

Repository files navigation

Loom

WebAssembly optimizer with per-pass translation validation (exact for loop-free functions)

 

CI Rust WebAssembly Translation validation: loop-free functions License: Apache-2.0

 

Meld · Loom · Synth · Kiln · Sigil

 

Meld fuses. Loom weaves. Synth transpiles. Kiln fires. Sigil seals.

WebAssembly optimization pipeline built on Cranelift's ISLE pattern-matching engine. Constant folding, strength reduction, CSE, inlining, dead code elimination. After each pass a Z3 SMT translation validator compares each changed function with its previous version and keeps the change only if the two are proven equivalent. For a function without loops the comparison is exact: return values, globals, every linear memory and its size, and traps, including the globals and memory a trap leaves behind. A function that is outside this model (a loop-free function with an instruction it does not model) is not changed. A function with loops is checked by a separate loop verifier that compares less (not memory, globals or traps), so for such functions a passing check is not a proof that the output is equivalent; --stats lists those acceptances as kept without a proof. Floating-point arithmetic on non-constant operands is compared as uninterpreted functions, and a NaN result is taken to have one payload per operation and operands. Includes a fused mode purpose-built for Meld output.

Loom consistently achieves 80-95% binary size reduction with 10-30 microsecond optimization times. The entire pipeline is pure Rust with minimal dependencies.

Quick Start

# Build from source
git clone https://github.com/pulseengine/loom
cd loom
cargo build --release

# Optimize a WebAssembly module
loom optimize input.wasm -o output.wasm

# With statistics
loom optimize input.wasm -o output.wasm --stats

# With Z3 verification
loom optimize input.wasm -o output.wasm --verify

Architecture

  • loom-core — Optimization pipeline implementation
  • loom-shared — Core ISLE definitions and WebAssembly IR (stable API)
  • loom-cli — Command-line interface
  • loom-testing — Differential testing framework

Two pipeline surfaces:

  • Library optimize_module() (loom-core) runs the canonical pipeline: Inline → Constant Folding → Advanced Instructions → Simplify Locals → DCE → Code Folding → LICM → Remove Unused Branches → Optimize Added Constants → DCE → Coalesce Locals.
  • CLI loom optimize --passes exposes selectable passes: inline, precompute, constant-folding, cse, advanced, branches, dce, merge-blocks, vacuum, simplify-locals.

See docs/architecture.md for the full pipeline design.

Features

  • Constant folding — Compile-time evaluation with cross-function propagation via inlining
  • Strength reduction — Replace expensive ops with cheaper equivalents (x * 8 becomes x << 3)
  • Common subexpression elimination — Deduplicate redundant computations
  • Function inlining — Inline small functions to expose cross-function optimizations
  • Dead code elimination — Remove unreachable code and unused locals
  • Loop-invariant code motion — Hoist invariant expressions out of loops
  • Component Model support — wasm32-wasip2 build target
  • Stateful dataflow analysis — Track locals and memory state across passes
  • Idempotent passes — Safe to run multiple times without degradation

Translation Validation

Z3 SMT translation validation is on by default (default = ["verification", "attestation"] in loom-core / loom-cli Cargo.toml). After each optimization pass the validator asks for an input on which the original and the optimized function differ, and keeps the change only if there is none; otherwise the function is reverted to its pre-pass state. For a function without loops the comparison is exact: return values, globals, every linear memory and its size, and traps, including the globals and memory a trap leaves behind. A function that is outside this model (a loop-free function with an instruction it does not model) is not changed. A function with loops is checked by a separate loop verifier that compares less (not memory, globals or traps), so for such functions a passing check is not a proof that the output is equivalent; --stats lists those acceptances as kept without a proof. Floating-point arithmetic on non-constant operands is compared as uninterpreted functions, and a NaN result is taken to have one payload per operation and operands. Functions over the solver size threshold are kept without a check. --stats reports how many accepted transforms were proven and how many were kept without a proof, with the reason.

# Default build — Z3 verification on
cargo build --release
loom optimize input.wasm -o output.wasm --verify

# Disable Z3 (faster, no translation validation)
cargo build --release --no-default-features

See docs/guides/formal-verification.md for details.

Note

Cross-cutting verification — Rocq mechanized proofs, Kani bounded model checking, Z3 SMT verification, and Verus Rust verification are used across the PulseEngine toolchain. Sigil attestation chains bind it all together.

Documentation

Building

cargo build --release                            # Standard build (Z3 on by default)
cargo build --release --no-default-features      # Without Z3 verification
cargo test                                       # Run tests
cargo bench                                      # Run benchmarks

# WASM build (CI uses these exact steps)
rustup target add wasm32-wasip2
cargo build --release --target wasm32-wasip2 --package loom-cli

License

Apache-2.0


Part of PulseEngine — WebAssembly verification toolchain for safety-critical systems

About

Loom — WebAssembly optimizer; every rewrite is checked by per-run SMT translation validation. Part of PulseEngine, the WebAssembly Component Model engine.

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages