Start the transaction on one vault device. It shows a QR code. Scan the code with another device of the same vault, check the details, tap Join Keysign, then confirm on the first device.
On this page
Every transaction from a vault needs the required number of devices. One device prepares the transaction, the others join it by scanning a QR code.
Before you start
- Have the required number of devices at hand: 2 of 2, 2 of 3 or 3 of 4.
- Each device must be online, with THORWallet open and the same vault selected.
- The vault needs enough of the chain's coin to pay the network fee.
Steps
- On the first device, select the vault and prepare the transaction as usual, for example a send or a swap. Review it and confirm.
- A sheet opens with a QR code and the line Scan with your Paired device. Below it the app shows Looking for devices.
- On a second device, open THORWallet and select the same vault. Tap the scan icon at the top of the Wallet screen and scan the QR code.
- The second device opens the Keysign screen with the transaction details. Check the addresses and the amount, then tap Join Keysign.
- On the first device, the second device now appears with a check mark. If your vault needs more devices, repeat steps 3 and 4 with them.
- On the first device, tap the action button at the bottom of the sheet, for example Send or Swap.
- Keep THORWallet open on all devices until the first device shows the transaction result.
If the devices are not in the same room, tap the share icon on the QR sheet and send the image to the other device. There, open the scanner and choose Upload from Gallery or Upload from Files.
Only scan or open a code that comes from your own device. Never join a vault or co-sign because another person sent you a code or a link. Support never sends one.
What the second device checks
The device that joins does not sign blindly. Before you tap Join Keysign, compare the recipient address and the amount with what you entered on the first device. If anything differs, do not join.
THORWallet also refuses a request when the details it receives do not match the QR code. In that case nothing is signed and you start again.
WalletConnect and the web app
A vault can connect to other apps and to the THORWallet web app through WalletConnect. Each request opens the same QR sheet and is signed the same way.
THORWallet may refuse a request it considers unsafe. The app then tells you that nothing was signed.
If something goes wrong
The first device keeps showing "Looking for devices"
The other device has not joined yet. Check that it is online, that the same vault is selected and that you tapped Join Keysign.
"This QR code is not a signing request for this vault"
The scanning device has another wallet selected, or you scanned a different code. Select the vault and scan the code shown on the device that started the transaction.
More cases are in Vault troubleshooting. Support will never ask for your recovery phrase, your vault backup files or their passwords.
Related
Common questions
Do my devices need to be in the same place?
No. The first device can share the QR code as an image, and the other device can load that image in the scanner. Only use a code that comes from your own device.
How many devices must take part?
At least two thirds of the vault's devices, counting the one that starts. In a 2 of 3 vault, one other device must join.
Where is the scan button?
At the top of the Wallet screen. It is only shown while a vault is the selected wallet.
Can the second device see what it signs?
Yes. The Keysign screen shows the sender, the recipient, the amount and the value before you join.
What if nothing happens after I join?
Keep THORWallet open on all devices and wait. If it does not finish, close the request and start it again on the first device. Check Activity first so you do not send twice.
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.