Nostr Wallet Connect (NWC) erklärt

Vor Nostr Wallet Connect musste jeder Nostr-Client seine eigene Wallet-Integration aufbauen oder ohne Zap-Funktionalität ausgeliefert werden. Dies führte zu zwei negativen Ergebnissen: Clients, die Zaps auslieferten, waren gezwungen, eine Wallet zu betreiben, und Clients, die keine Wallet betreiben wollten, konnten Zaps nicht unterstützen.

NWC löste dies durch die Trennung der Wallet vom Client. Die Wallet ist ihre eigene App; der Client sendet Ausgabeanfragen über Nostr selbst; alle gewinnen.

Wenn du Zaps auf einem Client ohne integrierter Wallet verwendest, verwendest du NWC, ob du dich dessen bewusst bist oder nicht. Diese Anleitung macht den Mechanismus explizit, damit du verstehst, was die Verbindungszeichenkette tut, was ihre Grenzen sind und wie du sie widerrufst.

Zusammenfassung. NWC ist ein Protokoll (NIP-47), mit dem ein Nostr-Client eine Lightning-Wallet auffordern kann, Rechnungen zu bezahlen. Die Kopplung ist eine Zeichenkette, die wie nostr+walletconnect://... aussieht. Die Zeichenkette gewährt Ausgabeberechtigung bis zu einem konfigurierbaren Budget. Jede Wallet kann mit jedem NWC-fähigen Client sprechen, sodass die Kopplung im gesamten Ökosystem funktioniert.

Wenn du bereit bist, sicher dir dein @nostr.blog →

Das Problem vor NWC

Vor NWC hatte ein Nostr-Client, der Zaps unterstützen wollte, drei schlechte Optionen.

Option 1: Eine Wallet in den Client integrieren. Verwalte Lightning-Kanäle, handle Verwahrung, sei ein Wallet-Unternehmen. Die meisten Clients konnten sich das technisch nicht leisten.

Option 2: Den Benutzer um seinen nsec und seine Wallet-Anmeldedaten bitten. Signiere Events clientseitig und sende Rechnungs-Pay-Anfragen direkt an die Wallet-API. Das bedeutete, der Client sah den API-Schlüssel der Wallet, was ein Sicherheitsnachteil ist.

Option 3: Zaps nicht unterstützen. Einige Clients wählten diesen Weg, was sie weniger nützlich machte.

NWC entkoppelt die Wallet vom Client, indem Nostr selbst als Signalisierungskanal verwendet wird. Der Client sieht niemals Wallet-Anmeldedaten. Die Wallet muss niemals etwas Nostr-Spezifisches wissen, außer wie man Anfragen empfängt.

Wie das Protokoll funktioniert

NWC ist in NIP-47 definiert. Der Ablauf:

1. Wallet generiert eine Verbindungszeichenkette. Enthält eine Nostr-Relay-URL, einen Pubkey, auf den die Wallet lauscht, und ein gemeinsames Geheimnis für die Verschlüsselung.
2. Der Benutzer fügt die Zeichenkette in den Client ein. Oder scannt einen QR-Code. Auf jeden Fall weiß der Client jetzt, wohin Anfragen gesendet werden sollen.
3. Client sendet verschlüsselte Ausgabeanfragen über Nostr. „Bezahle diese Rechnung für 1000 Sats" geht in einem verschlüsselten Event zum Listening-Pubkey der Wallet am angegebenen Relay.
4. Wallet empfängt die Anfrage und bezahlt. Wenn der Betrag innerhalb des Budgets der Verbindung liegt, bezahlt die Wallet die Rechnung sofort.
5. Wallet antwortet mit dem Ergebnis. Verschlüsseltes Nostr-Event zurück an den Client: Zahlung erfolgreich oder fehlgeschlagen, hier ist der Beweis.

Das Ganze passiert in unter einer Sekunde. Der Client behandelt Lightning nie direkt; er spricht nur mit Nostr. Die Wallet muss Nostr-Sozialfunktionen nie verstehen; sie lauscht nur auf Ausgabeanfragen.

Was die Verbindungszeichenkette enthält

