On the wallet home screen tap Connect, choose WalletConnect, then scan the QR code the dapp shows or paste its code. THORWallet shows every request from the dapp and nothing is signed until you tap Approve.
On this page
WalletConnect links THORWallet to other apps and websites (dapps), so you can use them with the funds in your own wallet. The dapp sends requests. You review and approve each one in THORWallet.
Before you start
- Open the dapp from a link you trust and check its address in the browser.
- Select the wallet you want to connect. A seed wallet and a vault can connect. A watch-only wallet cannot.
- Keep a small amount of the network's coin for fees.
Connect
- On the wallet home screen, tap Connect.
- Tap WalletConnect.
- In the dapp, choose WalletConnect. It shows a QR code and a copy button.
- In THORWallet, tap the QR button and scan the code. Or copy the code in the dapp, tap the copy button in THORWallet, paste it under Enter a WalletConnect URI and tap Connect.
- THORWallet shows which app wants to connect. Check the name and the address, then tap Approve.
You can also open the same screen from Settings, WalletConnect.
The second option in the list, THORWallet Connect, is a different feature. It links an app you use yourself, so that it can propose transactions for your review. Use it only with an app you opened yourself. Never enter a connection key that someone sends you.
In the web app: to use your mobile wallet on app.thorwallet.org, choose Connect Wallet, then THORWallet, and scan the QR code with the mobile app in the same way.
Review requests
When the dapp asks for a transaction or a signature, THORWallet opens a sheet with the details: what is sent, to which address, on which network and the network fee. Tap Approve to sign or Reject to decline.
- THORWallet warns you about risky requests. Read the warning before you decide.
- If THORWallet cannot show you what a request does, reject it.
- THORWallet may refuse a request it considers unsafe. The app then tells you that nothing was signed.
A site name marked Potential threat, Invalid domain or Cannot verify is a reason to stop. Leave the site if you did not expect the warning.
Supported networks
A seed wallet can connect on EVM networks such as Ethereum, Arbitrum, Base, BNB Chain and Avalanche, on Bitcoin and similar chains, on Cosmos chains including THORChain and Maya, and on Solana, Sui, TRON, XRP Ledger, Stellar and NEAR. A vault can connect on most of these networks, but not on NEAR. Which networks you can use also depends on the dapp.
Disconnect
- Open Settings, then WalletConnect. The screen lists the connected apps.
- Tap an app to open Session Details.
- Tap Delete.
To remove every connection at once, tap Reset at the top right. This disconnects all dapps and clears the WalletConnect data on this device.
If something goes wrong
The code does not pair
The code expires quickly. Reload the dapp for a new code and scan again. If you see There was an error pairing several times, tap Reset and restart the app.
"This dApp is connected to a different account"
The dapp was connected with another wallet. Switch back to that wallet in THORWallet, or disconnect and connect again.
The request expired
Nothing was signed. Start the action again in the dapp and approve it sooner. With a vault, have your other devices ready before you start.
"Your transaction was sent, but we could not notify the app"
The transaction is on its way. Check Activity before you try again, so you do not send it twice.
Support will never ask for your recovery phrase, and no dapp needs it to connect.
Related
Common questions
Can a connected dapp move my funds without me?
No. A dapp can only send requests. Every transaction and every signature appears in THORWallet and is sent only after you approve it.
How do I disconnect a dapp?
Open Settings, tap WalletConnect, tap the connected app and tap Delete. To disconnect every app at once, tap Reset at the top of the WalletConnect screen.
Why does WalletConnect not pair?
The code may have expired or old connection data may be in the way. Reload the dapp to get a new QR code. If it still fails, tap Reset on the WalletConnect screen and try again.
Does WalletConnect work with a vault?
Yes. A vault can connect, and each request is signed by your vault devices together. A watch-only wallet cannot connect because it has no key.
Do I need WalletConnect to swap or lend?
Often not. Swaps, lending and staking are built into THORWallet, so you only need WalletConnect for other apps.
Thank you.
Sorry about that. Chat with support inside the app, or write to info@thorwallet.org. Support will never ask for your recovery phrase.