Comment réparer le portefeuille Phantom qui n'affiche pas mon jeton SPL après l'avoir reçu ?

Dépannage de la visibilité du jeton SPL dans Phantom Wallet

1. Vérifiez que l'adresse contractuelle du jeton correspond à celle enregistrée sur Solana Explorer. Phantom affiche uniquement les jetons avec des métadonnées vérifiées hébergées sur le référentiel officiel de liste de jetons.

2. Confirmez que la transaction a été confirmée en chaîne en vérifiant le hachage de signature sur solscan.io ou explorer.solana.com . Les transactions non confirmées ou ayant échoué ne déclenchent pas la logique d'affichage du jeton.

3. Assurez-vous que le portefeuille est connecté au bon réseau : Phantom doit être défini sur mainnet-beta , et non sur devnet ou testnet, car les jetons SPL déployés sur d'autres clusters restent invisibles dans les vues de production.

4. Ajoutez manuellement le jeton en utilisant son adresse d'origine via le flux « Ajouter un jeton » > « Jeton personnalisé » de Phantom. Certains jetons SPL récemment lancés ne disposent pas d'entrées gérées par la communauté dans la liste de jetons par défaut.

5. Effacez le cache local de Phantom en déconnectant toutes les dApps, en fermant l'extension et en la rouvrant. Des bugs persistants de rendu de l’interface utilisateur gèlent parfois les mises à jour du solde des jetons sans rechargement complet.

Exigences en matière de métadonnées de jeton pour la détection automatique

1. Le jeton SPL doit avoir une entrée token-list.json valide soumise au référentiel GitHub solana-labs/token-list .

2. Les champs de métadonnées, notamment name , symbol , logoURI et decimals, doivent être présents et correctement formatés dans l'objet JSON.

3. Le logoURI doit pointer vers un point de terminaison HTTPS accessible au public renvoyant un fichier PNG ou SVG valide d'une taille inférieure à 1 Mo.

4. L'adresse d'origine répertoriée dans la liste des jetons doit correspondre exactement à l'adresse dérivée du programme en chaîne, et non à un contrat wrapper ou proxy.

5. Phantom extrait cette liste lors de l'initialisation du portefeuille ; les modifications nécessitent un redémarrage complet de l'extension ou une actualisation de la session du navigateur pour prendre effet.

Mauvaises configurations courantes au niveau des transactions

1. L'expéditeur a utilisé une version enveloppée du jeton (par exemple, Wormhole-wrapped) au lieu de la menthe SPL native, ce qui a amené Phantom à le traiter comme un actif distinct sans prise en charge de la découverte automatique.

2. Le compte du destinataire a été créé avec une ancienne version du programme de jetons SPL, ce qui a entraîné des présentations de données de compte incompatibles qui empêchent l'analyse du solde.

3. L'instruction de transfert comprenait un mémo ou un budget de calcul personnalisé qui déclenchait une défaillance silencieuse dans les hooks de post-traitement, entraînant un changement de solde nul malgré le succès de la transaction.

4. Le jeton dispose d'une autorité de gel activée et le compte a été gelé avant sa réception, verrouillant la visibilité jusqu'à ce qu'il soit dégelé par l'intermédiaire d'un signataire autorisé.

5. La transaction a été regroupée avec d'autres instructions dans plusieurs programmes, ce qui a amené l'analyseur interne de Phantom à ignorer le rapprochement du solde SPL en raison d'un suivi incomplet des instructions.

Extension de navigateur et différences de comportement des applications mobiles

1. Phantom Mobile ne synchronise pas automatiquement les listes de jetons provenant de la même source que l'extension du navigateur : il s'appuie sur un cache interne distinct, rarement mis à jour.

2. Les versions d'extension de navigateur antérieures à la version 6.6.0 ignorent les jetons dont les décimales sont supérieures à 9, tronquant les soldes à zéro et les omettant de la liste des actifs.

3. Les utilisateurs mobiles doivent déclencher manuellement « Actualiser les soldes » à partir du menu des paramètres du portefeuille, tandis que les utilisateurs d'ordinateurs de bureau s'appuient sur une interrogation automatique toutes les 30 secondes.

4. Les installations iOS Safari Web Clip contournent les services d'arrière-plan de Phantom, désactivant entièrement les écouteurs de balance en temps réel.

5. Les navigateurs basés sur Chrome permettent une intégration plus approfondie avec la couche RPC de Solana, permettant une détection de jetons plus riche par rapport aux environnements mobiles basés sur WebView.

Foire aux questions

Q : Pourquoi mon token SPL apparaît-il dans Solflare mais pas dans Phantom ? R : Solflare gère son propre registre de jetons indépendant et prend en charge le remplacement manuel des métadonnées manquantes. Phantom applique strictement la liste officielle des jetons Solana et rejette les entrées avec des URI mal formés ou des sommes de contrôle incompatibles.

Q : Puis-je voir les jetons SPL non vérifiés en utilisant le mode développeur de Phantom ? R : Non. Phantom n'expose pas de bascule de développeur pour les jetons non répertoriés. Sa couche d'interface utilisateur filtre les actifs au moment du rendu en fonction uniquement de leur présence dans la liste canonique.

Q : Phantom prend-il en charge les jetons déployés via les extensions Token-2022 ? R : Phantom ignore actuellement les comptes initialisés avec les fonctionnalités de Token-2022 telles que les frais de transfert ou les transferts confidentiels. Seules les anciennes monnaies compatibles Token-2022 sans extensions sont rendues.

Q : Pourquoi le jeton affiche-t-il un solde nul même après une confirmation réussie ? R : Phantom calcule le solde en lisant le champ de montant du compte token associé. Si le compte a été initialisé avec zéro lamports ou ne dispose pas d'une délégation de propriété appropriée, l'analyseur renvoie null au lieu de zéro, supprimant ainsi l'affichage.