initial commit

2026-03-24 16:00:15 +01:00
commit 5a088f595b
1 changed files with 172 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,172 @@
+# xmrpay.link — Serverless XMR Invoice Builder
+
+> Privat. Selbst gehostet. Keine Accounts. Kein Backend. Kein Bullshit.
+
+---
+
+## Idee
+
+**xmrpay.link** ist eine rein clientseitige Web-App, die es jedem ermöglicht,
+in unter 30 Sekunden eine professionelle Monero-Zahlungsanforderung zu erstellen —
+ohne eigenen Node, ohne Registration, ohne KYC, ohne Drittanbieter.
+
+Du gibst deine Adresse ein, den Betrag, eine optionale Beschreibung —
+und bekommst einen QR-Code, einen kopierbaren `monero:`-Link und eine
+optionale PDF-Rechnung. Fertig.
+
+---
+
+## Das Problem (Warum es das noch nicht gibt)
+
+| Lösung | Problem |
+|---|---|
+| **BTCPay Server** | Eigener Server nötig, komplexes Setup |
+| **NOWPayments, Globee** | Custodial, KYC, Fees, Drittanbieter-Abhängigkeit |
+| **Cake Wallet Invoice** | Mobil-only, kein Teilen ohne App |
+| **MoneroPay** | Backend-Daemon nötig, nur für Entwickler |
+| **Wallet-QR direkt** | Kein Betrag, keine Beschreibung, keine Bestätigung |
+
+**Die Lücke:** Es gibt kein einfaches, datenschutzkonformes Tool für Freelancer,
+kleine Händler und Creator, das ohne Setup funktioniert und trotzdem
+Zahlungsbestätigung ermöglicht.
+
+---
+
+## Technologie-Stack
+
+```
+Frontend:   HTML + Vanilla JS (oder leichtes Vue 3)
+Crypto:     monero-javascript (WASM, läuft im Browser)
+Node:       Frei wählbarer öffentlicher Remote Node (z.B. xmr.sh, node.community)
+QR:         QRCode.js (clientseitig)
+PDF:        jsPDF (clientseitig)
+Hosting:    Statische Site — GitHub Pages, Netlify, Vercel, Self-hosted
+Backend:    KEINES
+Daten:      LocalStorage (optional, nur lokal, nie übertragen)
+```
+
+**Kein PHP-Backend. Kein Node.js-Server. Kein Datenbank-Setup.**
+Die App ist eine einzige HTML-Datei, die von überall gehostet werden kann.
+
+---
+
+## Feature-Roadmap
+
+### v1 — Der Kern (Static QR Generator)
+
+- [ ] XMR-Adresse eingeben (mit Validierung)
+- [ ] Betrag in XMR eingeben (optional: EUR/CHF/USD-Umrechnung via CoinGecko API)
+- [ ] Beschreibung / Verwendungszweck
+- [ ] Optionaler Countdown-Timer (Zahlungsfrist)
+- [ ] `monero:`-URI generieren (Standard: [SLIP-0021](https://github.com/satoshilabs/slips/blob/master/slip-0021.md))
+- [ ] QR-Code anzeigen und als PNG downloaden
+- [ ] Link kopieren (für Messenger, E-Mail etc.)
+- [ ] Responsive Design, Dark Mode
+
+### v2 — View-Key Zahlungsbestätigung (Browser-basiert)
+
+- [ ] View-Only-Key eingeben (privater Spend-Key bleibt lokal)
+- [ ] Browser pollt Remote Node via Monero RPC (kein eigener Node nötig)
+- [ ] Live-Anzeige: "Warte auf Zahlung..." → "✅ Zahlung eingegangen (X Bestätigungen)"
+- [ ] Warnhinweis bei Unterzahlung
+- [ ] Subaddress-Unterstützung (für mehrere parallele Rechnungen)
+
+### v3 — Professionelle Features
+
+- [ ] PDF-Rechnung generieren (Logo, Betrag in Fiat, XMR-Betrag, QR, Fälligkeitsdatum)
+- [ ] Einbettbarer `<iframe>`-Widget für beliebige Websites
+- [ ] Mehrsprachigkeit (DE, EN, FR, ES)
+- [ ] Rechnungshistorie (LocalStorage, exportierbar als CSV)
+- [ ] „Pay Button" Generator (HTML-Snippet zum Einbetten)
+
+---
+
+## Warum das zur Monero-Philosophie passt
+
+- **Zero Trust:** App läuft im Browser, kein Server sieht Daten
+- **Open Source:** MIT-Lizenz, forkbar, selbst hostbar
+- **Keine Accounts:** Nichts zu registrieren, nichts zu verlieren
+- **Kein KYC:** Weder Sender noch Empfänger müssen sich ausweisen
+- **Kein Custody:** Coins gehen direkt in die eigene Wallet
+- **Offline-fähig (v1):** QR-Generator funktioniert ohne Internetverbindung
+
+---
+
+## Abgrenzung zu bestehenden Tools
+
+**Kein Konkurrenz zu BTCPay:** BTCPay ist für Shops mit hohem Volumen.
+xmrpay.link ist für Einzelpersonen, Freelancer, Aktivisten — alle, die
+schnell und ohne Overhead eine Zahlung anfragen wollen.
+
+**Kein Konkurrenz zu Wallets:** Wallets bleiben die primäre Lösung
+für den täglichen Gebrauch. xmrpay.link ergänzt mit Teil- und Präsentationslogik
+(PDF, Link, Timer), die Wallets nicht bieten.
+
+---
+
+## Sicherheitshinweise (für Nutzer)
+
+- Der **Spend-Key verlässt nie den Browser** — nur View-Key wird für Monitoring verwendet
+- Remote Node sieht nur: "Wurde an diese Adresse gezahlt?" — keine Wallet-Zuordnung
+- Für maximale Privatsphäre: eigenen Node via Tor verbinden (konfigurierbar)
+- LocalStorage-Daten bleiben lokal — nichts wird übertragen
+
+---
+
+## Mögliche Domain-Namen
+
+| Domain | Begründung |
+|---|---|
+| `xmrpay.link` | ⭐ Kurz, klar, `monero:` URI passt dazu, TLD `.link` passt perfekt |
+| `xmr.invoice` | Elegant, aber `.invoice` TLD existiert nicht |
+| `payxmr.dev` | Developer-affin, gut für GitHub-Kontext |
+| `xmrbill.com` | Einprägsam, beschreibend |
+| `monero.page` | Sauber, aber evtl. zu generisch |
+| `xmrlink.io` | Klar, crypto-affine TLD |
+
+**Empfehlung: `xmrpay.link`** — weil der Name sofort sagt was die App tut,
+`.link` auf den Share-Gedanken einzahlt, und der Name kurz genug ist
+um ihn mündlich weiterzugeben.
+
+---
+
+## Projektstruktur (geplant)
+
+```
+xmrpay.link/
+├── index.html          # Single-Page-App Entry Point
+├── app.js              # Haupt-Logik (URI-Builder, QR, Fiat-Kurs)
+├── monitor.js          # View-Key Monitoring (v2)
+├── invoice.js          # PDF-Generierung (v3)
+├── style.css
+├── lib/
+│   ├── qrcode.min.js
+│   ├── monero.js       # monero-javascript WASM build
+│   └── jspdf.min.js
+├── README.md
+└── LICENSE             # MIT
+```
+
+---
+
+## Beitragen / Entwickeln
+
+```bash
+git clone https://github.com/DEIN-USERNAME/xmrpay.link
+cd xmrpay.link
+# Keine Build-Tools nötig für v1 — einfach index.html im Browser öffnen
+# Für v2+: kleines Dev-Server-Setup empfohlen (z.B. `npx serve .`)
+```
+
+Pull Requests willkommen. Issues auf GitHub. Kein Discord, kein Slack —
+das Repo ist die Kommunikation.
+
+---
+
+## Lizenz
+
+MIT — fork it, host it, improve it.
+
+---
+
+*Gebaut mit ❤️ für die Monero-Community. Inspiriert von [monero.eco](https://monero.eco).*