dApp で「チェーンがサポートされていません」と表示される MetaMask を修正するにはどうすればよいですか?

チェーンがサポートされていないエラーについて

1. dApp が MetaMask のアクティブ ネットワーク リストに現在構成されていないブロックチェーン ネットワークと通信しようとすると、エラーが表示されます。

2. これは、チェーン ID、RPC URL、またはブロック エクスプローラー URL が手動で追加されていない、新しいレイヤー 2 ロールアップまたはカスタム テストネットの初期段階のテスト中によく発生します。

3. MetaMask は、内部レジストリに対して各チェーンを検証します。認識されないチェーンは、フォールバック ロジックなしで即座に拒否をトリガーします。

4. 一部の dApp には、ユーザーが選択したネットワークと競合するハードコードされたチェーン パラメーターが埋め込まれており、正しいチェーンが選択されているように見えても、サイレント不一致が発生します。

5. ブラウザーのキャッシュにより古いチェーン メタデータが保存される可能性があり、現在の dApp 要件に対する検証チェックが古くなります。

ネットワーク構成の確認

1. MetaMask 設定を開き、「ネットワーク」→「ネットワークの追加」→「カスタム RPC」に移動します。

2. チェーン ID が dApp ドキュメントの指定内容と正確に一致していることを確認します。大文字と小文字は区別され、数値のみが指定されます (例: 「base」ではなく、Base Mainnet の 8453)。

3. サードパーティのアグリゲータやコミュニティが管理するリストではなく、dApp の開発者ポータルから公式 RPC エンドポイントを直接貼り付けます。

4. 通貨記号フィールドがチェーンのトークン標準で定義された正確なティッカーを使用していることを確認します (例: イーサリアムの「ETH」、ポリゴンの「MATIC」、「マチック」や「マティック」ではありません)。

5. ブロック エクスプローラーの URL 形式をクロスチェックします。新しいタブで開いたときに、最近のブロックを表示するライブ エクスプローラー ページに解決される必要があります。

dApp 側の不一致の処理

1. dApp のフロントエンド JavaScript コンソールで「サポートされていないチェーン ID」の警告を調べます。これらの警告により、アプリが予期している正確なチェーン ID が明らかになります。

2. ブラウザの開発者ツールを使用して、Web3 プロバイダーの初期化コードを見つけ、正しいパラメーターを使用してethereum.request({ method: 'wallet_addEthereumChain' })を呼び出すかどうかを確認します。

3. dApp が自動切り替えを開始する場合は、チェーン ネゴシエーション中のセッションの中断を防ぐために、MetaMask の「自動ロック」設定を一時的に無効にします。

4. 再接続する前に、dApp ドメインのサイト Cookie とローカル ストレージをクリアします。キャッシュされたプロバイダーの状態には、以前のチェーン コンテキストが保持されている可能性があります。

5. デバッグに MetaMask のモバイル アプリを使用しないでください。デスクトップ拡張機能では、[設定] → [詳細設定] → [RPC 呼び出しの表示] を使用して完全な RPC 検査を実行できます。

開発者ツールを使用したデバッグ

1. Chrome DevTools を起動し、[ネットワーク] タブに移動し、「rpc」または「json-rpc」リクエストをフィルタリングして、失敗したペイロード応答を観察します。

2. 「コンソール」タブで、 ethereum.chainIdを実行して、現在検出されているチェーン ID を取得し、それを期待値と比較します。

3. await ethereum.request({ method: 'eth_chainId' })を手動で実行して、MetaMask が UI に表示されているものと同じ ID を返すかどうかを確認します。

4. 「メタマスク」データベース内の破損したチェーン メタデータがないか、アプリケーション → ストレージ → IndexedDB の IndexedDB エントリを確認します。

5. 「プロバイダー エラー」イベント リスナーの出力を監視して、ネットワーク タイムアウト、無効な応答構造、またはサポートされていないメソッド エラーを区別します。

よくある質問

Q: 正しいネットワークを追加した後でも、dApp に「チェーンがサポートされていません」と表示されるのはなぜですか? A: dApp は、特定の EIP-1559 サポート フラグを要求したり、ノードの同期ステータスと一致しない厳密なブロック タイムスタンプ ウィンドウを強制したりするなど、チェーン ID を超えた追加の検証を強制する場合があります。

Q: 手動で切り替えずに複数のチェーンを同時に追加できますか? A: はい。 MetaMask はすべてのカスタム ネットワークを永続的に保存します。ユーザーは再構成することなく、ネットワーク ドロップダウンを介して瞬時に切り替えることができます。

Q: プライバシー モードを無効にするとチェーン検出に影響しますか? A: はい。プライバシー モードが有効になっている場合、MetaMask は明示的にユーザーが承認するまで dApp のチェーン情報へのアクセスを制限し、許可が与えられるまで初期検出に失敗します。

Q: 2 つの dApp が同じチェーン ID の異なるバージョンをリクエストした場合はどうなりますか? A: MetaMask は、RPC エンドポイントが異なる場合を除き、それらを同一のものとして扱います。ブロック エクスプローラーや通貨記号が競合すると、UI の不一致が発生する可能性がありますが、接続は中断されません。