> For the complete documentation index, see [llms.txt](https://doc.lockerprotocol.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.lockerprotocol.com/reference/reproducible-build.md).

# Reproducible build & verification

Anyone can rebuild the store package bit for bit and check it matches the source.

The extension builds **deterministically**: two builds of the same source produce identical bytes, and the zip uploaded to the stores can be rebuilt and compared file by file. That is what makes "read the source" meaningful: the code you read is provably the code you run.

## Verify a store package yourself

```bash
git clone <extension repository> && cd qr-extensions
npm ci
node scripts/verify-build.mjs --zip=<downloaded store package>.zip --browser=chrome
# → "✔ Reproducible: rebuild matches ... bit for bit (N files)."
```

* Node 20 to 24, dependencies from the committed `package-lock.json` (the bundler, esbuild, is version-locked).
* No network at build time beyond `npm ci`; no obfuscation, no minifier randomness.
* Production bundles carry no sourcemaps and no absolute paths.

## Status

Every released package since v1.1.0 has been verified bit for bit. The current release is **v2.5.8**, cut on 23 September 2026: the **Chrome, Edge, Brave and Firefox** packages each rebuild **180 of 180 files** identically, under node 22, from a *cold archive* of the cut commit (`git archive` into an empty folder, `npm ci`, `node scripts/package.mjs`) rather than from a working directory.

The reviewer's own path is replayed too: the published source zip is unpacked into an empty directory and the Firefox package rebuilt from it, 180/180. Details, dates and file counts are in the repository's `REPRODUCIBLE-BUILD.md`. Third-party verifiers such as WalletScrutiny run this same check.

A signed store package carries the store's signature, which the source cannot reproduce; the check skips those signature files and **nothing else**. Anything a browser could load (a script, a page, a stylesheet) is compared even when it sits beside them.

## The Vault

The Vault is a web app served from `vault.lockerprotocol.com`. Its build is an Angular production bundle from the public repository; the service worker caches it so the app keeps working offline after the first load.
