WasmEdge for Rust Storage Extension

The WasmEdge (formerly SSVM) is a high performance WebAssembly runtime optimized for server side applications. This project provides support for storage access with Rust native storage library.

Getting Started

Prepare the environment

Use our docker image (Recommanded)

Our docker image is based on ubuntu 20.04.

$ docker pull wasmedge/wasmedge

Or setup the environment manually

Please notice that WasmEdge-storage requires cmake>=3.11

# Tools and libraries
$ sudo apt install -y \
	software-properties-common \
	cmake \
	libboost-all-dev

# WasmEdge supports both clang++ and g++ compilers
# You can choose one of them for building this project
$ sudo apt install -y gcc g++
$ sudo apt install -y clang

Get WasmEdge-storage Source Code

$ git clone --recursive [email protected]:second-state/WasmEdge-storage.git
$ cd WasmEdge-storage
$ git checkout 0.8.1

Prepare Machine with RocksDB

Follow Steps to prepare a machine with RocksDB.

Install Rust and Cargo

$ curl https://sh.rustup.rs -sSf | sh
$ source $HOME/.cargo/env

Build WasmEdge-storage

WasmEdge-storage depends on WasmEdge-Core, you have to prepare WasmEdge-Core before you build WasmEdge-storage. We provides two options for setting up the WasmEdge-Core:

Create and Enter the Build Folder

# After pulling our WasmEdge docker image
$ docker run -it --rm \
    -v <path/to/your/WasmEdge-storage/source/folder>:/root/WasmEdge-storage \
    wasmedge/wasmedge:latest
(docker)$ cd /root/WasmEdge-storage
(docker)$ mkdir -p build && cd build

Option 1. Use built-in CMakeLists to get WasmEdge-Core (Recommended)

(docker)$ cmake -DCMAKE_BUILD_TYPE=Release .. && make

Option 2. Use specific version of WasmEdge-Core by giving WASMEDGE_CORE_PATH

(docker)$ cmake -DWASMEDGE_CORE_PATH=<path/to/WasmEdge/source> -DCMAKE_BUILD_TYPE=Release .. && make

The shared library build/lib/libwasmedge-storage_c.so is the C API to create the wasmedge-storage import object. The header build/include/wasmedge-storage.h is the header of the libwasmedge-storage_c.so shared library. The static library build/lib/libwasmedgeHostModuleWasmEdgeStorage.a is for executables linking in CMake.