Comment lier Phantom à une dApp ? (Portefeuille connecté)

Connecter Phantom Wallet à une dApp

1. Assurez-vous que Phantom est installé en tant qu'extension de navigateur ou application mobile sur l'appareil cible. Les navigateurs pris en charge incluent Chrome, Brave, Firefox et Edge. Les utilisateurs mobiles doivent avoir l'application iOS ou Android Phantom active et mise à jour vers la version 3.79.

2. Accédez à l'interface de la dApp à l'aide d'un navigateur compatible. Le site doit être servi via HTTPS et ne pas être signalé comme malveillant par les protocoles de sécurité du navigateur.

3. Localisez le bouton de connexion du portefeuille, généralement intitulé « Connecter le portefeuille », « Connecter » ou représenté par une icône de portefeuille près du coin supérieur droit de la page.

4. Cliquez sur le bouton et sélectionnez Phantom dans la liste affichée des portefeuilles disponibles. Si Phantom n'apparaît pas, actualisez la page ou vérifiez que l'extension est activée dans les paramètres du navigateur.

5. Une fenêtre contextuelle Phantom apparaîtra vous demandant l'autorisation d'accéder à votre adresse publique et au contexte réseau. Examinez attentivement les autorisations demandées avant de les approuver.

Portée des autorisations et comportement de la session

1. Phantom accorde un accès en lecture seule à la clé publique de votre portefeuille et au contexte de chaîne actuel (par exemple, le réseau principal Solana, Ethereum Sepolia) lors de la connexion initiale.

2. Aucune clé privée, phrase de départ ou capacité de signature de transaction n'est exposée lors de la connexion. La signature ne se produit que lorsqu'elle est explicitement déclenchée par une action de l'utilisateur au sein d'un flux de transaction.

3. Les sessions persistent lors des rechargements de pages, à moins qu'elles ne soient déconnectées ou révoquées manuellement via les paramètres du portefeuille interne de Phantom sous « Sites connectés ».

4. Chaque dApp reçoit un identifiant de session unique ; Phantom ne partage pas les données de session entre les domaines, ce qui impose une isolation stricte de l'origine.

5. La déconnexion d'une dApp n'a aucun effet sur les connexions établies avec d'autres dApp ou réseaux.

Gestion des inadéquations de réseau

1. Si le dApp fonctionne sur un réseau non pris en charge par votre configuration Phantom actuelle (par exemple, dApp utilise Polygon zkEVM mais Phantom est défini sur Solana), une alerte apparaît invitant à un changement de réseau manuel.

2. Phantom affiche un menu déroulant répertoriant toutes les chaînes prises en charge nativement : Solana, Ethereum, Polygon, Base, Sui et Bitcoin via des actifs enveloppés.

3. La sélection d'un nouveau réseau déclenche la reconfiguration automatique du point de terminaison RPC sans nécessiter de réimportation ou de réauthentification du portefeuille.

4. Les actifs natifs de la chaîne nouvellement sélectionnée apparaissent instantanément dans le panneau de balance s'ils sont déjà détenus ; sinon, l'interface affiche des soldes nuls jusqu'à ce que les dépôts soient effectués.

5. Toute tentative de signature d'une transaction sur un réseau incompatible entraîne un rejet immédiat par la couche de validation interne de Phantom avant toute génération de signature.

Dépannage des échecs de connexion courants

1. L'icône fantôme manquante dans la barre d'outils du navigateur indique que l'extension est désactivée, bloquée par des bloqueurs de publicités/trackers ou incompatible avec la version actuelle du navigateur.

2. Le mode de connexion vide ou gelé provient souvent d'une version obsolète de Phantom : vérifiez que la version actuelle est la version 3.79 via le journal des modifications officiel sur phantom.app/changelog .

3. Des erreurs de « connexion refusée » peuvent survenir lorsque le domaine dApp échoue à la validation DNSSEC ou est signalé comme phishing par le flux de renseignements sur les menaces intégré de MetaMask ou Phantom.

4. Les messages répétés de « signature invalide » après l'approbation indiquent généralement un décalage d'horloge supérieur à ± 30 secondes entre l'appareil et les serveurs NTP ; une heure système correcte résout ce problème instantanément.

5. Les utilisateurs de Safari mobile doivent activer manuellement le mode « Site de bureau » pour une compatibilité complète avec Phantom Web3, car iOS WebKit restreint certaines API d'injection de portefeuille dans la vue mobile.

Foire aux questions

Q : Puis-je connecter Phantom à une dApp sans révéler l'adresse de mon portefeuille ? R : Non. La divulgation de l’adresse publique est obligatoire pour l’interaction avec dApp. Phantom ne partage jamais de clés privées ou de phrases de départ, mais la clé publique doit être visible pour établir l'identité et valider les signatures.

Q : La connexion à une dApp lui permet-elle de drainer mes fonds ? R : Non. Le raccordement à lui seul ne confère aucune autorisation de dépenser. Les fonds ne peuvent être déplacés qu'après confirmation explicite de l'utilisateur de chaque transaction signée via l'interface utilisateur sécurisée de Phantom.

Q : Pourquoi Phantom affiche-t-il parfois « Chaîne non prise en charge » même si la dApp revendique la compatibilité avec Solana ? R : Le dApp peut être configuré pour le devnet ou le testnet Solana pendant que Phantom est verrouillé sur le réseau principal, ou vice versa. Vérifiez la cohérence de l'ID de chaîne dans la configuration frontale de dApp et dans le sélecteur de réseau de Phantom.

Q : Puis-je utiliser Phantom pour me connecter à une dApp hébergée sur localhost pendant le développement ? R : Oui, à condition que le serveur local fonctionne via HTTPS avec des certificats valides ou utilise la gestion des exceptions localhost activée dans les paramètres du développeur de Phantom.