1.0.9 • Published 3 months ago
@hazae41/memory.wasm v1.0.9
memory.wasm
Zero-copy memory for WebAssembly
npm i @hazae41/memory.wasm
Features
- Reproducible building
- Pre-bundled and streamed
- Zero-copy memory slices
Usage
import { ExampleWasm, Memory, example_method } from "@hazae41/example.wasm";
// Wait for initialization
await ExampleWasm.initBundled();
// Pass bytes to memory
using memory = new Memory();
// View bytes from memory
console.log(memory.bytes)
// Call method with 0-copy
example_method(memory)
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!