Este artículo explica cómo iniciar la BitBoxApp con valores de gap limit personalizados utilizando parámetros de la línea de comandos.

Esta opción está pensada únicamente para casos avanzados o si te sientes cómodo trabajando en una terminal.

Para la mayoría de usuarios, recomendamos usar el método gráfico:

Consulta: Cómo ajustar el Gap Limit en BitBoxApp
Cómo ajustar el límite de gap en la BitBoxApp 

Cuándo usar el método por línea de comandos

Utiliza este método solo si:

• trabajas en Linux y necesitas iniciar BitBoxApp con parámetros personalizados
• prefieres usar la terminal en lugar de modificar la configuración desde la interfaz
• estás resolviendo un caso de recuperación con muchas direcciones no utilizadas o generadas externamente
• sabes que tu cartera anterior utilizaba gaps inusualmente grandes

Overrides temporales del gap limit

• Los valores personalizados aplican solo durante la sesión actual.
• Cuando cierres la aplicación y la abras normalmente, volverá a los valores por defecto.
• Esto evita configuraciones erróneas y mantiene compatibilidad entre aplicaciones de cartera.

Valores recomendados para comenzar

Empieza con:

• 50 para direcciones de recepción
• 50 para direcciones de cambio (change)

Si después del rescan el saldo sigue siendo incorrecto, vuelve a iniciar la aplicación con:

• 100
• 150
• 200

Aumenta los valores únicamente si es necesario.

Windows

1. Abre la consola (Command Prompt).
2. Ve a la carpeta de instalación:

cd "C:\Program Files\BitBox"

3. Ejecuta BitBoxApp con los parámetros deseados:

Solo recibir:

.\BitBox.exe --gap-limit-receive 50

Solo cambio:

.\BitBox.exe --gap-limit-change 50

Ambos límites:

.\BitBox.exe --gap-limit-receive 50 --gap-limit-change 50

macOS

1. Abre la aplicación Terminal (Aplicaciones → Utilidades).
2. Ejecuta uno de los siguientes comandos:

Límite de recepción:

open -a BitBox --args --gap-limit-receive 50

Límite de cambio:

open -a BitBox --args --gap-limit-change 50

Ambos límites:

open -a BitBox --args --gap-limit-receive 50 --gap-limit-change 50

Linux

El comando depende de cómo instalaste BitBoxApp.

Instalación por paquetes (.deb, .rpm)

Si instalaste través de un gestor de paquetes, el binario suele estar disponible como BitBox en tu PATH.

Límite de recepción:

BitBox -gapLimitReceive 50

Límite de cambio:

BitBox -gapLimitChange 50

Ambos límites:

BitBox -gapLimitReceive 50 -gapLimitChange 50

Si el comando no funciona, localiza la ruta:

which BitBox
whereis BitBox

Rutas típicas: /usr/bin, /usr/local/bin

Ejemplo:

/usr/bin/BitBox -gapLimitReceive 50

AppImage

1. Asegúrate de que el archivo sea ejecutable:

chmod +x BitBox-[version]-x86_64.AppImage

2. Inicia la aplicación con los parámetros deseados:

Límite de recepción:

./BitBox-[version]-x86_64.AppImage -gapLimitReceive 50

Límite de cambio:

./BitBox-[version]-x86_64.AppImage -gapLimitChange 50

Ambos límites:

./BitBox-[version]-x86_64.AppImage -gapLimitReceive 50 -gapLimitChange 50

Después de iniciar con un gap limit personalizado

Una vez que la aplicación se inicia:

• realiza un rescan completo usando los nuevos límites
• deberían aparecer transacciones y saldos que estaban fuera del gap por defecto
• si sigues sin ver todas tus transacciones, incrementa los valores y repite

Los cambios no son permanentes. Necesitas usar los parámetros cada vez que inicies la aplicación.

Preguntas frecuentes (FAQ)

¿Es seguro usar la línea de comandos?

Sí. Solo modifica la forma en que BitBoxApp escanea el historial.
Tus claves, direcciones y estructura de la cartera no se ven afectadas.

¿Por qué usar esto en lugar de la interfaz gráfica?

La mayoría de usuarios deben usar la UI.
El método por terminal es útil para:

• usuarios de Linux
• diagnósticos automatizados
• recuperaciones no estándar
• situaciones en las que la UI no funciona o no inicia correctamente

¿Puedo perder bitcoin si las transacciones están fuera del gap por defecto?

No. Tus fondos siguen en la cadena.
Solo necesitas aumentar la profundidad del escaneo para que aparezcan.

¿Los cambios se mantienen tras reiniciar la app?

No. Los parámetros personalizados aplican únicamente durante la sesión en la que iniciaste BitBoxApp.