Transaction Labeling ajoute des métadonnées utilisateur aux fiches du portefeuille, comme le but du paiement ou l’origine des pièces. Ce texte ne fait pas partie de la transaction Bitcoin et ne prouve seul ni identité ni propriété.
Renommer un paiement change la base de l’application, pas son txid ni l’historique. Restaurer les clés depuis une seed ne restaure donc pas spontanément les notes. Le format transfère du contexte, pas le droit de dépenser. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
BIP 329 distingue tx, addr, pubkey, input, output, xpub et spscan. Pour input, ref désigne la transaction et son indice d’entrée ; pour output, la transaction créatrice et l’indice de sortie. Sans type, txid:1 ne distingue pas entrée et sortie. [BIP 329 — Wallet Labels Export Format]
JSON Lines emploie UTF-8 et un objet JSON par ligne. type et ref sont obligatoires ; label, origin et spendable sont facultatifs. Omettre label ou spendable doit laisser la valeur existante intacte. Les types inconnus doivent être ignorés, sans garantie de transfert complet. [BIP 329 — Wallet Labels Export Format]
spendable concerne uniquement output et utilise le booléen false, pas la chaîne "false". Le portefeuille peut exclure la pièce de la sélection. Ce n’est ni Timelock ni interdiction du script ; un autre portefeuille disposant des clés peut dépenser si les conditions réelles sont satisfaites. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
origin contient un descriptor abrégé avec l’origine des clés, sans clés réelles, chemins enfants ni somme de contrôle. Il distingue les étiquettes d’une transaction selon les comptes ou portefeuilles. Il ne signe pas l’export et ne prouve pas la véracité d’une note. [BIP 329 — Wallet Labels Export Format]
Distinguez note personnelle, association automatique à une facture et affirmation analytique importée. BTCPay emploie invoice et payout et permet des étiquettes personnalisées. L’origine aide Coin Control, mais un nom ne prévient pas une fusion indésirable ; la sélection effective des entrées compte. [BIP 329 — Wallet Labels Export Format] [BTCPay Server — Wallet]
Un export peut relier adresses, xpub et historique à des noms. L’absence de type pour une clé privée de dépense ne rend pas le fichier inoffensif. Protégez transport et stockage et vérifiez le compte restauré ; la seed ne sauvegarde pas cette couche contextuelle. [BIP 329 — Wallet Labels Export Format]
Sur une copie de test, comparez type, ref, texte et spendable après export et import. Incluez accents, plusieurs comptes, type inconnu et valeurs facultatives absentes. Des fiches peuvent être ignorées ou tronquées ; 255 caractères est un défaut suggéré, pas une garantie. Charger le fichier ne prouve pas seul une restauration fidèle. [BIP 329 — Wallet Labels Export Format]
Pour une vision complète, lisez aussi Coin Control, UTXO, Confidentialité de Bitcoin, Address Clustering, Seed Phrase, Output Descriptor. Cette entrée est également citée par Chain Surveillance.