Open-source web app for encoding and decoding BIP39 words using the Stackbit 1248 system.
Live demo: ruipereira1.github.io/stackbit1248
- Open
index.htmlin your browser - Works 100% offline
- Can be installed as a PWA
index.html— Main pageapp.js— Application logicstyles.css— Stylesbip39-words.js— BIP39 dictionary (2048 words)manifest.json— PWA manifestservice-worker.js— Offline service workerscripts/generate-sri.js— Regenerate SRI hashes after JS/CSS changes
Quick options:
- GitHub Pages (free) — Enable in Settings → Pages
- Netlify (free) — Connect the GitHub repo
- Vercel (free) — Import the GitHub repo
Implemented measures (details in SECURITY.md):
- ✅ Strict CSP (no inline scripts,
frame-src 'none',worker-src 'self') - ✅ SRI on scripts, CSS, and JSON-LD
- ✅ SHA-384 Service Worker verification before registration
- ✅ XSS protection — input validation and safe DOM updates
- ✅ Auto-clear on tab switch or when the page is hidden
- ✅ No seed storage (language preference only)
- ✅ 100% offline after PWA cache
- ✅
autocomplete="off"andmaxlength="8"on Encode
- Clone the repo:
git clone https://github.com/ruipereira1/stackbit1248.git - Compare commits with GitHub (or use a trusted release/tag)
- Open
index.htmloffline or install the PWA without network after a verified first visit - After editing
.js/.cssfiles, runnode scripts/generate-sri.js(twice if you changedsecurity.js)
- Use offline on a trusted device
- Never share your seed phrase
- Avoid entering a full seed (12/24 words) online — use 1248 codes or single words for verification only
- Browser extensions and malware can read the screen — this risk cannot be eliminated by web code alone
This project is licensed under the MIT License.
The BIP39 word list used is public domain and not subject to copyright.
Contributions are welcome! Please read the Contributing Guide before opening pull requests.
This app was inspired by the Stackbit 1248 system developed by Stackbit Metalwallet.
- Original site: https://stackbit.me/
- 1248 system: All information about the 1248 encoding system is based on content available on the Stackbit website
- Thanks: Special thanks to the Stackbit Metalwallet team for creating and documenting the Stackbit 1248 system
This project is an open-source web implementation of Stackbit 1248 for BIP39 encode/decode.
See CREDITS.md for more details.
- Stackbit Metalwallet — Original site and inspiration
- BIP39 Specification
- Bitcoin BIPs Repository