Configuration de l'adresse de réception de zap : comment être payé en sats sur Nostr

Recevoir des zaps est la moitié de ce qui fait fonctionner la couche économique de Nostr. L'envoi est la partie visible ; la réception est ce qui vous intéresse si vous publiez du contenu méritant un pourboire.

La configuration est directe mais a un mode de défaillance courant qui représente la plupart des questions d'assistance « mes zaps n'apparaissent pas ». Ce guide vous montre comment configurer et diagnostiquer les problèmes.

TL;DR. Obtenez un portefeuille Lightning qui supporte les reçus de zap (Wallet of Satoshi, Primal wallet, Alby, portefeuille intégré nostr.blog). Collez l'adresse Lightning du portefeuille dans le champ « Lightning address » de votre profil Nostr. Enregistrez. Testez avec un petit zap depuis un autre compte. Le zap devrait apparaître sur votre post en quelques secondes.

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

Ce qu'une adresse de réception de zap est réellement

Deux choses regroupées ensemble.

Une adresse Lightning. Format comme un email : votrenoм@domain.com. C'est un point de terminaison LNURL-pay. Les portefeuilles des expéditeurs l'appellent pour demander une facture ; il retourne une facture ; l'expéditeur la paie ; les sats arrivent.

Un éditeur de reçu de zap. Quand la demande de l'expéditeur inclut un événement zap-request Nostr (kind:9734), le service de réception doit, après le paiement, publier un reçu de zap signé (kind:9735) sur les relais Nostr. C'est ce qui rend le zap visible sur le post.

Une adresse Lightning sans la fonctionnalité d'éditeur de reçu de zap est juste une adresse Lightning. L'argent se déplace ; aucun signal social n'apparaît. Une adresse de réception de zap complète fait les deux.

Les portefeuilles qui supportent les reçus de zap

Depuis avril 2026, les portefeuilles compatibles zap fiables :

• Wallet of Satoshi. Publication de reçus fiable depuis début 2023.
• Primal Wallet. Construit pour Nostr ; les reçus fonctionnent par défaut.
• Alby (hébergé et auto-hébergé). Support zap fort.
• Portefeuille intégré nostr.blog. Les reçus sont publiés automatiquement.
• Phoenix avec plugin Nostr ou configuration spécifique.
• LNbits avec l'extension Nostr Zaps (auto-hébergé).
• Alby Hub. Support zap complet.

Portefeuilles sans support zap (le paiement fonctionne, le reçu ne fonctionne pas) :

