ES-blst

ES and TypeScript wrapper around Wasm-built blst BLS12-381 signature library.

Requirements

ES2022 environment for asynchronous instantiating of the Wasm module during loading.

Build

Prerequisites

Clang >= 9.0 with wasm32 target available

MacOS

By default Homebrew doesn't link LLVM executables into its global executables directory which is usually listed in PATH. To build on MacOS you have to add LLVM directory (usually /opt/homebrew/opt/llvm/bin or /usr/local/opt/llvm/bin depending on Homebrew version) to PATH:

1export PATH="/opt/homebrew/opt/llvm/bin:${PATH}"

The exact path will be printed after LLVM installation is finished.

Building

1npm run init && npm run build

Example

1import { MinPk } from "es-blst";
2
3// generate a private key
4const ikm = new Uint8Array(32);
5crypto.getRandomValues(ikm);
6const priv = MinPk.PrivateKey.generate(ikm);
7
8// sign a message
9const msg = new TextEncoder().encode("message text");
10const sig = priv.sign(msg, "aug");
11
12// derive a public key
13const pub = priv.public();
14
15// verify
16const ok = sig.verify("aug", pub, msg);
17console.log(ok);