Transaction Labeling připojuje k záznamům peněženky uživatelská metadata: například účel platby nebo původ mince. Text štítku není součástí bitcoinové transakce a sám nedokazuje totožnost protistrany ani vlastnictví.
Přejmenování platby mění databázi aplikace, nikoli txid či historii blockchainu. Obnova klíčů ze seedu proto sama nevrací uživatelské poznámky. Formát štítků slouží přenosu kontextu mezi peněženkami, ne přenosu oprávnění utrácet. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
BIP 329 rozlišuje tx, addr, pubkey, input, output, xpub a spscan. U input znamená ref identifikátor transakce a index jejího vstupu; u output identifikátor vytvářející transakce a index výstupu. Stejné txid:1 proto bez typu neurčuje, zda jde o vstup, či výstup. [BIP 329 — Wallet Labels Export Format]
JSON Lines používá UTF-8 a jeden JSON objekt na řádek. Povinné jsou type a ref; label, origin a spendable jsou volitelné. Vynechané label či spendable nemají při importu měnit stávající hodnotu. Neznámé typy má kompatibilní importér ignorovat, což není záruka přenosu všech dat. [BIP 329 — Wallet Labels Export Format]
spendable platí jen pro output a používá booleovské false, nikoli řetězec "false". Peněženka tak může výstup vyřadit z výběru mincí. Není to Timelock ani zákaz v bitcoinovém skriptu; jiná peněženka se správnými klíči může utratit výstup, pokud jeho skutečné podmínky dovolují. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
origin obsahuje zkrácený descriptor s informací o původu klíčů, bez skutečných klíčů, dětských cest a kontrolního součtu. Pomáhá rozlišit štítky stejné transakce z různých účtů či peněženek. Není podpisem exportu ani důkazem pravdivosti poznámky. [BIP 329 — Wallet Labels Export Format]
Rozlišujte vlastní poznámku, automatickou vazbu na fakturu a převzaté analytické tvrzení. BTCPay používá například invoice a payout a umožňuje vlastní štítky. Původ mince pomáhá při Coin Control, ale samotný název nezabrání nevhodnému sloučení; rozhoduje skutečný výběr vstupů. [BIP 329 — Wallet Labels Export Format] [BTCPay Server — Wallet]
Export může spojovat adresy, xpub a platební historii se jmény. Absence typu pro soukromý utrácecí klíč neznamená neškodný soubor. Chraňte přenos i uloženou zálohu a ověřte, že se obnovuje správný účet; seed není záloha této kontextové vrstvy. [BIP 329 — Wallet Labels Export Format]
Na neprodukční kopii porovnejte typ, ref, text a stav spendable po exportu a importu. Zahrňte diakritiku, více účtů, neznámý typ a vynechané volitelné hodnoty. Importér smí některé záznamy nepodporovat či zkrátit text; 255 znaků je doporučený výchozí limit, ne univerzální garance. Úspěšné načtení souboru proto samo neprokazuje věrnou obnovu kontextu. [BIP 329 — Wallet Labels Export Format]
Pro nejúplnější obraz čtěte toto heslo společně s Coin Control, UTXO, Soukromí v Bitcoinu, Address Clustering, Seed Phrase, Output Descriptor. Opačným směrem na něj odkazují také Chain Surveillance.