• Adresses de retrait d'échange génériques (Kraken, Coinbase, etc.)
• Certains portefeuilles gardiens plus anciens antérieurs aux zaps
• Nœuds LND sans frontend LNURL conscient des zaps
• Factures brutes de nœud Lightning (pas d'adresse Lightning du tout)

Si votre portefeuille ne figure pas sur la première liste, attendez-vous à ce que les reçus de zap échouent.

Procédure de configuration

Étapes concrètes pour le cas le plus courant : utiliser Wallet of Satoshi.

1. Installez Wallet of Satoshi. Choisissez un nom d'utilisateur ; votre adresse Lightning devient username@walletofsatoshi.com.
2. Copiez l'adresse Lightning depuis le portefeuille (l'écran Receive l'affiche).
3. Ouvrez votre client Nostr. Allez aux paramètres du profil.
4. Trouvez le champ intitulé « Lightning address », « LN address » ou « Zap address ». Collez-y votre adresse WoS.
5. Enregistrez le profil. Le client publie un événement de profil mis à jour ; les relais le propagent.

Le même flux fonctionne avec n'importe quel autre portefeuille compatible zap ; seules les étapes spécifiques au portefeuille diffèrent.

Testez la configuration

Ne supposez jamais que les zaps fonctionnent sans vérification. Testez en moins de deux minutes.

Option 1 : Zappez-vous vous-même depuis une deuxième identité Nostr (si vous en avez une).

Option 2 : Demandez à un ami de vous zapper 21 sats.

Option 3 : Utilisez un outil de test de zap Nostr (certains clients incluent une fonctionnalité « test zap » dans les paramètres du portefeuille).

Résultat attendu : en quelques secondes, le zap apparaît à côté de l'un de vos posts récents avec « 21 sats » visible. Le solde de votre portefeuille augmente également d'environ 21 sats.

Si les sats arrivent mais aucun zap n'apparaît sur le post : votre portefeuille ne publie pas les reçus de zap. Basculez vers un portefeuille compatible.

Si aucun sat n'arrive et aucun zap n'apparaît : le paiement lui-même a échoué. C'est plus rare ; vérifiez les messages d'erreur dans le portefeuille Lightning de l'expéditeur.

La défaillance la plus courante

« J'ai zappé cette personne et l'argent est arrivé mais aucune icône de zap n'apparaît. »

Presque toujours : l'adresse Lightning du destinataire ne publie pas les reçus de zap.

Diagnostic : demandez au destinataire quel portefeuille il utilise. S'il figure sur la liste supportée, quelque chose d'autre est mal. S'il ne figure pas, c'est votre réponse.

Solution : le destinataire change de portefeuille ou configure son service pour publier les reçus. L'expéditeur a déjà payé ; l'argent est dans le portefeuille du destinataire. Seul le signal social manque.

Ce mode de défaillance représente la plupart du trafic d'assistance liée aux zaps sur Nostr. Il vaut la peine de vérifier spécifiquement votre propre configuration pour ce problème ; de nombreux utilisateurs ne réalisent pas que leur réception de zap est cassée parce qu'ils voient les sats arriver dans leur portefeuille et supposent que tout fonctionne.

Pourquoi certains services ne publient pas les reçus

Un reçu de zap est un événement Nostr. Pour le publier, le service Lightning doit :

1. Une clé privée Nostr (pour signer les reçus)
2. Les connexions aux relais Nostr
3. La connaissance de l'événement zap-request que l'expéditeur a joint
4. Un processus qui déclenche la publication du reçu lors de la réception du paiement

C'est du code supplémentaire et de l'infrastructure par rapport à un portefeuille Lightning pur. Les services qui précèdent les zaps (2022 et avant) n'ont pas tous rétrofité la fonctionnalité. Les services construits pour une utilisation Lightning non-Nostr n'ont aucune raison de l'expédier.

Le résultat : deux écosystèmes Lightning avec chevauchement. Tous les éditeurs de zap sont des adresses Lightning ; pas toutes les adresses Lightning sont des éditeurs de zap.

Adresses Lightning avec domaine personnalisé

Si vous voulez alice@yourdomain.com au lieu de alice@walletofsatoshi.com, vous avez besoin d'un service Lightning qui vous permet d'utiliser votre propre domaine. Options :

• Exécutez votre propre serveur LNURL-pay (LNbits avec extensions, BTCPay Server, configuration personnalisée). Contrôle complet ; nécessite l'hébergement.
• Alby Hub avec domaine personnalisé. Auto-hébergez Alby Hub, configurez un domaine personnalisé, pointez le DNS.
• Certains services gérés offrent la tarification des domaines personnalisés. Consultez la documentation de chaque service.

Pour la plupart des utilisateurs, le suffixe walletofsatoshi.com ou similaire est correct. Le domaine personnalisé est un raffinement de marque, pas une amélioration fonctionnelle.

Combiner la réception de zap avec NIP-05

Vous pouvez avoir :

• Votre identifiant Nostr vérifié : alice@nostr.blog (NIP-05)
• Votre adresse de réception de zap : wildfox123@walletofsatoshi.com (Lightning)

Ceux-ci ne doivent pas correspondre. Ils servent à des fins différentes (identité vs paiement) et résident souvent chez des fournisseurs différents.

Certains utilisateurs préfèrent les faire correspondre. Les services qui offrent les deux (nostr.blog offre les deux, par exemple) vous laissent utiliser alice@nostr.blog pour NIP-05 et Lightning. Nettoyage de marque, pas une exigence technique.

Tester votre adresse Lightning en externe

Collez votre adresse Lightning dans un testeur d'adresse Lightning. Plusieurs existent :

• lightningaddress.com a un outil de recherche
• Divers clients Nostr incluent une fonctionnalité « vérifier mon adresse Lightning » dans les paramètres
• Vous pouvez tester manuellement en faisant envoyer un paiement Lightning régulier (non-zap) à l'adresse par quelqu'un

Si l'adresse accepte les paiements réguliers, la partie Lightning de base fonctionne. Si elle publie également les reçus de zap sur les demandes de zap, la partie zap fonctionne.

La plupart des utilisateurs n'ont besoin que du test de base ; la partie zap est vérifiée par le premier vrai zap qui réussit.

Après la configuration

Une fois que votre adresse de réception de zap est configurée et testée, vous avez terminé. Les zaps arrivent, les reçus sont publiés, tout est automatique.

Choses à surveiller occasionnellement :

• Solde. Votre portefeuille accumule les zaps ; videz-le vers un stockage à froid ou un portefeuille non-gardien régulièrement si le solde augmente significativement.
• Statut du service. Si votre fournisseur de portefeuille est hors ligne, les zaps envoyés pendant la panne peuvent échouer ou arriver tardivement.
• Affichage du client. Différents clients Nostr affichent les reçus de zap différemment ; ce qui est visible sur Damus pourrait ressembler à quelque chose de différent sur Amethyst.

Tout cela est mineur. L'expérience typique est que les zaps fonctionnent simplement.

Si vous changez d'adresse de réception de zap plus tard

La migration est facile. Étapes :

1. Configurez le nouveau portefeuille ; obtenez la nouvelle adresse Lightning.
2. Mettez à jour votre profil Nostr avec la nouvelle adresse.
3. Attendez quelques minutes pour que la mise à jour du profil se propage aux relais.
4. Les nouveaux zaps vont maintenant au nouveau portefeuille.
5. Retirez tout solde restant de l'ancien portefeuille vers le nouveau (ou vers un stockage à froid).

Les zaps envoyés après la mise à jour du profil vont au nouveau portefeuille. Les zaps qui ont eu la malchance de faire la course avec la mise à jour peuvent aller à l'ancien pendant une minute ou deux. Perte négligeable ; le système est tolérant.

Vous pouvez changer aussi souvent que vous le souhaitez. L'adresse Lightning n'est pas un engagement ; c'est juste un pointeur.