Comment utiliser WalletConnect pour lier des DApps ? (Intégration multiplateforme)

Comprendre les mécanismes du protocole WalletConnect

1. WalletConnect fonctionne comme un protocole open source qui établit une communication sécurisée et cryptée entre les applications décentralisées et les portefeuilles de crypto-monnaie sur tous les appareils.

2. Il utilise un serveur pont pour relayer les charges utiles sans accéder aux clés privées ou aux détails des transactions, préservant ainsi la souveraineté des utilisateurs sur les actifs.

3. La poignée de main commence lorsqu'un DApp génère un code QR contenant une proposition de session avec l'ID de chaîne, les métadonnées et les autorisations requises.

4. Un portefeuille compatible scanne le code QR, valide l'origine et invite l'utilisateur à approuver ou rejeter la demande de connexion.

5. Après approbation, une clé de cryptage symétrique est échangée, permettant la transmission de messages cryptés de bout en bout pour les demandes de signature et les notifications d'événements.

Étapes d'intégration du portefeuille mobile

1. Les utilisateurs doivent installer un portefeuille mobile compatible WalletConnect tel que MetaMask Mobile, Trust Wallet ou Rainbow.

2. Lancez l'application de portefeuille et accédez à la section « DApp Browser » ou « WalletConnect », généralement accessible via le menu latéral ou l'icône de l'écran d'accueil.

3. Appuyez sur le bouton du scanner QR et alignez la caméra avec le code QR affiché du DApp sur le bureau ou la tablette.

4. Après l'analyse, le portefeuille affiche le nom du DApp, les chaînes demandées et les autorisations, telles que l'exposition du compte ou les droits de signature de transaction.

5. Confirmez la connexion manuellement ; le portefeuille attribue ensuite un identifiant de session unique et partage son adresse publique et les identifiants de chaîne EIP-155 pris en charge avec le DApp.

Exigences de configuration de DApp de bureau

1. Les développeurs intègrent le SDK WalletConnect v2.0 dans leur interface à l'aide de packages npm tels que @walletconnect/web3-provider ou @walletconnect/modal.

2. Le DApp initialise une instance client avec un ID de projet obtenu à partir du tableau de bord WalletConnect Cloud, qui remplace les URL de pont héritées.

3. La configuration de la session comprend la spécification des chaînes requises (par exemple, 1 pour Ethereum Mainnet, 137 pour Polygon), les espaces de noms facultatifs facultatifs et les événements auxquels s'abonner.

4. Lorsque les utilisateurs cliquent sur « Connecter le portefeuille », le DApp déclenche l'interface utilisateur modale, affichant le code QR et les options de liens profonds pour les portefeuilles mobiles.

5. Une fois connecté, le DApp reçoit un objet fournisseur capable de gérer les appels eth_requestAccounts, eth_sendTransaction et personal_sign via le réseau de relais.

Considérations de sécurité lors de l'utilisation multiplateforme

1. Les sessions WalletConnect ne stockent pas de clés privées sur des serveurs distants : les clés de chiffrement sont dérivées localement à l'aide de HKDF-SHA256 à partir de l'entropie partagée.

2. Chaque session applique la liaison de domaine : le portefeuille vérifie l'origine du DApp par rapport à l'URL intégrée dans la proposition de session pour empêcher les relais de phishing.

3. Le couplage limité dans le temps garantit que les sessions expirent après sept jours d'inactivité, à moins qu'elles ne soient prolongées manuellement par une ré-authentification.

4. Les demandes de signature de transaction incluent une inspection complète de la charge utile dans l'interface utilisateur du portefeuille, indiquant les paramètres du destinataire, de la valeur, des données et du gaz avant l'approbation.

5. Les portefeuilles doivent rejeter les propositions de session non signées provenant de domaines non vérifiés ou d'identifiants de chaîne incompatibles pour empêcher les attaques d'usurpation d'identité entre chaînes.

Foire aux questions

Q : WalletConnect peut-il se connecter directement aux portefeuilles matériels ? R : Non. Les portefeuilles matériels nécessitent un logiciel intermédiaire tel que MetaMask Desktop ou Rabby qui prend en charge WalletConnect comme couche relais. Le périphérique matériel lui-même n'exécute pas le client WalletConnect.

Q : Que se passe-t-il si le relais cloud WalletConnect se déconnecte ? R : Les sessions restent actives car les clés de chiffrement et l'état sont stockés localement aux deux extrémités. Seuls les nouveaux appariements et diffusions d’événements dépendent de la disponibilité des relais.

Q : Est-il possible de connecter plusieurs portefeuilles à un seul DApp simultanément à l'aide de WalletConnect ? R : Oui. Chaque portefeuille établit une session indépendante avec son propre espace de noms, comptes et autorisations. Le DApp les gère séparément via des instances de fournisseur distinctes.

Q : Toutes les chaînes compatibles EVM fonctionnent-elles immédiatement avec WalletConnect v2 ? R : Pas automatiquement. Les chaînes doivent être explicitement déclarées dans la configuration de l'espace de noms de session. Les chaînes non prises en charge déclenchent le rejet à moins qu'elles ne soient ajoutées à la liste optionnelleNamespaces avec les points de terminaison RPC appropriés.