メタマスクを使用して私のDAPPのチェーンの変更を処理する方法は？

「「ChainChanged」イベントを聞き、それに応じてプロバイダーと契約を更新することにより、Dappsのメタマスクチェーンの変更を処理します。」

2025/07/02 21:01

ダップのチェーンの変化を理解する

分散型アプリケーション（DAPP）を開発または相互作用する場合、ユーザーと開発者が直面する最も一般的な課題の1つは、チェーンの変更を処理することです。最も広く使用されている暗号通貨ウォレットの1つであるメタマスクは、ユーザーが異なるブロックチェーンネットワークを切り替えることができます。ただし、このようなチェーンの変更を検出および応答するようにDAPPが適切に構成されていない場合、これは混乱を引き起こす可能性があります。これには、Ethereum MainnetからBinance Smartチェーンまたはテストネット環境への切り替えなどのシナリオが含まれます。

コアの問題は、メタマスクで選択されたネットワークが変更されたときにDAPPが正しく反応するようにすることを中心に展開します。これは、チェーンIDまたはRPCエンドポイントが誤っていないため、ユーザーエクスペリエンスを維持し、トランザクションエラーを防ぐために重要です。

メタマスクのネットワークの変更を検出します

Metamaskは、 chainChangedと呼ばれるイベントリスナーを提供します。これは、ユーザーが別のネットワークに切り替えるたびにトリガーされます。これを処理するには、DappのJavaScriptコード内にチェーン変更されたイベントリスナーを実装する必要があります。

これがあなたがそれをセットアップする方法です：

• Web3をインポートするか、window.ethereumから注入プロバイダーを使用します。
• chainChangedのイベントリスナーを追加します：

   window.ethereum.on('chainChanged', handleChainChanged);

• handleChainChanged関数を定義して、新しいチェーンIDに基づいてDAPPをリロードまたは再構成します。

これにより、DAPPは常にユーザーが現在接続しているネットワークを認識し、それに応じて適応できるようになります。

チェーンIDとネットワーク識別子の取り扱い

各ブロックチェーンネットワークには、チェーンIDとして知られる一意の識別子があります。たとえば、Ethereum MainnetはチェーンID 1を使用し、Rinkebyは4使用します。ユーザーがチェーンを切り替えると、 chainChangedイベントは新しいチェーンIDを16進形式で返します。

互換性を確保するために、あなたのdappは次のようにする必要があります

• parseInt(chainId, 16)を使用して、返されたチェーンIDを16進数から小数点に変換します。
• サポートされているチェーンIDのリストに対して、結果の値を比較します。
• 適切なUIフィードバックを表示するか、選択したチェーンがサポートされていない場合にユーザーをリダイレクトします。

チェーンがサポートされていない場合、DAPPはユーザーにバックバックを切り替えるか、メタマスクを介してカスタムネットワークを追加する方法の指示を提供するように促す必要があります。

プロバイダーの更新と契約の再接続

チェーンの変更を検出した後、プロバイダーを更新し、スマートコントラクトインスタンスを再接続することが不可欠です。そうしないと、データの取得が誤っていないか、トランザクションが失敗する可能性があります。

従うべきステップ：

• チェーンが変更された後、 window.ethereumを使用してWeb3の新しいインスタンスを作成します。
• 更新されたプロバイダーを使用して、すべての契約インスタンスを再接続します。
• アカウントのバランスと契約状態を再評価して、現在のネットワークを反映します。

このプロセスにより、すべての相互作用が正しいチェーンで発生し、ネットワークスイッチに関係なくDAPPが応答性があり正確なままであることが保証されます。

ユーザーにカスタムチェーンを追加するように促します

場合によっては、DAPPがユーザーがMetamaskでデフォルトで利用できないネットワークに接続する必要がある場合があります。そのような場合、 wallet_addEthereumChainメソッドを使用してカスタムネットワークを追加するように求めることができます。

このアクションをトリガーする方法は次のとおりです。

• ターゲットネットワークのRPC URL、チェーンID、通貨シンボル、およびブロックエクスプローラーURLを準備します。
• 次の方法を呼び出します。

   await window.ethereum.request({
   method: 'wallet_addEthereumChain',
   params: [{ chainId: '0x...', rpcUrls: ['https://...'], chainName: 'Custom Network', nativeCurrency: { name: 'Token', symbol: 'TKN', decimals: 18 }, blockExplorerUrls: ['https://...']

  }]
  }）;

これにより、メタマスク確認ダイアログが開き、ユーザーがネットワークを安全に追加できます。

よくある質問

チェーンチェンジされたイベントはどのくらいの頻度で発火しますか？

チェーンチェンジされたイベントは、ユーザーがメタマスクで手動でネットワークを切り替えるたびに、または別のDAPPがネットワークの変更をトリガーするたびに発射されます。初期ページのロード中に発生するのではなく、ネットワークが開始後に変更された場合にのみ発生します。

メタマスクでプログラムでチェーンを切り替えることはできますか？

はい、 wallet_switchEthereumChainメソッドを使用してチェーンスイッチをリクエストできます。目的のチェーンIDを16進形式で渡す必要があります。チェーンがまだ追加されていない場合、メタマスクはユーザーに最初に追加するように促します。

なぜ私のDAPPはチェーンをすぐに検出しないのですか？

window.ethereum.on('chainChanged', callback)を使用して、 chainChangedイベントを積極的に聞く必要があります。このリスナーが実行時に登録されていない場合、または実行中に削除された場合、DAPPはチェーンの変更を検出しません。

ユーザーがサポートされていないチェーンを選択するとどうなりますか？

DAPPが選択したチェーンをサポートしていない場合、現在のネットワークがサポートされていないことを示す警告メッセージを表示する必要があります。また、正しいネットワークを追加するか、サポートされているネットワークに切り替えることにより、ユーザーをガイドするボタンを提供することもできます。