Transaction Labeling acrescenta metadados do utilizador a registos da carteira, como finalidade do pagamento ou origem das moedas. O texto não faz parte da transação Bitcoin nem prova sozinho identidade ou propriedade.
Renomear um pagamento altera a base da aplicação, não txid ou histórico. Restaurar chaves da seed não recupera por si só as notas. O formato transfere contexto entre carteiras, não autoridade para gastar. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
BIP 329 distingue tx, addr, pubkey, input, output, xpub e spscan. Em input, ref indica transação e índice da entrada; em output, transação criadora e índice da saída. Sem tipo, txid:1 não distingue entrada de saída. [BIP 329 — Wallet Labels Export Format]
JSON Lines usa UTF-8 e um objeto JSON por linha. type e ref são obrigatórios; label, origin e spendable opcionais. Omitir label ou spendable deve preservar o valor existente. Tipos desconhecidos devem ser ignorados; isso não garante transferência completa. [BIP 329 — Wallet Labels Export Format]
spendable aplica-se apenas a output e usa o booleano false, não a cadeia "false". A carteira pode excluir a moeda da seleção. Não é Timelock ou proibição no script; outra carteira com as chaves pode gastar se as condições reais o permitirem. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
origin contém um descriptor abreviado com origem das chaves, sem chaves reais, caminhos filhos ou checksum. Distingue rótulos da mesma transação em contas ou carteiras diferentes. Não assina o ficheiro nem prova a verdade da nota. [BIP 329 — Wallet Labels Export Format]
Distinga nota própria, associação automática a fatura e afirmação analítica importada. BTCPay utiliza invoice e payout e permite rótulos próprios. A origem ajuda Coin Control, mas o nome não impede uma fusão indesejada; conta a seleção efetiva das entradas. [BIP 329 — Wallet Labels Export Format] [BTCPay Server — Wallet]
Um ficheiro pode ligar endereços, xpub e histórico a nomes. Não ter tipo para chave privada de gasto não o torna inofensivo. Proteja trânsito e armazenamento e confirme a conta restaurada; a seed não copia esta camada contextual. [BIP 329 — Wallet Labels Export Format]
Numa cópia de teste, compare tipo, ref, texto e spendable após exportar e importar. Inclua acentos, várias contas, tipo desconhecido e valores opcionais ausentes. Pode haver registos ignorados ou texto truncado; 255 caracteres é uma sugestão, não garantia. Carregar o ficheiro não prova restauração fiel. [BIP 329 — Wallet Labels Export Format]
Para ter uma visão mais completa, leia este verbete junto com Coin Control, UTXO, Privacidade no Bitcoin, Address Clustering, Seed Phrase, Output Descriptor. Também há referências a este verbete em Chain Surveillance.