Eine typische NWC-Zeichenkette:

nostr+walletconnect://abc123def456...?relay=wss://relay.example.com&secret=xyz789...

Drei Teile.

Ein Pubkey. Die Listening-Identität der Wallet auf Nostr. Der Client sendet Anfragen an diesen Pubkey.

Ein Relay. Wo die Wallet lauscht. Der Client und die Wallet verbinden sich beide mit diesem Relay, um Nachrichten auszutauschen.

Ein Geheimnis. Wird verwendet um Nachrichten zwischen Client und Wallet zu verschlüsseln, damit das Relay nur Geheimtext sieht.

Zusammen geben diese drei Werte dem Client die Berechtigung, Ausgabebefehle an die Wallet zu senden. Das Relay ist der Briefkasten; der Pubkey ist die Adresse; das Geheimnis ist das Schloss.

Budget und Berechtigungen

Jede NWC-Verbindung hat Grenzen, die von der Wallet bei der Erstellung der Verbindung festgelegt wurden.

• Höchstbetrag pro Zahlung. Typischerweise 10.000 bis 100.000 Sats, je nachdem, was du festlegst. Das Ausgeben von mehr erfordert eine neue Genehmigung.
• Höchstbetrag pro Tag/Woche/Monat. Rollierendes Budget, das nach einem Zeitplan aufgefüllt wird.
• Ablaufdatum. Einige Wallets laufen Verbindungen nach einem Zeitraum automatisch ab; andere lassen sie offen, bis sie widerrufen werden.
• Zulässige Methoden. Einige Wallets ermöglichen es dir nur, die Berechtigung „Rechnung bezahlen" zu gewähren und verweigern „Saldo nachschlagen" oder „Transaktionen auflisten".

Das Budget bedeutet, dass selbst wenn eine Verbindungszeichenkette durchsickert, der Schaden begrenzt ist. Ein Angreifer kann nicht die ganze Wallet leeren; er kann bis zum Budget ausgeben, woraufhin die Wallet weitere Anfragen ablehnt, bis du das Limit erhöhst oder eine neue Verbindung generierst.

NWC einrichten, Schritt für Schritt

Konkreter Ablauf für einen typischen Benutzer, der eine Wallet mit einem Nostr-Client koppelt.

1. Öffne deine Lightning-Wallet. Wallet of Satoshi, Phoenix, Alby Hub, Zeus oder eine beliebige NWC-unterstützende Wallet.
2. Finde die NWC-Einstellungen. Suche nach „Verbindungen", „Nostr Wallet Connect" oder „Apps" im Einstellungsmenü. Jede Wallet platziert es an einer etwas anderen Stelle.
3. Erstelle eine neue Verbindung. Gib ihr einen Namen, damit du weißt, für welche App sie ist. Lege ein Budget fest.
4. Kopiere die generierte NWC-Zeichenkette. Oder erhalte einen QR-Code.
5. Öffne deinen Nostr-Client. Gehe zu Einstellungen, finde „Lightning-Wallet" oder „Zap-Einstellungen".
6. Füge die NWC-Zeichenkette ein oder scanne den QR. Der Client testet die Verbindung.
7. Erfolg. Zap-Schaltflächen leuchten auf; dein nächster Zap geht durch die gekoppelte Wallet.

Wenn der Client nach der Kopplung „Verbindung fehlgeschlagen" anzeigt, ist die häufigste Ursache eine Relay-Nichtübereinstimmung (das Relay in der NWC-Zeichenkette ist eines, das der Client nicht erreichen kann) oder eine Firewall, die WebSocket-Verbindungen blockiert.

Warum dies besser ist als eine integrierte Wallet

Drei echte Vorteile von NWC gegenüber integrierten Wallets.

Portabilität. Du kannst Nostr-Clients wechseln, ohne die Wallet zu wechseln. Dein Guthaben, deine Historie und deine Kanäle bleiben bestehen; der neue Client koppelt sich einfach über eine neue NWC-Verbindung mit derselben Wallet.

