カスタム トークンを MetaMask にインポートするにはどうすればよいですか? （契約先住所案内）

カスタム トークンのインポートの仕組みを理解する

1. MetaMask は、Ethereum または EVM 互換チェーンにデプロイされたすべてのトークンを自動的に検出するわけではありません。トークンは、検証済みのコントラクト アドレスを使用して手動で追加する必要があります。

2. インポート プロセスは、トークンのスマート コントラクト アドレス、小数点、記号の精度に完全に依存しています。不一致があると、残高表示エラーやトランザクションの取り消しが発生します。

3. ユーザーは、ERC-20 を ERC-721 または BEP-20 トークンと混同することがよくあります。 MetaMask は Ethereum で ERC-20 および ERC-721 をサポートしますが、BSC、Polygon、または Arbitrum のネットワーク固有の構成が必要です。

4. Etherscan などのブロック エクスプローラーでの契約検証ステータスは問題です。未検証の契約は重大なセキュリティ リスクを引き起こすため、独立した監査による確認なしに決してインポートすべきではありません。

5. MetaMask のインターフェースでは、追加が成功し、オンチェーン残高が十分に検出された場合にのみ、「資産」タブにカスタム トークンが表示されます。

段階的な契約住所の検証

1. Etherscan (Ethereum の場合) または関連するチェーン エクスプローラー (BSC の場合は BscScan、Polygon の場合は Polygonscan) に移動し、疑わしいコントラクトのアドレスを検索バーに貼り付けます。

2. 住所の横に「契約」ラベルが表示され、契約名の横に「確認済み」バッジが緑色で表示されていることを確認します。

3. トークンの公式 Web サイト、Twitter、および GitHub リポジトリをクロスチェックして、公開されたコントラクト アドレスがエクスプローラー上のアドレスと一致することを確認します。

4. 「契約の読み取り」セクションを参照して、 totalSupply 、 name 、 symbol 、および10 進数などの標準関数が期待値を返すことを確認します。

5. 最近のトランザクションと保有者数を確認します。アクティビティが異常に低い場合や突然のスパイクがある場合は、ハニーポットまたはラグ プル詐欺を示している可能性があります。

手動トークン追加ワークフロー

1. MetaMask を開いて、正しいネットワークに接続していることを確認します。ネットワークを切り替えるとトークンの可視性がリセットされ、再インポートが必要になります。

2. 「資産」タブをクリックし、「トークンのインポート」を選択して「カスタムトークン」タブに切り替えます。

3. 検証されたコントラクト アドレスを「トークン コントラクト アドレス」フィールドに貼り付けます。コントラクトが準拠し検証されている場合、MetaMask は記号と小数点を自動入力します。

4. 自動検出が失敗した場合は、正しい小数点以下の桁数を手動で入力します。一般的な値は、ほとんどの ERC-20 トークンでは 18、一部のステーブルコインでは 8、特定の DeFi ガバナンス トークンでは 9 です。

5. 「次へ」をクリックし、次に「トークンの追加」をクリックします。ウォレットのオンチェーン残高がゼロ以外の場合、トークンは即座に表示されます。

契約上の不適切な取扱いによるリスク

1. 名前は同じだがバイトコードが異なる偽の契約またはクローン契約をインポートすると、オンチェーンで保有しているにもかかわらず残高の可視性がゼロになります。

2. 期限切れまたは非推奨の契約アドレスを使用する場合、特にトークンの移行後は、ユーザーが廃止されたアドレスに資金を送金すると、取り返しのつかない損失が発生します。

3. 非標準実装のトークン（転送ロジックをオーバーライドするものや許可署名を必要とするものなど）は、残高を表示してもすべての転送試行が失敗する場合があります。

4. 一部の悪意のあるコントラクトは、特定のアドレスのBalanceOf読み取りを無効にし、アセットが存在する場合でも MetaMask に「0.00」を表示させます。

5. クロスチェーン展開ステータスを確認せずに、複数のチェーン間で同じコントラクト アドレスを再利用すると、混乱が生じ、インポートが失敗します。

よくある質問

Q: コントラクトを貼り付けると MetaMask に「無効なアドレス」と表示されるのはなぜですか? A: アドレスの形式が間違っている可能性があります。アドレスが「0x」で始まり、正確に 42 文字を含み、スペースや特殊記号が含まれていないことを確認してください。また、選択したネットワークがコントラクトが展開されているチェーンと一致することを確認します。

Q: 残高を持たずにトークンをインポートできますか? A: はい — MetaMask は、インポートされると資産リストにトークンを表示しますが、トークンを受け取るか契約を直接操作するまで、残高はゼロのままです。

Q: 同じトークンを異なる小数点で 2 回インポートするとどうなりますか? A: MetaMask は、各インポートを一意のアセットとして扱います。重複したエントリは個別に表示され、小数点以下が間違っていると残高表現が崩れます。再追加する前に、必ず誤ったインポートを削除してください。

Q: カスタム トークンをインポートするには、ウォレットに ETH またはネイティブ ガス トークンが必要ですか? A: いいえ — インポートはクライアント側の UI アクションであり、ブロックチェーン トランザクションは必要ありません。ただし、後でトークンを操作 (送信、承認、または交換) するには、ターゲット ネットワーク上に十分なネイティブ ガス トークンが必要です。