Conecta la BitBoxApp a tu propio nodo completo de Bitcoin para consultar saldos e historiales de transacciones y transmitir transacciones firmadas a la red mediante una infraestructura que controlas. La aplicación accede a los datos de la cadena de bloques de tu nodo a través de un servidor compatible con Electrum; no se conecta directamente a Bitcoin Core.

Puedes hacerlo desde un ordenador o un móvil, incluso fuera de tu red doméstica mediante una VPN. Al añadir tu servidor, los anteriores siguen disponibles como alternativas. Para que la BitBoxApp utilice exclusivamente tu infraestructura de Bitcoin, también debes eliminar esas alternativas y reiniciar la aplicación.

Antes de empezar

Necesitas la versión más reciente de la BitBoxApp y un nodo de Bitcoin completamente sincronizado. El servidor compatible con Electrum también debe haber terminado de sincronizar e indexar los datos. Los paquetes para nodos como Umbrel, Start9 o RaspiBlitz pueden incluir este servidor; consulta su documentación para configurarlo y obtener los datos de conexión.

Si administras tu propia instalación, electrs y ElectrumX son dos ejemplos de servidores Electrum. La compatibilidad depende de las versiones del backend y de Bitcoin Core que utilices. Sigue la documentación de la versión que instales, incluidos sus requisitos de almacenamiento e índices.

La compatibilidad con la poda de bloques, o pruning, depende del servidor Electrum. No hay un ajuste independiente de poda en la BitBoxApp. Tanto electrs como ElectrumX necesitan un nodo de Bitcoin Core sin poda. Si utilizas otro backend con un nodo podado, comprueba que pueda proporcionar los datos históricos y las funciones de Electrum que necesita la BitBoxApp.

Lo mismo ocurre con disablewallet=1: solo puedes desactivar la función de billetera de Bitcoin Core si tu backend no depende de ella. Este ajuste no hace que un backend sea compatible con la poda.

Antes de continuar, obtén la dirección de conexión de Electrum, también llamada endpoint: el nombre de host o la dirección IP del servidor, más el puerto, como hostname:port. Utiliza el endpoint y el tipo de conexión que indique el software de tu nodo, en lugar de la dirección RPC de Bitcoin Core. No sustituyas el puerto por 50001 o 50002, salvo que las instrucciones de tu nodo lo indiquen expresamente.

Elige cómo conectarte a tu nodo

Elige una conexión que ofrezca tu nodo y prepárala antes de añadir el endpoint en la BitBoxApp.

Para utilizar un endpoint onion en un ordenador, primero configura el proxy Tor de la BitBoxApp. El endpoint onion debe dar acceso al servidor Electrum, no solo a la página de administración del nodo. Mantén Tor en funcionamiento mientras lo utilices. La opción de proxy Tor de la BitBoxApp no está disponible en iOS; utiliza allí una conexión local o una VPN.

Para conectarte directamente por la red local o por una VPN, desactiva Activar proxy TOR en Configuración → Configuración avanzada si está activado. Después, cierra por completo la BitBoxApp y vuelve a abrirla para que se conecte directamente.

No expongas tu servidor Electrum a Internet mediante el reenvío de puertos del router. Accede a través de tu red local, una VPN o el endpoint onion de tu nodo.

Usa tu nodo fuera de casa con una VPN

Una VPN puede permitirte acceder al nodo mientras el móvil usa datos móviles o el ordenador se conecta a otra red. Una opción es Tailscale, que crea una red privada y cifrada entre tus dispositivos. Tu nodo sigue necesitando un servidor Electrum sincronizado.

1. Instala Tailscale en el equipo donde se ejecuta tu nodo y añádelo a tu red de Tailscale. Si utilizas Umbrel, puedes instalar la aplicación Tailscale de la tienda de aplicaciones de Umbrel. Completa la configuración siguiendo las instrucciones del software de tu nodo.
2. Instala Tailscale en el móvil u ordenador donde utilizas la BitBoxApp y conéctalo a la misma red de Tailscale. Para una configuración personal sencilla, puedes usar la misma cuenta en ambos dispositivos. Sigue la guía de configuración de Tailscale para autorizar los dispositivos y conceder los permisos de VPN necesarios.
3. Busca en Tailscale la dirección IP de Tailscale del equipo donde se ejecuta tu nodo. Utilízala con el puerto de Electrum que indique el software del nodo. El servicio Electrum debe ser accesible en esa dirección y ese puerto; poder abrir la página de administración del nodo no confirma el acceso a Electrum.

