Come usare WalletConnect
Guida passo dopo passo per utilizzare WalletConnect nel 2026 e connettere facilmente qualsiasi wallet mobile a DEX e altre app DeFi per effettuare transazioni.
5 minuti|Yann Gerardi|Pubblicato il 29.09.2020|
Cos'è WalletConnect?
WalletConnect è un pratico strumento open source che consente a qualsiasi wallet cripto mobile di stabilire facilmente una connessione sicura con applicazioni decentralizzate (dApp) accessibili via browser web, e di interagire con esse da uno smartphone.
Come funziona WalletConnect?
WalletConnect funziona creando una connessione sicura e crittografata tra il suo wallet mobile e un'applicazione web, senza mai esporre le sue chiavi private.
Ecco cosa avviene in background quando connette il suo wallet a un'app DeFi tramite WalletConnect:
- La dApp genera un QR code univoco o, su mobile, un deep link contenente una richiesta di connessione monouso.
- Il suo wallet scansiona il QR code e stabilisce una sessione crittografata peer-to-peer con la dApp tramite il server di WalletConnect.
- Il server funge da ponte: trasmette i messaggi tra il suo wallet e la dApp, ma non ha mai accesso alle sue chiavi private né ai suoi fondi.
- Ogni transazione deve essere approvata manualmente nel suo wallet. La dApp può richiedere una transazione, ma non accade nulla finché non preme il pulsante «Approva».
Le sue chiavi private non lasciano mai il suo dispositivo. WalletConnect consente alle dApp soltanto di inviarle richieste — lei mantiene sempre il pieno controllo di ciò che firma e di ciò che approva. Per questo è molto importante verificare sempre con attenzione ciò che sta approvando.
Come usare WalletConnect?
Il tutorial qui sotto le mostra come usare WalletConnect dalla nostra app mobile Bridge Wallet, ma la procedura è identica per qualsiasi altro wallet mobile che supporti WalletConnect.
1: Apra un'applicazione DeFi nel suo browser web
Apra il suo browser web e acceda al sito dell'applicazione DeFi che desidera utilizzare, ad esempio un exchange decentralizzato, un protocollo di prestito o un servizio di bridge.
Si assicuri di essere sull'URL ufficiale dell'applicazione. Non clicchi su link non verificati provenienti da e-mail, social media o annunci nei risultati di ricerca. Digiti sempre l'indirizzo ufficiale direttamente o lo aggiunga ai preferiti per evitare il phishing.
Per questo esempio, accediamo a app.velora.xyz ma la procedura è identica per qualsiasi altra app DeFi.
2: Clicchi su «Connect Wallet» sulla dApp
Trovi e clicchi sul pulsante «Connect Wallet» o «Connect» sull'applicazione DeFi. Di solito si trova nell'angolo in alto a destra dell'interfaccia. Apparirà una finestra di selezione del wallet con i metodi di connessione disponibili.
3: Selezioni WalletConnect tra le opzioni di connessione
Nella finestra di selezione del wallet, scelga WalletConnect. Se desidera connettere il suo wallet mobile, non selezioni un'opzione per estensione del browser (come l'estensione MetaMask) — scelga specificamente WalletConnect. A quel punto apparirà un QR code sullo schermo.
4: Scelga l'opzione WalletConnect
Se ha aperto la dApp web da un browser desktop, WalletConnect le mostrerà un QR code da scansionare. Se l'ha aperta da un browser mobile, le mostrerà un elenco di wallet compatibili: trovi il suo e clicchi su di esso.
5: Apra WalletConnect nel suo wallet mobile
Se ha scelto l'opzione QR code, apra la sua app wallet mobile e individui la funzione WalletConnect o lo scanner per QR code, quindi scansioni il QR code. In Bridge Wallet, questa funzione è accessibile tramite l'icona WalletConnect nella schermata principale o dal magic menu. La posizione esatta varia a seconda dell'app wallet.
6: Esamini e approvi la richiesta di connessione
Il suo wallet mostrerà una richiesta di connessione con il nome e l'URL della dApp che richiede l'accesso, insieme a una breve descrizione dell'app. Verifichi che il nome e l'URL della dApp corrispondano esattamente al sito che ha aperto al passaggio 1 — questa è la sua ultima linea di difesa contro il phishing. Se tutto corrisponde, prema «Approva». Connettere il suo wallet non autorizza la dApp a spostare i suoi fondi: condivide soltanto il suo indirizzo wallet pubblico.
7: È ora connesso
Dopo aver approvato la connessione nel suo wallet, torni al browser web. La dApp dovrebbe ora mostrare il suo indirizzo wallet nell'angolo in alto a destra, confermando che la connessione è attiva. Può ora interagire con la dApp per effettuare scambi, prestiti, staking o qualsiasi altra azione disponibile. Ogni transazione che avvierà sulla dApp richiederà un'approvazione separata nel suo wallet mobile — lo tenga quindi aperto sulla schermata WalletConnect.
8: Si disconnetta al termine
Quando ha finito di utilizzare la dApp, disconnetta il suo wallet invece di chiudere semplicemente la scheda del browser, per una maggiore sicurezza. Sulla schermata WalletConnect della sua app mobile, clicchi sul pulsante «Disconnetti». Può farlo anche dalla dApp: clicchi sul suo indirizzo wallet o sull'icona del wallet connesso e selezioni «Disconnetti».
Domande frequenti
WalletConnect serve a connettere un wallet cripto mobile ad applicazioni decentralizzate (dApp) accessibili via browser web, senza bisogno di un'estensione del browser. Viene utilizzato principalmente per accedere a exchange decentralizzati (DEX), protocolli di prestito, marketplace NFT e altre piattaforme DeFi direttamente dal suo wallet mobile. WalletConnect funziona su un'ampia gamma di reti blockchain, tra cui Ethereum, Polygon, BNB Chain, Arbitrum e molte altre, rendendolo uno degli standard di connessione più diffusi nell'ecosistema Web3.
WalletConnect funziona con Ethereum e l'intero suo ecosistema di chain EVM, reti layer-2 e sidechain. Supporta inoltre Bitcoin, Solana, SUI, Stacks, TON, Tron, ADI Chain e Canton.
Più di 70.000 applicazioni supportano WalletConnect, quindi non è possibile elencarle tutte. Può tranquillamente partire dal presupposto che tutte le app DeFi supportino WalletConnect.
Sì, WalletConnect è sicuro da utilizzare. Crea una connessione crittografata peer-to-peer tra il suo wallet e la dApp. Le sue chiavi private non lasciano mai il suo dispositivo in nessun momento del processo. Il server di WalletConnect si limita a trasmettere messaggi crittografati tra le due parti e non ha accesso ai suoi fondi. Ogni transazione deve essere esaminata e approvata manualmente nel suo wallet prima di essere eseguita sulla blockchain.
Detto questo, WalletConnect è sicuro soltanto nella misura in cui lo è la dApp a cui si connette. Se si connette a un sito di phishing e approva una richiesta malevola, perderà dei fondi. Per evitarlo, verifichi sempre che l'URL della piattaforma a cui si sta connettendo sia quello ufficiale prima di approvare qualsiasi transazione, e disconnetta il suo wallet dalle dApp che non utilizza più.
È inoltre buona pratica esaminare periodicamente tutte le approvazioni passate e rimuovere quelle non più utili. Può farlo su revoke.cash o direttamente su blockchain explorer come etherscan.io.
La procedura dipende dal fatto che stia utilizzando un computer desktop o un dispositivo mobile.
Da desktop: Apra la dApp nel suo browser e clicchi sul pulsante "Connect Wallet". Selezioni WalletConnect dall'elenco delle opzioni. Apparirà un QR code. Apra il suo wallet mobile, acceda alla sezione WalletConnect o allo scanner QR e scansioni il codice. La connessione viene stabilita istantaneamente.
Da mobile: Apra la dApp nel suo browser mobile e prema "Connect Wallet", poi selezioni WalletConnect. Al posto di un QR code, vedrà un elenco di wallet compatibili o un deep link che apre direttamente la sua app wallet. Confermi la connessione nel suo wallet.
In entrambi i casi, il suo wallet le chiederà di approvare la connessione prima che qualsiasi dApp possa inviarle richieste di transazione.
Deve rimanere sulla schermata WalletConnect del suo wallet mobile mentre utilizza l'applicazione web a cui è connesso. Se lascia quella schermata, verrà disconnesso.
Questo può verificarsi per diversi motivi. Per risolvere il problema, provi le seguenti operazioni:
- Si assicuri di aver installato l'ultima versione disponibile del suo wallet cripto mobile.
- Disconnetta il suo wallet, forzi il ricaricamento della pagina web (Ctrl+F5 / ⌘+Maiusc+R) e tenti di connettersi nuovamente. Potrebbe dover ripetere questa operazione alcune volte prima che funzioni.
- Verifichi se ha attivi ad blocker o plugin del browser simili che potrebbero interferire, e provi a disattivarli.
- Provi ad aprire l'applicazione web in modalità di navigazione privata o in incognito.
- Provi ad aprire l'applicazione web su un browser diverso.
- Se sta utilizzando un browser mobile, provi ad accedere all'applicazione web da un browser desktop.
Se riceve un messaggio di errore "wrong chain" o "unsupported network" durante la scansione di un QR code WalletConnect, significa che la dApp richiede di scansionare il codice da una rete specifica. Verifichi di quale rete si tratta e passi alla rete corretta nella sua app mobile prima di riprovare. Se non viene indicata alcuna rete, passi alla mainnet di Ethereum e riprovi.
Se la schermata WalletConnect nel suo wallet mobile mostra "In attesa di una richiesta" o un messaggio simile, significa semplicemente che il suo wallet è correttamente connesso all'applicazione web e che è in attesa che lei esegua un'azione su di essa.
Può terminare una sessione WalletConnect da entrambi i lati: dal suo wallet o dalla dApp.
Dal suo wallet: Apra la sua app wallet e acceda alla sezione WalletConnect o alle app connesse. Vedrà un elenco di tutte le sessioni attive. Prema sulla sessione che desidera terminare e selezioni "Disconnettare".
Dalla dApp: La maggior parte delle dApp mostra un indicatore del wallet connesso nell'angolo in alto a destra dell'interfaccia. Clicchi su di esso e selezioni "Disconnect" o "Logout".
È buona pratica di sicurezza disconnettersi dalle dApp che non utilizza più. Le sessioni WalletConnect attive possono continuare a inviarle richieste di transazione finché non vengono chiuse esplicitamente. Disconnettersi garantisce che non vengano effettuate ulteriori richieste senza un suo intervento.
No, WalletConnect è progettato per funzionare con un'app wallet mobile installata sul suo smartphone. Quando si connette tramite WalletConnect su desktop, il QR code deve essere scansionato da un'app wallet compatibile sul suo telefono. Senza un wallet mobile, la connessione non può essere completata.
Se preferisce connettersi direttamente dal browser desktop senza utilizzare il telefono, un wallet come estensione del browser, ad esempio MetaMask o Rabby Wallet, è un'opzione più pratica per questo caso d'uso.
Detto questo, se sta utilizzando una dApp nel suo browser mobile, WalletConnect può aprire direttamente la sua app wallet mobile tramite un deep link. In quel caso non è necessaria la scansione di alcun QR code.
Le sessioni WalletConnect hanno un tempo di scadenza automatico integrato. Per impostazione predefinita, le sessioni durano generalmente fino a 7 giorni, sebbene alcuni wallet come Bridge Wallet possano impostare durate più brevi. La maggior parte dei wallet le mostra la durata di una connessione. Una volta scaduta la sessione, la connessione tra il suo wallet e la dApp viene chiusa automaticamente e dovrà riconnettersi.
Una sessione può anche scadere o disconnettersi prima del previsto se:
- La connessione internet del suo telefono è stata interrotta
- La dApp è stata aggiornata o ridistribuita
- La sua app wallet è stata chiusa forzatamente oppure la sessione è stata cancellata dalla memoria
Per riconnettersi, torni semplicemente alla dApp e ripeta il processo di connessione: clicchi su "Connect Wallet", selezioni WalletConnect e scansioni il QR code oppure approvi il deep link nel suo wallet.
