Con WalletConnect en la BitBoxApp puedes conectar una DApp compatible a tu cuenta de Ethereum. Una DApp es una aplicación de terceros que puede pedirte que firmes mensajes o transacciones.

Las pantallas y los pasos de firma pueden variar de una DApp a otra. Antes de firmar, compara y verifica siempre los datos en la pantalla de la BitBox. Que las claves privadas permanezcan en el dispositivo no significa que una solicitud autorizada sea inofensiva.

Antes de empezar

• Necesitas una BitBox de la edición Multi que ya esté configurada. La edición Bitcoin-only no puede firmar solicitudes de Ethereum.
• Comprueba que la BitBoxApp y el firmware de tu BitBox estén actualizados antes de empezar.
• Ten a mano la BitBox de la cuenta de Ethereum que quieras utilizar: la necesitarás para firmar.
• Para un iPhone o iPad necesitas una BitBox Nova compatible. Para un ordenador o un dispositivo Android, necesitas una conexión USB compatible.

WalletConnect en la BitBoxApp admite la red principal de Ethereum, Arbitrum One, Base, Optimism y la red de prueba Ethereum Sepolia. La DApp debe solicitar una red y un método de firma compatibles. Conectar una DApp no añade estas redes ni sus saldos a la vista de cuentas de la BitBoxApp.

Si esta conexión no admite la red o la DApp que necesitas, comprueba si alguna billetera externa compatible con BitBox permite utilizarla. Consulta cómo conectar tu BitBox a Rabby Wallet.

Conectar una DApp

Primero obtén el enlace de conexión o el código QR de la DApp. Después, úsalo en la BitBoxApp: puedes pegar el enlace en el mismo dispositivo o escanear el código que se muestre en otro. Las instrucciones utilizan los nombres de los controles de la BitBoxApp en español, aunque las capturas muestran la interfaz de escritorio en inglés. Los botones del sitio web de la DApp pueden aparecer en otro idioma.

1. Abre el sitio web oficial de la DApp en tu navegador. Comprueba el dominio por una vía independiente antes de conectarte. El nombre o el logotipo que aparezca en una solicitud no basta para demostrar que la DApp es auténtica.
2. Abre las opciones del sitio web para conectar una billetera. Suelen aparecer como Connect o Connect wallet.
3. Selecciona WalletConnect entre las opciones de billetera. La DApp muestra un código QR y puede ofrecer también un enlace de conexión para copiar.
4. Si vas a pegar el enlace en la BitBoxApp, copia el que acaba de generar la DApp para WalletConnect. Si prefieres escanear el código QR, déjalo abierto en el otro dispositivo. Mantén privados el enlace y el código QR de emparejamiento; no utilices los de una guía ni los que te envíe otra persona.
5. Abre la BitBoxApp y selecciona la cuenta de Ethereum que quieras conectar a la DApp.
6. En la página de esa cuenta, selecciona Wallet Connect.
7. En la página de WalletConnect, selecciona Nueva conexión para abrir el formulario de conexión.

8. Pega el enlace copiado en el campo Introduce la dirección URI de la Dapp. Para escanear el código, selecciona el icono de código QR que aparece en ese campo y escanea el código actual del sitio web de la DApp.

9. Si has pegado un enlace, selecciona Conectar. Si has escaneado el código, este se envía directamente. En ambos casos, la BitBoxApp muestra una nueva solicitud de conexión.
10. En la solicitud, revisa la dirección de la cuenta, el nombre de la DApp y su sitio web. Deben coincidir con la cuenta que has elegido y la DApp que quieres utilizar. Selecciona Rechazar si algún dato no corresponde a lo que esperabas.
11. Si los datos coinciden y quieres establecer la conexión, selecciona Aprobar conexión.
12. Espera al mensaje Dapp conectada con éxito. Puedes continuar en el sitio web de la dapp. Selecciona Hecho y vuelve a la DApp.

La conexión se ha establecido cuando la BitBoxApp muestra el mensaje de confirmación y la DApp aparece en la lista de sesiones de WalletConnect. Esto no confirma ningún pago, depósito ni operación de compraventa. Si la DApp te pide que firmes un mensaje o una transacción, decide por separado si quieres autorizarlo. La siguiente sección explica cómo revisar esa solicitud.

