Morax
WebAssembly port of RustCrypto's SHA-1 and Keccak-256 and Sam Rijs's crc32fast
npm i @hazae41/morax
Node Package ðĶ âĒ Deno Module ðĶ âĒ Next.js CodeSandbox ðŠĢ
Use case
This WebAssembly module is useful when you want to use hashes incrementially, as WebCrypto doesn't support incremental hashing, and want good performances.
Performances | Incremental hashing | |
---|---|---|
Morax | âïļâïļâïļâïļ | â |
WebCrypto | âïļâïļâïļâïļâïļ | â |
JavaScript | âïļâïļâïļ | â |
Benchmarks
SHA-1
Deno
cpu: Apple M1 Max
runtime: deno 1.30.3 (arm64-darwin)
ââââââââââââââââââââââââââŽââââââââââââââââââŽâââââââââââââŽââââââââââââââ
â (idx) â average â minimum â maximum â
ââââââââââââââââââââââââââžââââââââââââââââââžâââââââââââââžââââââââââââââĪ
â wasm sha1 â "9.41 Ξs/iter" â "6.88 Ξs" â "199.92 Ξs" â
â webcrypto sha1 â "24.46 Ξs/iter" â "14.92 Ξs" â "360.38 Ξs" â
â node:crypto sha1 â "20.75 Ξs/iter" â "13.08 Ξs" â "3.56 ms" â
â npm:@noble/hashes/sha1 â "19.92 Ξs/iter" â "15.87 Ξs" â "759.75 Ξs" â
ââââââââââââââââââââââââââīââââââââââââââââââīâââââââââââââīââââââââââââââ
Summary
- wasm sha1 is 2.60x faster than WebCrypto
- wasm sha1 is 2.21x faster than node:crypto
- wasm sha1 is 2.12x faster than npm:@noble/hashes
Node
cpu: Apple M1 Max
runtime: node v18.12.1 (arm64-darwin)
ââââââââââââââââââââââââââŽââââââââââââââââââŽââââââââââââŽââââââââââââââ
â (index) â average â minimum â maximum â
ââââââââââââââââââââââââââžââââââââââââââââââžââââââââââââžââââââââââââââĪ
â wasm sha1 â '6.07 Ξs/iter' â '5.37 Ξs' â '23.71 Ξs' â
â webcrypto sha1 â '12.34 Ξs/iter' â '9.04 Ξs' â '852.58 Ξs' â
â node:crypto sha1 â '3.48 Ξs/iter' â '2.83 Ξs' â '88.50 Ξs' â
â npm:@noble/hashes/sha1 â '7.34 Ξs/iter' â '6.37 Ξs' â '746.42 Ξs' â
ââââââââââââââââââââââââââīââââââââââââââââââīââââââââââââīââââââââââââââ
Summary
- wasm sha1 is 2.03x faster than WebCrypto
- wasm sha1 is 0.57x faster than node:crypto
- wasm sha1 is 1.21x faster than npm:@noble/hashes
Keccak-256
Deno
âââââââââââââââââââââŽââââââââââââââââââŽâââââââââââââŽââââââââââââââ
â (idx) â average â minimum â maximum â
âââââââââââââââââââââžââââââââââââââââââžâââââââââââââžââââââââââââââĪ
â wasm keccak256 â "4.91 Ξs/iter" â "4.37 Ξs" â "25.37 Ξs" â
â npm:@noble/hashes â "60.01 Ξs/iter" â "57.83 Ξs" â "195.50 Ξs" â
âââââââââââââââââââââīââââââââââââââââââīâââââââââââââīââââââââââââââ
Summary
- wasm keccak256 is 12.22x faster than npm:@noble/hashes
Node
cpu: Apple M1 Max
runtime: node v20.3.1 (arm64-darwin)
âââââââââââââââââââââŽââââââââââââââââââŽâââââââââââââŽââââââââââââââ
â (index) â average â minimum â maximum â
âââââââââââââââââââââžââââââââââââââââââžâââââââââââââžââââââââââââââĪ
â wasm keccak256 â '3.10 Ξs/iter' â '2.92 Ξs' â '104.00 Ξs' â
â npm:@noble/hashes â '62.28 Ξs/iter' â '60.21 Ξs' â '166.33 Ξs' â
âââââââââââââââââââââīââââââââââââââââââīâââââââââââââīââââââââââââââ
Summary
- wasm keccak256 is 20.08x faster than npm:@noble/hashes
CRC32
Deno
cpu: Apple M1 Max
runtime: deno 1.30.3 (arm64-darwin)
ââââââââââââââŽâââââââââââââââââŽââââââââââââŽââââââââââââââ
â (idx) â average â minimum â maximum â
ââââââââââââââžâââââââââââââââââžââââââââââââžââââââââââââââĪ
â wasm crc32 â "3.04 Ξs/iter" â "2.17 Ξs" â "198.04 Ξs" â
â npm:crc-32 â "4.36 Ξs/iter" â "2.04 Ξs" â "97.96 Ξs" â
ââââââââââââââīâââââââââââââââââīââââââââââââīââââââââââââââ
Summary
- wasm crc32 is 1.44x faster than npm:crc-32
Node
cpu: Apple M1 Max
runtime: node v18.12.1 (arm64-darwin)
ââââââââââââââŽâââââââââââââââââŽââââââââââââŽâââââââââââââ
â (index) â average â minimum â maximum â
ââââââââââââââžâââââââââââââââââžââââââââââââžâââââââââââââĪ
â wasm crc32 â '2.40 Ξs/iter' â '2.00 Ξs' â '53.88 Ξs' â
â npm:crc-32 â '3.73 Ξs/iter' â '2.25 Ξs' â '1.11 ms' â
ââââââââââââââīâââââââââââââââââīââââââââââââīâââââââââââââ
Summary
- wasm crc32 is 1.55x faster than npm:crc-32
Usage
SHA-1 (direct)
import { Morax, sha1 } from "@hazae41/morax";
// Wait for WASM to load
Morax.initSyncBundledOnce()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Grab the digest (20 bytes)
const digest = sha1(hello)
Keccak-256 (direct)
import { Morax, keccak256 } from "@hazae41/morax";
// Wait for WASM to load
Morax.initSyncBundledOnce()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Grab the digest (32 bytes)
const digest = keccak256(hello)
CRC32 (direct)
import { Morax, crc32 } from "@hazae41/morax";
// Wait for WASM to load
Morax.initSyncBundledOnce()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Grab the digest (number)
const digest = crc32(hello)
SHA-1 (incremential)
import { Morax, Sha1Hasher } from "@hazae41/morax";
// Wait for WASM to load
Morax.initSyncBundledOnce()
// Create a hash
const hasher = new Sha1Hasher()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Update the hash with your data
hasher.update(hello)
// Grab the digest (20 bytes)
const digest = hasher.finalize()
// Update the hash another time
hasher.update(hello)
// Grab the digest (20 bytes)
const digest2 = hasher.finalize()
// digest !== digest2
console.log(digest)
console.log(digest2)
Keccak-256 (incremential)
import { Morax, Keccak256Hasher } from "@hazae41/morax";
// Wait for WASM to load
Morax.initSyncBundledOnce()
// Create a hash
const hasher = new Keccak256Hasher()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Update the hash with your data
hasher.update(hello)
// Grab the digest (32 bytes)
const digest = hasher.finalize()
// Update the hash another time
hasher.update(hello)
// Grab the digest (32 bytes)
const digest2 = hasher.finalize()
// digest !== digest2
console.log(digest)
console.log(digest2)
CRC32 (incremential)
import { Morax, Crc32Hasher } from "@hazae41/morax";
// Wait for WASM to load
Morax.initSyncBundledOnce()
// Create a hash
const hasher = new Crc32Hasher()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Update the hash with your data
hasher.update(hello)
// Grab the checksum (number)
const checksum = hasher.finalize()
// Update the hash another time
hasher.update(hello)
// Grab the checksum (number)
const checksum2 = hasher.finalize()
// checksum !== checksum2
console.log(checksum)
console.log(checksum2)
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 git status
git status --porcelain
If the output is empty then the bytecode is the same as the one I commited
Automated checks
Each time I commit to the repository, the GitHub's CI does the following:
- Clone the repository
- Reproduce the build using
docker compose up --build
- Throw an error if the
git status --porcelain
output is not empty
Each time I release a new version tag on GitHub, the GitHub's CI does the following:
- Clone the repository
- Do not reproduce the build, as it's already checked by the task above
- Throw an error if there is a
npm diff
between the cloned repository and the same version tag on NPM
If a version is present on NPM but not on GitHub, do not use!