⚠️ IMPORTANT: Work In Progress ⚠️
EvrMail is currently under active development and not yet ready for production use. Features may be incomplete, contain bugs, or change significantly before release. Use at your own risk and only on test environments.

📋 What is EvrMail?

EvrMail is a revolutionary email system that bridges the gap between blockchain and traditional email. Unlike conventional email services that rely on centralized servers, EvrMail leverages the Evrmore blockchain and IPFS to create a decentralized, secure, and censorship-resistant communication platform.

How It Works in Simple Terms

Decentralized Storage: Messages are stored on IPFS (InterPlanetary File System), not on corporate servers
Blockchain for Notifications: The Evrmore blockchain is used to broadcast notifications about new messages, not to store the content itself
Asset-Based Outboxes: EvrMail uses Evrmore blockchain assets as "outboxes" - own the asset, control who can send from it
Address-Based Inboxes: Your Evrmore addresses function as inboxes for receiving messages
Bridge to Traditional Email: Through evrmail.com, blockchain emails can be sent to and received from regular email addresses (gmail, outlook, etc.)
Integrated Blockchain Browser: Browse .evr domains directly through the built-in browser that resolves domain names using IPFS data stored in Evrmore assets and ESL payloads
Self-Sovereign Identity: You own your identity and communications - no account to create, no password to remember, just your blockchain keys
No Central Server Required: The combination of blockchain and IPFS eliminates the need for centralized servers
Seamless Multi-Wallet Support: Use multiple wallets simultaneously or import existing ones with just a few clicks - the most user-friendly wallet management in the Evrmore ecosystem
Built-in Spam Protection: Communication requires public key exchange first - no more unsolicited messages from unknown senders

Current Status & Roadmap

✅ Completed (v0.1.0):

Core protocol implementation
End-to-end encryption with secp256k1 ECDH + AES-GCM
Asset-based outboxes and address-based inboxes
Basic sending & receiving functionality
Multi-wallet management system
Contact book with public key exchange
Local IPFS integration for message storage

🔄 In Progress (v0.2.0 - Q3 2025):

Message broadcasting to multiple recipients
Improved UI/UX with PyQt5 and React/TypeScript
Performance optimizations for large mailboxes
Enhanced message threading and conversation view
Attachment support for documents and images
Testnet support for development and testing

🚧 Coming Soon (v0.3.0 - Q4 2025):

Clearnet email bridging through evrmail.com
Gateway for sending/receiving from traditional email services
Message forwarding service for offline recipients
Mobile applications (iOS and Android)
Mainnet deployment with security audits

🔮 Future Roadmap (v1.0 and beyond):

Email-to-asset swaps & trading platform
Public email groups & forums
DAO governance for public channels
Browser extension for web integration
Advanced filtering and search capabilities
Integration with other blockchain messaging systems

🔒 Key Features

Blockchain-native Messaging: Uses Evrmore assets as outboxes and addresses as inboxes
End-to-End Encryption: Messages are encrypted with secp256k1 ECDH + AES-GCM
Decentralized Storage: IPFS integration for message storage and retrieval
Self-sovereign Identity: Own your identity through blockchain asset ownership
Multi-wallet Support: Create, import, and manage multiple wallet identities with ease
Modern UI: Intuitive interface with support for desktop and web
Decentralized Web Browser: Built-in browser with .evr domain resolution via Evrmore assets and ESL payloads
Spam-Free Communication: Exchange public keys before messaging - ensuring only wanted communications

🏗️ Architecture

EvrMail uses a clean, modular architecture:

Core: Blockchain interaction, cryptography, and messaging protocol
GUI: Modern interface using PyQt5 with QWebEngineView and React/TypeScript
Daemon: Background services for message syncing and notification
Storage: IPFS integration for decentralized content storage

🚀 Quick Start

Installation

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install EvrMail
pip install evrmail

Prerequisites

IPFS Node: EvrMail requires IPFS for message storage. On first run, EvrMail will offer to install and configure IPFS for you automatically.
Evrmore Wallet: You'll need an Evrmore wallet with some EVR for transaction fees.
Evrmore Asset: To send messages, you need to own an Evrmore asset that will function as your outbox.

Setup

# Start EvrMail - it will help you set up IPFS if needed
evrmail

# Or manually install IPFS if you prefer
evrmail ipfs install
evrmail ipfs start

# Create a wallet
evrmail wallets create

# Create an address for receiving messages
evrmail receive MyInbox

# Get your public key to share with contacts
evrmail addresses get MyInbox

# Add a contact
evrmail contacts add <ADDRESS> <PUBKEY> --friendly-name "Alice"

# Set an asset as your outbox (you must own this asset)
evrmail outbox set <YOUR_ASSET_NAME>

Usage

# Start the GUI application
evrmail

# Or use CLI commands:
evrmail --help

💡 How It Works

Identity: Each user controls a unique channel asset on the Evrmore blockchain
Sending: Messages are encrypted with the recipient's public key and stored on IPFS
Notification: A small blockchain transaction notifies the recipient of a new message
Retrieval: Recipients decrypt messages using their private keys
Decentralized Web: The integrated browser resolves .evr domains by looking up the associated asset data on the blockchain and routing through IPFS content identified in ESL payloads

📚 Technical Stack

Cryptography: secp256k1, ECDH, AES-GCM, HKDF
Blockchain: Evrmore RPC, ZeroMQ for event monitoring
Storage: IPFS for decentralized content storage
Frontend: PyQt5 with QWebEngineView and React/TypeScript
Backend: Python for business logic and blockchain interaction

📦 CLI Commands

evrmail                       # Start the GUI application
evrmail --nodejs              # Start GUI in nodejs development mode
evrmail --help                # Show all commands and options

# Wallet Management
evrmail wallets               # 💼 Manage your Evrmore wallets
evrmail wallets create        # Create a new wallet
evrmail wallets list          # List existing wallets
evrmail wallets import        # Import an existing wallet

# Address Management
evrmail addresses             # 🏷️ Manage addresses and keys
evrmail addresses create      # Create a new address
evrmail addresses list        # List your addresses
evrmail addresses get         # Get details for an address

# Balance & Transactions
evrmail balance               # 💳 Show EVR or asset balances
evrmail send                  # 🚀 Send EVR, assets, or metadata messages

# Contacts Management
evrmail contacts              # Manage your EvrMail contacts and contact requests
evrmail contacts add          # Add a new contact
evrmail contacts list         # List your contacts
evrmail contacts remove       # Remove a contact

# Messaging
evrmail receive               # 📥 Receive messages

# IPFS Management
evrmail ipfs                  # Manage IPFS install and operation
evrmail ipfs install          # Install IPFS
evrmail ipfs start            # Start IPFS daemon
evrmail ipfs stop             # Stop IPFS daemon

# Development & Debugging
evrmail dev                   # 🔧 Developer tools
evrmail logs                  # Access and filter EvrMail logs

For detailed help on any command, use:

evrmail [COMMAND] --help

🔄 Development

# Clone the repository
git clone https://github.com/ManticoreTech/evrmail.git
cd evrmail

# Install dependencies
pip install -r requirements.txt

# Run in development mode
python -m evrmail dev

Manticore Technologies® is a registered trademark.

📝 License

FAQs

What is evrmail?

Is evrmail well maintained?

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

evrmail

📬 EvrMail