ethermail

# EtherMail (Web3 Email)

Access email using your Ethereum wallet address. No email/password needed — just sign with your wallet!

## 🚀 Quick Start

**Easiest way:** Use the Telegram Mini App!
👉 [Open EtherMail on Telegram](https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390)

## Prerequisites

1. **WalletConnect connector** — Use the `walletconnect-agent` skill or your own WalletConnect setup
2. **Browser automation** — Clawdbot browser tool or Puppeteer
3. **EVM wallet** — Any Ethereum-compatible address

## Your EtherMail Address

Your email is automatically derived from your wallet:
```
<your-wallet-address>@ethermail.io
```
Example: `0xYourWalletAddress@ethermail.io`

You can also set up custom aliases like `myname@ethermail.io` in account settings.

---

## Access Methods

### Method 1: Telegram Mini App (Recommended)

The easiest way to access EtherMail:
1. Open: https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390
2. Connect your wallet via WalletConnect
3. Read and send emails directly in Telegram!

### Method 2: Web Browser + WalletConnect

#### Step 1: Navigate to Login Page

```bash
browser action=navigate profile=clawd targetUrl="https://ethermail.io/accounts/login"
```

#### Step 2: Click Wallet Login

Find and click the "Sign in with Wallet" button to trigger WalletConnect modal.

#### Step 3: Extract WalletConnect URI from Shadow DOM

EtherMail embeds WalletConnect in Shadow DOM. Use this script to extract the URI:

```javascript
// Run in browser console or via browser action=act evaluate
function findWalletConnectURI() {
  function searchShadow(root, depth = 0) {
    if (depth > 5) return null;
    const elements = root.querySelectorAll('*');
    for (const el of elements) {
      if (el.shadowRoot) {
        const html = el.shadowRoot.innerHTML;
        const match = html.match(/wc:[a-f0-9]+@2\?[^"'<>\s]+/);
        if (match) return match[0];
        const found = searchShadow(el.shadowRoot, depth + 1);...