NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #2627 most downloaded on crates.io
A library for performing WebAssembly transformations
Latest stable
0.28.0
Last release 19 days ago
03 Nov 2026
Ships unpredictably
gaps range from 8 days to 10 months
Most releases are documented
notes for 47 of 55 stable releases
1 version withdrawn
withdrawn after publishing
8 years old
56 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
LocalFunction::original_range and CodeTransform::function_ranges now start at the function body, after the body's size, rather than at the size.
LocalFunction::original_range and CodeTransform::function_ranges now
start at the function body, after the body's size, rather than at the size.
CodeTransform::code_section_start is now the start of the code section's
contents, at the function count, for any number of functions. It was
previously two bytes before the first function's size.
DWARF code addresses are no longer one byte off in modules with fewer than 128 or with 16,384 or more functions. The emitted DWARF assumed that the code section's function count takes two bytes.
A function's DWARF start address no longer moves when walrus emits its body's size in a different number of bytes than the original module did, as when re-encoding shrinks or grows a body across 128 or 16,384 bytes.
A function's DWARF start address is no longer moved into its local declarations when a transform adds locals to a function that had none.
ModuleConfig::legacy_exceptions turns off support for the legacy exception handling instructions (try, catch, catch_all, delegate and rethrow). It def
ModuleConfig::legacy_exceptions turns off support for the legacy exception
handling instructions (try, catch, catch_all, delegate and
rethrow). It defaults to true, so parsing is unchanged unless it is set
to false, in which case modules that use them fail validation.ref.func targets,
instead of walking every body four times for these. Emission of large
modules is roughly 40% faster.LocalFunction::instruction_mapping by pushing onto a Vec
instead of inserting every operator offset into a BTreeMap. The table's
contents are unchanged; parsing large modules is roughly a third faster.catch handler types when the module has no tag with params and no function
type with more than one result, or when ModuleConfig::legacy_exceptions is
false, since the pre-scan can't register a type then.InstrSeq at its exact size when the block ends, rather than
growing every block's Vec one push at a time.parallel feature, function bodies are parsed and emitted one
function per rayon task. Walrus emits functions largest first, so splitting
the function list into contiguous chunks left one thread with most of the
work, both when emitting and when parsing walrus-emitted modules.try with a catch, catch_all or
delegate in unreachable code.Your coding agent can read these notes before it upgrades. Set up the MCP server →
fix: emit DW_AT_high_pc as fixed-width DW_FORM_data4 by @guybedford in https://github.com/wasm-bindgen/walrus/pull/323
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.27.1...0.27.2
DW_AT_high_pc is now emitted as fixed-width DW_FORM_data4 (as LLVM does)
rather than DW_FORM_udata. Tools that patch code addresses in place, such
as binaryen's DWARF update under wasm-opt -g, rely on the encoded size not
changing and aborted with "compile unit size was incorrect" on walrus output.fix: tombstone removed-code DWARF addresses as -2, not -1 by @guybedford in https://github.com/wasm-bindgen/walrus/pull/322
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.27.0...0.27.1
-2 instead of -1.
In DWARF 4 .debug_loc/.debug_ranges with 4-byte addresses a begin of
-1 is the base address selection marker, so the previous tombstone made
the rest of the section unparseable (llvm-dwarfdump: "unexpected end of
data"; wasm-opt -g: "debug_loc error").fix: keep dynamic-link metadata before standard sections by @danlapid in https://github.com/wasm-bindgen/walrus/pull/320
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.26.5...0.27.0
Released 2026-09-08.
memory.discard experimental instruction removeddylink.0 and legacy dylink metadata before standard sections, preserving their payloads.memory.discard experimental instruction removed
Released 2026-09-08.
memory.discard experimental instruction removeddylink.0 and legacy dylink metadata before standard sections, preserving their payloads.Add memory.discard instruction support (memory-control proposal) by @guybedford in https://github.com/wasm-bindgen/walrus/pull/319
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.26.4...0.26.5
Fix MVP element-segment encoding for table64 active segments by @guybedford in https://github.com/wasm-bindgen/walrus/pull/317
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.26.3...0.26.4
Fix panic parsing legacy try/catch with a multi-value handler signature by @avrabe in https://github.com/wasm-bindgen/walrus/pull/316
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.26.2...0.26.3
test: spec test suite cleanup by @guybedford in https://github.com/wasm-bindgen/walrus/pull/313
ModuleProducers fields by @daxpedda in https://github.com/wasm-bindgen/walrus/pull/314Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.26.1...0.26.2
Remove producer section from test checks by @logan-gatlin in https://github.com/wasm-bindgen/walrus/pull/307
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.26.0...0.26.1
feat: Full support for GC extension by @logan-gatlin in https://github.com/wasm-bindgen/walrus/pull/304
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.25.2...0.26.0
Fix imported memory serialization to preserve flags
Fix imported memory serialization to preserve flags (#303)
Downgrade gimli from 0.33 to 0.32 by @guybedford in https://github.com/wasm-bindgen/walrus/pull/302
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.25.0...0.25.1
fix: dfs_pre_order_mut not visiting inside catch and catchall blocks by @logan-gatlin in https://github.com/wasm-bindgen/walrus/pull/297
i64.atomic.rmw8.xchg_u (fixes #299) by @aaronmunsters in https://github.com/wasm-bindgen/walrus/pull/300Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.24.4...0.25.0
Nothing published for this version
fix: trytable visit implementaiton by @guybedford in https://github.com/wasm-bindgen/walrus/pull/295
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.24.3...0.24.4
Fix gc for tags: retain tags that are only caught and never thrown too by @hoodmane in https://github.com/wasm-bindgen/walrus/pull/294
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.24.2...0.24.3
feat: legacy exceptions by @guybedford in https://github.com/wasm-bindgen/walrus/pull/293
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.24.1...0.24.2
feat: support names section for tags by @guybedford in https://github.com/wasm-bindgen/walrus/pull/292
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.24.0...0.24.1
fix: correct error message for missing function import by @oligamiq in https://github.com/wasm-bindgen/walrus/pull/289
Full Changelog: https://github.com/wasm-bindgen/walrus/compare/0.23.3...0.24.0
Nothing published for this version
Don't emit empty DWARF sections by @daxpedda in https://github.com/rustwasm/walrus/pull/284
Module::from_buffer_with_config by @kateinoigakukun in https://github.com/rustwasm/walrus/pull/285Full Changelog: https://github.com/rustwasm/walrus/compare/0.23.1...0.23.2
Emit extended name section by @surban in https://github.com/rustwasm/walrus/pull/283
Full Changelog: https://github.com/rustwasm/walrus/compare/0.23.0...0.23.1
Specify "shared" attribute of TableType to enable upgrade of wasm encoder to 0.213 by @burakemir in https://github.com/rustwasm/walrus/pull/280
Full Changelog: https://github.com/rustwasm/walrus/compare/0.22.0...0.23.0
feat: remove non_exhaustive from Instr enum by @guybedford in https://github.com/rustwasm/walrus/pull/277
Full Changelog: https://github.com/rustwasm/walrus/compare/0.21.3...0.22.0
fix: add non_exhaustive to Instr enum by @guybedford in https://github.com/rustwasm/walrus/pull/276
Full Changelog: https://github.com/rustwasm/walrus/compare/0.21.2...0.21.3
Fix most clippy warnings by @CryZe in https://github.com/rustwasm/walrus/pull/273
Full Changelog: https://github.com/rustwasm/walrus/compare/0.21.1...0.21.2
GC private tables by @zetanumbers in https://github.com/rustwasm/walrus/pull/265
Full Changelog: https://github.com/rustwasm/walrus/compare/0.21.0...0.21.1
chore: update wasm-encoder dependency to 0.38.1 by @obycode in https://github.com/rustwasm/walrus/pull/256
wasm-encoder dependency to 0.38.1 by @obycode in https://github.com/rustwasm/walrus/pull/256Full Changelog: https://github.com/rustwasm/walrus/compare/0.20.3...0.21.0
Resolve more translated address in DWARF debug info by @nokotan in https://github.com/rustwasm/walrus/pull/255
Full Changelog: https://github.com/rustwasm/walrus/compare/0.20.2...0.20.3
fix(tests): update WAT used in tests by @vados-cosmonic in https://github.com/rustwasm/walrus/pull/249
ModuleImports/ModuleExports by @vados-cosmonic in https://github.com/rustwasm/walrus/pull/251Full Changelog: https://github.com/rustwasm/walrus/compare/0.20.1...0.20.2
Use backwards-compatible encoding of element segments where possible by @Liamolucko in https://github.com/rustwasm/walrus/pull/245
Full Changelog: https://github.com/rustwasm/walrus/compare/0.20.0...0.20.1
More permissive parsing of the "name" section by @samsartor in https://github.com/rustwasm/walrus/pull/209
FunctionBuilder::local_func method. by @teymour-aldridge in https://github.com/rustwasm/walrus/pull/225syn to v2 by @daxpedda in https://github.com/rustwasm/walrus/pull/239Full Changelog: https://github.com/rustwasm/walrus/compare/0.19.0...0.20.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added support for typed select instructions.
Released 2020-02-03.
select instructions.--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Added support for multi-value Wasm!
Released 2019-09-10.
Added support for multi-value Wasm!
Added ModuleExports::get_exported_{func, table, memory, global} helper
functions to get an export by the id of the thing that it is exporting (if
any).
Added fuzz testing with libFuzzer and cargo fuzz.
No longer using the "derive" feature from failure, which should result in
slimmer dependency graphs and faster builds.
Module::emit_wasm is no longer fallible. It never actually did ever return
an Err and now the type signature reflects that.
walrus::Module::write_graphviz_dot: You can now render a whole Wasm module as a GraphViz Dot file (previously you could only do one function at a time
Released 2019-08-13.
walrus::Module::write_graphviz_dot: You can now render a whole Wasm module
as a GraphViz Dot file (previously you could only do one function at a time)
and it will also show the relationships between all the various Wasm
structures (previously it only showed the relationships between instructions).The intermediate representation for instructions (walrus::ir::*) has been
overhauled. Expr has been renamed to Instr, and an operator no longer
points to its operands as nested children in the AST. Instead of representing
every instruction as a node in an AST, now there is a tree of instruction
sequences. An instruction sequence is a vector of Instrs that relate to each
other implicitly via their effect on the stack. A nested block ... end,
loop ... end, or if ... else ... end form new nested instruction
sequences.
The Visitor and VisitorMut traits and traversing the IR has also been
overhauled:
Visitors are no longer recursive, and should never recursively call
self.visit_foo() from inside self.visit_bar(). Not in the default
provided trait methods and not in any user-written overrides of those
trait methods.
There are now traversal functions which take a visitor, a
LocalFunction, and a start InstrSeqId, and then perform some kind of
traversal over the function's IR from the given start sequence. These
traversal functions are not recursive, and are implemented with explicit
work lists and while loops. This avoids blowing the stack on deeply nested
Wasm inputs. Although we can still OOM, we leave fixing that to future
PRs. Right now there are only two traversals, because that is all we've
needed so far: an in-order DFS for immutable visitors (needs to be
in-order so we can encode instructions in the right order) and a pre-order
DFS for mutable visitors (pre-order is the easiest traversal to implement
iteratively). We can add more traversals as we need them.
The Dot trait has been made internal. Use the new
walrus::Module::write_graphviz_dot method instead.
The Visit trait is no longer exported in the public API, and has been made
internal. Use the new traversal functions instead (walrus::ir::dfs_in_order
and walrus::ir::dfs_pre_order_mut).
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Added ModuleExports::iter_mut for iterating over exclusive references to a module's exports.
Released 2019-06-05.
Added ModuleExports::iter_mut for iterating over exclusive references to a
module's exports.
Added a ModuleConfig::on_parse hook, which has access to a map from indices
in the original Wasm binary to the newly assigned walrus IDs. This is a good
time to parse custom sections that reference functions or types or whatever by
index.
The TableKind enum now has various unwrap_* helpers to get a particular
variant's inner data or else panic.
Added ModuleFunctions::by_name to get a function ID by function name.
CustomSection::data trait method now has a new parameter: a map from
walrus IDs to their indices in the new wasm binary we are emitting. This is
useful for custom sections that reference functions or types or whatever by
index.Added the walrus::ModuleCustomSections API for working with arbitrary custom sections, including and especially custom sections that walrus itself has
Released 2019-05-17.
Added the walrus::ModuleCustomSections API for working with arbitrary custom
sections, including and especially custom sections that walrus itself has no
special knowledge of. This is exposed as the customs field of a
walrus::Module.
Added the Module::with_config constructor method to create a default, empty
module that uses the given configuration.
walrus::Module::custom vector of raw custom modules has been removed and
is superceded by the new walrus::ModuleCustomSections API. If you were using
this and the old CustomSection type, switch to use the RawCustomSection
type with ModuleCustomSections.Nothing published for this version
ModuleConfig::parse_file and Module::parse_file_with_config helper functions to easily parse a Wasm file from disk with a given configuration.
Released 2019-05-02.
ModuleConfig::parse_file and Module::parse_file_with_config helper
functions to easily parse a Wasm file from disk with a given configuration.ModuleConfig::parse takes &self instead of &mut self now. This was just
an oversight / copy-past error before.--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Added support for the reference types wasm proposal. #50
Released 2019-02-19.
FunctionBuilder with the relevant &mut parts of a module,
rather than a whole &mut Module. This is useful when some parts of the
module are mutably borrowed
elsewhere. #56FunctionBuilder from an existing LocalFunction so you can build
new expressions for the
function. #54id getter for
Imports. #59WithSideEffects expression variant can have arbitrary stack-neutral side
effects before its value now, in addition to after its
value. #55Added configuration options for controlling emission of the producers section
Released 2019-02-14.
Added configuration options for controlling emission of the DWARF and name custom sections.
Released 2019-02-14.
Released 2019-02-12. ### Added * Initial release!
Released 2019-02-12.
One column per quarter.