Comment connecter Trust Wallet à une dApp Web3 sans exposer votre phrase de récupération ?

Comprendre les mécanismes d'intégration du portefeuille de confiance

1. Trust Wallet fonctionne comme un portefeuille mobile non dépositaire qui implémente nativement le protocole WalletConnect v2. Il ne repose pas sur l’injection du navigateur comme les extensions de bureau.

2. Le flux de connexion démarre à partir de l'interface dApp, qui génère une proposition de session contenant les ID de chaîne, les autorisations demandées et les métadonnées telles que le nom et le logo de l'application.

3. Un code QR ou un lien profond transporte un URI de session crypté limité à un serveur relais spécifique. Cet URI ne contient aucun élément de clé privée ni aucune donnée de phrase de récupération.

4. Lors de l'analyse, Trust Wallet déchiffre la demande de session à l'aide de sa clé d'appariement stockée localement et valide l'intégrité du domaine via la signature du relais.

5. Une fois approuvé, le portefeuille établit un canal crypté de bout en bout avec la dApp via le relais, permettant un échange sécurisé de messages JSON-RPC sans exposer les phrases de départ.

Architecture de sécurité de session WalletConnect v2

1. Chaque session utilise des clés symétriques éphémères dérivées de l'échange de clés ECDH entre dApp et wallet. Ces clés sont supprimées après la fin de la session.

2. Le serveur relais ne voit jamais les charges utiles décryptées : tous les messages sont cryptés AES-256-GCM avant leur transmission.

3. Les propositions de session incluent des champs de métadonnées d'homologue obligatoires : appUrl , appIcon et appDescription , empêchant l'usurpation d'identité de domaine.

4. Trust Wallet applique une validation stricte de l'origine : il recoupe le domaine de la dApp avec le redirectUri enregistré lors du lancement de la session.

5. Aucune opération cryptographique impliquant la phrase de récupération n'a lieu pendant la connexion. Les demandes de signature sont traitées exclusivement dans l'enclave sécurisée du portefeuille après approbation.

Mauvaises configurations courantes qui risquent d'être exposées

1. L'utilisation de ponts WalletConnect v1 obsolètes introduit des vulnérabilités de négociation non chiffrées et manque d'application des liaisons de domaine.

2. Le codage en dur des URI spécifiques au portefeuille (par exemple, trust:// ) contourne la couche de découverte standardisée de WalletConnect et peut déclencher une gestion d'intention dangereuse sur Android.

3. Ne pas valider l'objet sessionNamespaces entraîne une escalade des autorisations - par exemple, accepter les méthodes Ethereum tout en étant connecté à une chaîne Solana.

4. Le stockage des clés de session dans localStorage au lieu de contextes de mémoire uniquement permet aux scripts malveillants de détourner les sessions actives.

5. La mise en œuvre de scanners QR personnalisés en dehors du SDK officiel de Trust Wallet augmente le risque d'interception de l'homme du milieu lors de l'analyse de l'URI.

Garanties de mise en œuvre côté client

1. Initialisez toujours WalletConnect avec projectId lié à votre identité dApp vérifiée sur le tableau de bord WalletConnect Cloud.

2. Appliquez requisNamespaces pour restreindre les méthodes RPC - par exemple, refusez explicitement eth_signTypedData_v4 à moins que l'interaction contractuelle ne soit confirmée.

3. Utilisez le SDK web3wallet uniquement pour le couplage initié par le portefeuille ; évitez d'intégrer @walletconnect/modal dans des contextes où le sandboxing iframe est désactivé.

4. Vérifiez la cohérence de l'ID de chaîne entre la charge utile sessionEvent et web3.eth.getChainId() avant d'envoyer toute demande de transaction.

5. N'appelez jamais eth_requestAccounts plus d'une fois par session : des appels répétés peuvent déclencher des invites de signature redondantes et accroître la confusion dans l'interface utilisateur.

Foire aux questions

Q : Trust Wallet peut-il divulguer ma phrase de récupération si j'approuve une dApp malveillante ? R : Non. Les phrases de récupération ne sont jamais transmises, traitées ou référencées pendant les sessions WalletConnect. L’approbation accorde uniquement des autorisations de signature étendues.

Q : La numérisation d'un code QR WalletConnect permet-elle à la dApp d'accéder à l'historique des transactions de mon portefeuille ? R : Uniquement si cela est explicitement demandé via eth_getLogs ou des méthodes de lecture similaires – et même dans ce cas, les résultats sont filtrés par plage de blocs et adresse de contrat définies dans la demande.

Q : Pourquoi Trust Wallet affiche-t-il parfois « DApp inconnue » lors de la connexion ? R : Cela se produit lorsque la dApp ne parvient pas à fournir une appUrl ou une appIcon valide dans la proposition de session, déclenchant l'avertissement de sécurité de secours de Trust Wallet.

Q : Est-il sûr de connecter Trust Wallet à une dApp exécutée sur localhost ? R : Oui, à condition que le serveur local utilise HTTPS ou soit servi via 127.0.0.1 avec le mode de développement de WalletConnect activé – les deux empêchent la fuite des URI de session sur le réseau externe.