Mantén Tailscale conectado y sigue el apartado Añade tu servidor Electrum con este endpoint. Después, configura el uso exclusivo de tu nodo y comprueba el acceso remoto. Tailscale es un servicio de red de un tercero, y el acceso depende de que tus dispositivos sigan autorizados y conectados.

Añade tu servidor Electrum

Cuando el nodo y el servidor Electrum estén preparados y sean accesibles mediante la conexión elegida, añade el endpoint. Para configurar esta conexión no necesitas introducir palabras de recuperación, claves privadas ni una copia de seguridad de la billetera.

1. Abre Configuración en la BitBoxApp; en un móvil, encontrarás esta opción en la barra de navegación inferior. Selecciona Configuración avanzada → Conecta tu propio nodo completo y, si es necesario, Servidores Electrum de Bitcoin.
2. En Añadir un servidor, introduce el endpoint completo de Electrum en el campo host:port.

Si el endpoint utiliza TLS, pega el certificado del servidor en el campo del certificado, incluidas las líneas -----BEGIN CERTIFICATE----- y -----END CERTIFICATE-----. Obtén el certificado mediante un acceso de confianza a tu propio nodo. Como alternativa, selecciona Descargar certificado remoto y compara el certificado descargado con el que hayas obtenido del nodo mediante ese acceso de confianza. Detén el proceso si no coinciden o si no puedes confirmar que el certificado pertenece a tu nodo.

Si el endpoint no utiliza TLS, deja vacío el campo del certificado. Utiliza únicamente el tipo de conexión que ofrezca tu nodo.

1. Selecciona Comprobar y espera a que aparezca el mensaje La conexión a [tu endpoint] se ha establecido con éxito. Cierra el mensaje. Si la comprobación falla, resuelve el error antes de continuar.
2. Selecciona Añadir. El endpoint aparecerá en la lista Servidores. Cierra por completo la BitBoxApp y vuelve a abrirla para aplicar la nueva configuración.

Una comprobación correcta confirma que la aplicación puede establecer una conexión Electrum con el endpoint. No comprueba todas las operaciones de la billetera ni confirma que la aplicación utilice exclusivamente tu nodo.

Usa solo tu propio nodo y comprueba el resultado

Mientras haya otros servidores de Bitcoin configurados, la BitBoxApp puede utilizarlos como alternativas. Elimina todos los servidores que no controles si quieres que las consultas de las cuentas y la transmisión de transacciones de Bitcoin pasen exclusivamente por tu infraestructura.

1. Vuelve a Configuración → Configuración avanzada → Conecta tu propio nodo completo → Servidores Electrum de Bitcoin. Busca tu endpoint en la lista Servidores y selecciona Comprobar junto a él para confirmar que sea accesible.
2. Selecciona Eliminar junto a cada servidor predeterminado y cualquier otro servidor de Bitcoin de terceros, y confirma cada eliminación. Conserva en la lista tu propio endpoint, cuya conexión ya has comprobado.
3. Cierra por completo la BitBoxApp y vuelve a abrirla. Abre tu cuenta de Bitcoin y espera a que termine la sincronización. Comprueba que pueda actualizar el saldo y el historial de transacciones sin errores de conexión. Si solo está configurado tu endpoint, esas actualizaciones dependen de tu nodo.
4. Si has configurado el acceso por VPN, pruébalo desde fuera de tu red doméstica. En un móvil, desactiva temporalmente el wifi y usa datos móviles; en un ordenador, utiliza otra red. Con la VPN conectada, cierra la BitBoxApp, vuelve a abrirla y comprueba que tu cuenta de Bitcoin se sincronice sin errores de conexión. Vuelve a activar el wifi si lo habías desactivado.

Cuando solo está configurado tu endpoint, las transacciones de Bitcoin que envías desde la BitBoxApp se transmiten a la red a través de ese servidor Electrum y de tu nodo, también cuando accedes por VPN. La sincronización de la cuenta permite comprobar el acceso remoto a los datos; no prueba la transmisión de transacciones.

