Firefox で Phantom ウォレットが読み込まれないのを修正するにはどうすればよいですか?

ファントムウォレット統合の問題のトラブルシューティング

1. ファントム ウォレットは、イーサリアム ベースの DAPP と対話するためにブラウザ拡張機能のインジェクションに依存します。 Firefox で使用すると、特定のセキュリティ ポリシーとコンテンツ ブロック メカニズムにより、ウォレットのスクリプトが適切に初期化されなくなる可能性があります。

2. Firefox は、埋め込みスクリプトをホストする Web サイトに厳格なコンテンツ セキュリティ ポリシー (CSP) ルールを適用します。 dapp サイトが無許可のドメインを通じて Phantom のプロバイダー インジェクション ロジックを提供する場合、または CSP ディレクティブに違反する場合、ウォレットは window.ethereum に接続できません。

3. Firefox 拡張機能には、特定のサイトで実行する許可を明示的に付与する必要があります。 Phantom では、「プライベート Windows で実行」と「ファイル URL へのアクセスを許可」の切り替えが有効になっている必要があります。どちらかが無効になっている場合、ページの読み込み中にウォレットは非表示のままになります。

4. 複数の Web3 インジェクターが同時にアクティブになると、競合が発生します。 MetaMask、Coinbase Wallet、または新しいバージョンと一緒にインストールされた Phantom のレガシー バージョンでさえ、互いのプロバイダー オブジェクトを上書きし、未定義の window.ethereum が発生する可能性があります。

5. Firefox Quantum のプロセス分離モデルは、拡張コンテンツ スクリプトを別個の実行コンテキストとして扱います。拡張機能マニフェストが「activeTab」や「scripting」などの適切な権限を宣言しない限り、Phantom のバックグラウンド サービス ワーカーは状態をアクティブなタブと正しく同期しない可能性があります。

Firefox 固有の拡張機能の動作

1. Firefox は、Chromium ブラウザと同じペースで拡張機能の Manifest V3 をサポートしていません。 Phantom には現在 Manifest V2 が同梱されており、Firefox は引き続きサポートしていますが、特に Web ページへの動的スクリプト挿入に関して、より厳密なサンドボックスが適用されます。

2. ブラウザーに組み込まれている拡張トラッキング保護 (ETP) は、Phantom の RPC 通信をクリプトマイニング活動として誤って分類し、サイレントにブロックすることがあります。これにより、目に見えるエラーは発生しませんが、ウォレットが完全に検出されなくなります。

3. Firefox の自動アップデータは、アクティブなブラウジング セッション中に拡張機能の更新を一時停止する場合があります。古い Phantom バージョンには、v146 などの最近の Firefox リリースの互換性パッチが不足している可能性があり、初期化タイムアウトが発生します。

4. Chrome とは異なり、Firefox はすべてのコンテキストにわたって chrome.runtime.sendMessage を均一に公開しません。 Phantom の内部メッセージ ルーティングはこの API に依存しています。これを解決できないと、UI が応答しなくなり、ポップアップ ウィンドウが空白になります。

5. Firefox プロファイルは、拡張機能データをインストールごとに個別に保存します。 Phantom が以前に別のプロファイルでインストールされていた場合、または Firefox アカウント経由で同期されていた場合、キャッシュされたプロバイダーの状態が現在のセッション キーと競合する可能性があります。

ネットワークとプロバイダーの初期化の失敗

1. Phantom は、ページの読み込み時にデフォルトの RPC エンドポイント (https://rpc.phantom.app) への接続を試みます。 Firefox の DNS-over-HTTPS (DoH) リゾルバーがドメインまたはネットワーク レベルのファイアウォールがリクエストをブロックしていることを解決できない場合、ウォレットはインターフェイスを挿入する前に停止します。

2. 一部の dapp は、EIP-1193 への準拠を厳密に強制し、request()、sendAsync()、または on() メソッドを完全に実装していないプロバイダーを拒否します。 Phantom の Firefox ビルドでは、下位互換性のある shim が省略されることがあり、サイレント拒否が発生します。

3. document.write() に対する Firefox の WebExtensions API 制限により、Phantom はフォールバック iframe ベースのプロバイダーを動的に挿入できなくなります。これは、スクリプトの直接挿入が失敗するエッジケースで使用される手法です。

4. ユーザーが Phantom 内のネットワークを切り替えると (例: Ethereum から Solana に)、ウォレットはプロバイダー オブジェクトを再初期化します。 Firefox のメモリ管理は、dapp に通知せずに古い参照を破棄し、window.ethereum が無効なインスタンスを指したままにする場合があります。

5. Phantom のウォレット ポップアップは、カスタム モーダルではなく Firefox のネイティブ ダイアログ システムを使用します。ブラウザーのポップアップ ブロッカーが急速な連続呼び出しによってトリガーされた場合 (Dapp オンボーディング フロー中によく見られます)、バックグラウンド接続が成功したにもかかわらず UI が表示されません。

開発者向けの診断手順

1. Firefox 開発者ツール → コンソール タブを開き、「Phantom」または「ethereum」でフィルターします。 「ReferenceError: ethereum が定義されていません」または「TypeError: Cannot read property 'on' of unknown」のようなエラーを探します。

2. [デバッガー] タブで、phantom-provider.js にブレークポイントを設定し、スクリプトが読み込まれるかどうかを確認します。 phantom-inpage.js または挿入されたバンドルの 404 の [ネットワーク] タブを確認します。

3. コンソールでnavigator.userAgent.includes('Firefox')を実行して、環境の検出を確認します。 Phantom はブラウザ ID に基づいて条件付きロジックを適用します。誤った検出により初期化パスがスキップされます。

4. ページ DOM に次のものが存在するかどうかを検査します。 。これが存在しないことは、Phantom の DOM 操作ルーチンの失敗を示しており、多くの場合、Firefox のより厳格な MutationObserver の動作に関連しています。

5. about:config フラグのprivacy.resistFingerprintingをfalseに設定してテストします。この設定を有効にすると、署名導出のための Phantom のエントロピー収集が妨げられ、ウォレットのロック解除シーケンスが停止します。

よくある質問

Q: Phantom はすべてのオペレーティング システムで Firefox を正式にサポートしていますか? A: Phantom は、Windows、macOS、および Linux 上の Firefox をサポートします。拡張 API のプラットフォーム制限のため、Android または iOS の Firefox はサポートされていません。

Q: Phantom を Firefox コンテナで使用できますか? A: Phantom はデフォルトのコンテナでのみ動作します。分離されたコンテナーは、プロバイダーのハンドシェイクに必要なクロスオリジン メッセージングをブロックし、永続的な「未検出」状態につながります。

Q: Firefox の一部の Dapps で Phantom が「接続中…」を無期限に表示するのはなぜですか? A: これは、Phantom がプロバイダーの初期化を完了する前に、dapp が ethereum.request({ method: 'eth_accounts' }) を呼び出すときに発生します。 Firefox のイベント ループの優先順位付けにより、Promise ベースの RPC ハンドラーの解決が遅れます。

Q: Firefox 固有の Phantom ビルドは利用可能ですか? A: いいえ。Phantom は、Firefox のアドオン レビュー プロセスに対して検証された単一の拡張機能パッケージを配布します。すべての機能は、サポートされているブラウザ間で統合されています。