With WalletConnect integrated directly into the BitBoxApp, you can now securely explore the vibrant world of Decentralized Applications (DApps) using your BitBox02 hardware wallet. This feature opens up possibilities like DeFi, NFTs, and much more, all while upholding the security principles you trust.


What is WalletConnect?

WalletConnect is an open-source protocol that facilitates secure connections between cryptocurrency wallets and DApps. It's a widely used open protocol designed specifically for this purpose. Instead of needing complex setups or potentially exposing your sensitive information, WalletConnect uses a simple, encrypted connection, often initiated by scanning a QR code or clicking a special link.

Here's the magic: when a DApp needs your approval for an action, like sending a transaction or signing a message, WalletConnect securely forwards that request to your BitBoxApp. Crucially, your private keys – the secret codes that control your crypto – never leave your BitBox02 hardware wallet. You then verify and approve the request directly on your BitBox02's trusted screen. This combination of secure hardware and a standardized communication protocol allows you to engage with the blockchain world with greater peace of mind.


Prerequisites

Before you begin, ensure you have the following:

  • A BitBox02 Multi Edition hardware wallet.
  • The latest version of the BitBoxApp installed on your desktop or Android device.
  • An active Ethereum account within the BitBoxApp.
  • Access to a compatible DApp (e.g., Uniswap) via a web browser.

Note: Currently, WalletConnect in the BitBoxApp supports only the Ethereum mainnet. For other EVM-compatible networks like Polygon, Arbitrum, or BSC, please use the Rabby browser extension.

 

Step-by-Step guide to connecting with WalletConnect

1. Open the DApp

  1. Open your chosen DApp (like Uniswap) in your preferred web browser.
  2. Click on the “Connect wallet”

2. Select WalletConnect

  1. You'll likely see several wallet options. It's important to select WalletConnect from this list.
  2. The DApp will now display a QR code. Usually, it will also provide a copyable connection link or code string nearby. You'll use one of these methods to link the DApp to your BitBoxApp.

3. Initiate connection in BitBoxApp

  1. Open the BitBoxApp on your desktop or Android device.
  2. Navigate to your Ethereum account.
  3. Click on the “WalletConnect” button next to the “Send” and “Receive” buttons.
  4. Choose “New Connection.” 
  1. Now, bridge the gap between the DApp and your BitBoxApp:
    1. Using the BitBoxApp on Android: The easiest way is often to tap the "Scan QR code" option within the BitBoxApp and point your phone's camera directly at the QR code displayed by the DApp in your browser.
    2. Using the BitBoxApp on Desktop (or preferring the link): Go back to the DApp interface in your browser and click the "copy" icon next to the WalletConnect connection link/code. Then, paste this copied link into the input field provided in the BitBoxApp's WalletConnect section.
  2. Once the QR code is scanned or the link is pasted, click the "Connect" button (or similar confirmation) within the BitBoxApp.

5. Approve the Connection

  1. The BitBoxApp will prompt you to approve the connection.
  2. Review the details and click “Approve Connection.”
  3. A confirmation message will indicate a successful connection.

Interacting with the DApp

Now that you're connected, you can start interacting with the DApp. Here’s how approving actions works securely with your BitBox02:

  1. Initiating Actions in the DApp: Go ahead and use the DApp's features – perhaps setting up a token swap, interacting with a DeFi protocol, or minting an NFT.
  2. The BitBoxApp Prompt: When you take an action in the DApp that requires blockchain confirmation (like submitting a transaction or signing a message to prove ownership), WalletConnect acts as the secure messenger. It forwards the request from the DApp to your open BitBoxApp. You'll see a pop-up or notification appear within the BitBoxApp, asking for your attention.
  3. The CRUCIAL Step: Verify on Your BitBox02!
    1. The BitBoxApp will now prompt you to check your connected BitBox02 hardware wallet. This is where the real security happens!
    2. Look closely at your BitBox02's built-in screen. It will display the critical details of the action you are about to approve.
    3. THIS IS THE MOST IMPORTANT STEP. Treat this verification with utmost seriousness. Carefully read every piece of information shown on the BitBox02's trusted display.
  4. The BitBoxApp will then broadcast the transaction to the Ethereum network.

Important: Always ensure that the BitBoxApp is open and your BitBox02 is connected when interacting with DApps. Each DApp must be connected individually to ensure proper authentication.

 

Conclusion

The WalletConnect integration within the BitBoxApp represents a powerful combination of the BitBox02's rock-solid hardware security and the convenience needed to engage with the rapidly evolving world of decentralized applications. It provides a fantastic way to explore DApps on supported networks like Ethereum, Arbitrum, Base, and Optimism, all while ensuring your critical private keys remain safely offline, protected by your BitBox02.

By understanding the connection process, diligently following the security steps – especially verifying everything on your BitBox02 device – you can confidently navigate the exciting possibilities of Web3.