Transaction Labeling añade metadatos del usuario a registros de cartera, como finalidad del pago u origen de monedas. El texto no forma parte de la transacción Bitcoin ni prueba por sí solo identidad o propiedad.
Renombrar un pago cambia la base de datos, no su txid ni la historia de la cadena. Recuperar claves desde una semilla no recupera por sí solo las notas. El formato transporta contexto entre carteras, no autoridad para gastar. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
BIP 329 distingue tx, addr, pubkey, input, output, xpub y spscan. En input, ref identifica la transacción y su índice de entrada; en output, la transacción creadora y el índice de salida. Sin tipo, txid:1 no distingue entrada de salida. [BIP 329 — Wallet Labels Export Format]
JSON Lines usa UTF-8 y un objeto JSON por línea. type y ref son obligatorios; label, origin y spendable son opcionales. Omitir label o spendable debe conservar el valor existente al importar. Los tipos desconocidos deben ignorarse; eso no garantiza transferir todos los datos. [BIP 329 — Wallet Labels Export Format]
spendable solo corresponde a output y usa el booleano false, no la cadena "false". La cartera puede excluir la moneda de la selección. No es Timelock ni prohibición del script; otra cartera con las claves puede gastar si se cumplen las condiciones reales. [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]
origin contiene un descriptor abreviado con origen de claves, sin claves reales, rutas hijas ni suma de comprobación. Distingue etiquetas de una transacción en varias cuentas o carteras. No firma el archivo ni prueba la veracidad de la nota. [BIP 329 — Wallet Labels Export Format]
Distinga nota propia, vínculo automático a factura y afirmación analítica importada. BTCPay emplea invoice y payout y admite etiquetas propias. El origen ayuda a Coin Control, pero el nombre no evita una fusión inconveniente: importa la selección efectiva de entradas. [BIP 329 — Wallet Labels Export Format] [BTCPay Server — Wallet]
El archivo puede unir direcciones, xpub e historial con nombres. No tener tipo para clave privada de gasto no lo hace inocuo. Proteja transporte y almacenamiento y compruebe la cuenta restaurada; la semilla no respalda esta capa de contexto. [BIP 329 — Wallet Labels Export Format]
En una copia no productiva compare tipo, ref, texto y spendable tras exportar e importar. Incluya acentos, varias cuentas, tipo desconocido y valores opcionales ausentes. Puede haber registros no compatibles o texto truncado; 255 caracteres es un valor sugerido, no garantía universal. Cargar el archivo correctamente no prueba por sí solo la recuperación fiel del contexto. [BIP 329 — Wallet Labels Export Format]
Para obtener la imagen más completa, lee esta entrada junto con Coin Control, UTXO, Privacidad en Bitcoin, Address Clustering, Seed Phrase, Output Descriptor. También enlazan con esta entrada Chain Surveillance.