Scénario SHTF pour noeud Umbrel
Comment restaurer les fonds de votre nœud Umbrel (LND) en cas de SHTF ?
Voici donc le chapitre distinct sur la gestion de votre nœud Umbrel, sur les méthodes/manières de restaurer/récupérer votre portefeuille Umbrel (LND) en cas de SHTF1.
Il y a beaucoup d'utilisateurs qui font des choses délirantes avec leurs nœuds Umbrel. Parfois, il n'y a pas d'autre moyen de le réparer que de le restaurer dans une autre application et de recommencer avec un nouveau portefeuille ou avec le même portefeuille LND, mais dans une nouvelle instance.
RAPPELS:
Gardez votre calme et soyez patient.
Ce processus peut prendre du temps et des étapes précises doivent être suivies.
Ne faites rien de stupide qui pourrait faire échouer le processus.
Ne videz pas ou ne déplacez pas les fonds / UTXOs de votre portefeuille on-chain pendant le processus de récupération. De nombreux UTXOs peuvent être liés à la fermeture des canaux, c’est ce qu’on appelle des UTXOs de “réserve d'ancrage”.
Attendez patiemment la fermeture des canaux, cela peut prendre de 40 à 144 blocs2 jusqu'à ce que les fonds soient libérés, même si les txs sont confirmés dans l'explorateur de blocs.
La procédure de restauration des fonds est le DERNIER recours, donc avant de la lancer, veuillez consulter d'autres personnes et essayer d'avoir un diagnostic exact de ce qui est arrivé à votre nœud. Peut-être qu'un simple redémarrage est juste suffisant.
Il existe 8 méthodes pour “restaurer” votre nœud Umbrel.
Si vous avez des fonds UNIQUEMENT dans le portefeuille on-chain et n'avez pas de fonds dans les canaux LN, utilisez simplement les méthodes 2, 3, 4 ou 5.
Si vous avez des fonds dans le portefeuille on-chain et dans les canaux LN, utilisez les méthodes 1, 3, 6, 7 ou 8.
Méthode standard et normale en utilisant une nouvelle instance du nœud Umbrel
Utilisation d'une copie des fichiers de la base de données dans une autre instance d’un nœud LND
Copie expérimentale complète des données d'un nœud RPi vers une machine Linux de bureau/NUC
Utilisation d'une sauvegarde ThunderHub / Amboss SCB pour restaurer dans Blixt wallet
Utilisation de l’outils Guggero pour les canaux bloqués. Consultez également cette note.
Veuillez consulter ces liens pour plus d'outils, de documentation, de guides sur la restauration de fonds à partir d'un nœud LND mort :
1 - Méthode Standard
Cette méthode est la méthode normale, telle qu’elle est décrite et recommandée par l'équipe d'Umbrel.
Ici nous supposons que vous avez déjà votre phrase mnémonique (liste de 24 mots) et votre fichier channel.backup. Si vous n'avez pas fait la sauvegarde de ce fichier, mais que vous avez encore accès à l’ancien disque du nœud, vous pouvez le trouver dans /home/umbrel/umbrel/lnd/data/chain/bitcoin/mainnet/channel.backup
ou vous pouvez demander une copie aux développeurs d'Umbrel (contactez-les dans le groupe Telegram d'Umbrel ou sur le forum communautaire d'Umbrel).
Installez une nouvelle instance d'Umbrel. Lancer la page du tableau de bord et il vous sera demandé d'utiliser la phrase mnémonique de 24 mots précédemment utilisée.
Une fois que vous avez restauré à partir de ces 24 mots, cela peut prendre quelques minutes jusqu’à quelques heures pour analyser toutes vos transactions et votre solde Bitcoin (sur la timechain). Pendant ce temps, voici comment vous pouvez restaurer les fonds de vos canaux Lightning.
ÉTAPE 1 : COPIEZ LE FICHIER DE SAUVEGARDE DES CANAUX DE VOTRE ORDINATEUR VERS VOTRE UMBREL.
Entrez en utilisant SSH et exécutez ceci :
scp <path/to/your/channel/backup/file> umbrel@umbrel.local:/home/umbrel/umbrel/lnd/channel.backup
Remplacez <path/to/your/channel/backup/file> par le chemin exact sur votre ordinateur du fichier de sauvegarde des canaux.
Le mot de passe est `moneyprintergobrrr`, sauf sur la version 0.3.3 ou plus récente où le mot de passe est votre mot de passe utilisateur personnel à la place.
ÉTAPE 2 : RÉCUPÉRER LES FONDS
cd ~/umbrel && ./bin/lncli restorechanbackup --multi_file /data/.lnd/channel.backup
Après avoir exécuté cette opération, attendez une minute. Vous devriez maintenant être en mesure de voir vos canaux fermés sur http://umbrel.local/lightning.
Vous devez attendre patiemment que les fonds reviennent dans votre portefeuille on-chain. Cela prendra au moins 40 blocs (~6h). Vous pouvez voir/vérifier les détails de la fermeture des canaux avec ce guide de dépannage.
2 - Méthode avec BlueWallet
Eh oui, maintenant vous pouvez vous connecter directement un portefeuille on-chain de nœuds (on-chain) à une application mobile. Il suffit d'utiliser la phrase mnémonique (liste de 24 mots) de votre feu nœud Umbrel dans Bluewallet (en l'ajoutant comme nouveau portefeuille). Et voilà, c'est fait !
Cas d’usages :
vous voulez avoir à portée de main un moyen de déposer rapidement sur le portefeuille on-chain votre nœud Umbrel
vous avez besoin d'avoir accès à vos fonds on-chain en cas de crash de votre nœud et vous voulez récupérer / accéder aux fonds.
RAPPEL :
il s'agit de restaurer UNIQUEMENT le portefeuille on-chain, pas les canaux LN !
pour restaurer les fonds de vos canaux LN, vous devez toujours suivre la procédure de récupération en utilisant la méthode standard, voir le 1er point.
Je recommande de ne pas restaurer la même graine dans une nouvelle instance Umbrel LND, mais de plutôt lancer une nouvelle instance LND et de garder cet ancien portefeuille dans Bluewallet, et de simplement déplacer ces fonds vers la nouvelle instance Umbrel.
3 - Méthode avec Blixt Wallet
Il s'agit d'une excellente application mobile. C’est un noeud LND qui utilise la synchronisation des blocs avec Neutrino, avec de nombreuses fonctionnalités qu'aucun autre portefeuille mobile n'a réussi à réunir (pour le moment). Il vaut vraiment la peine de l'avoir sur votre smartphone, afin d’avoir un noeud privé en association avec vos autres noeuds LN.
Blixt est en capacité de restaurer un nœud LND, dès les premières étapes de l'ouverture de l'application.
Vous ne perdrez pas vos fonds dans ce test/scénario. La pire chose qui puisse arriver est de ne pas pouvoir garder vos canaux ouvert, mais tous les fonds alloués se retrouveront dans le portefeuille on-chain ou le système rejettera simplement la "restauration" et vos canaux seront toujours actifs dans le nœud Umbrel.
Pré-requis
- Votre nœud Umbrel est mort et ne doit pas être en ligne dans ce processus.
- vous avez une sauvegarde des derniers états de vos canaux. Utilisez le fichier de sauvegarde que vous obtenez à partir du tableau de bord Umbrel - page Lightning (et non sur RTL ou Thunderhub). Vous pouvez également utiliser la sauvegarde en ligne des serveurs d'Umbrel (vous devrez contacter les développeurs d'Umbrel pour cela). Si vous n'avez pas fait cette sauvegarde, mais que vous avez toujours accès à votre ancien disque de nœud, vous pouvez la trouver dans /home/umbrel/umbrel/lnd/data/chain/bitcoin/mainnet/channel.backup.
- vous avez une sauvegarde de votre phrase mnémonique (liste de 24 mots)
Étapes à suivre
1 - Installez le portefeuille Blixt sur votre smartphone
2 - Allez dans le menu paramètres et activez Tor (l'application va redémarrer). Ceci est nécessaire du fait qu'Umbrel est par défaut sous Tor et que beaucoup de vos précédents canaux étaient ouverts avec des pairs dont leur noeud est sous Tor.
3 - Sélectionnez “restore wallet”
4 - prenez votre liste de 24 mots et insérez-la dans le 1er champ
5 - prenez votre fichier channels.backup (que vous avez précédemment sauvegardé à partir du tableau de bord Umbrel LN) et téléchargez-le sur votre téléphone et insérez-le la “boîte de restauration” dans Blixt.
6 - cliquez sur restaurer et attendez un certain temps pour permettre à l'application de synchroniser le nœud neutrino (une petite version de la blockchain). Une fois restauré, les fonds devraient apparaître dans la balance et aussi dans les canaux. Mais rappelez-vous, les canaux seront fermés et les fonds retournés dans on-chain. Soyez patient.
Je recommanderais de ne pas restaurer la même graine dans une nouvelle instance Umbrel LND, mais de commencer avec une nouvelle instance LND et de garder cet ancien portefeuille dans Blixt, ou simplement de déplacer les fonds vers la nouvelle instance Umbrel. Blixt pourrait être un très bon nœud compagnon pour votre nouveau nœud Umbrel.
Il existe quelques moyens de vérifier l'état de l'application Blixt, mais je ne vais pas entrer dans les détails ici.
Faites-moi savoir quand/si vous voulez faire ce test et je peux vous aider, mais seulement si votre nœud Umbrel est mort. Vous pouvez également entrer en contact avec Hampus, le développeur de Blixt, en utilisant le groupe Telegram Blixt.
Ne cassez pas des choses juste pour en tester d’autres. Rappelez-vous que c'est un procédure expérimentale et que vous n'avez pas d'autre alternative.
4 - Méthode avec Zap desktop
Cela fonctionne seulement avec la version bureau de Zap, pas mobile.
Installez simplement l'application Zap et utilisez votre liste de 24 mots pour restaurer le portefeuille AEZEED on-chain.
Cela NE restaurera PAS les canaux LN ! Pour restaurer les canaux LN, vous aurez toujours besoin d'utiliser la procédure standard expliquée au point 1 dans ce guide.
5 - Méthode avec Sparrow
Cette méthode ne restaurera pas vos canaux LN, seulement le portefeuille on-chain ! Pour restaurer les fonds des canaux LN, vous devez suivre la "procédure standard" expliquée au point 1 de ce guide.
Allez sur Cryptography Toolkit et téléchargez le fichier HTML sur votre ordinateur.
Ouvrez ce fichier HTML en “mode hors ligne” (sans Internet) et sélectionnez “aezeed Cipher Seed Scheme” dans “Tools”. Allez ensuite dans le 2ème onglet “Decode Mnemonic”.
Collez vos 24 mots dans le champ “Mnemonic”.
Sélectionnez le format BIP84 segwit natif et patientez quelques instants le temps que le décodage se fasse.
Copiez le zprv affiché dans le champ “HD node root base 58”.
Ouvrez l'application Sparrow wallet (déjà téléchargée) et sélectionnez “new wallet”.
Dans “Keystores”, sélectionnez “new imported software wallet”.
Dans la fenêtre suivante qui s'ouvre, sélectionnez “Master Private Key BIP32” et collez la clé zprv que vous avez obtenue de l'outil de cryptographie et cliquez sur “importer”. Il vous montrera que un chemin de dérivation
m/84/0/0(comme il se doit, pour restaurer toutes vos adresses et txs utilisés précédemment avec votre feu noeud Umbrel).
Cliquez sur “Import Keystore” et vous retournerez à la fenêtre principale de l'application du portefeuille où vous pourrez voir toute la configuration du portefeuille. Cliquez sur “appliquer” et vous serez invité à définir un mot de passe pour chiffrer votre fichier de portefeuille local.
L'application Sparrow commencera à scanner toutes vos clés et txs (affiché après un moment dans l'onglet “Transactions”). Patience, cela prendra un certain temps.
Pour une connexion plus rapide, sécurisée et privée, il est préférable de connecter votre application Sparrow wallet à votre nœud. Suivez simplement les instructions dans “Umbrel - connect wallet - sparrow” et vous utiliserez directement les blocs et les index de votre propre nœud (ou selui d’une personne de confiance).
6 - Méthode expérimentale - Copie des fichiers .db
Cette méthode n'a été confirmée que par un utilisateur d'Umbrel qui l'a effectué avec succès. Par contre, il n'utilisait pas la version Raspberry Pi d'Umbrel, mais une machine avec un Linux normal et Umbrel installé dessus.
Cette procédure est UNIQUEMENT destinée aux utilisateurs expérimentés de Linux ! Si vous ne savez pas utiliser Linux, vous feriez mieux de rester à l'écart.
La procédure est simple. Il vous faudra seulement ces 2 fichiers situés dans :
<lnd folder>/data/chain/bitcoin/mainnet/wallet.db
<lnd folder>/data/graph/mainnet/channel.db
Vous devez construire vous-même les dossiers
data/...puis y copier les fichiers, avant de démarrer lnd.Donc, prenez une autre machine/un autre disque dur et installez Umbrel tout frais. Utilisez votre phrase mnémonique (liste de 24 mots) pour restaurer le portefeuille AEZEED on-chain. Laissez-le pour démarrer la synchronisation et construire le reste des dossiers pour LND. Puis arrêtez-le.
Allez sur l'ancien disque et localisez ces 2 fichiers.
Copiez-les dans le même chemin dans le nouveau noeud.
En option, si vous avez les données de la blockchain (bonne intégrité des fichiers), vous pouvez copier également la blockchain afin de gagner du temps. Si vous pensez qu'elle est corrompue, il vaut mieux l'oublier et laisser la synchronisation se faire de manière normale/naturelle.
Démarrez le nœud, laissez-le se synchroniser et... voilà, vos anciens canaux LN sont là, vivants et non fermés.
S'il y a un problème pour redémarrer le nœud, exécutez simplement :
sudo scripts/configure
RAPPEL : ces fichiers doivent être la dernière version en ligne ! Si vous utilisez une ancienne sauvegarde, vous pouvez perdre des fonds en étant puni pour avoir triché avec une ancienne version de vos canaux.
7 - Méthode expérimentale II - Migration noeud RPi vers un linux
Cette méthode n'a pas encore été complètement testée. Il serait possible de migrer un ancien noeud RPi avec Umbrel vers un nouveau NUC / ordinateur de bureau / ordinateur portable qui tourne sous Linux + dépendances docker (de préférence Debian pour utiliser les mêmes libraries que UmbrelOS).
La procédure est simple :
installer la nouvelle machine avec OS Debian + toutes les dépendances requises (voir le guide d'installation GitHub Umbrel pour Linux desktop)
ajouter l'ancien SSD USB avec l'installation UmbrelOS sur le nouveau noeud et démarrer la copie de l'ensemble du dossier Umbrel, avec le même chemin de dérivation mais sur le disque du nouveau noeud.
une fois la copie terminée, retirer l’ancien SSD
démarrer Umbrel à partir de ce dossier avec la commande :
sudo ./scripts/startSi il y a un problème lors du redémarrage de la noeud, il suffit de lancer :
sudo scripts/configure
Tout devrait bien se passer. Le noeud reprendra sa synchronisation et toutes vos données précédentes devraient être là. Soyez patient pour que le noeud rattrape les derniers blocs et index.
8 - Méthode Blixt / ThunderHub / Amboss SCB
Récemment, Amboss a ajouté une fonctionnalité intéressante pour les opérateurs de nœuds. Avec l’enregistrement de votre nœud public, vous pouvez télécharger le fichier SCB appelé channels.backup sur votre compte. Ce fichier peut être récupéré plus tard dans le cas où votre nœud est mort.
Cette option est liée à l'application ThunderHub. Il suffit de se rendre dans l’app puis Tools > Backup. Une fois que vous avez configuré ThunderHub pour faire automatiquement vos sauvegardes, celles-ci peuvent être liées à votre compte Amboss et ainsi avoir une copie sur leurs serveurs.
Il n'y a aucun risque de fuite / vol de fonds avec ce fichier. Sans votre phrase mnémonique du portefeuille de votre noeud, le fichier est tout simplement inutile.
Ce fichier de sauvegarde grâce à ThunderHub peut également être enregistré localement, dans un endroit sûr, en dehors du nœud. Amboss et ThunderHub offrent cette option seulement comme un moyen supplémentaire de sauvegarde.
Procédure de restauration
Donc, votre nœud est complètement mort mais vous avez votre phrase mnémonique (liste de 24 mots) et les sauvegardes dans Amboss ont été faites automatiquement. Vous souhaitez un moyen rapide de récupérer ces fonds, pendant que vous construisez un nouveau nœud.
Ouvrez l'application Blixt sur votre téléphone
Choisissez “recover mode”.
Insérez votre liste de 24 mots (de votre nœud mort).
Blixt va prendre quelques minutes pour se synchroniser avec Neutrino et récupérer votre nodeID.
Dans cette phase, vous n'avez pas à choisir de récupérer avec les canaux de sauvegarde, cela peut être fait plus tard. Vous devez seulement être capable de vous connecter à Amboss et de récupérer votre fichier SCB.
Une fois synchronisé (voir l'icône en haut), allez sur amboss.space et connectez-vous, en signant la clé avec votre application Blixt. Oui, Blixt supporte LN-auth, comme beaucoup d'autres fonctionnalités.
Vous êtes à présent connecté à votre compte Amboss. Il vous faut télécharger le fichier SCB sur votre mobile.
À ce moment-là, vous devrez effacer les données de votre Blixt. Le moyen le plus simple est de le désinstaller et de le réinstaller. Autre moyen, dans Android, détails de l'application Blixt, supprimer les données et le cache.
Collez les données HEX de la sauvegarde Amboss dans un fichier texte et nommez-le “channels.backup” ou ce que vous voulez.
Une fois que Blixt est réinstallé, commencez la procédure de restauration en insérant le fichier de sauvegarde des canaux (channels.backup) et votre liste de 24 mots. A ce moment là, la procédure de récupération des fonds est déclenchée. Cela prendra un certain temps jusqu'à ce que les blocs soient synchronisés par Neutrino et que les canaux soient fermés. Il faut généralement moins de 5 minutes pour synchroniser et 44 à 144 blocs pour débloquer les fonds de la fermeture des canaux.
PATIENCE et gardez l'application Blixt active pendant la première phase de la procédure de récupération, jusqu'à ce que les canaux commencent à être fermés. Vous pouvez vérifier dans Settings > LND logs et dans le tiroir en haut à gauche - Lightning Channels. Si les canaux y apparaissent en état de "fermeture", alors tout va bien et vous pouvez fermer l'application Blixt.
REMARQUES :
Si vous ne voulez pas restaurer les fonds dans Blixt, vous pouvez utiliser le même fichier
channels.backupdans Thunderhub, une fois que votre nouveau nœud est prêt et synchronisé. La procédure est la même, avec la fermeture des anciens canaux et les fonds récupérés dans votre portefeuille onchain.Vous pouvez aussi utiliser la commande cli :
lncli restorechanbackup --multi_backup <filename_location>
QUE ₿ITCOIN SOIT AVEC TOI !
Si tu apprécies le travail de DarthCoin, tu peux lui envoyer quelques sats via le LN :
en utilisant la page Telegram @LNtxBot DarthCoin LNURL
ou simplement en utilisant l'adresse Lightning à darthcoin@lntxbot.com
Si tu apprécies le travail (de traduction) d’asi0, tu lui peux envoyer quelques sats via le LN :
en utilisant la page Telegram @LNtxBot asi0_flammeus LNURL
ou simplement en utilisant l'adresse Lightning à asi0_flammeus@lntxbot.com
NdT : acronyme pour “Shit Hits The Fan” qui est une expression pour le moins visuelle pour parler d’une situation très critique qui arrive (trop) soudainement.
NdT : soit entre 6h et 24h, en considérant des blocs tous les 10 minutes