Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wwwg/wasmdec
WebAssembly to C decompiler
https://github.com/wwwg/wasmdec
binaryen decompile decompiler webassembly
Last synced: about 1 month ago
JSON representation
WebAssembly to C decompiler
- Host: GitHub
- URL: https://github.com/wwwg/wasmdec
- Owner: wwwg
- License: mit
- Created: 2017-07-20T07:36:30.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-02-07T20:04:21.000Z (10 months ago)
- Last Synced: 2024-08-03T01:12:42.810Z (4 months ago)
- Topics: binaryen, decompile, decompiler, webassembly
- Language: C++
- Homepage: https://wwwg.github.io/web-wasmdec/
- Size: 7.73 MB
- Stars: 395
- Watchers: 16
- Forks: 26
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-wasm-tools - repo - wasmdec/) (Inspecting)
README
# wasmdec
wasmdec is a program that converts WebAssembly binaries to C.
# Demo
[An online real-time WebAssembly decompiler utilizing wasmdec is avalible here](https://wwwg.github.io/web-wasmdec/)
# Simple Example
wasmdec will translate this WebAssembly binary:
```wasm
(module
(func $addTwo (param i32 i32) (result i32)
(return
(i32.add (get_local 0) (get_local 1))
)
)
(export "addTwo" $addTwo)
)
```
To the following pseudo-C code:
```c
int fn_addTwo(int arg0, int arg1) {
return arg0 + arg1;
}
```
# More practical examples
### [Diep.io](https://diep.io) (HTML5 web game written in C++ and compiled to WASM)
Diep.io is a real time web game written in C++ and compiled to WebAssembly via Emscripten.
* The WebAssembly binary is is always `http://static.diep.io/build_.wasm.wasm`
* [The decompiled binary is avalible here](examples/diep_decompiled.c)
### wasmdec
wasmdec is capable of decompiling itself back to C.
* The makefile has a `wasm` target that uses [Emscripten](https://github.com/kripken/emscripten) to compile wasmdec to WebAssembly
* [The decompiled binary is avalible here](examples/wasmdec_decompiled.c)
### [WebDSP](https://github.com/shamadee/web-dsp) (a signal processing library compiled to WASM)
From the [WebDSP repository](https://github.com/shamadee/web-dsp):
```
WebDSP is a collection of highly performant algorithms, which are designed to be building blocks for web applications that aim to operate on media data. The methods are written in C++ and compiled to WASM, and exposed as simple vanilla Javascript functions developers can run on the client side.
```
* A compiled version of the library is avalible on the WebDSP demo page
* [The decompiled library is avalible here](examples/webdsp_decompiled.c)
# Applications
[A CTF write-up which uses wasmdec to reverse engineer a WASM binary](http://maroueneboubakri.blogspot.com/2018/04/nuit-du-hack-ctf-quals-2018-assemblyme.html)
# Installing with release
- Grab a release on the releases page and select the correct tarball for your OS and arch.
- Extract and run `install.sh` as root.
# Installing manually
## Getting the code
Clone the repository with
```bash
git clone https://github.com/wwwg/wasmdec.git --recursive
```
Make sure the recursive flag is set to clone all the submodules.
## Building
To build wasmdec and install all of it's dependencies, run `sudo make all` in the `wasmdec` directory. GCC 7 or higher is reccomended.
# Usage
```bash
wasmdec -o (output file) (options) [input files]
```
Where options is one of:
- `-e` or `--extra` : Emits extra function information as comments:
* Raw WebAssembly names of functions
* Number of local variables and parameters of functions
- `-m` or `--memdump` :
* Dumps the binary's memory and table to disk
* NOTE : memdump ONLY dumps memory and doesn't actually do any decompilation
- `-d` or `--debug` : Print extra debug information to stdout
- If no output file is specified, the default is `out.c`
- When more than one input file is provided, wasmdec will decompile each WebAssembly to the same output file. Functions from more than one file are prefixed by their module name in order to prevent ambiguous function definitions.