Spezialisierung. Wallet-Entwickler konzentrieren sich auf Lightning-Infrastruktur; Client-Entwickler konzentrieren sich auf soziale UX. Jede Seite wird in ihrer eigenen Domäne besser, und die Interoperabilität funktioniert über Kombinationen hinweg.

Sicherheitsgrenze. Der Client hat niemals Wallet-Anmeldedaten. Ein fehlerhafter Client kann im schlimmsten Fall falsche Rechnungen senden; er kann die Wallet nicht leeren oder die Seed-Phrase exportieren.

Der einzige Fall, in dem integriert eindeutig besser ist, ist für Benutzer, die maximales reibungsloses Onboarding wünschen. Ein Client mit einer gebündelten Wallet bringt den Benutzer um einen Schritt schneller zum Zappen als die Kopplung einer externen Wallet. Deshalb wird die nostr.blog-Anmeldung standardmäßig mit einer Wallet versehen, und Benutzer können sich später immer noch über NWC an externe Wallets koppeln, falls sie dies bevorzugen.

Eine NWC-Verbindung widerrufen

Wenn du ein Gerät verlierst, einen Client nicht mehr verwendest oder Anmeldedaten rotieren möchtest, widerrufe die Verbindung von der Wallet-Seite.

1. Öffne die Wallet.
2. Finde die Verbindung in der Einstellungsliste.
3. Tippe auf Widerrufen oder Löschen.
4. Die Verbindungszeichenkette funktioniert nicht mehr; jeder Client, der sie hält, erhält beim nächsten Request „Nicht autorisiert".

Dies ist sofort. Im Gegensatz zu API-Schlüsseln, die du möglicherweise in ein GitHub-Repo durchsickerst, können NWC-Verbindungen in Sekunden beendet werden und es bestehen keine bleibenden Sitzungen. Dies ist eine bedeutungsvolle Sicherheitseigenschaft.

Häufige NWC-Probleme

„Verbindungszeitüberschreitung." Das Relay in der NWC-Zeichenkette ist von deinem Netzwerk aus nicht erreichbar, oder die Wallet ist offline. Überprüfe, dass die Wallet-App offen und verbunden ist; einige Wallets erfordern, dass die App aktiv ist, um zu antworten.

„Zahlung fehlgeschlagen" trotz einer gültigen Rechnung. Die Kanäle der Wallet haben möglicherweise nicht genug Liquidität, um die Zahlung zu leiten. Dies ist ein Lightning-Layer-Problem, nicht spezifisch für NWC. Versuche es mit einem anderen Betrag oder zu einer anderen Zeit.

„Berechtigung verweigert." Das Budget der Verbindung ist erschöpft, die Verbindung ist abgelaufen, oder der Anforderungstyp ist nicht in den zulässigen Methoden enthalten. Überprüfe die Verbindungseinstellungen der Wallet.

„Client kann Wallet nicht erkennen." Nach dem Einfügen bleibt der Client hängen. Schließe den Client und öffne ihn erneut; einige Clients cachen den Verbindungsstatus und überprüfen ihn nur beim Start erneut.

Wohin NWC geht

NIP-47 ist nicht endgültig. Die aktive Arbeit 2026 deckt ab:

• Umfassendere Berechtigungen. Granularer als „kann bis zu X pro Zeitraum ausgeben", mit pro-Empfänger- oder pro-Betrag-Regeln.
• Multi-Wallet-Routing. Ein Client, der mit mehreren Wallets gekoppelt ist, wählt für jede Zahlung die beste basierend auf Guthaben, Gebühr oder Route.
• Bessere Fehlerbehandlung. Standardisierte Fehlercodes, damit Clients nützliche Nachrichten anzeigen können, wenn Zahlungen fehlschlagen.
• Unterstützung für Offline-Wallets. Das aktuelle NWC geht davon aus, dass beide Seiten online sind; Entwürfe ermöglichen eingereihte Anfragen, die sich beilegen, wenn die Wallet erneut verbunden wird.

Das Protokoll ist 2026 stabil genug für den täglichen Gebrauch und wird sich weiterhin entwickeln. Die Kopplung einer Wallet ist heute eine einminütige Operation; nichts am aktuellen Design wird später kaputt gehen.