Cómo etiquetar y exportar una wallet en Sparrow

Qué harás

Las etiquetas convierten una lista de direcciones e identificadores de transacción en un registro que podrás entender más adelante. Una etiqueta breve como «salario octubre», «prueba de hardware wallet» o «entrada para conferencia» puede ayudarte a elegir la moneda correcta, explicar un pago antiguo y evitar que combines fondos sin relación.

Esta guía usa Sparrow Wallet 2.5.5, la última versión publicada que no era preliminar cuando se comprobó el 28 de octubre de 2026. Su registro oficial de versión tiene fecha del 17 de septiembre de 2026. Añadirás etiquetas, las exportarás como archivo JSON Lines según BIP 329 y revisarás la estructura sin exponerla a un servicio en línea.

Los pasos se comprobaron con el código publicado de Sparrow 2.5.5 y la especificación BIP 329 actual. No se usaron archivos de wallet, claves privadas, frases de recuperación, direcciones, transacciones ni fondos. La interfaz de Sparrow no se ejecutó, por lo que la ubicación de los botones se describe a partir del código publicado y puede cambiar en una versión posterior.

Antes de empezar

Necesitas:

• Sparrow Wallet 2.5.5 con la wallet correcta abierta
• unos minutos para escribir etiquetas que sigan teniendo sentido dentro de varios meses
• una carpeta local cifrada o una unidad extraíble para guardar el archivo exportado
• un editor de texto sin formato que funcione sin conexión

No escribas frases de recuperación, claves privadas, contraseñas, datos completos de clientes ni secretos de autenticación en una etiqueta. Las etiquetas son metadatos de la wallet, no un gestor de secretos.

Elige un patrón antes de editar. Una buena etiqueta describe el propósito y el contexto sin recopilar identidad innecesaria. «Transferencia a ahorros 2026-10» suele ser más segura y útil que el nombre completo, número de teléfono y dirección de una persona. Usa palabras coherentes para poder encontrar juntas las operaciones relacionadas.

1. Etiqueta los registros que querrás reconocer

Empieza con un grupo pequeño de registros en lugar de intentar documentar toda la wallet de una vez.

Abre Transactions, UTXOs o Addresses, según lo que quieras describir. Las tablas de Sparrow 2.5.5 tienen una columna Label. Haz clic derecho en una celda de esa columna y elige Edit Label..., o edita la celda directamente cuando la tabla lo permita. El código publicado de la celda de etiqueta confirma las acciones Copy Label, Paste Label y Edit Label... y elimina los espacios de los extremos cuando se guarda.

Usa la etiqueta más específica y precisa:

• etiqueta una dirección antes de recibir si ya conoces su finalidad
• etiqueta una transacción cuando la descripción corresponde al pago completo
• etiqueta un UTXO cuando una salida necesita una nota distinta de gasto o contabilidad

Por ejemplo, una transacción puede ser «retiro de exchange 2026-10», mientras que una de sus salidas puede ser «ahorro a largo plazo». Las dos etiquetas responden preguntas distintas.

Comprueba la etiqueta después de guardarla. Una etiqueta en la fila equivocada puede ser peor que no tener ninguna porque puede influir en una decisión futura de selección de monedas. Compara el identificador de transacción, la dirección o la referencia de salida antes de continuar.

2. Revisa las etiquetas antes de exportar

Busca etiquetas vagas como «prueba», «mío» o «pago». Sustitúyelas por una descripción breve que distinga el registro de otros similares. Evita suposiciones que no puedas comprobar. Si no recuerdas un pago antiguo, escribe «desconocido 2025-04» en lugar de adivinar quién lo envió.

Presta especial atención a los UTXOs. Un UTXO es una salida gastable concreta, no el saldo total de la wallet. Nuestra guía sobre el uso de coin control en Sparrow explica por qué distintas salidas pueden tener historiales de privacidad diferentes. Las etiquetas ayudan a revisarlos, pero no imponen por sí solas una regla de gasto.

Sparrow también permite marcar un UTXO como congelado. En el exportador de etiquetas de la versión 2.5.5, una salida congelada y no gastada se escribe con "spendable": false. Es un metadato de la wallet. No cambia la salida de Bitcoin ni impide que otra wallet compatible la gaste.

3. Exporta las etiquetas según BIP 329

Abre la pantalla Settings de la wallet y elige Export.... En el diálogo de exportación, selecciona Labels y guarda el archivo con la extensión .jsonl. El exportador de etiquetas publicado identifica el formato como BIP 329 y escribe un objeto JSON por línea.

La exportación no requiere descifrar la wallet en Sparrow 2.5.5. Eso no vuelve inofensivo el resultado. El archivo puede incluir identificadores de transacción, direcciones, referencias de salidas, claves públicas extendidas, etiquetas y un descriptor de origen. En conjunto, esos registros pueden revelar la estructura y actividad de la wallet.

Guarda el archivo en la ubicación protegida que preparaste. No lo subas a un sitio para pegar texto, un issue público, una herramienta de analítica compartida ni un servicio de IA. No lo envíes por un canal al que no confiarías tu historial de transacciones.

4. Comprueba el archivo sin modificarlo

Haz una copia antes de revisarlo y conserva la exportación original sin cambios. Abre la copia en un editor de texto sin formato y sin conexión.

BIP 329 usa JSON Lines, también llamado JSONL. Cada línea contiene un objeto JSON independiente. Un ejemplo sintético simplificado es este:

