Transaction Labeling

Abre el historial y encuentra un pago antiguo. ¿Era un anticipo, un regalo o un traslado a su otra cuenta? La etiqueta «anticipo reparación bicicleta» puede aclararlo mucho después. Renombrarla cambia una nota de la aplicación, no la transacción ni su identificador txid. No es necesario escribir nada nuevo en la blockchain, el historial público de transacciones confirmadas. Lo mismo importa al recuperar: la Seed Phrase, las palabras para restaurar las claves de la cartera, no contiene sus notas personales. Recuperar la capacidad de gastar y recuperar el contexto son tareas distintas. [1] [3] [5]

Una nota útil recoge lo que sabe: número de factura, propósito u origen del dinero. Su anotación no equivale a una asociación automática de la aplicación ni a una afirmación copiada de un analista. BTCPay Server usa, por ejemplo, invoice para pagos por factura y payout para desembolsos o reembolsos, y admite etiquetas propias. El contexto ayuda en Coin Control, la selección manual de UTXO, salidas todavía sin gastar. Cada salida registra un importe y las condiciones para gastarlo. Pero escribir «no combinar» no lo impide: las entradas realmente elegidas determinan qué cobros vincula el próximo pago. [1] [2]

Algunas carteras congelan una salida para excluirla de la selección al gastar. BIP 329 transmite ese estado local mediante spendable, solo para el tipo output. spendable:false usa el valor booleano false; la cadena de texto "false" es otra cosa. La consecuencia práctica es sencilla: congelar evita una selección involuntaria en esa aplicación, no cualquier gasto posible. No es un Timelock, una condición temporal impuesta por Bitcoin. Otra cartera con las claves correctas puede gastar la salida si cumple sus condiciones reales. [1] [3]

Al cambiar de aplicación, piense también en exportar las notas por separado. El archivo puede vincular nombres, facturas e historial con direcciones o un XPUB, una clave pública extendida. Permite calcular más direcciones de la parte correspondiente de la cartera, pero un XPUB por sí solo no permite firmar pagos. Si la exportación incluye un registro de tipo spscan, ese registro contiene una clave privada de escaneo para encontrar Silent Payments entrantes. No autoriza por sí sola a gastar, pero exponerla perjudica la privacidad. Por tanto, carecer de una clave privada de gasto no hace inocuo el archivo. Cifre las copias y su transmisión y pruebe la recuperación en la cuenta correcta. [1] [4] [5]

BIP 329 distingue tx, addr, pubkey, input, output, xpub y spscan: transacción, dirección, clave pública, entrada, salida, clave pública extendida y expresión de escaneo de Silent Payments. El tipo determina cómo interpretar ref. Para input identifica la transacción y el índice de su entrada; para output, la transacción creadora y el índice de salida. Así, txid:1 no basta sin el tipo. Podría señalar una entrada o una salida, objetos diferentes. Tratar cualquier referencia así como una «dirección de pago» no es seguro. [1] [4]

BIP 329 utiliza JSON Lines: un archivo de texto UTF-8 con un registro estructurado por línea. No necesita escribirlo a mano; ambas aplicaciones deben entenderlo. Los campos obligatorios type y ref identifican el objeto. label, origin y spendable son opcionales. Omitir label o spendable no debería sobrescribir valores existentes al importar. Un importador conforme debe ignorar tipos desconocidos. Abrir el archivo correctamente no significa que la nueva cartera haya conservado todas las notas y configuraciones. [1]

Una transacción puede aparecer en varias cuentas o carteras con distintas notas. origin permite distinguir esas perspectivas. Contiene un Output Descriptor abreviado, una descripción de cartera legible por software, con información del origen de claves pero sin claves reales, rutas de derivación hijas ni suma de comprobación. Indica a qué cartera corresponde la etiqueta. No firma el archivo ni certifica que el autor describiera el pago con veracidad. Identificar la cuenta correcta y confiar en la nota son cuestiones diferentes. [1]

Antes de dejar la aplicación antigua, pruebe el traslado en una copia de ensayo separada. Compare pagos conocidos: objeto y ref, texto y posible congelación spendable. Revise tildes, varias cuentas, tipos desconocidos y ausencia de campos opcionales. El importador puede omitir registros no compatibles o recortar etiquetas. Los 255 caracteres sugeridos son un límite predeterminado, no una garantía universal. Conserve la copia original hasta verificar el contexto importante. Un mensaje «importación completada» no lo demuestra por sí solo. [1]