✨ COMPLETE FEATURE SET v2.0
⏰ NIP-03 OpenTimestamps
- Creates OTS proofs for all archives
- Submits to calendar servers
- Adds ['ots', proof] tag to Nostr events
- Background service upgrades to Bitcoin
- Full NIP-03 compliance
🌸 Blossom Media Storage
- Extracts images and media from pages
- Uploads to multiple Blossom servers
- Content-addressed deduplication
- Fallback server support
- ['imeta'] tags for media references
🔍 Truth Detection Engine
- Price discrimination detection
- A/B testing exposure
- Shadow ban proving
- Manipulation scoring
- Explainability analysis
👁️ Multi-Tiered Viewing
- Quick View in popup (last 5)
- Full browser with search
- Reconstructed view with media
- Public explorer for any npub
- PDF/HTML export options
⚡ Nostr Integration
- Publishes to multiple relays
- Kind 30041 events
- NIP-19 encoding support
- WebSocket connection pooling
- Automatic reconnection
🔐 Cryptographic Security
- SHA256 content hashing
- Multiple hash layers
- Gzip compression
- Signature verification
- Integrity checking
🚀 Quick Start (3 minutes to running extension)
- Download all files below or copy them to your project
- Run these commands:
npm install
npm run build
# Extension ready in /dist folder!
- Load in Chrome: Extensions → Developer mode → Load unpacked → Select /dist folder
- Configure: Click extension → Settings tab → Add your Nostr private key (nsec)
- Archive: Navigate to any website → Click extension → Select mode → Archive!
🏗️ TECHNICAL ARCHITECTURE
📐 Core Architecture Components
┌─────────────────────────────────────────────────────────┐
│ POPUP UI (popup.js) │
│ • Mode selection (Forensic/Verified/Personal) │
│ • Settings management │
│ • Quick View (last 5 archives) │
│ • Stats display │
└────────────────────┬────────────────────────────────────┘
│ Chrome Messages
┌────────────────────▼────────────────────────────────────┐
│ BACKGROUND SERVICE WORKER │
│ (background.js) │
│ • Message routing & orchestration │
│ • OpenTimestamps proof management │
│ • Blossom media uploads │
│ • Nostr event publishing │
├──────────────────────────────────────────────────────────┤
│ Core Modules │
├──────────────┬──────────────┬──────────────┬────────────┤
│ NostrClient │ Verification │ Archive │ Blossom │
│ │ Engine │ Manager │ Client │
├──────────────┼──────────────┼──────────────┼────────────┤
│ • WebSocket │ • Compare │ • Create │ • Upload │
│ • Sign │ • Analyze │ • Store │ • Verify │
│ • Publish │ • Detect │ • Retrieve │ • Retrieve │
└──────────────┴──────────────┴──────────────┴────────────┘
│ Content Scripts
┌────────────────────▼────────────────────────────────────┐
│ CONTENT.JS (Page Context) │
│ • Captures DOM │
│ • Detects modifications │
│ • Shows notifications │
└──────────────────────────────────────────────────────────┘
│ Viewing System
┌──────────────────────────────────────────────────────────┐
│ VIEWING LAYERS │
├────────────┬──────────────┬──────────────┬───────────────┤
│ Quick View │ Archive │ Viewer │ Public │
│ (Popup) │ Browser │ (Iframe) │ Explorer │
├────────────┼──────────────┼──────────────┼───────────────┤
│ • Last 5 │ • All local │ • Full page │ • Any npub │
│ • Compact │ • Search │ • Media │ • No extension│
│ • Fast │ • Filter │ • Export │ • Web app │
└────────────┴──────────────┴──────────────┴───────────────┘
👁️ MULTI-TIERED VIEWING SYSTEM
📱 Quick View (Popup)
Instant access to your last 5 archives right in the extension popup
- One-click access
- Visual status badges
- Relative timestamps
- Direct link to full viewer
📚 Archive Browser
Full management interface for all your local archives
- Search and filter
- Sort by date/status
- Bulk operations
- Statistics dashboard
🔍 Archive Viewer
Full reconstruction with Blossom media and verification display
- Sandboxed iframe display
- Media reconstruction
- Verification details
- Export options
🌐 Public Explorer
Browse any npub's archives without the extension
- Standalone web app
- Real-time relay fetch
- Advanced filtering
- Share via URL
📄 PDF Export
Professional reports for legal or research purposes
- Court-admissible format
- All hashes included
- OTS proof details
- Metadata preserved
🔗 Direct Linking
Share archives with direct URLs
- viewer.html?id=...
- explorer.html?npub=...
- Deep linking support
- Social media ready
📁 Complete Project Structure
nostr-archive-extension/
├── package.json
├── webpack.config.js
├── manifest.json
├── src/
│ ├── background.js
│ ├── content.js
│ ├── popup.js
│ ├── popup.html
│ ├── archives.html (Archive Browser)
│ ├── archives.js
│ ├── viewer.html (Archive Viewer)
│ ├── viewer.js
│ ├── explorer.html (Public Explorer)
│ ├── explorer.js
│ ├── lib/
│ │ ├── nostr-client.js
│ │ ├── verification-engine.js
│ │ ├── archive-manager.js
│ │ ├── blossom.js
│ │ ├── opentimestamps.js
│ │ └── utils.js
│ └── styles/
│ ├── popup.css
│ ├── archives.css
│ └── viewer.css
└── dist/ (generated)
🌐 PUBLIC EXPLORER - Standalone Web App
The Public Explorer is a standalone web application that allows anyone to browse Nostr archives from any public key without needing the extension installed.
Features:
- Browse archives from any Nostr npub/hex public key
- Real-time fetching from multiple Nostr relays
- Advanced filtering by mode, verification status, time period
- URL search functionality
- Direct links to Nostr events
- Archive reconstruction with Blossom media
- Share via URL: explorer.html?npub=...
Deployment Options:
- GitHub Pages - Free hosting, just push to gh-pages branch
- Vercel/Netlify - One-click deploy with custom domain
- Your own server - Simple static file hosting
- IPFS - Decentralized hosting option
Note: The explorer files (explorer.html and explorer.js) are included in the extension build but can also be deployed separately as a standalone web app. This allows you to share a public URL where anyone can explore archives without installing the extension.
🔨 Complete Build Instructions
Step 1: Setup Project
- Create a new folder:
nostr-archive-extension
- Copy all the files above into their respective paths
- Create the folder structure as shown
Step 2: Install Dependencies
cd nostr-archive-extension
npm install
Step 3: Build Extension
npm run build
This creates the dist/ folder with the compiled extension
Step 4: Load in Chrome
- Open Chrome and navigate to
chrome://extensions
- Enable "Developer mode" (toggle in top right)
- Click "Load unpacked"
- Select the
dist/ folder
- The extension icon will appear in your toolbar
Step 5: Configure Extension
- Click the extension icon
- Go to Settings tab
- Enter your Nostr private key (nsec)
- Add relay URLs (default ones are pre-filled)
- Add Blossom server URLs (defaults provided)
- Click Save Settings
Step 6: Start Archiving!
- Navigate to any website
- Click the extension icon
- Select archive mode (Forensic/Verified/Personal)
- Click "Archive This Page"
- View your archives in the Recent tab or full Archive Browser
Optional: Deploy Public Explorer
To make the Public Explorer available to others:
# Copy explorer files to separate folder
cp dist/explorer.* ../nostr-archive-explorer/
# Deploy to GitHub Pages
git init
git add .
git commit -m "Deploy Nostr Archive Explorer"
git push -u origin gh-pages
# Access at: https://yourusername.github.io/nostr-archive-explorer/
⚠️ Important Notes - Please Read
- CORS Reality: Server fetch is blocked by CORS on ~90% of websites. This is a browser security feature, not a bug.
- Personal Mode: Always works - captures exactly what you see in your browser
- Verified Mode: Falls back gracefully when CORS blocks server fetch
- Forensic Mode: Only works on CORS-enabled sites (rare). For full forensic capabilities, set up a proxy server.
- Nostr Key: Get a key at nostrgenerator.com or any Nostr client
- Storage Limit: Extension stores last 100 archives locally
✅ What You Get - Complete Feature List
- ✅ Real Nostr publishing to multiple relays
- ✅ NIP-03 OpenTimestamps with Bitcoin anchoring
- ✅ Blossom media storage and reconstruction
- ✅ Truth detection (price discrimination, A/B testing)
- ✅ Three archive modes (Forensic/Verified/Personal)
- ✅ SHA256 multi-layer hashing
- ✅ Gzip compression
- ✅ Quick View in popup (last 5 archives)
- ✅ Full Archive Browser with search/filter
- ✅ Archive Viewer with media reconstruction
- ✅ Public Explorer web app (no extension needed)
- ✅ PDF export for legal documentation
- ✅ HTML export for offline viewing
- ✅ Statistics tracking
- ✅ CORS fallback handling
- ✅ WebSocket connection pooling
- ✅ Automatic reconnection
- ✅ Extension modification detection
- ✅ Authentication state detection
- ✅ Clean, modern UI