Skip to main content
Questa pagina descrive il flusso di pairing (abbinamento) da mobile: apri l’exchange in un browser desktop, l’app mostra un QR code e tu lo scansioni con l’app wallet sul telefono per stabilire una sessione di firma.

Il flusso normale

  1. Nel browser desktop, clicca «Connect wallet» e scegli l’opzione di pairing da mobile.
  2. L’app mostra un QR code con una finestra di validità breve.
  3. Apri l’app wallet sul telefono e usa il suo scanner integrato — non la fotocamera di sistema, a meno che il wallet non supporti i deep link dall’app fotocamera.
  4. Approva la richiesta di pairing che compare nel wallet.
  5. La scheda desktop passa allo stato connesso e chiede una firma di sessione.

Modi tipici in cui fallisce

La fotocamera non si apre. L’app wallet non ha il permesso per la fotocamera. Concediglielo dalle impostazioni del sistema operativo e riprova. Su iOS il permesso è sotto Impostazioni, poi Privacy, poi Fotocamera; su Android è sotto Info app, poi Autorizzazioni. Il QR code è scaduto prima che riuscissi a scansionarlo. I codici hanno vita breve per ragioni di sicurezza. Clicca «refresh» o «show new code» sul lato desktop e scansiona subito quello nuovo. Il wallet dice «pairing failed» oppure non succede proprio nulla. Il protocollo di pairing si appoggia a un server relay raggiungibile da entrambi i dispositivi. Se il telefono è su una Wi-Fi aziendale, sulla rete di un hotel o su una VPN che blocca il traffico WebSocket in uscita, il relay non riceverà mai nulla dal telefono. Passa il telefono alla rete cellulare, o a un’altra rete, e riprova. Il pairing riesce ma ogni azione fallisce. La sessione si è connessa, ma qualcosa nel percorso di firma non funziona. Le cause tipiche sono un wallet abbinato al conto sbagliato, un wallet che non supporta lo schema di firma di sessione (aggiornalo), oppure un telefono che è andato in sospensione e ha chiuso il relay in background. Annulla l’abbinamento dal lato wallet, riapri il wallet e ripeti il flusso.

Che cosa mandarci se niente di tutto questo funziona

Scrivi a contact@intention.xyz indicando:
  • Nome e versione del wallet mobile.
  • Sistema operativo e versione del telefono.
  • Browser desktop e versione.
  • Una foto o uno screenshot dell’errore mostrato sul telefono.
  • L’orario UTC approssimativo in cui hai tentato il pairing.
Possiamo incrociare l’orario con i log del relay per capire dove è fallito l’handshake.