Skip to main content
This page covers the mobile pairing flow: you open Intention Exchange (app.intention.xyz) in a desktop browser, the app shows a QR code, and you scan it with a wallet app on your phone to establish a signing session.
Intention Exchange has not yet launched to mainnet. The behavior described here is the planned pairing flow. Exact error messages may change before release.

​
The normal flow

  1. In the desktop browser, click “Connect wallet” and choose the mobile pairing option.
  2. The app displays a QR code with a short validity window.
  3. Open your wallet app on the phone and use its built-in scanner — not the system camera, unless your wallet supports deep links from the camera app.
  4. Approve the pairing request that appears in the wallet.
  5. The desktop tab transitions to the connected state and asks for a session signature.

​
Common failure modes

The camera does not open. Your wallet app does not have camera permission. Grant it from the operating system settings and try again. On iOS the permission is under Settings to Privacy to Camera; on Android it is under App info to Permissions. The QR code expired before you could scan it. The codes are short-lived for security reasons. Click “refresh” or “show new code” on the desktop side and scan the fresh one promptly. The wallet says “pairing failed” or nothing happens at all. The pairing protocol relies on a relay server reachable from both devices. If your phone is on a corporate Wi-Fi, a hotel network, or a VPN that blocks outbound WebSocket traffic, the relay will never hear from the phone. Switch the phone to cellular, or to a different network, and try again. Pairing succeeds but every action fails. The session did connect, but something on the signing path is broken. The usual causes are a wallet that is paired to the wrong account, a wallet that does not support the session signature scheme (update it), or a phone that has gone to sleep and disconnected the relay in the background. Unpair from the wallet side, reopen the wallet, and run through the flow again.

​
What to send us if none of this works

Email support@intention.xyz with:
  • The name and version of your mobile wallet.
  • The phone’s operating system and version.
  • The desktop browser and version.
  • A photo or screenshot of the error shown on the phone.
  • The approximate UTC time you attempted the pairing.
We can cross-reference the time against relay logs to see where the handshake failed.