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 "Connect wallet" then select "WalletConnect".

Paraswap connect wallet

3: 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 displayed on your computer screen.

Bridge Wallet settings screen

5: Approve the request

Review and approve the connection request.

Bridge Wallet WalletConnect request screen

6: You're connected!

You can now use the web app and make transactions. When you do, you will need to approve transactions on this screen of your wallet so keep it open to avoid losing your connection to the web app.

Bridge Wallet WalletConnect screen

How to use WalletConnect on mobile

This section shows you how to use WalletConnect if you open a web app from a mobile browser.

1: Open a web app

Open your phone's mobile 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 mobile 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 "Connect wallet" then select "WalletConnect".

Paraswap mobile connect wallet

3: Click on "Select Wallet"

If you have a crypto wallet installed on your phone, clicking on "Select Wallet" will open it and directly bring you on its WalletConnect screen.

Paraswap mobile select wallet

4: Approve the request

Review and approve the connection request.

Bridge Wallet WalletConnect request screen

5: You're connected!

You can now use the web app and make transactions. When you do, you will need to approve transactions on this screen of your wallet so keep it open to avoid losing your connection to the web app.

Bridge Wallet WalletConnect screen

Troubleshooting common
WalletConnect issues

  • The current WalletConnect version is v2. Some web dapps still use WalletConnect v1, which is not supported anymore and will result in an error message on your mobile wallet. In such case, you will need to use another web dapp.
  • 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 interference. 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.