Publié à l'origine sur Substack le 12 décembre 2022. Mis à jour ici le 28 décembre 2024.
Un guide pour les nouveaux utilisateurs/administrateurs de LNbits, sur la façon de démarrer et de gérer le nœud LN derrière chaque instance LNbits.
Ce guide est dédié à ceux qui souhaitent implémenter LNbits dans leur entreprise mais n'ont pas d'expérience dans l'exécution d'un nœud Lightning derrière LNbits.
À la fin du guide, vous trouverez plus de documentation à étudier. Cet article est uniquement destiné à vous donner quelques « premières orientations ». Ce n'est PAS le guide ultime pour la liquidité de votre nœud, il suffit juste de vous mettre, vous, le nouvel utilisateur de LN, sur la bonne voie. Après avoir lu ce guide, vous devrez faire beaucoup de devoirs.
Je vais essayer de l'expliquer en termes simples afin qu'il puisse être assimilé par tout type d'utilisateur, qui n'est pas très familier avec les détails techniques et encore moins avec l'exécution d'un nœud LN, mais qui souhaite commencer à utiliser LNbits pour divers scénarios professionnels et personnels.
ASPECT IMPORTANT
LNbits est un système de comptabilité au-dessus de votre nœud LN.
À partir de la version 12.0, il s'agit également d'un logiciel de gestion de nœuds !
Considérez LNbits comme un « cadre modulaire WordPress » pour votre nœud. Une plateforme facile à gérer, basée sur des extensions que vous pouvez combiner pour de nombreux cas d'utilisation.
Considérez LNbits comme votre propre logiciel de gestion financière bancaire. Votre nœud propose des canaux de paiement et LNbits étend votre nœud pour pouvoir exécuter plus d'un portefeuille Lightning fourni avec votre nœud. Ces portefeuilles ne doivent pas nécessairement vous appartenir. Disons que vous, en tant que gestionnaire de nœud LN, disposez déjà de suffisamment de liquidités et de fonds de canal et que vous souhaitez maintenant offrir des services bancaires Bitcoin à vos amis, votre famille, votre propre magasin ou d'autres commerçants réguliers.
Vous leur proposerez un moyen simple d'ouvrir un « compte bancaire » sur votre nœud sans avoir accès aux autres portefeuilles de votre nœud et à toute la liquidité de votre nœud, mais seulement à leur part. Votre nœud (la banque) agit uniquement en tant que fournisseur de transport pour leurs paiements (entrée/sortie).
REMARQUE : tous les fonds que vos « clients » déposent sur leurs comptes bancaires LNbits sur votre nœud iront directement dans les canaux LN de votre nœud. Cela signifie que VOUS êtes en fait le véritable propriétaire de ces fonds. Vous aurez une grande responsabilité pour ces fonds. Ne soyez pas méchant et ne vous enfuyez pas avec les fonds, ne soyez pas méchant et ne facturez pas de frais élevés. Nous voulons baiser les banquiers fiat, pas nous baiser les uns les autres (utilisateurs de bitcoin).
A - Gestion de la liquidité des nœuds (bancaires)
Il s'agit d'une partie très importante, où de nombreux nouveaux utilisateurs se perdent un peu, ne connaissant pas les bases du fonctionnement du Lightning Network et ce qui est nécessaire pour fournir une bonne liquidité pour les paiements entrants et sortants.
La courbe d'apprentissage n'est pas facile, mais pas non plus si difficile. Avec un peu de patience et de lecture, tout le monde peut le faire. Mais s'il vous plaît, ne commencez pas à proposer des services avec votre banque LNbits à d'autres avant d'avoir correctement préparé votre nœud LN.
Les cas d'utilisation les plus courants pour un nœud comme celui-ci (banque marchande LNBits, utilisateurs réguliers, backend spécifique pour une application Web) nécessiteraient certaines conditions préalables pour une navigation fluide :
- une liquidité entrante et sortante suffisante dans les canaux LN de votre nœud
- des frais faibles voire nuls entre vos comptes LNbits
- un matériel et une configuration fiables, toujours en ligne, une connexion rapide, clearnet (de préférence) et/ou Tor (pour ceux qui veulent un accès tunnel différent, mais gardez à l'esprit que Tor est vraiment lent).
Qu'est-ce que la liquidité entrante ? La capacité d'un nœud LN à recevoir des paiements. Pas seulement au total, mais aussi pour chaque paiement.
Qu'est-ce que la liquidité sortante ? Cela signifie la capacité totale que votre nœud est capable d'envoyer.
Pensez aux paiements via votre nœud comme à des verres d'eau qui, remplis d'eau, passent à travers une petite ou une grande paille ou un tuyau. Le verre (le destinataire), est le canal LN, ne peut à la fois transporter qu'une certaine quantité d'eau et votre verre ne peut au total pas envoyer plus que ce que vous possédez dans votre verre.
Je n'entrerai pas maintenant dans les détails, expliquant comment fonctionne LN. J'ai écrit des guides détaillés sur ma page de guides et ici j'ai rassemblé une liste de ressources LN à étudier, avec des documentations, des tutoriels, des outils, des liens, des services, etc.
Préparer la liquidité d'un nœud LN demande de la patience, du temps, des études et la sélection de bons pairs, surtout si vous l'utilisez à des fins commerciales. Ici, je vais vous donner quelques conseils sur la façon de commencer, afin que vos nouveaux LNbits puissent commencer à recevoir et à envoyer des sats, pour tous vos comptes et utilisateurs supplémentaires. Vous trouverez votre propre moyen d'affiner votre nœud, une fois que vous en saurez plus sur la gestion des liquidités.
Supposons que vous ayez un tout nouveau nœud prêt, mais pas encore de canaux LN. À ce moment, vos LNbits ne pouvaient ni recevoir ni envoyer de paiement en dehors de votre « banque », dans le réseau sauvage LN (Lightning Network).
Comme outil principal pour vérifier et étudier les homologues des nœuds LN, je recommande d'utiliser la page d'exploration Amboss ou Mempool LN, où vous pouvez en apprendre davantage sur de nombreux détails d'un nœud, y compris le vôtre.
Aspects importants lors de la recherche d'un bon nœud homologue / partenaire de canal :
- nombre de canaux, plus il y en a, mieux c'est (un nœud avec seulement 5 à 10 canaux ne vous fournira pas trop de routes)
- longévité, plus c'est long, mieux c'est (indique l'engagement à fournir un bon service)
- capacité totale, plus c'est grand, mieux c'est (indique la quantité totale de satellites qui peuvent router vers/depuis votre nœud)
- taille des canaux, plus c'est grand, mieux c'est (probablement un temps plus long avant que les canaux ne soient secs et indique également la taille maximale d'un paiement qui peut être routé)
- ne considérez pas votre pair comme un « ami Facebook ». LN ne concerne pas les amis mais les bons pairs de routage. Ainsi, se connecter à un nœud simplement parce que le propriétaire est votre ami ne vous aidera pas du tout, ni le réseau, si ce nœud n'a pas lui-même de bonnes routes. Oui, si votre nœud est déjà bien positionné et que vous souhaitez aider votre ami novice à démarrer avec un nouveau nœud, cela pourrait et devrait être une exception.
Remarquez les détails sur la page Amboss, qui vous donnent une compréhension approfondie de la façon dont ce nœud gère ses canaux : taille du canal, frais de base, frais de taux, TimeLock, etc.
Ces aspects sont très importants lorsqu'il est temps de choisir vos premiers pairs.
a. Taille du canal
N'ouvrez pas de petits canaux de moins de 3 M de satellites. Restez cependant en dessous de 10 à 21 M de satellites maximum.
Tout dépend de votre utilisation par paiement. Si vous êtes sûr d'utiliser de très gros canaux, vous pouvez également avoir un canal de 21 M de satellites par exemple, mais limitez le nombre de satellites par paiement unique à 1 M, en utilisant l'option HTLC min/max, par canal. J'ai écrit ici un guide détaillé sur le résultat de l'utilisation de cette méthode.
b. Capacité totale du nœud
Votre nœud doit pouvoir disposer d'une capacité suffisante pour tous les clients de votre « banque ».
Dans cette capture d'écran de Thunderhub (application de gestion des nœuds), vous pouvez voir la capacité totale entrante et sortante ainsi que la taille maximale des montants entrants et sortants par transaction.
Il est recommandé de maintenir cet équilibre, c'est-à-dire d'avoir presque la même capacité de réception et d'envoi. Tout drainage expansif dans une direction pourrait aboutir à des échecs de paiement.
Peu importe si un canal n'est pas parfaitement équilibré à 50-50.
Vos canaux LN de nœud ressembleront à ceci, après un certain temps, un côté qui représente vos sats et l'autre côté qui représente les sats de votre pair, jonglant toujours dans les deux sens pendant que les portefeuilles de votre nœud l'utilisent et que les paiements des autres sont acheminés.
Ce qui entre par un canal peut également sortir par un autre, ce qui, avec le temps, les équilibrera globalement.
Oui, au début, il est bon de commencer par des canaux équilibrés, afin de pouvoir effectuer et fournir directement des paiements entrants et sortants. Cela peut être réalisé grâce à un rééquilibrage circulaire, en utilisant un service de swap pour déplacer les sats de vos canaux LN vers votre adresse onchain et les utiliser à nouveau pour ouvrir plus de canaux. J'expliquerai dans le prochain chapitre comment cela fonctionne.
c. Liquidité
Une bonne stratégie serait d'ouvrir 2-3-4-5 canaux avec de bons LSP (fournisseurs de services de liquidité), pour avoir de bons itinéraires dès le départ. De préférence ceux qui ont des nœuds de fournisseur de portefeuille où de nombreux autres utilisateurs sont connectés et qui ont de bonnes connexions.
Voir plus d'exemples dans ce guide "Gestion de la liquidité des nœuds Lightning".
Étendez ensuite vos connexions avec d'autres nœuds d'entreprises Bitcoin (services, échanges, LSP, Rings of Fire, etc.). La page Amboss est très utile pour en trouver.
Je pourrais vous montrer ma liste personnelle de bons pairs que j'ai accumulée au fil du temps, mais ils pourraient ne pas être adaptés à 100 % à vos propres besoins et aussi, avec le temps, ces pairs modifient leurs politiques ou même ferment leurs nœuds. Veuillez donc le prendre uniquement comme exemple. Certains des nœuds ne sont peut-être même plus en ligne.
Chaque opérateur de nœud doit conserver sa propre liste de pairs, la mettre à jour si possible et l'ajuster à ses propres besoins.
Vous ouvrez un premier canal, disons de 10 M de satellites avec l'un de ces pairs. Ensuite, vous utilisez un service de swap pour déplacer la moitié des satellites (5 M plus ou moins) hors du canal. De cette façon, vous pouvez réutiliser ces satellites pour ouvrir le canal suivant et également obtenir de la liquidité entrante. Voir le guide dédié aux swaps sous-marins que j'ai écrit ici.
Répétez le processus pour les 3-4 nouveaux canaux suivants et vous aurez une belle liquidité pour commencer. Au fil du temps, vous pouvez augmenter votre nombre de pairs en utilisant LightningNetworkPlus ou Satoshi Radio Rings of Fire ou en ajoutant manuellement d'autres nœuds sélectionnés à l'aide d'outils spécifiques pour analyser vos pairs avant de vous y connecter : LN Router, LN Node Insight, NodeMatch, LN channel TG Bot et autres plus.
d. Longévité
Essayez de garder vos canaux LN ouverts autant que possible. Surtout ceux qui affichent le plus de trafic. Vous devrez observer le comportement de votre nœud presque tous les jours si vous souhaitez fournir de bons itinéraires à vos clients. Observez où et d'où votre nœud reçoit des fonds, où vont la plupart des satellites, essayez de trouver les meilleurs itinéraires pour ces destinations.
Si d'autres « jeunes nœuds » se connectent à vous mais qu'ils ne génèrent pas beaucoup de trafic et sont également pour la plupart hors ligne, vous devez fermer ces canaux inutiles. Ils ne génèrent que des requêtes inutiles et chargent votre nœud avec des délais d'attente inutiles. Un bon outil pour observer cela est LNTop. J'ai expliqué dans cet autre guide quelques avertissements.
En général, un canal LN ne doit être fermé que dans quelques cas, sinon gardez-le en ligne :
- le pair est principalement hors ligne
- le pair a un très mauvais ping (temps de réponse d'accès), la plupart des nœuds Tor ont cela
- c'est un très petit canal ; tout ce qui est inférieur à 3 M est considéré comme petit
- le pair ne fournit aucun trafic pendant une certaine période (2 à 3 mois)
- le pair a vu son nœud planter et tous les canaux doivent être fermés (ils vous en ont informé)
OK, maintenant vous avez un bon nœud avec une bonne liquidité, vous êtes plus que prêt à offrir des services de paiement à d'autres. Plongeons-nous un peu dans la gestion de votre serveur LNbits.
B. Gestion de la banque LNbits
Procédure d'installation
Première étape : Où l'installer ? Votre propre machine ou une solution hébergée ?
Comme je l'ai expliqué dans ce guide dédié, vous pouvez l'installer sur votre nœud de bundle, mais vous pouvez aussi bien l'installer de manière autonome sur n'importe quelle autre machine PC ordinaire.
Mon point de vue personnel sur cet aspect est d'exécuter une machine de nœud LN dédiée (qu'il s'agisse d'un bundle domestique, d'un VPS, d'un nœud Voltage dans le cloud) et l'instance LNbits sur une machine distincte. Cela rend les deux plus faciles à gérer, plus accessibles et je peux changer la source de financement à tout moment.
Oui, c'est bien d'avoir tout en un, mais qu'en est-il de votre entreprise qui dépend trop de cette instance LNbits et qui fait planter votre nœud LN ? L'avoir sur la même machine que votre nœud LN pourrait entraîner des pertes. Mais si vous avez les deux sur des machines distinctes, vous pouvez facilement changer la source de financement avec un autre nœud LN et être prêt à continuer à recevoir ou à effectuer des paiements immédiatement.
Le manuel d'installation est très simple et en 5 à 10 minutes, vous avez un LNbits opérationnel. Je suggérerais d'utiliser le proxy Caddy, il est très facile et rapide à installer et à configurer. Avec Caddy, vous connectez votre instance LNbits à un domaine qui pourrait par exemple héberger votre boutique en ligne. Veuillez noter que cela est essentiel si vous souhaitez proposer des services bancaires à d’autres.
La configuration des sources de financement consiste essentiellement à modifier quelques lignes dans le fichier de configuration .env et c’est fait. Démarrez le service lnbits et… bonjour.
Sauvegardez régulièrement votre base de données LNbits
Si vous respectez les clients de votre « banque », vous devez effectuer des sauvegardes régulières de votre base de données LNbits. Ce n’est pas difficile à faire. Juste une copie du dossier lnbits/data.
Bientôt, lorsque la nouvelle extension d'administration sera prête et publiée, il y aura plus d'options automatiques et d'interface Web pour effectuer cette sauvegarde/restauration.
Cette base de données contient UNIQUEMENT : les identifiants et accès des portefeuilles des utilisateurs, l'historique des transactions, le solde, les paramètres personnels, etc.
Gardez à l'esprit que cette base de données (un fichier sqfile) est comme un fichier Excel. CE N'EST PAS un portefeuille, un canal ou un xpub. Donc, si vous souhaitez déplacer la banque LNbits vers une autre source de financement (un autre nœud en cas de catastrophe), vous pouvez facilement pointer votre instance LNbits vers un autre nœud LN et c'est fait, les soldes des clients sont là, mais vous venez de passer à un autre « coffre-fort », un autre fournisseur de transport de liquidités.
Si vous souhaitez déplacer votre instance LNbits vers un autre serveur, vous pouvez également simplement copier-coller cette base de données et redémarrer LNbits.
LNbits peut s'exécuter sur diverses sources de financement comme décrit dans le guide d'installation ici. Donc, même si vous l'aviez déjà exécuté avec un nœud LND et que vous vouliez passer à un nœud CLN, par exemple, une simple modification du fichier .env suffit et redémarrez le service LNbits.
Ouvrez votre banque LNbits pour accéder au clearnet
Avoir un LNbits uniquement derrière Tor n'est PAS fiable. Oui, aujourd'hui, tout le monde peut démarrer un nœud de bundle comme Umbrel, Citadel, myNode, Raspiblitz, Embassy, etc. qui par défaut fonctionne derrière Tor. Oui, vous pouvez en utiliser un pour votre LNbits, qui est déjà intégré, facile à démarrer en un clic.
Mais la partie amusante arrive lorsque les clients de votre banque ne savent pas ce qu'est Tor et à quoi il sert principalement. De plus, tous les services et fonctionnalités ne fonctionnent pas bien derrière Tor. Sans parler de la compatibilité du navigateur et de la connexion.
Donc ici, dans ce guide dédié, j'ai décrit plusieurs scénarios sur la façon dont vous pourriez créer un serveur d'applications LNbits et être accessible sur clearnet (https, IP/domaine). Veuillez prêter attention à tous les détails et scénarios.
Lire plus de documentation sur LNbits
Voici une liste avec plus de liens sur LNbits, des scénarios de cas d'utilisation, des exemples, de la documentation, pour que vous puissiez lire et vous inspirer pour vos propres cas d'utilisation et scénarios :
- Page Web LNbits | Page Github | Groupe Telegram | Instance LNbits SaaS
- Page de documentation LNbits | Tutoriels vidéo YouTube
- Powered by LNbits - collection de projets utilisant LNbits
- Guides d'Axel : Installation du serveur LNbits | Blitz Bank (nœud LNbits + PhoenixD)
- Guides DC : The LNbits Bank | LNbits pour les petits commerçants | LNbits Streamer Copilot
- Exécutez LNbits sur différents types de machines/serveurs
- Des commerçants réels acceptant le BTC sur LN
- Ressources Lightning Network - POUR EN SAVOIR PLUS ET APPRENDRE
- « Opérateur de nœud Lightning » est le titre de poste le plus important de cette décennie
- Maintenance des nœuds Lightning
- Expérience sur les frais de routage Lightning
- Guide de comparaison des portefeuilles Lightning
- Recommandations pour les nouveaux utilisateurs de LN
- Fonctionner avec LN en tant que marchand - guide avancé
- Utiliser votre nœud Tor sur Tailscale
REMARQUE : si vous pensez que ce guide n'est pas suffisamment expliqué, veuillez m'envoyer vos questions/suggestions sur la façon de l'améliorer ou même d'en rédiger un autre pour un cas spécifique.
Si vous lisez ce guide, mais que votre niveau de connaissances n'est pas si technique (est compréhensible), veuillez partager cet article avec votre ami « Oncle Jim » qui est plus féru de technologie et qui peut vous aider à configurer vos propres LNbits ou qui peut même l'exécuter pour vous.