MetaMask でスワップした後に不足しているトークンを追加するにはどうすればよいですか?

MetaMask でのトークンの可視性を理解する

1. MetaMask は、デフォルトのトークン検出ロジックにより、スワップ後にすべてのトークンを自動的に表示しません。公式トークン リストにリストされているトークン、または手動で追加されたトークンのみがアセット インターフェイスに表示されます。

2. ユーザーが新しくデプロイされたトークンまたは流動性の低いトークンに交換すると、コントラクトアドレスが MetaMask の内部レジストリによってインデックス付けされない可能性があり、その結果、オンチェーン転送が成功したにもかかわらず残高の可視性がゼロになります。

3. ウォレットは ERC-20 標準への準拠と正しい 10 進構成に依存します。標準外の小数や伝達関数の戻り値の欠落などの偏差により、適切な残高解析が妨げられる可能性があります。

4. ネットワーク コンテキストは重要です。Arbitrum や Base などの L2 チェーン上のトークンでは、トークンを追加する前に明示的なチェーンの選択が必要です。そうしないと、正しく入力されたとしてもアセット パネルはコントラクトを無視します。

5. ブラウザ拡張機能のキャッシュにより、トークンの表示が遅れる場合があります。契約の確認後に、MetaMask ポップアップの強制更新または完全な拡張機能のリロードが必要になる場合があります。

手動トークン追加プロセス

1. MetaMask を開き、正しいネットワーク (イーサリアム メインネット、ポリゴン、オプティミズム、またはトークンが存在する別のサポートされているチェーン) にいることを確認します。

2. アセットリストの下にある「トークンのインポート」ボタンをクリックし、 「カスタムトークン」タブを選択します。

3. スワップで受け取ったトークンの正確なコントラクト アドレスを貼り付けます。このアドレスは、スワップ トランザクションの出力イベント ログで使用されるアドレスと一致する必要があります。

4. 「次へ」をクリックします。 MetaMask は、コントラクトへの読み取り専用呼び出しを介して、名前、記号、小数点を含むトークン メタデータをブロックチェーンから取得しようとします。

5. メタデータのロードに失敗した場合は、トークン記号、名前、小数点以下の桁数を手動で入力します。ほとんどの ERC-20 トークンでは、10 進数は 18 に相当しますが、一部のトークンでは 6、9、または 12 が使用され、誤った入力により残高の不正表示が発生します。

オンチェーントークンの受信の検証

1. 使用するネットワークに応じて、Etherscan、Arbiscan、Basescan などのブロック エクスプローラーに移動します。

2. ウォレット アドレスを検索バーに貼り付け、 「トークン トランザクション」または「ERC-20 トークン転送イベント」セクションに移動します。

3. トークンのコントラクトアドレスと一致する最新のインバウンド転送を見つけて、値フィールドに生の単位でゼロ以外の金額が表示されていることを確認します (たとえば、1 つのトークンに対して小数点以下 18 桁の 1000000000000000000) 。

4. トランザクション ハッシュとスワップ レシートを照合します。確認済みステータスと実行成功ステータスは、トークンがプロトコル レベルでアドレスに配信されたことを示します。

5. エクスプローラーには残高が表示されるが、MetaMask には表示されない場合、問題はチェーンレベルの配信の失敗ではなく、ウォレット側のトークン登録のみにあります。

一般的なインポート失敗のトラブルシューティング

1. 「トークン情報を取得できません」エラーは、多くの場合、RPC エンドポイントの不安定性に起因します。 MetaMask のネットワーク設定内で別の RPC プロバイダー (Alchemy、Infura、QuickNode など) に切り替えると、この問題を解決できる可能性があります。

2. Sepolia や Holesky などのテストネットにデプロイされたトークンには、明示的なネットワークのアクティブ化が必要です。メインネットに接続しているときに Sepolia ベースのトークンをインポートしようとすると、結果は得られません。

3. 一部のトークンは、標準の BalanceOf() 呼び出しを妨げるカスタム アクセス制御またはプロキシ パターンを実装しています。このような場合、記号と小数点の手動入力は必須であり、残高は契約と直接対話した後にのみ更新される場合があります。

4. MetaMask モバイル アプリの 7.12.0 より前のバージョンには、特定の BEP-20 および ERC-677 トークンがサポートされていません。アプリケーションを更新すると、クロスチェーン資産の互換性ギャップが解決されます。

5. トークンが非標準インターフェイスを使用する場合（たとえば、totalSupply() を省略するか、supportsInterface() で false を返す場合）、MetaMask は自動検出中にトークンを破棄する可能性があります。手動インポートは引き続き機能します。

よくある質問

Q: Etherscan が残高を確認しているにもかかわらず、トークンを追加すると MetaMask が残高 0 を表示するのはなぜですか? A: これは、手動インポート中に小数点が間違って入力された場合に発生します。コントラクトの Decimals() 関数で指定された正確な 10 進数を使用してトークンを再インポートします。

Q: コントラクトアドレスを知らなくてもトークンを追加できますか? A: いいえ。契約住所は必須です。これは、DEX のトークン ページ、プロジェクトの公式ドキュメント、またはブロック エクスプローラーでデコードされたスワップ トランザクションの入力データから取得できます。

Q: トークンをインポートすると、秘密キーまたはシード フレーズが公開されますか? A: いいえ。インポートでは、コントラクト アドレスとメタデータがローカルに登録されるだけです。暗号化マテリアルがデバイスやブラウザ環境から流出することはありません。

Q: 一部のトークンは自動的に表示されますが、他のトークンは手動でインポートする必要があるのはなぜですか? A: MetaMask は、毎週更新される厳選されたトークン リストを維持します。流動性のしきい値、監査検証、およびコミュニティの使用状況メトリクスを満たすトークンが自動的に組み込まれます。その他はオプトインのみのままです。