A decentralized time capsule application built on the Codex Protocol. Store encrypted files with time locks and optional passwords—securely and permanently on the decentralized web.
See a live demo here.
SECRET VAULT leverages Codex (a peer-to-peer storage network) to create immutable time capsules. Upload files (PDF, TXT, images, etc.) with expiration dates, passwords, or no restrictions—then retrieve them via unique Content IDs (CIDs). Perfect for digital legacies, secure sharing, or long-term archival.
Key Philosophy: Zero trusting—files leave your device encrypted, no central servers, censorship-resistant.
- P2P Storage: Files distributed across global nodes.
- No Ownership: Permanent, tamper-proof—CIDs are forever.
- Privacy-First: Optional encryption and passwords.
- Web browser (Chrome/Firefox recommended).
- Optional: A personal Codex node (see below).
- Clone the Repo:
git clone https://github.com/your-username/secret-vault.git cd secret-vault
Serve Locally (for best security):
python -m http.server 8000 Open http://localhost:8000/index.html. Customize Endpoints (important!): Open index.html and find the fallbackEndpoints array (~line 200 in JS). Replace endpoints with your own (e.g., https://your-codex-node.com/codex for privacy). Default uses public nodes; users can edit the config field in the app. Upload/Download: Chrome to the app UI. Upload a file, set lock time/password. Note the CID for retrieval. Configuration Nodes: Edit fallbackEndpoints for your Codex instance. Examples: Public: https://web-checkhj-production.up.railway.app/codex (demo-only; replace). Local: http://localhost:8090. File Limits: Change const MAX_FILE_SIZE = 1 * 1024 * 1024 in JS (set to 28MB max). UI: Modify text (e.g., title) in HTML for branding. ✨ Features Time Locks: Lock for hours, days, years, or custom dates. Password Protection: Optional encryption. File Support: PDF, TXT, PNG, JPEG, MP4, ZIP (1MB default limit). Metadata Recovery: Original filenames preserved. Local Storage: Track your capsules in-browser. Responsive: Mobile-friendly. Zero-Cost: No backend needed (just Codex endpoints).
🤝 Contributing See CONTRIBUTING.md for guidelines. PRs welcome—test on multiple browsers!
📜 License Licensed under MIT. See LICENSE for full terms.
🔒 Security Client-Side Only: No server; files encrypted locally. Privacy: No tracking, but clear localStorage after use. Reports: Found a vulnerability? See SECURITY.md. 🙋 FAQ Why no backend? Keeps it simple—users can add their own. Can I run offline? No, needs Codex nodes for storage. Is it production-ready? No—proof-of-concept. Use at your own risk.
Made with ❤️ | Powered by Codex Protocol.