Revisar las solicitudes antes de firmar

Sigue estos pasos solo para las solicitudes que hayas iniciado tú en el sitio web de la DApp. La firma de un mensaje no es necesariamente una transacción en la cadena, pero puede autorizar acciones con consecuencias importantes incluso sin comisión de red.

1. Cuando aparezca una Solicitud de WalletConnect en la BitBoxApp, comprueba la cuenta, la red y la DApp. Asegúrate de que la cuenta y la red correspondan a la acción que querías realizar en el sitio web.
2. Lee el tipo de solicitud y sus datos para entender qué vas a autorizar. Cancela si no esperabas recibirla o no entiendes su significado.
3. Selecciona Continuar solo si quieres seguir con esa solicitud.
4. Si la BitBoxApp te pide que conectes tu BitBox, conecta y desbloquea la BitBox de la cuenta que aparece en la solicitud. La necesitas para firmar.
5. En la pantalla de la BitBox, revisa la dirección completa con la que vas a firmar. Verifica que sea la de la cuenta que quieres utilizar.
6. Lee todos los datos del mensaje o la transacción en la BitBox. Los mensajes estructurados pueden incluir campos de dominio y de mensaje; las transacciones tienen sus propias pantallas de revisión.
7. Compara los valores completos que muestra la BitBox con la solicitud de la BitBoxApp y con la acción que querías realizar. Cancela si algún valor no coincide, aparece una advertencia inesperada o no entiendes algún dato. Aunque los datos coincidan, eso no demuestra que la acción o la DApp sean de confianza.
8. Tras revisar todas las pantallas, confirma la solicitud final de firma en la BitBox solo si quieres autorizarla. Sigue las instrucciones de confirmación del dispositivo.

Espera a que la BitBoxApp indique el resultado y vuelve a la DApp para comprobar qué ha ocurrido. Una firma completada no demuestra que se haya realizado un pago o una operación de compraventa. Mantén la BitBoxApp disponible para recibir más solicitudes y revisa cada una por separado. Si has concedido permisos, no des por hecho que todas las acciones posteriores requerirán otra confirmación en el dispositivo.

Desconectar una DApp

Para finalizar una sesión de WalletConnect:

1. En la BitBoxApp, abre la cuenta de Ethereum que has conectado a la DApp.
2. Selecciona Wallet Connect en la página de la cuenta.
3. Busca la DApp en la lista de sesiones y selecciona Eliminar.
4. Comprueba que la DApp ya no aparezca en la lista.

Eliminar la sesión desconecta la DApp de WalletConnect. No deshace las acciones firmadas, ni recupera los fondos transferidos, ni revoca los permisos ya concedidos mediante firmas o transacciones. Si necesitas revisar esos permisos, consulta las instrucciones oficiales de la DApp.

Si la conexión o la solicitud no funciona

• Se rechaza el enlace de conexión o no ocurre nada: abre de nuevo el cuadro de conexión de WalletConnect en la DApp y utiliza el enlace o código QR que se genere. No reutilices un enlace de emparejamiento caducado o rechazado anteriormente.
• La DApp solicita una red o un método no compatible: detente y comprueba la compatibilidad. La compatibilidad con una solicitud no garantiza que todas las funciones de esa DApp sean compatibles.
• Los datos del dispositivo no coinciden o no entiendes su significado: cancela. No firmes para cerrar una advertencia ni porque un sitio web afirme que no supone ningún riesgo.

Si el problema persiste, contacta con el soporte de BitBox e indica el modelo de BitBox, las versiones de la aplicación y del firmware, el sistema operativo, el sitio web de la DApp, la red, el tipo de solicitud y el texto exacto del error. Nunca envíes palabras de recuperación, passphrases, contraseñas, claves privadas, archivos de copia de seguridad ni enlaces o códigos QR de emparejamiento de WalletConnect.

Para entender cómo WalletConnect transmite las solicitudes entre una DApp y la BitBoxApp, puedes leer nuestra introducción al uso de WalletConnect con BitBox (en inglés). El artículo describe el lanzamiento original de 2024; para este proceso, sigue las instrucciones y la lista de redes de esta guía.