Learn how to use WalletConnect to connect your mobile wallet to DeFi platforms and web Dapps, and make transactions on them.
5 minutes|Yann Gerardi|Published 2020-09-29|Updated 2024-06-13
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.
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".
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.
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.
5: Approve the request
Review and approve the connection request.
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.
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.
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".
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.
4: Approve the request
Review and approve the connection request.
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.
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.
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.
