MetaMask でトークン残高が表示されない問題を修正するにはどうすればよいですか? (トラブルシューティング)

トークン残高の可視性の問題について

1. MetaMask は外部ブロックチェーン ノードに依存してトークン残高を取得します。選択したネットワーク RPC エンドポイントが応答しないか構成が間違っている場合、トークン残高が表示されない場合があります。

2. カスタム トークン コントラクトは、Etherscan または同等のエクスプローラーで検証する必要があります。未検証の契約では、オンチェーンで保有しているにもかかわらず、残高がゼロまたは表示されないことがよくあります。

3. アカウントの切り替えが間違っているため、MetaMask で使用されるウォレット アドレスがトークンを保持しているアドレスと異なる場合があります。ユーザーは右上隅にあるアクティブなアカウントの選択を見落とすことがあります。

4. トークン標準は重要です。ERC-20 トークンは、手動追加時に適切なコントラクト アドレス、記号、および 10 進数の入力を必要としますが、ERC-721 または ERC-1155 資産は、インターフェース バージョンで明示的にサポートされていない限り、メイン資産リストに残高として表示されません。

5. ブラウザ拡張機能の競合、特に広告ブロッカー、プライバシー ツール、またはその他の Web3 インジェクターとの競合は、MetaMask のコンテンツ スクリプトの実行を妨げることにより、バランス レンダリングを抑制する可能性があります。

ネットワーク構成の確認

1. MetaMask がトークンが存在する正しいネットワークに接続されていることを確認します。たとえば、BSC ベースの BEP-20 トークンは Ethereum メインネットには表示されません。

2. カスタム RPC URL に Infura や Alchemy などのサービスの有効な API キーが含まれているかどうかを確認します。期限切れのキーやレート制限のあるキーは、サイレントに空の応答を返します。

3. ネットワーク間の切り替えによりキャッシュの無効化がトリガーされます。ネットワーク変更後に手動更新 (Ctrl+R または Cmd+R) を強制すると、多くの場合、古いバランス状態が解決されます。

4. 一部のテストネットではアーカイブ ノードのサポートが一貫していません。 Chainstack や QuickNode などのパブリック エンドポイントを使用すると、デフォルトの MetaMask が提供する URL よりも信頼性が向上します。

5. Geth や Hardhat などのローカル ノードを使用している場合は、ノードが eth_getBalance および eth_call エンドポイントを公開していること、および CORS ヘッダーが localhost:3000 または同様の発信元からのリクエストを許可していることを確認します。

トークンの追加と契約の検証

1. トークンを手動で追加するには、正確なコントラクト アドレスの一致が必要です。ただし、MetaMask は貼り付け時にチェックサムを自動的に正規化しますが、大文字と小文字は区別されます。

2. プロキシ パターン (透過的プロキシや UUPS など) を介して展開されたトークンは、プロキシ アドレスの代わりに実装アドレスを公開する場合があります。プロキシの実装スロットをクエリすると、実際のコントラクトの場所が得られます。

3. トークンの totalSupply はゼロ以外であり、その伝達関数がアクセス可能でなければなりません。転送が一時停止されている、またはブラックリストに登録されている所有者がいる契約では、残高は報告されますが、UI レイヤーでは非表示になる場合があります。

4. オンチェーン ストレージと MetaMask 入力の間の小数精度の不一致により、表示異常が発生します。たとえば、オンチェーンに 9 つしかないトークンに小数点 18 桁を入力すると、残高が 10 億で除算されます。

5. MetaMask は、Token Lists プロジェクトなどのコミュニティ提供のリストからのトークン メタデータをキャッシュします。古いエントリや欠落しているエントリがあると、自動バランシング ロジックが欠けている手動の契約対話に依存することになります。

ブラウザと拡張機能の環境チェック

1. MetaMask 以外のすべての拡張機能、特に Phantom、Coinbase Wallet、Rainbow などの dApp ページにスクリプトを挿入する拡張機能を一時的に無効にします。

2. [設定] > [詳細設定] > [アカウントのリセット] に移動して、MetaMask の内部キャッシュをクリアします。これにより、シード フレーズやアカウントを削除せずに、残高の再取得が強制されます。

3. ブラウザがサードパーティの Cookie とサイト データを許可していることを確認します。これらをブロックすると、MetaMask がトークン残高のポーリングに必要なセッション キーを保存できなくなります。

4. MetaMask のみを有効にして、シークレット ウィンドウで同じ dApp にアクセスしてみてください。これにより、保存されたログイン、キャッシュされた JS バンドル、または Service Worker による干渉が排除されます。

5. モバイルでは、MetaMask モバイル アプリがブラウザ拡張機能と同じネットワークとアカウントを使用していることを確認します。クロスデバイス同期はトークンの可視性設定には拡張されません。

よくある質問

Q: Etherscan がトークンを保持していることを確認しているにもかかわらず、トークンが 0.000000 と表示されるのはなぜですか? A: これは通常、小数点の不一致または契約アドレスの入力が正しくないことを示します。Etherscan の契約ページで確認された詳細を使用してトークンを再追加します。

Q: MetaMask は、複数のチェーンからのトークンを 1 つのビューに同時に表示できますか? A: いいえ。MetaMask は、現在選択されているネットワークの残高のみを表示します。対応するトークンを確認するには、ユーザーはネットワークを手動で切り替える必要があります。

Q: MetaMask アカウントをリセットすると、秘密キーは削除されますか? A: いいえ。アカウントをリセットすると、キャッシュされた残高と取引履歴は消去されますが、シードフレーズとウォレットへのアクセスはそのまま保持されます。

Q: 一部のトークンが「収集品」の下に表示され、「資産」には表示されないのはなぜですか? A: 収集品は NFT (ERC-721/ERC-1155) を表し、代替可能なトークン残高とは別に追跡され、MetaMask のインターフェース内で異なる検出ロジックが必要です。