Introduction

SSVM is a high performance and enterprise-ready WebAssembly (WASM) Virtual Machine for cloud, AI and Blockchain applications. Its use cases include the following.

• A high performance and secure runtime for Rust functions in Node.js applications. Getting started | VSCode Codespaces | Tensorflow | Privacy computing @ Mozilla Open Labs
• A hardware-optimized runtime for ONNX AI models. ONNC compiler for AI
• Smart contract runtime engine for leading blockchain platforms. Polkadot/Substrate | CyberMiles

Getting Started

Get Source Code

$ git clone [email protected]:second-state/SSVM.git
$ cd SSVM
$ git checkout 0.6.1

Prepare environment

Use our docker image

Our docker image use ubuntu 18.04 as base.

$ docker pull secondstate/ssvm

Or setup the environment manually

$ sudo apt install -y \
	cmake \
	gcc-8 \
	g++-8
	libboost-all-dev
# And you will need to install llvm-9 for ssvm-aot tools
$ wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
$ sudo apt update && apt install -y \
	libllvm9 \
	llvm-9 \
	llvm-9-dev \
	llvm-9-runtime \
	libclang-common-9-dev # for yaml-bench

Build SSVM

SSVM provides various tools to enabling different runtime environment for optimal performance. After the build is finished, you can find there are several ssvm related tools:

1. ssvm is for general wasm runtime. Interpreter mode.
2. ssvm-qitc is for AI application, supporting ONNC runtime for AI model in ONNX format.
   • If you want to try ssvm-qitc, please refer to ONNC-Wasm project to setup the working environment and run several examples.
   • And here is our tutorial for ONNC-Wasm project(YouTube Video).
3. ssvm-aot is for general wasm runtime. AOT compilation mode.
   • ssvmc compiles a general wasm runtime to so file.
   • ssvmr execute a general wasm runtime or so file in WASI environment.
   • To disable building the ahead of time compilation runtime, you can set the cmake option SSVM_DISABLE_AOT_RUNTIME to OFF.

# After pulling our ssvm docker image
$ docker run -it --rm \
    -v <path/to/your/ssvm/source/folder>:/root/ssvm \
    secondstate/ssvm:latest
(docker)$ cd /root/ssvm
(docker)$ mkdir -p build && cd build
(docker)$ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=ON .. && make

Run built-in tests

The following built-in tests are only avaliable when the build flag BUILD_TESTS sets to ON.

Users can use these tests to verify the correctness of SSVM binaries.

$ cd <path/to/ssvm/build_folder>
$ ctest

Run ssvm (SSVM with general wasm runtime)

To run SSVM with general wasm runtime, users will need to provide the following parameters:

1. Wasm file(/path/to/wasm/file)
2. (Optional) Entry function name, default value is main
3. (Optional) Argument List, can be one or more arguments.

Example: Fibonacci

# cd <path/to/ssvm/build_folder>
$ cd tools/ssvm
# ./ssvm wasm_file.wasm [exported_func_name] [args...]
$ ./ssvm examples/fibonacci.wasm fib 10
2020-06-23 21:53:56,703 DEBUG [default] [ubuntu@unknown-host] [Expect<void> SSVM::Interpreter::Interpreter::runFunction(Runtime::StoreManager &, const Runtime::Instance::FunctionInstance &, Span<const SSVM::ValVariant>)] [/root/ssvm/lib/interpreter/engine/engine.cpp:100]  Execution succeeded.
2020-06-23 21:53:56,703 DEBUG [default] [ubuntu@unknown-host] [Expect<void> SSVM::Interpreter::Interpreter::runFunction(Runtime::StoreManager &, const Runtime::Instance::FunctionInstance &, Span<const SSVM::ValVariant>)] [/root/ssvm/lib/interpreter/engine/engine.cpp:111]
 ====================  Statistics  ====================
 Total execution time: 52 us
 Wasm instructions execution time: 52 us
 Host functions execution time: 0 us
 Executed wasm instructions count: 1766
 Gas costs: 1855
 Instructions per second: 33961538

 Return value: 89

Example: Factorial

# ./ssvm wasm_file.wasm [exported_func_name] [args...]
$ ./ssvm examples/factorial.wasm fac 5
2020-06-23 21:56:14,706 DEBUG [default] [ubuntu@unknown-host] [Expect<void> SSVM::Interpreter::Interpreter::runFunction(Runtime::StoreManager &, const Runtime::Instance::FunctionInstance &, Span<const SSVM::ValVariant>)] [/root/ssvm/lib/interpreter/engine/engine.cpp:100]  Execution succeeded.
2020-06-23 21:56:14,707 DEBUG [default] [ubuntu@unknown-host] [Expect<void> SSVM::Interpreter::Interpreter::runFunction(Runtime::StoreManager &, const Runtime::Instance::FunctionInstance &, Span<const SSVM::ValVariant>)] [/root/ssvm/lib/interpreter/engine/engine.cpp:111]
 ====================  Statistics  ====================
 Total execution time: 49 us
 Wasm instructions execution time: 49 us
 Host functions execution time: 0 us
 Executed wasm instructions count: 55
 Gas costs: 61
 Instructions per second: 1122448

 Return value: 120

Related tools

SSVM-EVMC

SSVM-EVMC provides support for Ewasm runtime which is compatible with EVMC.

This project provides a shared library that can initialize and execute by the EVMC interface.

SSVM nodejs addon

SSVM-napi provides support for accessing SSVM as a Node.js addon.

It allows Node.js applications to call WebAssembly functions written in Rust or other high performance languages.

Why do you want to run WebAssembly on the server-side?

The SSVM addon could interact with the wasm files generated by the ssvmup compiler tool.

DevChain

The Second State DevChain features a powerful and easy-to-use virtual machine that can quickly get you started with smart contract and DApp development.

SSVM-evmc is integrated into our DevChain. Click here to learn how to run an ewasm smart contrat on a real blockchain.

Customized Host Functions

Design document shows how to register customized host functions into SSVM and execute with wasm files.