The world's first decentralized email client powered by Bitcoin SV blockchain technology.
Built by The Bitcoin Corporation LTD (UK Company No. 16735102)
CEO: Richard Boase | CSO: Spamsom Mo
Making Bitcoin Work Again™
Send emails with micropayments to eliminate spam. Store message hashes on-chain for immutability. Experience the future of email with true digital ownership and censorship resistance.
🌐 Live Demo: https://bitcoin-email.vercel.app
📖 Documentation: https://bitcoin-apps-suite.github.io/bitcoin-email/
- Pay fractions of a cent per email to ensure delivery
- $0.0000001 per character (0.00001 cents)
- Automatic spam prevention through economic incentives
- Store email hashes on BSV blockchain for permanent records
- Tamper-proof message verification
- Decentralized architecture with no central point of failure
- End-to-end encryption for all messages
- Private key management through HandCash
- Zero-knowledge proof capabilities
- Seamless BSV payments with $handles
- OAuth 2.0 authentication
- Instant micropayments
- Collectible stamps for priority delivery
- Custom stamp marketplace
- Visual flair for your messages
- Install as a Chrome app to your dock
- Offline support with service workers
- Native app-like experience
- Node.js 18+ and npm
- HandCash Developer Account
- Google Cloud Console Account (for OAuth)
- BSV Wallet with small balance for testing
# Clone the repository
git clone https://github.com/bitcoin-apps-suite/bitcoin-email.git
cd bitcoin-email
# Install dependencies
npm install
# Copy environment variables
cp .env.example .env.local
# Configure your credentials in .env.local
# Add your HandCash App ID, Secret, and Google OAuth credentials
# Run the development server
npm run dev
# Open http://localhost:3004Create a .env.local file with:
# HandCash OAuth
NEXT_PUBLIC_HANDCASH_APP_ID=your_app_id
HANDCASH_APP_SECRET=your_app_secret
# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
# Email Service (optional)
EMAIL_FROM=noreply@yourdomain.com
EMAIL_PASSWORD=your_app_password
# BSV Network
BSV_NETWORK=mainnet # or testnet
BSV_PRIVATE_KEY=your_private_key- Visit https://bitcoin-email.vercel.app in Chrome
- Click the install icon in the address bar (or the custom prompt)
- Click "Install"
- The app will be added to your dock/Applications
- Frontend: Next.js 15, React 19, TypeScript
- Blockchain: BSV SDK, HandCash Connect
- Styling: Tailwind CSS, Custom Dark Theme
- Email: React Email, Nodemailer
- PWA: next-pwa, Service Workers
- Authentication: OAuth 2.0 (HandCash & Google)
POST /api/email/send
Content-Type: application/json
{
"to": ["recipient@example.com"],
"subject": "Hello World",
"html": "<p>Email content</p>",
"text": "Plain text content",
"paymentAmount": 0.00001,
"encryptEmail": true,
"storeOnChain": false
}GET /api/email/receive?limit=20&offset=0&folder=inboxPOST /api/blockchain/store
Content-Type: application/json
{
"emailHash": "sha256_hash_of_email",
"timestamp": 1234567890,
"sender": "$handle",
"recipient": "user@example.com"
}- PWA Installation Support
- HandCash OAuth Integration
- Email Cost Calculator
- Dark Theme UI
- Folder Navigation
- Search Functionality
- Real BSV Micropayments
- On-Chain Storage
- Email Encryption
- Digital Stamp Marketplace
- Multi-wallet Support
- IPFS Integration
- Mobile Apps (iOS/Android)
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Please use the GitHub Issues page to report bugs or request features.
This project is licensed under the MIT License - see the LICENSE file for details.
- Bitcoin SV Community
- HandCash Team
- Next.js Team
- All contributors and testers
- Repository: https://github.com/bitcoin-apps-suite/bitcoin-email
- Documentation: https://bitcoin-apps-suite.github.io/bitcoin-email/
- Live Demo: https://bitcoin-email.vercel.app
- Issues: https://github.com/bitcoin-apps-suite/bitcoin-email/issues
- Bitcoin Apps Suite: https://github.com/bitcoin-apps-suite
This project is licensed under the Open BSV License v4 - see the LICENSE file for details.
Copyright © 2025 The Bitcoin Corporation LTD (UK Company No. 16735102)
- ✅ Open Source: Free to use, modify, and distribute
- ✅ Commercial Use: Permitted and encouraged
- ✅ BSV Required: Must use Bitcoin SV blockchain
- ✅ Attribution: Must credit The Bitcoin Corporation LTD
- ❌ BTC Support: Not permitted (BTC has been terminated)
- ❌ Lightning Network: Deprecated and not supported
We are the officially registered company working to restore Bitcoin to its original vision. As the legal entity behind Bitcoin's governance, we have:
- Terminated BTC for failure to scale
- Approved BSV as the official Bitcoin implementation
- Deprecated Lightning Network for chronic underperformance
Company Mission: Making Bitcoin work as Satoshi intended - peer-to-peer electronic cash that actually scales.
Leadership:
- CEO: Richard Boase - Registered director, vision & strategy
- CSO: Spamsom Mo - Chief Spam Officer, memes & marketing
We welcome contributions! Please ensure all code:
- Follows the Open BSV License
- Uses BSV blockchain exclusively
- Maintains attribution to The Bitcoin Corporation LTD
- Includes no BTC or Lightning Network support
See CONTRIBUTING.md for more details.
Built with ❤️ on Bitcoin SV by The Bitcoin Corporation LTD
Making Bitcoin Work Again™
