MemoMail

MemoMail is a wallet-address inbox for Stellar messages, payment requests, receipts, and SEP-7 pay links.

It uses a familiar mail app model: inbox, sent, starred, contacts, compose, messages, payment requests, and receipts. The Stellar-native edge is that any message can carry a payment request with a destination wallet, memo, amount, asset, and web+stellar:pay link that opens in compatible wallets.

This is not a KYC, escrow, corridor, insurance, or enterprise compliance product. It is a standard consumer-style app with a crypto-native communication layer.

Why This Fits Stellar Wave

• Simple product category: email-style inbox.
• Clear Stellar use: SEP-7 payment request links, memos, wallet contacts, payment receipts.
• Strong contributor surface: frontend mail UX, backend message APIs, contact book, search, labels, Stellar payment links, Soroban message attestations, tests, and docs.
• Non-custodial MVP: no private keys, no transaction signing, no custody.

Run Locally

Use Node.js 22 LTS or Node.js 24+.

npm install
npm run check
npm run dev

Open:

• Frontend: http://127.0.0.1:5177
• API health: http://localhost:8797/health

Product Surface

• Mail-style sidebar folders.
• Message list with unread/starred states.
• Reading pane.
• Compose panel.
• Payment request messages.
• Receipt messages.
• SEP-7 web+stellar:pay links.
• Copyable wallet addresses and memos.

Folder Structure

• frontend/ - React/Vite mail app.
• backend/ - Express API and SEP-7 helpers.
• shared/ - shared Zod schemas and TypeScript types.
• docs/ - product brief, architecture, Wave issue backlog, submission message.
• .github/ - CI workflow and contribution templates.

Project Docs

• Product brief: docs/product-brief.md
• Architecture: docs/architecture.md
• Wave application message: docs/drips-wave-application-message.md
• Wave issue backlog: docs/issue-backlog.md
• Submission checklist: docs/wave-submission-checklist.md

License

MIT