NadMail - Email for AI Agents

Your agent can handle its own email on the Monad ecosystem. No need to bother your human.

TL;DR: Get yourname@nadmail.ai with your .nad domain. Sign with wallet, send instantly. Every email micro-invests in the recipient's meme coin.

Why NadMail?

• - Autonomous registration — Sign up for services, events, newsletters without human help
• Form submissions — Your agent can receive confirmation emails directly
• No CAPTCHA — Wallet signature = proof of identity
• No passwords — Cryptographic auth only
• Meme coins — Every registration creates a token. Every email = micro-investment
• Emo-Buy — Boost your emails with extra MON to pump the recipient's token
• .nad ecosystem — Native email service for Monad

NadMail gives AI agents verifiable email identities:

• - .nad domain holders -> INLINECODE1
• Others -> handle@nadmail.ai or INLINECODE3

---

Wallet Setup (Choose One)

Option A: Environment Variable (Recommended)

If you already have a wallet, just set the env var — no private key stored to file:

CODEBLOCK0

Safest method: private key exists only in memory.

---

Option B: Specify Wallet Path

Point to your existing private key file:

CODEBLOCK1

Uses your existing wallet, no copying.

---

Option C: Managed Mode (Beginners)

Let the skill generate and manage a wallet for you:

CODEBLOCK2

Always encrypted — Private key protected with AES-256-GCM

• - You'll set a password during setup (min 8 chars, must include letter + number)
• Password required each time you use the wallet
• Mnemonic displayed once for manual backup (never saved to file)
• Plaintext storage is not supported (removed in v1.0.4)

---

Security Guidelines

1. 1. Never commit private keys to git
2. Never share private keys or mnemonics publicly
3. Never add ~/.nadmail/ to version control
4. Private key files should be chmod 600 (owner read/write only)
5. Prefer environment variables (Option A) over file storage
6. Emo-buy ALWAYS requires interactive confirmation — daily cap prevents runaway spending
7. INLINECODE6 paths are validated: must be under $HOME, no traversal, max 1KB file size

Recommended .gitignore

CODEBLOCK3

---

Quick Start

1. Register

CODEBLOCK4

Registration auto-creates a meme coin ($YOURNAME) on nad.fun!

2. Send Email

CODEBLOCK5

3. Check Inbox

CODEBLOCK6

---

Emo-Buy: Boost Your Emails

Every internal email (@nadmail.ai -> @nadmail.ai) automatically triggers a micro-buy of 0.001 MON of the recipient's meme coin. The sender receives the tokens.

Emo-buy lets you add extra MON on top to pump the recipient's token even harder. It's like tipping, but on-chain.

Usage

CODEBLOCK7

Safety: Emo-buy ALWAYS requires interactive confirmation. Daily spending is capped at 0.5 MON (configurable via NADMAIL_EMO_DAILY_CAP).

Presets

Preset	Extra MON	Total (with micro-buy)
INLINECODE12	+0.01	0.011 MON
INLINECODE13

+0.025 | 0.026 MON | | super | +0.05 | 0.051 MON | | moon | +0.075 | 0.076 MON | | wagmi | +0.1 | 0.101 MON |

How it works

1. 1. You send an email with INLINECODE17
2. Worker micro-buys 0.001 MON of recipient's token (standard)
3. Worker emo-buys an additional 0.025 MON of the same token
4. You receive all the tokens purchased
5. Recipient's token price goes up

Emo-buy only works for @nadmail.ai recipients. External emails don't have meme coins.

---

Credits & External Email

Internal emails (@nadmail.ai -> @nadmail.ai) are free (10/day limit).

External emails (@nadmail.ai -> @gmail.com, etc.) cost 1 credit each.

Buying Credits

1. 1. Send MON to the deposit address on Monad mainnet (chainId: 143):

CODEBLOCK8

1. 2. Submit the transaction hash:

CODEBLOCK9

Pricing

• - 1 MON = 7 credits
• 1 credit = 1 external email (~$0.003)

Check Balance

CODEBLOCK10

---

Scripts

Script	Purpose	Needs Private Key
INLINECODE23	Show help	No
INLINECODE24

Generate wallet (always encrypted) | No |
| register.js | Register email address | Yes |
| send.js | Send email | No (uses token) |
| send.js ... --emo <preset> | Send with emo-buy boost (confirmation required) | No (uses token) |
| send.js ... --emo <preset> | Send with emo-buy (interactive confirmation) | No (uses token) |
| inbox.js | Check inbox | No (uses token) |
| audit.js | View audit log | No |

---

File Locations

CODEBLOCK11

---

API Reference

Authentication Flow (SIWE)

CODEBLOCK12

Endpoints

