Morax
WebAssembly port of SHA-1, SHA-256, Keccak-256, and CRC-32 hashing algorithms
npm i @hazae41/morax
Node Package ðĶ âĒ Deno Module ðĶ âĒ Next.js CodeSandbox ðŠĢ
Algorithms
- Incremental SHA-1 from RustCrypto (sha1)
- Incremental Keccak-256 from RustCrypto (sha3)
- Incremental CRC-32 from Sam Rijs (crc32fast)
Features
- Reproducible building
- Pre-bundled and streamed
- Zero-copy memory slices
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 / SHA-256 / Keccak-256 (direct)
import { Morax, sha1 } from "@hazae41/morax";
// Wait for WASM to load
await Morax.initBundledOnce()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Grab the digest (Uint8Array)
const digest = sha1(hello).copyAndDispose()
CRC32 (direct)
import { Morax, crc32 } from "@hazae41/morax";
// Wait for WASM to load
await Morax.initBundledOnce()
// Data to be hashed
const hello = new TextEncoder().encode("Hello World")
// Grab the digest (number)
const digest = crc32(hello)
SHA-1 / SHA-256 / Keccak-256 (incremental)
import { Morax, Sha1Hasher } from "@hazae41/morax";
// Wait for WASM to load
await Morax.initBundledOnce()
// 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 (Uint8Array)
const digest = hasher.finalize().copyAndDispose()
// Update the hash another time
hasher.update(hello)
// Grab the digest (Uint8Array)
const digest2 = hasher.finalize().copyAndDispose()
// digest !== digest2
console.log(digest)
console.log(digest2)
hasher.free()
CRC32 (incremental)
import { Morax, Crc32Hasher } from "@hazae41/morax";
// Wait for WASM to load
await Morax.initBundledOnce()
// 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)
hasher.free()
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!