Phantom ウォレットを受け取った後に SPL トークンが表示されない問題を修正するにはどうすればよいですか?

ファントムウォレットでの SPL トークンの可視性のトラブルシューティング

1. トークンのコントラクト アドレスが Solana Explorer に登録されているものと一致することを確認します。 Phantom は、公式トークンリスト リポジトリでホストされている検証済みのメタデータを持つトークンのみを表示します。

2. solscan.ioまたはexplorer.solana.comの署名ハッシュをチェックして、トランザクションがオンチェーンで確認されたことを確認します。未確認または失敗したトランザクションは、トークン表示ロジックをトリガーしません。

3. ウォレットが正しいネットワークに接続されていることを確認します。代替クラスターにデプロイされた SPL トークンは運用ビューでは表示されないため、Phantom は devnet や testnet ではなくmainnet-betaに設定する必要があります。

4. Phantom の「トークンの追加」 > 「カスタム トークン」フローを介して、ミント アドレスを使用してトークンを手動で追加します。新しく起動された一部の SPL トークンには、デフォルトのトークン リストにコミュニティが管理するエントリがありません。

5. すべての dApp を切断し、拡張機能を閉じて再度開くことで、Phantom のローカル キャッシュをクリアします。永続的な UI レンダリングのバグにより、完全なリロードが行われないとトークン残高の更新がフリーズすることがあります。

自動検出のためのトークン メタデータ要件

1. SPL トークンには、solana-labs/token-list GitHub リポジトリに送信された有効なtoken-list.jsonエントリが必要です。

2. name 、 symbol 、 logoURI 、小数点を含むメタデータ フィールドが JSON オブジェクト内に存在し、正しくフォーマットされている必要があります。

3. logoURI は、サイズが 1MB 未満の有効な PNG または SVG ファイルを返す、公的にアクセス可能な HTTPS エンドポイントを指す必要があります。

4. トークン リストにリストされているミント アドレスは、ラッパーやプロキシ コントラクトではなく、オンチェーン プログラムから派生したアドレスと正確に一致する必要があります。

5. Phantom はウォレットの初期化中にこのリストを取得します。変更を有効にするには、拡張機能を完全に再起動するか、ブラウザ セッションを更新する必要があります。

一般的なトランザクションレベルの構成ミス

1. 送信者がネイティブ SPL ミントの代わりにラップされたバージョンのトークン (ワームホール ラップなど) を使用したため、Phantom は自動検出サポートのない別個の資産としてそれを扱いました。

2. 受信者のアカウントが古いバージョンの SPL トークン プログラムで作成されているため、アカウント データのレイアウトに互換性がなく、残高の解析ができなくなります。

3. 転送命令には、後処理フックでサイレントエラーを引き起こすメモまたはカスタムコンピューティングバジェットが含まれており、その結果、トランザクションが成功したにもかかわらず残高の変更がゼロになりました。

4. トークンには凍結権限が有効になっており、アカウントは受信前に凍結されており、承認された署名者によって解凍されるまで可視性がロックされています。

5. トランザクションは複数のプログラムにわたる他の命令とバンドルされており、不完全な命令トレースにより Phantom の内部パーサーが SPL バランス調整をスキップしました。

ブラウザ拡張機能とモバイルアプリの動作の違い

1. Phantom Mobile は、ブラウザ拡張機能と同じソースからのトークン リストを自動同期しません。これは、頻繁に更新されない別の内部キャッシュに依存します。

2. v6.6.0 より前のバージョンのブラウザ拡張機能では、9 より大きい小数点以下のトークンが無視され、残高がゼロに切り捨てられ、資産リストから除外されます。

3. モバイル ユーザーはウォレット設定メニューから「残高の更新」を手動でトリガーする必要がありますが、デスクトップ ユーザーは 30 秒ごとの自動ポーリングに依存します。

4. iOS Safari Web Clip のインストールは、Phantom のバックグラウンド サービス ワーカーをバイパスし、リアルタイム バランス リスナーを完全に無効にします。

5. Chrome ベースのブラウザでは、Solana の RPC レイヤーとのより深い統合が可能になり、WebView ベースのモバイル環境と比較してより豊富なトークン検出が可能になります。

よくある質問

Q: 私の SPL トークンが Solflare には表示されるのに、Phantom には表示されないのはなぜですか? A: Solflare は独自の独立したトークン レジストリを維持し、不足しているメタデータの手動オーバーライドをサポートしています。 Phantom は公式の Solana トークン リストを厳密に適用し、不正な形式の URI または不一致のチェックサムを持つエントリを拒否します。

Q: Phantom の開発者モードを使用して、未検証の SPL トークンを表示できますか? A: いいえ。Phantom は、リストに掲載されていないトークンの開発者切り替え機能を公開していません。その UI レイヤーは、正規リスト内の存在のみに基づいて、レンダリング時にアセットをフィルターします。

Q: Phantom は、Token-2022 拡張機能を介してデプロイされたトークンをサポートしていますか? A: Phantom は現在、送金手数料や機密送金などの Token-2022 機能で初期化されたアカウントを無視します。拡張機能のない従来の Token-2022 互換ミントのみがレンダリングされます。

Q: 確認に成功した後でも、トークンの残高が 0 と表示されるのはなぜですか? A: Phantom は、関連付けられたトークン アカウントの金額フィールドを読み取ることで残高を計算します。アカウントが lamports ゼロで初期化されているか、適切な所有権の委任がない場合、パーサーはゼロではなく null を返し、表示を抑制します。