Nostr Wallet Connect (NWC) expliqué

Avant Nostr Wallet Connect, chaque client Nostr devait construire sa propre intégration de portefeuille, ou être expédié sans fonctionnalité de zap du tout. Cela a produit deux mauvais résultats : les clients qui expédiaient des zaps étaient forcés de gérer un portefeuille, et les clients qui ne voulaient pas gérer un portefeuille ne pouvaient pas supporter les zaps.

NWC a résolu ce problème en séparant le portefeuille du client. Le portefeuille est sa propre application ; le client envoie des demandes de dépense via Nostr lui-même ; tout le monde gagne.

Si vous utilisez des zaps sur n'importe quel client sans portefeuille intégré, vous utilisez NWC que vous y pensiez ou non. Ce guide rend le mécanisme explicite pour que vous compreniez ce que la chaîne de connexion fait, quelles sont ses limites et comment la révoquer.

TL;DR. NWC est un protocole (NIP-47) permettant à un client Nostr de demander à un portefeuille Lightning de payer des factures. L'appairage est une chaîne qui ressemble à nostr+walletconnect://.... La chaîne accorde la permission de dépenser jusqu'à un budget configurable. N'importe quel portefeuille peut parler NWC à n'importe quel client conscient de NWC, donc l'appairage fonctionne dans tout l'écosystème.

Quand vous êtes prêt, prenez votre adresse @nostr.blog →

Le problème avant NWC

Avant NWC, un client Nostr qui voulait supporter les zaps avait trois mauvaises options.

Option 1 : Intégrer un portefeuille dans le client. Gérer les canaux Lightning, gérer la garde, être une société de portefeuille. La plupart des clients ne pouvaient pas se permettre l'ingénierie.

Option 2 : Demander à l'utilisateur son nsec et ses identifiants de portefeuille. Signer les événements côté client et envoyer les demandes de paiement de facture directement à l'API du portefeuille. Cela signifiait que le client voyait la clé API du portefeuille, ce qui est un cauchemar de sécurité.

Option 3 : Ne pas supporter les zaps. Certains clients ont pris ce chemin, ce qui les a rendus moins utiles.

NWC découple le portefeuille du client en utilisant Nostr lui-même comme canal de signalisation. Le client ne voit jamais les identifiants du portefeuille. Le portefeuille ne doit jamais rien savoir de spécifique à Nostr sauf comment recevoir les demandes.

Comment le protocole fonctionne

NWC est défini dans NIP-47. Le flux :

1. Le portefeuille génère une chaîne de connexion. Contient une URL de relai Nostr, une pubkey que le portefeuille écoute, et un secret partagé pour le chiffrement.
2. L'utilisateur colle la chaîne dans le client. Ou scanne un code QR. De toute façon, le client sait maintenant où envoyer les demandes.
3. Le client envoie des demandes de dépense chiffrées via Nostr. « Payer cette facture pour 1000 sats » va dans un événement chiffré à la pubkey d'écoute du portefeuille au relai spécifié.
4. Le portefeuille reçoit la demande et paie. Si le montant est dans le budget de la connexion, le portefeuille paie la facture immédiatement.
5. Le portefeuille répond avec le résultat. Événement Nostr chiffré de retour au client : le paiement a réussi ou échoué, voici la preuve.

Le tout se déroule en moins d'une seconde. Le client ne gère jamais Lightning directement ; il parle juste à Nostr. Le portefeuille n'a jamais besoin de comprendre les fonctionnalités sociales de Nostr ; il écoute juste les demandes de dépense.

Ce que contient la chaîne de connexion

Une chaîne NWC typique :

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

Trois parties.

Une pubkey. L'identité d'écoute du portefeuille sur Nostr. Le client envoie les demandes à cette pubkey.

Un relai. Où le portefeuille écoute. Le client et le portefeuille se connectent tous deux à ce relai pour échanger les messages.

Un secret. Utilisé pour chiffrer les messages entre le client et le portefeuille, pour que le relai ne voie que du texte chiffré.

Ensemble, ces trois valeurs donnent au client la permission d'envoyer des commandes de dépense au portefeuille. Le relai est la boîte aux lettres ; la pubkey est l'adresse ; le secret est la serrure.

Budget et permissions

Chaque connexion NWC a des limites définies par le portefeuille lors de la création de la connexion.

• Montant maximum par paiement. Typiquement 10 000 à 100 000 sats selon ce que vous avez défini. Dépenser plus nécessite une nouvelle approbation.
• Montant maximum par jour/semaine/mois. Budget roulant qui se recharge selon un calendrier.
• Date d'expiration. Certains portefeuilles font expirer automatiquement les connexions après une période ; d'autres les laissent ouvertes jusqu'à révocation.
• Méthodes autorisées. Certains portefeuilles vous permettent d'accorder uniquement « payer facture », refusant « consulter solde » ou « lister transactions ».

Le budget signifie que même si une chaîne de connexion fuit, les dégâts sont limités. Un attaquant ne peut pas vider tout le portefeuille ; il peut dépenser jusqu'au budget, auquel point le portefeuille refuse les demandes ultérieures jusqu'à ce que vous augmentiez la limite ou génériez une nouvelle connexion.

