Comment connecter Phantom Wallet à un DApp Solana

Comprendre l'intégration du portefeuille fantôme

1. Phantom Wallet fonctionne comme une interface non dépositaire qui permet une communication directe entre les clés privées contrôlées par l'utilisateur et les applications décentralisées basées sur Solana.

2. Son intégration repose sur le SDK Solana Web3.js , qui fournit des méthodes standardisées pour la détection de portefeuille, l'autorisation de compte et la soumission de transactions.

3. Le portefeuille expose un objet window.solana global dans les environnements de navigateur, permettant aux interfaces DApp de détecter sa présence sans dépendances externes.

4. L'initiation de la connexion déclenche un modal sécurisé qui demande l'approbation explicite de l'utilisateur avant d'exposer les informations de clé publique ou les capacités de signature.

5. Une fois connecté, le DApp reçoit une référence de clé publique en lecture seule : aucune clé privée ou phrase de départ ne quitte jamais l'appareil de l'utilisateur.

Flux de travail de connexion étape par étape

1. Un DApp doit d'abord vérifier si Phantom est installé en vérifiant l'existence de window.solana et en confirmant qu'il prend en charge la propriété isPhantom .

2. Les développeurs appellent solana.connect() , invitant l'extension Phantom à afficher une boîte de dialogue d'autorisation avec le contexte réseau et les étendues demandées.

3. Après confirmation de l'utilisateur, Phantom renvoie un objet contenant publicKey , account et chainId , permettant la dérivation d'adresse et les requêtes de solde.

4. Les interactions ultérieures nécessitent l'appel de solana.signTransaction() ou solana.signAllTransactions() , chacun invoquant la signature cryptographique locale dans le bac à sable du portefeuille.

5. Toutes les transactions signées sont sérialisées et soumises via le point de terminaison RPC configuré du DApp : Phantom lui-même ne les relaie ni ne les diffuse.

Considérations de sécurité pendant la connexion

1. Phantom applique une validation stricte de l'origine : les connexions provenant de domaines non enregistrés ou malveillants sont bloquées au niveau de l'extension.

2. Le portefeuille n’approuve jamais automatiquement aucune action ; chaque demande de signature nécessite une interaction manuelle de l'utilisateur, même pour des opérations répétées sur le même site.

3. La persistance de la session est limitée à l'onglet et au domaine actuels ; la fermeture de l'onglet ou la navigation mettent fin immédiatement à la connexion active.

4. L'affichage de l'adresse résistant au phishing garantit que les utilisateurs voient leur adresse SOL complète de 44 caractères dans le modal de confirmation, et non dans les versions tronquées ou obscurcies.

5. Les fonctionnalités de simulation de transactions permettent aux développeurs de pré-valider la logique des instructions avant de les soumettre, réduisant ainsi le risque d'échec ou d'opérations coûteuses.

Pièges courants de l’intégration

1. En supposant que Phantom soit disponible sur tous les navigateurs, Brave et Firefox nécessitent l'activation manuelle de l'extension même après l'installation.

2. Le codage en dur des points de terminaison RPC sans solutions de repli provoque des échecs lorsque le réseau sélectionné par l'utilisateur (réseau principal bêta, devnet, testnet) ne correspond pas à la configuration du DApp.

3. Ignorer les écouteurs d'événements disconnect conduit à des états d'interface utilisateur obsolètes où les indicateurs « Connecté » restent visibles malgré la fin de la session.

4. Toute tentative d'accès à solana.publicKey avant une connexion réussie entraîne des erreurs de référence nulle et une exécution interrompue du flux.

5. L'utilisation de versions Web3.js obsolètes introduit des ruptures de compatibilité avec le format de sérialisation des messages mis à jour de Phantom pour les transactions versionnées.

Foire aux questions

Q : Phantom peut-il se connecter à des chaînes non Solana au sein de la même session DApp ? Oui. Phantom prend en charge les réseaux Ethereum et Polygon. Le changement de chaîne déclenche une redérivation automatique de l'adresse et met à jour le champ chainId en conséquence.

Q : Phantom prend-il en charge le couplage de portefeuilles matériels lors de la connexion DApp ? Oui. Lorsque Ledger est connecté et que Phantom est configuré pour l'utiliser, toutes les opérations de signature sont acheminées via le périphérique Ledger au lieu du stockage de clés logiciel.

Q : Que se passe-t-il si un utilisateur refuse la demande de connexion ? La promesse renvoyée par solana.connect() est rejetée avec un WalletConnectionError et aucune clé publique ou donnée de session n'est exposée au DApp.

Q : Existe-t-il un moyen de détecter si Phantom est verrouillé ou nécessite la saisie d'un mot de passe avant d'établir la connexion ? Non. Phantom n'expose pas l'état interne tel que l'état du verrouillage. Le flux de connexion lui-même vous demandera de saisir un mot de passe si nécessaire et ne procédera qu'une fois l'authentification réussie.