Comment vérifier l'état d'un paiement Lightning dans BlueWallet

Comprendre le cycle de vie des paiements Lightning

1. Un paiement Lightning est initié lorsque l'expéditeur crée une facture contenant un hachage de paiement, un montant et une heure d'expiration.

2. Le nœud de l'expéditeur achemine le paiement via un ou plusieurs canaux intermédiaires jusqu'à ce qu'il atteigne le nœud du destinataire.

3. Une fois la réception réussie, le nœud du destinataire révèle la pré-image, qui se propage le long du même itinéraire pour confirmer le règlement.

4. Si un canal le long du chemin manque de liquidités suffisantes ou échoue à la vérification, le paiement échoue instantanément sans bloquer les fonds.

5. Contrairement aux transactions en chaîne Bitcoin, les paiements Lightning n'apparaissent pas dans les explorateurs de blocs : le statut doit être déduit des événements internes du portefeuille.

Indicateurs d'état intégrés de BlueWallet

1. Après avoir lancé un paiement, BlueWallet affiche un badge d'état en temps réel : « En attente » , « Confirmé » ou « Échec » .

2. En appuyant sur la ligne de transaction, vous ouvrez une vue détaillée montrant les tentatives de routage, la latence saut par saut et le code d'erreur final, le cas échéant.

3. Pour les paiements sortants, l'onglet « Envoyé » affiche les horodatages pour la génération de facture, la première tentative d'acheminement et la confirmation de pré-image.

4. Les paiements entrants apparaissent sous « Reçu » uniquement une fois la pré-image vérifiée et le solde mis à jour : aucune entrée non confirmée n'est affichée.

5. BlueWallet n'affiche pas « 0-conf » ou les états intermédiaires ; il attend une confirmation cryptographique complète avant de mettre à jour l'état de l'interface utilisateur.

Vérification manuelle via l'état du canal

1. Accédez à Paramètres → Lightning → « Afficher les canaux » pour inspecter les soldes des canaux locaux et les identifiants de transaction d'engagement.

2. Croisez le hachage de paiement avec la dernière transaction d'engagement du canal à l'aide d'un explorateur de blocs compatible comme 1ML ou Amboss.

3. Si le hachage apparaît dans le script de sortie d'engagement, le paiement est lié cryptographiquement à cet état de canal.

4. Utilisez la fonction « Exporter les journaux » pour récupérer les enregistrements HTLC bruts, notamment cltv_expiry, amt_to_forward et custom_records.

5. Comparez le champ payment_hash dans les journaux avec le hachage de la facture d'origine pour exclure toute collision de hachage ou tout mauvais acheminement.

Déclencheurs de défaillance courants observés dans la pratique

1. Incompatibilité d'expiration : une expiration de facture trop basse entraîne le rejet des nœuds avant d'atteindre la destination.

2. Solde de canal insuffisant : le nœud intermédiaire n'a pas suffisamment de capacité sortante pour relayer le montant demandé.

3. Désalignement du delta CLTV : la non-concordance entre la cltv_expiry de l'expéditeur et la politique du nœud entraîne un rejet immédiat au premier saut.

4. Partitionnement du réseau : la perte temporaire de connectivité entre les nœuds empêche la propagation des pré-images même après une livraison réussie.

5. Réutilisation des factures : tenter de payer deux fois la même facture déclenche un rejet automatique par les implémentations Lightning conformes.

Foire aux questions

Q : Puis-je voir les HTLC en attente dans BlueWallet avant qu'ils ne soient résolus ? R : Non. BlueWallet masque intentionnellement les HTLC non confirmés pour éviter toute confusion chez les utilisateurs. Seuls les paiements entièrement réglés ou définitivement échoués apparaissent dans l'interface utilisateur.

Q : BlueWallet stocke-t-il les préimages localement une fois le paiement réussi ? R : Oui. Les préimages sont cryptées et stockées dans l'enclave sécurisée de l'appareil. Ils ne sont jamais transmis aux serveurs ni exposés dans les logs d’export.

Q : Pourquoi un paiement affiche-t-il « Confirmé » mais n'est-il pas reflété dans mon solde en chaîne ? R : Les soldes Lightning sont hors chaîne. La confirmation signifie que le HTLC a été réglé dans le graphique du canal, et non que BTC a bougé sur la chaîne.

Q : Puis-je forcer manuellement la fermeture d'un canal pour récupérer les fonds d'un paiement bloqué ? R : La fermeture forcée ouvre une fenêtre de litige de 144 blocs. Il n’accélère pas la résolution HTLC et peut entraîner une perte de frais en cas de mauvaise utilisation.