How to use WalletConnect

Learn how to use WalletConnect to connect your mobile wallet to DeFi platforms and web Dapps, and make transactions on them.

WalletConnect illustration

What is WalletConnect?

WalletConnect is a convenient open source tool that enables a mobile wallet to easily connect to web-based blockchain applications, and interact with them from a smartphone.

How to use WalletConnect

This section shows you how to use WalletConnect from our mobile app Bridge Wallet, but the process is the same for any other mobile wallet that supports WalletConnect.

1: Open a web app

Open your browser and go to the website of the application that you want to use.

For this example, we go to app.paraswap.io but there are many other apps that you can use. See WalletConnect's website for the list of supported apps.

Paraswap web app

2: Choose WalletConnect

On most web apps like ParaSwap, you will find a "Connect Wallet" button, with "WalletConnect" as an option. Click on it and select it.

Paraswap connect wallet

3: Get the QR code

On a desktop browser, the website will show you a QR code that you will need to scan from your mobile wallet.

Paraswap WalletConnect QR code

4: Open WalletConnect in your mobile wallet

In Bridge Wallet, go to Settings > WalletConnect > Scan, then scan the QR code.

Bridge Wallet settings screen

5: You're connected!

You can now use the web app and make transactions. Most apps will require that you confirm transactions in your wallet, in such a case a request with the transaction detail will appear on the screen shown here and you will be able to approve or reject it.

Bridge Wallet WalletConnect screen

On mobile

If you open a web app on a mobile browser, you will simply see a "Connect" button after step 2. Click on it, and it will take you in your mobile wallet where you will be able to approve the connection request.

Paraswap mobile WalletConnect
Bridge Wallet WalletConnect Paraswap request

Troubleshooting common
WalletConnect issues

  • If you're seeing error messages on mobile, try using the web app on a desktop browser.
  • It's usually better to use web apps via WalletConnect while disabling ad blockers or similar browser plugins, which can cause interferences. You can also open the web app in private/incognito navigation mode.
  • If the connection to your wallet loads indefinitely, close everything, hard refresh your browser (ctrl-F5 / ⌘-shift-R) and start again.
  • "Waiting for request" means your wallet is properly connected to the web app, and that it is waiting for you to take an action there.
  • You must stay on your mobile wallet's WalletConnect screen while using the web app. If you leave that screen, you will be disconnected.

Have a question?

Check our FAQ

The most common questions that our clients ask us are all answered there. Have a look!

Contact us

We answer all your questions, and we answer them fast! Get in touch by email or through Bridge Wallet's contact form.