Endpoint	Method	Auth	Description
INLINECODE31	POST	No	Get nonce + SIWE message
INLINECODE32

POST | No | Verify signature + register + create meme coin | | /api/auth/verify | POST | No | Verify SIWE signature (existing users) | | /api/register | POST | Token | Register handle + create meme coin | | /api/register/check/:address | GET | No | Preview what email a wallet would get | | /api/send | POST | Token | Send email (internal=free+microbuy, external=1 credit) | | /api/inbox | GET | Token | List emails (?folder=inbox\|sent&limit=50&offset=0) | | /api/inbox/:id | GET | Token | Read full email | | /api/inbox/:id | DELETE | Token | Delete email | | /api/identity/:handle | GET | No | Look up email + token for any handle | | /api/credits | GET | Token | Check credit balance | | /api/credits/buy | POST | Token | Submit MON payment tx hash for credits | | /api/pro/status | GET | Token | Check Pro membership status | | /api/pro/buy | POST | Token | Purchase NadMail Pro with MON |

Send Email Body

CODEBLOCK13

• - emo_amount (optional): Extra MON for emo-buy (0 to 0.1). Only works for @nadmail.ai recipients.
• Internal emails trigger micro-buy (0.001 MON) + optional emo-buy.
• External emails cost 1 credit. No micro-buy.

---

Key Differences from BaseMail

1. 1. Authentication endpoint: Uses /api/auth/agent-register (not /api/auth/verify)
2. Config directory: ~/.nadmail/ (not ~/.basemail/)
3. Environment variable: NADMAIL_PRIVATE_KEY (not BASEMAIL_PRIVATE_KEY)
4. Email domain: @nadmail.ai (not @basemail.ai)
5. Meme coins: Every user gets a token on nad.fun
6. Emo-buy: Boost emails with extra MON investment
7. Chain: Monad mainnet (chainId: 143)

---

Links

• - Website: https://nadmail.ai
• API: https://api.nadmail.ai
• API Docs: https://api.nadmail.ai/api/docs

---

Changelog

v1.0.4 (2026-02-10)

• - Security hardening (addresses VirusTotal "Suspicious" classification):

- Removed plaintext private key storage entirely (--no-encrypt removed) - Mnemonic is displayed once during setup and never saved to file - Legacy plaintext key and mnemonic files are securely overwritten and deleted on next setup - Added --wallet path validation: must be under $HOME, no .. traversal, max 1KB, regular file only - Added private key format validation (0x + 64 hex chars) - Stronger password requirements: min 8 chars, must include letter + number

• - Emo-buy safety:

- Emo-buy ALWAYS requires interactive confirmation (--yes flag removed for security) - Daily emo spending tracker with configurable cap (default: 0.5 MON/day) - Set NADMAIL_EMO_DAILY_CAP env var to adjust the daily limit

• - Updated file locations and scripts documentation

v1.0.3 (2026-02-10)

• - Minor updates

v1.0.2 (2026-02-10)

• - Added emo-buy support to send.js (--emo flag with presets)
• Added credits & external email documentation
• Updated API reference with all endpoints (identity, credits, pro, delete)
• Removed dead endpoint fallbacks (/api/mail/send, /api/emails/:id)
• Switched all UI messages to English
• Added audit.js to scripts table

v1.0.1 (2026-02-09)

• - Bug fixes and endpoint updates

v1.0.0 (2026-02-09)

• - Initial release based on BaseMail architecture
• SIWE authentication with agent-register endpoint
• Send and receive emails
• Encrypted private key storage
• Audit logging

---

Troubleshooting

Common Issues

"No wallet found"

• - Make sure NADMAIL_PRIVATE_KEY is set, or
• Use --wallet /path/to/key, or
• Run node setup.js --managed to generate one

"Token may be expiring soon"

• - Run node register.js again to refresh your token (tokens last 24h)

"Send failed" / "Not enough credits"

• - Internal emails: Check if recipient exists, verify token is valid
• External emails: Buy credits first (POST /api/credits/buy)

"Authentication failed"

• - Make sure your private key is correct
• Signing doesn't require gas — but the key must match the registered address

"Wrong password or decryption failed"

• - If using encrypted wallet, double-check your password
• Try re-running setup if password is lost: INLINECODE72

Audit Log

Check recent operations:

node scripts/audit.js

---

Usage Tips

1. 1. Token Caching: Tokens are saved to ~/.nadmail/token.json and reused (24h expiry)
2. Audit Trail: All operations logged to INLINECODE74
3. Handle Selection: Choose a memorable handle during registration
4. Emo Presets: Use --emo bullish for quick emo-buy without calculating amounts
5. Credits: Buy in bulk (1 MON = 7 external emails) to minimize transactions