aes.wasm

WebAssembly port of AES

npm i @hazae41/aes.wasm

Node Package 📦

Features

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

Modules

• aes
• ctr

Algorithms

• AES-128-CTR-128-BE

Usage

import { AesWasm, Memory, Aes128Ctr128BEKey } from "@hazae41/aes.wasm";

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

const plaintext = new TextEncoder().encode("Hello World")

using memory = new Memory(plaintext)

const key = crypto.getRandomValues(new Uint8Array(16))
const iv = crypto.getRandomValues(new Uint8Array(16))

using key_memory = new Memory(key)
using iv_memory = new Memory(iv)

using cipher = new Aes128Ctr128BEKey(key_memory, iv_memory)
using decipher = new Aes128Ctr128BEKey(key_memory, iv_memory)

/**
 * Encryption
 */

cipher.apply_keystream(memory)
console.log(memory.bytes)

cipher.apply_keystream(memory)
console.log(memory.bytes)

/**
 * Decryption
 */

decipher.apply_keystream(memory)
console.log(memory.bytes)

decipher.apply_keystream(memory)
console.log(memory.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!