@hazae41/chacha20poly1305.wasm

chacha20poly1305.wasm

WebAssembly port of ChaCha20-Poly1305

npm i @hazae41/chacha20poly1305.wasm

Node Package 📦

Features

• Reproducible building
• Pre-bundled and streamed
• Zero-copy memory slices

Modules

• chacha20poly1305

Algorithms

• ChaCha20-Poly1305

Usage

import { ChaCha20Poly1305Wasm, ChaCha20Poly1305Cipher } from "@hazae41/chacha20poly1305.wasm";

// Wait for WASM to load
await ChaCha20Poly1305Wasm.initBundled();

using key = new Memory(crypto.getRandomValues(new Uint8Array(32)))
using nonce = new Memory(crypto.getRandomValues(new Uint8Array(12)))
using message = new Memory(crypto.getRandomValues(new Uint8Array(256)))

using chacha = new ChaCha20Poly1305Cipher(key)

using encrypted = chacha.encrypt(message, nonce)
using decrypted = chacha.decrypt(encrypted, nonce)

console.log(encrypted.bytes)
console.log(decrypted.bytes)

Building

Unreproducible building

You need to install Rust

Then, install wasm-pack

cargo install wasm-pack

Finally, do a clean install and build

npm ci && npm run build

Reproducible building

You can build the exact same bytecode using Docker, just be sure you're on a linux/amd64 host

docker compose up --build

Then check that all the files are the same using npm diff

npm diff

If the output is empty then the bytecode is the same as the one I commited

Automated checks

Each time I release a new version on GitHub, the GitHub's CI clones the GitHub repository, reproduces the build, and throws an error if the NPM release is different. If a version is present on NPM but not on GitHub, do not use it!