Mantén en funcionamiento el nodo, el servidor Electrum y cualquier conexión VPN o Tor necesaria. Si dejan de estar disponibles, la aplicación no podrá actualizar tus cuentas de Bitcoin ni transmitir transacciones de Bitcoin a través de ese endpoint. Cambiar la configuración del servidor no mueve por sí mismo bitcoin ni modifica las claves privadas de tu billetera de la BitBox.

Este ajuste corresponde al backend de Bitcoin. No dirige todos los servicios de la BitBoxApp a través de tu nodo. Consulta qué datos comparte la BitBoxApp para conocer los límites respecto a otras cuentas y servicios.

Resuelve problemas de conexión

La comprobación de conexión falla o agota el tiempo de espera

• Comprueba que Bitcoin Core esté sincronizado y que el servidor Electrum también haya terminado de sincronizar e indexar los datos.
• Comprueba que la versión del backend sea compatible con tu versión y configuración de Bitcoin Core. Revisa los requisitos de poda e índices y si debe estar activada la función de billetera de Core.
• Vuelve a copiar el endpoint de Electrum y el puerto desde el software de tu nodo. Un endpoint RPC de Bitcoin Core no es un endpoint de Electrum.
• Comprueba que el endpoint sea accesible desde el equipo donde se ejecuta la BitBoxApp: conéctate a la red local o a la VPN, o inicia el proxy Tor en el ordenador, según el método elegido. El ajuste de proxy de la BitBoxApp debe corresponder a esa conexión.
• Si utilizas Tailscale, confirma que ambos dispositivos estén conectados a la misma red de Tailscale y autorizados para comunicarse. Comprueba que el puerto Electrum del nodo sea accesible mediante su dirección de Tailscale. Si falla el acceso a la red, sigue la guía de Tailscale para resolver problemas de conexión entre dispositivos.

Si aparece connection refused al utilizar Tor, comprueba que el proxy Tor local esté en funcionamiento y que su dirección coincida con la configurada en la BitBoxApp. Sigue la guía de configuración y solución de problemas de Tor.

No se puede descargar o verificar el certificado

Un endpoint sin TLS no proporciona un certificado TLS. Si tu nodo ofrece endpoints TCP y TLS separados, utiliza exactamente el que corresponda al tipo de conexión elegido. Para un endpoint TLS, comprueba el certificado actual mediante un acceso de confianza a tu nodo. No aceptes un cambio de certificado sin explicación ni pases a una conexión sin cifrar solo para evitar un error.

La comprobación es correcta, pero la cuenta no se actualiza

Reinicia la BitBoxApp después de cambiar la lista de servidores y comprueba el estado de sincronización y los registros del servidor Electrum. El backend debe admitir las operaciones de billetera que utiliza la aplicación: consultas y suscripciones al historial de direcciones, obtención de transacciones, cabeceras de bloques y pruebas de transacciones, información sobre comisiones y transmisión de transacciones a la red. Una conexión TLS funcional o una función de billetera de solo lectura por sí solas no confirman esa compatibilidad.

Si el problema persiste, contacta con el soporte de BitBox. Indica las versiones de la BitBoxApp, Bitcoin Core y el backend, si están activadas la poda y la función de billetera de Bitcoin Core, el método de conexión y el error exacto. Elimina las credenciales, los datos privados de los endpoints y la información personal no relacionada de las capturas o los fragmentos de registros. Nunca compartas palabras de recuperación, claves privadas, contraseñas, passphrases ni copias de seguridad de la billetera.

Tu nodo no está disponible

Primero restablece el funcionamiento del nodo, el backend y la conexión de red necesaria. Si decides volver temporalmente a los servidores predeterminados de Bitcoin, abre Servidores Electrum de Bitcoin, selecciona Restablecer a predeterminados y confirma. Esta acción sustituye la lista de servidores de Bitcoin configurada por los predeterminados. Conserva los datos de tu endpoint y su certificado si quieres volver a añadirlos más adelante. Después, reinicia la aplicación.

Al utilizar los servidores predeterminados, vuelves a depender de infraestructura pública para las consultas y la transmisión de transacciones de Bitcoin. Para volver a usar exclusivamente tu nodo, añade y comprueba tu endpoint, elimina los servidores predeterminados y reinicia la aplicación.