A zero-dependency WebAssembly virtual machine implemented in Rust.

Features

• Run multi-module WASM applications
• Disassemble WASM applications
• Supports WASI interface to run WASM programs compiled from C/C++ and Rust
• Web GUI debugging interface with step-by-step traces, breakpoints, and visualization of memory and call stack data.

一个用 Rust 实现的零依赖 WebAssembly 虚拟机。

功能

• 运行多模块 WASM 应用程序
• 反汇编 WASM 应用程序
• 支持 WASI 接口，能运行由 C/C++ 和 Rust 编译而得的 WASM 程序
• Web GUI 调试界面，能逐步跟踪、能设置断点、能直观地查看内存、调用栈的数据。

$ cargo test

$ cargo build

编译完成之后将会在 ./target/debug/ 里面得到 anvm 和 anvm-debug 两个程序。也可以编译为发行版：

$ cargo build --release

编译后的程序将会在 ./target/release 里。

$ anvm app.wasm

其中 app.wasm 为被运行的 WebAssembly 应用程序（模块），模块当中 start 段指向的函数或者名称为 main 的函数将会作为程序的入口。

如果模块文件不在当前目录，则需要写上模块文件的完整路径（也可以写相对路径），比如：

$ anvm ~/myproject/first/app.wasm

如果你不想编译就直接运行 XiaoXuan VM，也可以通过命令 cargo run 来启动 XiaoXuan VM，例如：

$ cargo run --bin anvm -- app.wasm

这跟 $ anvm app.wasm 的效果是一样的，也就是说，下面的例子当中的 $ anvm ... 都可以替换成 $ cargo run --bin anvm -- ... 。

有时一个 WebAssembly 应用程序可能由多个模块组成，如果要运行这种应用程序，则只需将所有模块（的文件名）传入 XiaoXuan VM 即可：

$ anvm core.wasm std.wasm app.wasm

程序的入口将从右侧的模块开始搜索。

$ anvm app.wasm --function app::add 123 456

上面的 app::add 为指定的函数的名称，其中 app 为模块的名称，即 *.wasm 的文件名，add 则为该模块所导出的函数的名称，123 456 为函数的参数，多个参数之间使用空格分隔。

如果想启动一个未导出的函数，也可以通过函数的索引来启动，假设 app.wasm 模块里有一个函数 sub，其索引值为 2，则启动的命令为：

$ anvm app.wasm --function app::2 123 456

上述的命令参数 --function 可以使用 -f 来代替，比如：

$ anvm app.wasm -f app::add 123 456

XiaoXuam VM 也提供了反汇编的功能，用于将二进制的 WASM 反汇编为文本格式，命令如下：

$ anvm --disassembly input.wasm output.wat

每次只能反汇编一个模块，其中的命令参数 --disassembly 可以使用 -d 来代替，比如：

$ anvm -d input.wasm output.wat