mithril-client-wasm

Mithril-client-wasm

This is a work in progress 🛠

• mithril-client-wasm defines all the tooling necessary to manipulate Mithril certified types available from a Mithril aggregator from a WASM compatible browser.

• The different types of available data certified by Mithril are:

  • Snapshot: list and get.
  • Mithril stake distribution: list and get.
  • Cardano transactions: list & get snapshots, get proofs
  • Certificate: list, get, and chain validation.

Installation

• Install a correctly configured Rust toolchain (latest stable version). You can follow the instructions provided here.

• Install the WASM target:

rustup target add wasm32-unknown-unknown

• Install Rust WASM Pack:

cargo install wasm-pack

• Install clang:

sudo apt install clang

• Install nodejs version 16.15+

sudo apt install nodejs

• Install npm version 8.11+

sudo apt install npm

[!WARNING] If you have troubles building the BLST library, you will need to:

• Install Emscripten
• For macOS users, consider reading this guide to activate the emcc command
• Use these environment variables to use this compiler (or prefix all following commands with them):

export CC=emcc
export AR=emar

• Install the WASM emscripten target:

rustup target add wasm32-unknown-emscripten

Build Mithril client library in WASM

Go to the mithril-client-wasm directory:

cd mithril-client-wasm

Then you can build the WASM library:

make build

Run the Mithril client library in the browser

You will need to run the Mithril client library in a compatible browser:

Browser	Minimum version	Released	Tested in CI
Chrome	54	2016-10-12	:heavy_check_mark:
Edge	79	2020-01-15	-
Firefox	38	2015-05-12	:heavy_check_mark:
Opera	41	2016-10-25	-
Safari	15.4	2022-03-14	-
Chrome Android	54	2016-10-19	-
Firefox for Android	38	2015-05-12	-
Opera Android	41	2016-10-25	-
Safari on iOS	15.4	2022-03-14	-

Go to the mithril-client-wasm directory:

cd mithril-client-wasm

Install the library:

make www-install

Then you can serve the Mithril client library in the browser:

make www-serve

Finally, open http://localhost:8080 with your browser. (port 8080 is the default port)