Transaction Labeling додає до записів гаманця метадані користувача, наприклад призначення платежу або походження монет. Текст не входить до транзакції Bitcoin і сам не доводить особу чи власність.
Перейменування платежу змінює базу застосунку, не txid чи історію ланцюга. Відновлення ключів із seed саме не повертає нотаток. Формат переносить контекст між гаманцями, а не право витрачання. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
BIP 329 розрізняє tx, addr, pubkey, input, output, xpub та spscan. Для input поле ref вказує транзакцію та індекс її входу; для output — створюючу транзакцію та індекс виходу. Без типу txid:1 не розрізняє вхід і вихід. [BIP 329 — Wallet Labels Export Format]
JSON Lines використовує UTF-8 та один JSON-об’єкт на рядок. type і ref обов’язкові; label, origin та spendable необов’язкові. Відсутні label чи spendable не мають змінювати наявні значення. Невідомі типи слід ігнорувати; повноту перенесення це не гарантує. [BIP 329 — Wallet Labels Export Format]
spendable стосується лише output і використовує булеве false, не рядок "false". Гаманець може виключити монету з вибору. Це не Timelock чи заборона скрипту; інший гаманець із ключами може витратити її за виконання справжніх умов. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
origin містить скорочений descriptor з походженням ключів, без самих ключів, дочірніх шляхів і контрольної суми. Це розрізняє мітки тієї самої транзакції різних рахунків чи гаманців. Поле не підписує експорт і не доводить правдивість нотатки. [BIP 329 — Wallet Labels Export Format]
Розрізняйте власну нотатку, автоматичний зв’язок із рахунком на оплату й імпортоване аналітичне твердження. BTCPay використовує invoice і payout та дозволяє власні мітки. Походження допомагає Coin Control, але назва сама не запобігає небажаному злиттю; важливий фактичний вибір входів. [BIP 329 — Wallet Labels Export Format] [BTCPay Server — Wallet]
Експорт може пов’язувати адреси, xpub та історію з іменами. Відсутність типу для приватного ключа витрачання не робить файл нешкідливим. Захищайте передачу й зберігання та перевіряйте правильний рахунок; seed не резервує цей контекстний шар. [BIP 329 — Wallet Labels Export Format]
На тестовій копії порівняйте тип, ref, текст і spendable після експорту та імпорту. Додайте діакритику, кілька рахунків, невідомий тип і пропущені необов’язкові значення. Записи можуть не підтримуватися чи скорочуватися; 255 символів — рекомендована межа, не гарантія. Успішне читання файлу не доводить точного відновлення. [BIP 329 — Wallet Labels Export Format]
Для повної картини прочитайте також Coin Control, UTXO, Приватність у Bitcoin, Address Clustering, Seed Phrase, Output Descriptor. На цю статтю також посилаються Chain Surveillance.