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.