https://github.com/WAVM/WAVM

WebAssembly Virtual Machine
https://github.com/WAVM/WAVM

Last synced: about 2 months ago
JSON representation

WebAssembly Virtual Machine

• Host: GitHub
• URL: https://github.com/WAVM/WAVM
• Owner: WAVM
• License: bsd-3-clause
• Created: 2015-08-21T11:14:30.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-02-14T18:05:44.000Z (10 months ago)
• Last Synced: 2024-04-10T09:07:33.299Z (8 months ago)
• Language: C++
• Homepage: https://wavm.github.io/
• Size: 15.4 MB
• Stars: 2,591
• Watchers: 75
• Forks: 223
• Open Issues: 87
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-wasi - WAVM
• awesome-repositories - WAVM/WAVM - WebAssembly Virtual Machine (C++)
• awesome-list - WAVM

README

        
[![BSD license](https://img.shields.io/badge/license-BSD-green)](LICENSE.txt)

[![GitHub repo](https://img.shields.io/badge/repo-github-green.svg)](https://github.com/WAVM/WAVM)

[![Discord](https://img.shields.io/discord/484466837988573194)](https://discordapp.com/invite/fchkxFM)

[![Azure Build Status](https://dev.azure.com/WAVM/WAVM/_apis/build/status/WAVM.WAVM)](https://dev.azure.com/WAVM/WAVM/_build/latest?definitionId=1)

# WAVM

[Getting Started](Doc/GettingStarted.md) | [Building WAVM from Source](Doc/Building.md) | [Exploring the WAVM source](Doc/CodeOrganization.md)

##### WAVM is a WebAssembly virtual machine, designed for use in non-browser applications.

### Fast

WAVM uses [LLVM](https://llvm.org/) to compile WebAssembly code to machine code with close to

native performance. It can even beat native performance in some cases, thanks to the ability to

generate machine code tuned for the exact CPU that is running the code.

WAVM also leverages virtual memory and signal handlers to execute WebAssembly's bounds-checked

memory accesses at the same cost as a native, unchecked memory access.

### Safe

WAVM prevents WebAssembly code from accessing state outside of WebAssembly virtual machine*, or

calling native code that you do not explicitly link with the WebAssembly module.

* WAVM is vulnerable to some side-channel attacks, such as Spectre variant 2. WAVM may

add further mitigations for specific side-channel attacks, but it's impractical to guard against

all such attacks. You should use another form of isolation, such as OS processes, to protect

sensitive data from untrusted WebAssembly code.

### WebAssembly 1.0+

WAVM fully supports WebAssembly 1.0, plus many proposed extensions to it:

* [WASI](https://github.com/WebAssembly/WASI)

* [128-bit SIMD](https://github.com/WebAssembly/simd)

* [Threads](https://github.com/WebAssembly/threads)

* [Reference types](https://github.com/WebAssembly/reference-types)

* [Multiple results and block parameters](https://github.com/WebAssembly/multi-value)

* [Bulk memory operations](https://github.com/webassembly/bulk-memory-operations)

* [Non-trapping float-to-int conversions](https://github.com/WebAssembly/nontrapping-float-to-int-conversions)

* [Sign-extension instructions](https://github.com/WebAssembly/sign-extension-ops)

* [Exception handling](https://github.com/WebAssembly/exception-handling)

* [Extended name section](https://github.com/WebAssembly/extended-name-section)

* [Multiple memories](https://github.com/WebAssembly/multi-memory)

### Portable

WAVM is written in portable C/C++, with a small amount of architecture-specific assembly and LLVM

IR generation code.

WAVM is tested on and fully supports X86-64 Windows, MacOS, and Linux. It is designed to run on any

POSIX-compatible system, but is not routinely tested on other systems.

Support for AArch64 is a [work-in-progress](#76).

WAVM mostly works on AArch64 Linux, but with some known bugs with handling WebAssembly stack

overflow and partially out-of-bounds stores.

WAVM's runtime requires a 64-bit virtual address space, and so is not portable to 32-bit hosts.

However, WAVM's assembler and disassembler work on 32-bit hosts.

[Portability Matrix](Doc/PortabilityMatrix.md)