ROADMAP.md

🗺 Stellar MicroPay — Roadmap & Feature Reconcilation (#854)

This document outlines what has been built, verified test links, documented feature coverage, and remaining partial gaps across all versions.

---

✅ v1.0 — Foundation

• Freighter wallet connection (frontend/src/components/WalletConnect.tsx)
• Send XLM to any Stellar address (backend/src/services/stellarService.js, stellarService.test.js)
• View transaction history (backend/src/controllers/paymentController.js, paymentController.test.js)
• Basic Next.js frontend (frontend/src/pages/index.tsx)
• Node.js / Express backend (backend/src/server.js)
• Soroban contract template (contracts/stellar-micropay-contract)

---

✅ v1.1 — Developer Experience

• Docker Compose setup for one-command startup (backend/Dockerfile, Dockerfile.prod)
• GitHub Actions CI pipeline (.github/workflows/ci.yml)
• Unit tests for frontend components (frontend/__tests__)
• API integration tests (backend/__tests__/integration.test.js)
• Improved error handling & toast notifications (sanitization.test.js, ANALYTICS_GUIDE.md)

---

✅ v1.2 — Username Payments

• Register a human-readable username (e.g. @alice) (usernameService.js, usernameService.test.js)
• Map username → Stellar wallet address (accountController.js, accountController.test.js)
• Send payments to @username instead of raw address (federation.js, federation.test.js)
• Username resolution API endpoint (GET /api/v1/accounts/resolve/:username) (docs/api.md)

---

✅ v1.3 — QR Code Payments

• Generate QR code for your wallet address (frontend/src/components/QRCodeDisplay.tsx)
• Scan QR code to pre-fill payment form (frontend/src/components/QRScanner.tsx)
• Deep link support (stellarmicropay://pay?to=...&amount=...) (docs/api.md)
• Mobile-optimised QR scanner (PWA-SETUP.md)

---

✅ v1.4 — Creator Tipping

• Public tip page (e.g. /tip/alice) (frontend/src/pages/tip/[username].tsx)
• Preset tip amounts (☕ $1 / 🍕 $5 / 🚀 $20) (tipsController.js, tipsController.test.js)
• Tip with a message (tipsService.js, tipsService.test.js)
• Creator dashboard showing tips received (ANALYTICS_GUIDE.md)

---

🟡 v1.5 — Payment Links

• Generate shareable payment request links (frontend/src/utils/paymentLink.ts)
• Set amount + memo in the link (docs/api.md)
• One-click payment from link (frontend/src/pages/pay.tsx)
• Partial Gap: Server-enforced persistent link expiry storage and single-use claim nonces (planned for v3.0).

---

🟡 v2.0 — Multi-Currency Payments

• Send USDC on Stellar (stellarService.js, stellarService.test.js)
• Display balance in local fiat equivalent (backend/src/controllers/paymentController.js)
• Support Stellar-issued assets (docs/api.md)
• Partial Gap: Automated DEX path-payment swap routing for arbitrary asset-pair conversions (planned for v2.3).

---

🟡 v2.1 — Soroban Escrow Payments & Turrets

• Hold funds in Soroban smart contract escrow (contracts/stellar-micropay-contract)
• Release on condition (time-lock, approval) (turretsService.js, turretsService.test.js)
• Milestone-based payment release (turretsController.js, turretsController.test.js)
• Partial Gap: On-chain multi-signature dispute resolution arbitration panel flow (planned for v2.4).

---

✅ v2.2 — Analytics Dashboard

• Payment volume chart (analytics.js, analytics.test.js)
• Top recipients (ANALYTICS_GUIDE.md)
• Monthly spending summary (docs/api.md)
• CSV export (GET /api/v1/analytics/export) (analytics.test.js)

---

💬 Want to work on something?

Open an issue or comment on an existing one. See CONTRIBUTING.md to begin.