Configuration de NWC, étape par étape

Flux concret pour un utilisateur typique appairant un portefeuille avec un client Nostr.

1. Ouvrez votre portefeuille Lightning. Wallet of Satoshi, Phoenix, Alby Hub, Zeus, ou n'importe quel portefeuille supportant NWC.
2. Trouvez les paramètres NWC. Cherchez « Connexions », « Nostr Wallet Connect » ou « Applications » dans le menu des paramètres. Chaque portefeuille le place à un endroit légèrement différent.
3. Créez une nouvelle connexion. Donnez-lui un nom pour que vous vous souvenez pour quelle application c'est. Définissez un budget.
4. Copiez la chaîne NWC générée. Ou obtenez un code QR.
5. Ouvrez votre client Nostr. Allez aux paramètres, trouvez « Portefeuille Lightning » ou « Paramètres Zap ».
6. Collez la chaîne NWC ou scannez le QR. Le client teste la connexion.
7. Succès. Les boutons Zap s'allument ; votre prochain zap passe par le portefeuille appairé.

Si le client affiche « connexion échouée » après l'appairage, la cause la plus commune est une incompatibilité de relai (le relai dans la chaîne NWC est un que le client ne peut pas atteindre) ou un pare-feu bloquant les connexions WebSocket.

Pourquoi cela bat un portefeuille intégré

Trois vrais avantages de NWC sur les portefeuilles intégrés.

Portabilité. Vous pouvez changer de client Nostr sans changer de portefeuille. Votre solde, historique et canaux restent ; le nouveau client s'apparie simplement avec le même portefeuille via une nouvelle connexion NWC.

Spécialisation. Les développeurs de portefeuilles se concentrent sur l'infrastructure Lightning ; les développeurs de clients se concentrent sur l'UX social. Chaque côté devient meilleur dans son propre domaine, et l'interopérabilité fonctionne entre les combinaisons.

Limite de sécurité. Le client n'a jamais les identifiants du portefeuille. Un client bogué peut au pire envoyer de mauvaises factures ; il ne peut pas vider le portefeuille ou exporter la phrase graine.

Le seul cas où l'intégration est clairement meilleure est pour les utilisateurs qui veulent un onboarding sans friction maximale. Un client avec un portefeuille fourni fait zapper l'utilisateur une étape plus vite que d'appairer un portefeuille externe. C'est pourquoi l'inscription nostr.blog inclut un portefeuille par défaut, et les utilisateurs peuvent toujours appairer des portefeuilles externes via NWC plus tard s'ils préfèrent.

Révoquer une connexion NWC

Si vous perdez un appareil, arrêtez d'utiliser un client, ou voulez faire pivoter les identifiants, révoquez la connexion du côté du portefeuille.

1. Ouvrez le portefeuille.
2. Trouvez la connexion dans la liste des paramètres.
3. Appuyez sur révoquer ou supprimer.
4. La chaîne de connexion ne fonctionne plus ; n'importe quel client la possédant obtient « non autorisé » à la demande suivante.

C'est instantané. Contrairement aux clés API que vous pourriez fuite dans un dépôt GitHub, les connexions NWC peuvent être tuées en secondes et aucune session persistante ne reste. C'est une propriété de sécurité significative.

Problèmes NWC courants

« Connexion expirée. » Le relai dans la chaîne NWC est inaccessible depuis votre réseau, ou le portefeuille est hors ligne. Vérifiez que l'application du portefeuille est ouverte et connectée ; certains portefeuilles nécessitent que l'application soit active pour répondre.

« Paiement échoué » malgré une facture valide. Les canaux du portefeuille peuvent manquer de liquidité pour acheminer le paiement. C'est un problème de la couche Lightning, pas spécifique à NWC. Essayez un montant différent ou un moment différent.

« Permission refusée. » Le budget de la connexion est épuisé, la connexion a expiré, ou le type de demande n'est pas dans les méthodes autorisées. Vérifiez les paramètres de connexion du portefeuille.

« Le client ne peut pas détecter le portefeuille. » Après collage, le client s'arrête. Fermez et rouvrez le client ; certains clients mettent en cache l'état de connexion et ne revérifient qu'au lancement.

Où va NWC

NIP-47 n'est pas finalisé. Le travail actif en 2026 couvre :

• Permissions plus riches. Plus granulaire que « peut dépenser jusqu'à X par période », avec des règles par destinataire ou par montant.
• Routage multi-portefeuille. Un client appairé avec plusieurs portefeuilles choisit le meilleur pour chaque paiement en fonction du solde, des frais ou de l'itinéraire.
• Meilleur rapport d'erreur. Codes d'erreur standardisés pour que les clients puissent afficher des messages utiles quand les paiements échouent.
• Support des portefeuilles hors ligne. Le NWC actuel suppose que les deux côtés sont en ligne ; les brouillons permettent les demandes en attente qui se règlent quand le portefeuille se reconnecte.

Le protocole est assez stable pour un usage quotidien en 2026 et continuera à évoluer. Appairer un portefeuille aujourd'hui est une opération d'une minute ; rien dans la conception actuelle ne se cassera plus tard.