Recuperación de Bisq por línea de comandos: guía completa y segura

Introducción

Bisq es una aplicación de intercambio peer-to-peer y una cartera Bitcoin no custodial. Aunque su interfaz habitual es gráfica, la línea de comandos sigue siendo una vía útil para iniciar la aplicación con parámetros controlados, aislar directorios de datos y ejecutar una recuperación ordenada. La clave está en entender que Bisq no ofrece un comando único del tipo bisq recover; la recuperación real se completa en el asistente de restauración, mientras que la CLI sirve para preparar el entorno, apuntar a una carpeta concreta y revisar registros.

Esta guía explica cómo recuperar una cartera Bisq desde la línea de comandos usando dos escenarios: restaurar con la semilla de doce palabras y restaurar desde una copia del directorio de datos. También cubre verificación, solución de problemas y seguridad.

Antes de empezar: conceptos clave

• Semilla de recuperación: conjunto de palabras que permite reconstruir la cartera Bitcoin de Bisq. Debe mantenerse offline y nunca compartirse.
• Directorio de datos: carpeta donde Bisq guarda configuración, base de datos, cartera, claves y registros. En Linux suele ser ~/.local/share/Bisq; en macOS, ~/Library/Application Support/Bisq; en Windows, C:/Users/TuUsuario/AppData/Roaming/Bisq.
• Parámetro --appDataDir: permite iniciar Bisq usando una carpeta de datos alternativa, ideal para recuperaciones limpias o pruebas.
• Sincronización: tras restaurar, Bisq debe sincronizar la cadena SPV, la red P2P, el estado DAO y los datos de mercado.

Advertencia: nunca escribas la semilla en un equipo comprometido. Si sospechas de malware, usa un sistema limpio y verifica la descarga oficial de Bisq antes de continuar.

Requisitos previos

1. Una copia oficial de Bisq, descargada desde su sitio web y con firma verificada.
2. Java 11 o superior, salvo que uses el instalador que incluya el runtime.
3. Terminal o línea de comandos con permisos sobre la carpeta de trabajo.
4. Tu semilla de doce palabras o una copia íntegra del directorio de datos anterior.
5. Espacio libre suficiente para la sincronización y una conexión estable. Bisq usará Tor, por lo que la primera sincronización puede tardar.

Preparar una recuperación segura

Antes de tocar nada, detén cualquier instancia de Bisq. Haz una copia completa del directorio actual, incluso si parece dañado:

cp -a ~/.local/share/Bisq ~/backup-bisq-$(date +%F)

En Windows puedes copiar la carpeta Bisq desde AppData/Roaming a una unidad externa cifrada. No sobrescribas la copia original. Si vas a restaurar desde semilla, crea un directorio nuevo y vacío para evitar mezclar estados antiguos:

mkdir -p ~/BisqRecuperacion

Iniciar Bisq desde la línea de comandos

El objetivo de estos comandos es abrir Bisq apuntando a una carpeta de datos concreta. Así puedes recuperar sin alterar tu instalación principal.

En Linux o macOS, desde la carpeta donde descomprimiste Bisq:

./Bisq --appDataDir=/home/usuario/BisqRecuperacion

En Windows, usando PowerShell o CMD:

Bisq.exe --appDataDir=C:/Users/Usuario/BisqRecuperacion

Si ejecutas el archivo JAR directamente:

java -jar Bisq.jar --appDataDir=/ruta/BisqRecuperacion

Opcionalmente, añade --logLevel=INFO para obtener más detalle en los registros. Mantén la terminal abierta: algunos mensajes de arranque y errores solo aparecen allí.

Método 1: restaurar desde la semilla

Este es el método recomendado cuando no tienes una copia del directorio de datos, pero sí tus doce palabras.

1. Ejecuta Bisq con --appDataDir apuntando a una carpeta nueva.
2. En el asistente inicial, elige la opción de restaurar cartera desde semilla.
3. Introduce las palabras en el orden correcto, separadas por espacios. Respeta mayúsculas y minúsculas solo si el asistente lo indica.
4. Define una contraseña robusta para la cartera. No reutilices contraseñas.
5. Espera a que Bisq cree la cartera y comience la sincronización.
6. No cierres la aplicación durante la sincronización inicial. Puede tardar desde varios minutos hasta varias horas según la red y el estado de la cadena.

Cuando termine, comprueba el saldo, el historial de transacciones y las direcciones de depósito. Si el saldo no coincide, no muevas fondos: revisa primero la semilla, la versión de Bisq y los registros.

Método 2: restaurar desde una copia del directorio de datos

Si conservas una copia completa de Bisq, este método puede recuperar configuración, cartera y estado local sin depender solo de la semilla.

1. Cierra Bisq por completo.
2. Copia la carpeta de respaldo a una ubicación segura, por ejemplo ~/BisqRestaurado.
3. Inicia Bisq con:

./Bisq --appDataDir=/home/usuario/BisqRestaurado

4. Comprueba que Bisq abre sin errores de base de datos.
5. Revisa saldo, historial, órdenes abiertas y estado de la cartera.
6. Si la carpeta está corrupta o la versión es incompatible, vuelve al método de semilla.

No edites archivos internos de la cartera ni de la base de datos salvo que sepas exactamente lo que haces. Un cambio incorrecto puede inutilizar la recuperación.

Verificación posterior

Una recuperación no termina cuando la aplicación abre. Debes verificar:

• Que la sincronización SPV haya alcanzado el bloque actual.
• Que la conexión Tor y la red P2P funcionen correctamente.
• Que las direcciones y el saldo esperado aparezcan en la cartera.
• Que el historial de transacciones coincida con tus registros.
• Que las órdenes y reputación se comporten según lo esperado.

Haz una transferencia pequeña de prueba solo si entiendes el riesgo y ya confirmaste el saldo. Para cantidades importantes, considera esperar confirmaciones suficientes antes de operar.

Solución de problemas comunes

• La cartera aparece vacía: puede ser una sincronización incompleta, una semilla incorrecta o un directorio de datos equivocado. Revisa la terminal y bisq.log.
• Error de permisos: asegúrate de que el usuario tenga lectura y escritura sobre --appDataDir.
• Bisq no inicia: comprueba Java, la versión de Bisq y si otra instancia está usando la misma carpeta.
• Problemas de Tor: espera, reinicia la aplicación y revisa la conectividad. No desactives Tor sin comprender las consecuencias de privacidad.
• Versión incompatible: usa una versión de Bisq igual o superior a la que creó los datos, pero evita versiones no oficiales.

Buenas prácticas de seguridad

Mantén la semilla en papel o metal, nunca en una foto, correo o nube sin cifrar. Verifica las descargas con firmas y hashes. Usa una carpeta de recuperación separada. Registra los pasos que funcionaron y guarda una copia de los registros sin datos sensibles. Si recuperas fondos importantes, considera hacerlo en un equipo dedicado y sin conexión a redes innecesarias.

Conclusión

La recuperación de Bisq por línea de comandos no consiste en un único comando mágico, sino en iniciar la aplicación con parámetros seguros, elegir el método correcto y verificar cada etapa. Si tienes la semilla, restaura en un directorio limpio; si tienes una copia completa, apunta --appDataDir a esa carpeta y valida el estado. La paciencia durante la sincronización y la disciplina con la seguridad son tan importantes como el propio procedimiento. Con estos pasos puedes recuperar tu cartera Bisq de forma ordenada, reproducible y con menor riesgo.