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.

Clock icon5 minutes|Yann Gerardi|Published 2020-09-29|Updated 2024-09-27

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, in the main app menu click on the magic button and then on the WalletConnect icon. Click on the "Scan" button, and scan the QR code displayed on your computer screen.

Bridge Wallet magic menu WalletConnect

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.
  • Make sure that you have the latest version of your wallet app installed on your phone.
  • Make sure to have the same chain selected in both your mobile wallet and on the website that you're trying to connect to.
  • You must have enough funds in your wallet to pay for transactions fees, otherwise you won't be able to initiate a transaction via WalletConnect. More information about transaction fees here.
  • If the connection loads indefinitely, disconnect everything, refresh the web page (ctrl-F5 / ⌘-shift-R) and try connecting again. You may have to do that a few times until it works.
  • 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 still doesn't work, try using a different web browser.
  • If the connection still doesn't work, try opening the web app from a desktop browser.
  • "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.
Yann Gerardi photo

About the author

Yann Gerardi

Yann is the head of marketing of Mt Pelerin. He fell down the rabbit hole of crypto at the end of 2017, when he joined the assembling team that would give birth to Mt Pelerin.

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.