Phantom Walletが接続できない問題を解決するにはどうすればよいですか? (トラブルシューティング)

ファントムウォレット接続失敗のトラブルシューティング

1. Phantom ブラウザ拡張機能がサポートされているブラウザ (Chrome、Brave、Edge、または Firefox) にインストールされており、最新バージョンに更新されていることを確認します。古い拡張機能は、Solana ベースの dApp との安全な RPC ハンドシェイクを確立できないことがよくあります。

2. ウォレットのロックが解除され、正しいネットワークが選択されていることを確認します。 Phantom のデフォルトはメインネット ベータ版です。ネットワークを切り替えずにテストネット dApp と対話しようとすると、サイレント接続タイムアウトが発生します。

3. トラブルシューティング中は、他のすべてのウォレット拡張機能を無効にします。 Phantom と MetaMask、Trust Wallet、または Rabby の間で競合が発生すると、挿入された window.solana オブジェクトが破損し、dApp の検出が妨げられる可能性があります。

4. 「ファントム設定」→「接続されているサイト」→「問題のある dApp エントリを削除」に移動して、サイト固有の権限をクリアし、接続プロンプトを再度開始します。

5. dApp が標準化されたsolana.connect({onl​​yIfTrusted: false })呼び出しの代わりにwindow.solana.connect()などの非推奨の接続メソッドを使用しているかどうかを確認します。従来の実装では、Phantom の権限 UI が正しくトリガーされない可能性があります。

ブラウザレベルの干渉源

1. uBlock Origin などの広告ブロッカーや、Privacy Badger などのプライバシー重視の拡張機能は、ウォレット検出に必要なスクリプト インジェクションを頻繁にブロックします。一時的に無効にして、dApp ページをリロードします。

2. ブラウザのサンドボックス機能 (特に Brave's Shields または Firefox の拡張トラッキング保護) は、Phantom の署名エンジンによって使用される WebAssembly モジュールを抑制する可能性があります。テストのために保護設定を標準に下げます。

3. Chrome ベースのブラウザにおけるハードウェア アクセラレーションの問題により、暗号化キー導出のレンダリングが中断されることがあります。 「設定」→「システム」でハードウェアアクセラレーションを無効にすると、ウォレットの応答性が回復する可能性があります。

4. ファントム セッション トークンに関連するローカル ストレージ エントリが破損すると、ハンドシェイクの完了が妨げられる場合があります。 chrome://extensions→Phantom→Details→Clear site data にアクセスして、保存された状態をリセットします。

Solana RPC エンドポイントの構成ミス

1. https://api.mainnet-beta.solana.comなどのパブリック RPC エンドポイントを使用するようにハードコードされた dApp は、高負荷時にタイムアウトになり、署名リクエストの前に Phantom が接続を中止することがあります。エンドポイントがcurlまたはPostman経由で応答することを確認します。

2. ファントム設定内で構成されたカスタム RPC URL は、dApp の予期されるクラスターと一致する必要があります。 dApp のクラスター (devnet など) と Phantom の RPC (メインネットなど) が一致しないと、接続が即座に拒否されます。

3. 一部の dApp は、RPC 認証ヘッダーまたはレート制限トークンを強制します。 Phantom はこれらのヘッダーに認証情報を挿入できないため、「接続失敗」メッセージとしてマスクされた 403 エラーが発生します。

4. ファイアウォールまたは企業ネットワーク ポリシーにより、Solana RPC ドメインへの WebSocket 接続がブロックされる場合があります。コマンド ラインからwscat -c wss://api.devnet.solana.comを使用して接続をテストします。

モバイルファントムアプリの制限事項

1. Phantom モバイル アプリは、デスクトップ版とは異なり、直接ブラウザー ウォレット インジェクションをサポートしていません。モバイル ブラウザではサードパーティのスクリプト インジェクションが制限されているため、iOS で Safari または Chrome 経由で接続しようとしてもアクションはトリガーされません。

2. QR コードのペアリングには、dApp が Solana のウォレット標準 URI スキームを実装する必要があります。カスタムディープリンク形式を使用するレガシー dApp は、Phantom モバイルでスキャンすると通知なく失敗します。

3. iOS 17 以降では、より厳格なクリップボード アクセス制御が導入されています。 dApp が Permissions API 経由でクリップボード許可を要求していない場合、Phantom のコピー＆ペーストのアドレス共有機能が停止する可能性があります。

4. Android ユーザーは、APK をサイドローディングする場合、Phantom の「不明なアプリのインストール」を有効にする必要があります。 Google Play にインストールされたバージョンは自動更新されますが、新しい dApp 統合に必要なベータ リリースより遅れる場合があります。

よくある質問

Q: ポップアップを承認した後でも、Phantom に「接続がタイムアウトしました」と表示されるのはなぜですか? A: これは、dApp がsolana.connect()から解決された Promise を受信できない場合に発生します。ブラウザー コンソールで、未処理の拒否や solana オブジェクトのイベント リスナーの欠落を調べます。

Q: Phantom を Ethereum dApps に接続できますか? A: いいえ。Phantom は、Solana、SPL トークン、および明示的なブリッジ統合を介した Sei や Monad などの互換性のあるチェーン専用に構築されています。 window.ethereumは注入されません。

Q: Phantom はブラウザ拡張機能を通じて Ledger ハードウェア ウォレットをサポートしていますか? A: はい、ただし、Ledger Live が開いており、Solana アプリが実行されている場合に限ります。 Phantom は、USB アクセス許可が付与され、デバイスがロックされていない場合にのみ Ledger を検出します。

Q: 特定の DeFi ダッシュボードで接続した後、Phantom がすぐに切断されるのはなぜですか? A: 一部のダッシュボードでは、solana.disconnect()呼び出しを定期的に実行して、アカウントの状態を更新します。開発者コンソールの「アプリケーション」→「ストレージ」→「ローカル ストレージ」セクションで、繰り返し切断されたログがないか確認します。