{"type":"tx","ref":"0000000000000000000000000000000000000000000000000000000000000000","label":"solo un ejemplo"}
{"type":"output","ref":"0000000000000000000000000000000000000000000000000000000000000000:0","label":"salida de práctica","spendable":false}

Estas referencias llenas de ceros son datos didácticos, no registros reales de una wallet.

Comprueba cuatro cosas:

1. cada línea no vacía contiene un objeto JSON completo
2. cada objeto tiene type y ref
3. las etiquetas coinciden con los registros que querías documentar
4. el archivo no contiene una clave privada o frase de recuperación que hayas pegado por error en una etiqueta

BIP 329 define tipos comunes como tx, addr, input, output y xpub. No define tipos para claves privadas. La especificación también advierte que los archivos de etiquetas afectan a la privacidad y deben cifrarse durante su traslado.

No conviertas el archivo en un gran array JSON si piensas importarlo en Sparrow. JSONL espera un objeto por línea. Un procesador de texto también puede sustituir las comillas o añadir formato, por lo que debes usar un editor de texto sin formato.

5. Prueba una importación solo con un destino seguro

Si necesitas restaurar etiquetas, abre primero la wallet correspondiente. Después elige File > Import Wallet..., selecciona Labels y escoge el archivo JSONL guardado. El importador publicado de Sparrow aplica los registros coincidentes a la wallet desbloqueada que esté seleccionada. El código comprueba el descriptor de origen opcional y luego busca referencias como identificadores de transacción, direcciones y salidas.

Importar el archivo en una wallet sin relación no debería crear por arte de magia su historial de transacciones. Las referencias deben coincidir con registros de la wallet seleccionada. Aun así, crea una copia de seguridad de la wallet antes de una importación grande porque las etiquetas pueden sustituir metadatos existentes.

Después de importar, comprueba una muestra pequeña en Transactions, Addresses y UTXOs. Confirma que la etiqueta aparece en el registro previsto y que una salida congelada sigue congelada si ese estado formaba parte de la exportación. No supongas que un diálogo correcto significa que todas las líneas coincidieron.

Este paso de importación no se ejecutó para la guía. Se describe a partir de la implementación publicada de la versión 2.5.5. Si tu versión instalada es distinta, consulta sus notas de versión y prueba con una wallet desechable de solo lectura que no contenga claves privadas ni fondos.

Resultado esperado

Ahora deberías tener:

• etiquetas claras en los registros que revisaste
• una exportación .jsonl guardada en una ubicación protegida
• un archivo cuyas líneas se pueden analizar como objetos JSON independientes
• un registro de qué se exportó y cuándo

El archivo es una copia de seguridad de metadatos, no de la wallet. No sustituye el archivo de wallet, el descriptor de salida, el dispositivo de firma ni el proceso de recuperación necesario para gastar fondos.

Solución de problemas

No aparece la exportación Labels: comprueba que la wallet correcta esté abierta y seleccionada. En Sparrow 2.5.5, el diálogo de exportación incluye un exportador Labels. Si tu versión es anterior, verifica la versión instalada antes de seguir instrucciones actuales.

Una etiqueta desaparece después de editarla: se eliminan los espacios de los extremos. Una etiqueta que solo contiene espacios se considera vacía en 2.5.5. Escribe texto visible y sal de la celda para guardarlo.

El archivo JSONL parece una sola línea larga: usa un editor que conserve los saltos de línea de Unix o Windows. No pegues el archivo en un documento de texto enriquecido.

La importación indica éxito pero falta una etiqueta: puede que la wallet seleccionada no contenga una referencia coincidente o que el origen del archivo describa otra wallet. Comprueba el identificador de transacción, la dirección o la referencia de salida exactos y confirma que elegiste la wallet correcta.

Una salida congelada se puede gastar después de cambiar de wallet: spendable: false es un metadato importado, no una restricción de la red. Confirma que la importación coincidió con esa salida y que la wallet de destino admite el campo antes de confiar en él.

Expusiste el archivo: considera que las etiquetas y los registros públicos enlazados ya se divulgaron. Traslada la copia restante a un almacenamiento protegido, elimina copias públicas innecesarias cuando sea posible y evita añadir más datos personales. Cambiar una etiqueta no borra información que ya compartiste.

Qué se verificó y qué no

La versión publicada Sparrow 2.5.5, el editor, exportador e importador de etiquetas publicados para 2.5.5 y la especificación BIP 329 actual se comprobaron el 28 de octubre de 2026.

Un programa desechable de Node.js sin conexión analizó tres registros JSONL sintéticos, confirmó los campos obligatorios type y ref, conservó el valor spendable: false de una salida y rechazó una línea sin ref. No se usaron datos reales de wallets. La ilustración se creó a mano como SVG, se convirtió en un WebP de 1200 × 630 y se inspeccionó visualmente.

No se ejecutaron el binario de Sparrow, archivos de wallet, la interfaz, importaciones, exportaciones, conexiones a servidores ni dispositivos de firma. Tampoco se usaron direcciones reales, transacciones, claves públicas extendidas, claves privadas, frases de recuperación ni fondos. Por tanto, la guía verifica el formato publicado y la implementación publicada, no todos los estados posibles de la interfaz en tu equipo.

Las etiquetas son útiles porque devuelven el contexto. Son sensibles por el mismo motivo. Hazlas lo bastante específicas para orientar decisiones futuras, limita los datos personales y protégelas como el historial de wallet que describen.