Comment réparer le portefeuille Phantom qui ne se charge pas sur Firefox ?

Dépannage des problèmes d'intégration du portefeuille fantôme

1. Le portefeuille Phantom s'appuie sur l'injection d'extensions de navigateur pour interagir avec les dapps basées sur Ethereum. Lorsqu'elles sont utilisées avec Firefox, certaines politiques de sécurité et mécanismes de blocage de contenu peuvent empêcher le script du portefeuille de s'initialiser correctement.

2. Firefox applique des règles strictes de politique de sécurité du contenu (CSP) sur les sites Web qui hébergent des scripts intégrés. Si un site dapp sert la logique d'injection du fournisseur de Phantom via un domaine non autorisé ou enfreint les directives CSP, le portefeuille ne parvient pas à s'attacher à window.ethereum.

3. Les extensions Firefox doivent être explicitement autorisées à s'exécuter sur des sites spécifiques. Phantom nécessite que les options « Exécuter dans une fenêtre privée » et « Autoriser l'accès aux URL des fichiers » soient activées. Si l'un ou l'autre est désactivé, le portefeuille reste invisible pendant le chargement de la page.

4. Des conflits surviennent lorsque plusieurs injecteurs Web3 sont actifs simultanément. MetaMask, Coinbase Wallet ou même les anciennes versions de Phantom installées aux côtés de versions plus récentes peuvent écraser les objets fournisseurs les uns des autres, ce qui entraîne un window.ethereum non défini.

5. Le modèle d'isolation des processus de Firefox Quantum traite les scripts de contenu d'extension comme des contextes d'exécution distincts. Le travailleur du service en arrière-plan de Phantom peut ne pas synchroniser correctement l'état avec l'onglet actif à moins que le manifeste de l'extension ne déclare les autorisations appropriées telles que « activeTab » et « script ».

Comportement des extensions spécifiques à Firefox

1. Firefox ne prend pas en charge Manifest V3 pour les extensions au même rythme que les navigateurs Chromium. Phantom est actuellement livré avec Manifest V2, que Firefox prend toujours en charge mais applique un sandboxing plus strict, notamment en ce qui concerne l'injection dynamique de scripts dans les pages Web.

2. La protection améliorée contre le pistage (ETP) intégrée au navigateur classe parfois à tort la communication RPC de Phantom comme une activité de cryptominage et la bloque silencieusement. Cela ne conduit à aucune erreur visible mais à une absence totale de détection de portefeuille.

3. Le programme de mise à jour automatique de Firefox peut suspendre les mises à jour des extensions pendant les sessions de navigation actives. Une version obsolète de Phantom peut manquer de correctifs de compatibilité pour les versions récentes de Firefox telles que la v146, ce qui entraîne des délais d'initialisation.

4. Contrairement à Chrome, Firefox n'expose pas chrome.runtime.sendMessage de manière uniforme dans tous les contextes. Le routage interne des messages de Phantom dépend de cette API : l'échec de sa résolution entraîne une interface utilisateur qui ne répond pas et des fenêtres contextuelles vides.

5. Les profils Firefox stockent les données d'extension séparément par installation. Si Phantom a été précédemment installé sous un profil différent ou synchronisé via des comptes Firefox, les états du fournisseur mis en cache peuvent entrer en conflit avec les clés de session actuelles.

Échecs d’initialisation du réseau et du fournisseur

1. Phantom tente de se connecter à son point de terminaison RPC par défaut (https://rpc.phantom.app) lors du chargement de la page. Si le résolveur DNS sur HTTPS (DoH) de Firefox ne parvient pas à résoudre ce domaine ou si les pare-feu au niveau du réseau bloquent la demande, le portefeuille se bloque avant d'injecter une interface.

2. Certaines dapps appliquent strictement la conformité EIP-1193 et ​​rejettent les fournisseurs qui n'implémentent pas entièrement les méthodes request(), sendAsync() ou on(). La version Firefox de Phantom omet parfois des cales rétrocompatibles, déclenchant un rejet silencieux.

3. La restriction de l'API WebExtensions de Firefox sur document.write() empêche Phantom d'injecter dynamiquement des fournisseurs de secours basés sur iframe — une technique utilisée dans les cas extrêmes où l'injection directe de script échoue.

4. Lorsque les utilisateurs changent de réseau dans Phantom (par exemple, d'Ethereum à Solana), le portefeuille réinitialise son objet fournisseur. La gestion de la mémoire de Firefox peut supprimer les références obsolètes sans en informer le dapp, laissant window.ethereum pointant vers une instance défunte.

5. La fenêtre contextuelle du portefeuille de Phantom utilise le système de dialogue natif de Firefox plutôt que des modaux personnalisés. Si le bloqueur de popups du navigateur est déclenché par des appels successifs rapides (ce qui est courant lors des flux d'intégration de Dapp), l'interface utilisateur ne s'affiche jamais malgré une connexion en arrière-plan réussie.

Étapes de diagnostic pour les développeurs

1. Ouvrez les outils de développement Firefox → onglet Console et filtrez « Phantom » ou « Ethereum ». Recherchez des erreurs telles que « ReferenceError : Ethereum n'est pas défini » ou « TypeError : Cannot read property 'on' of undefined ».

2. Dans l'onglet Débogueur, définissez des points d'arrêt dans phantom-provider.js et vérifiez si le script se charge. Vérifiez l'onglet Réseau pour les 404 sur phantom-inpage.js ou les bundles injectés.

3. Exécutez navigator.userAgent.includes('Firefox') dans la console pour confirmer la détection de l'environnement. Phantom applique une logique conditionnelle basée sur l'identité du navigateur : une détection incorrecte entraîne l'omission des chemins d'initialisation.

4. Inspectez la page DOM pour détecter la présence de . Son absence indique un échec dans la routine de manipulation du DOM de Phantom, souvent lié au comportement plus strict de MutationObserver de Firefox.

5. Testez avec about:config flag privacy.resistFingerprinting défini sur false. Lorsqu'il est activé, ce paramètre interfère avec la collecte d'entropie de Phantom pour la dérivation de signature, interrompant la séquence de déverrouillage du portefeuille.

Foire aux questions

Q : Phantom prend-il officiellement en charge Firefox sur tous les systèmes d'exploitation ? R : Phantom prend en charge Firefox sous Windows, macOS et Linux. Il ne prend pas en charge Firefox pour Android ou iOS en raison des restrictions de plate-forme sur les API d'extension.

Q : Puis-je utiliser Phantom avec les conteneurs Firefox ? R : Phantom fonctionne uniquement dans le conteneur par défaut. Les conteneurs isolés bloquent la messagerie d'origine croisée requise pour les poignées de main du fournisseur, conduisant à des états persistants « non détectés ».

Q : Pourquoi Phantom affiche-t-il « Connexion… » indéfiniment sur certaines applications dans Firefox ? R : Cela se produit lorsque le dapp appelle ethereum.request({ method: 'eth_accounts' }) avant que Phantom ait fini d'initialiser son fournisseur. La priorisation des boucles d'événements de Firefox retarde la résolution des gestionnaires RPC basés sur Promise.

Q : Existe-t-il une version Phantom spécifique à Firefox ? R : Non. Phantom distribue un seul package d'extension validé par le processus d'examen des modules complémentaires de Firefox. Toutes les fonctionnalités sont unifiées sur tous les navigateurs pris en charge.