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

カスタムトークンの統合について

1. MetaMask は、ERC-20、ERC-721、および ERC-1155 標準を通じてイーサリアム互換トークンをサポートします。ユーザーはインターフェイス内で不明瞭なトークンを単純に検索することはできません。多くの場合、正確なコントラクト アドレスを使用して手動で追加する必要があります。

2. トークンのコントラクト アドレスは、特定のブロックチェーンに展開される一意の 42 文字の 16 進文字列です。このアドレスは、トークンのスマート コントラクト ロジックと残高追跡の最終的な識別子として機能します。

3. 正しいネットワークを検証せずにカスタム トークンを追加すると、残高がゼロになったり、仮想資産が発生したりする可能性があります。各トークンは、そのコントラクトがデプロイされたチェーン上にのみ存在します。Ethereum Mainnet、Polygon、BSC、Arbitrum などは完全に別個の環境です。

4. MetaMask はトークンの正当性を検証しません。詐欺師は、人気のあるプロジェクトを模倣した名前の偽の契約を頻繁に展開します。続行する前に、Etherscan、Polygonscan、または BscScan を介してコントラクト アドレスを相互参照することが必須です。

5. トークンの記号と小数点以下の桁数は、契約で定義されているものと一致する必要があります。小数点以下が正しくないと、残高の誤りが表示されます。たとえば、9 を使用するトークンに小数点以下 18 を入力すると、実際よりも 10 億分の 1 少ない残高が表示されます。

手動追加フローの操作

1. MetaMask を開き、左上のドロップダウンで正しいネットワークが選択されていることを確認します。これは、トークンのコントラクトが存在する場所と一致している必要があります。

2. 「資産」タブをクリックし、下にスクロールして「トークンのインポート」を選択します。モーダルには、「カスタム トークン」、「トークン リスト」、「NFT」の 3 つのタブが表示されます。

3. 「カスタム トークン」を選択し、検証された契約アドレスを指定されたフィールドに貼り付けます。コントラクトが標準の ERC 呼び出しに正しく応答する場合、MetaMask は名前、記号、および小数点を自動的に取得します。

4. 自動検出が失敗した場合は、トークン名、記号、および小数点を手動で入力します。これらの値は、コミュニティ チャットや未検証の Web サイトではなく、公式プロジェクト ドキュメントまたは検証済みのブロック エクスプローラー ページから取得する必要があります。

5. 「次へ」をクリックして詳細を確認し、「トークンの追加」をクリックします。ウォレットにゼロ以外の残高がある場合、トークンはすぐに「資産」の下に表示されます。

契約アドレスの一般的な落とし穴

1. コピー＆ペーストのエラーにより、目に見えない Unicode 文字や余分なスペースが挿入されます。必ず最初にプレーンテキストエディタに貼り付けてから、きれいな 42 文字の文字列を再コピーしてください。

2. 一部のトークンは、名前は同じだがコントラクトが異なる複数のチェーンに存在します。イーサリアムの USDT は 0xdAC17F958D2ee523a2206206994597C13D831ec7 を使用しますが、Polygon の USDT は0xc2132D05D31c914a87C6611C10748AEb04B58e8F。

3. テストネットにデプロイされたコントラクトは、メインネットでは機能しません。 Goerli ベースのトークンを Ethereum メインネットに追加しようとすると、残高が表示されず、認識されない資産が生成されます。

4. 名前変更またはアップグレードされたトークンは、多くの場合、非公式リストに古い契約アドレスを保持します。 ChainLink のようなプロジェクトは 0xa0b73e1ff0b80914ab6fe04447664353ee79dff5 から 0x514910771AF9Ca656af840dff83E8264EcF986CA に移行されました。古いアドレスを使用すると残高が空になります。

インポート後のトークンの信頼性の検証

1. インポート後、資産リストでトークンの名前をクリックして詳細ビューを開きます。 MetaMask にコントラクト アドレスが表示されます。これをクリックすると、そのネットワークのデフォルトのブロック エクスプローラーが開きます。

2. Etherscan または同等のもので、「Contract」タブをチェックして、それが検証されていることを確認します。未検証の契約にはバイトコードのみが表示され、重大なリスクが生じます。

3. 「契約の読み取り」セクションを確認して、 totalSupply()とdecmals()を呼び出します。返された値とインポート時に入力された値を比較します。

4. [トランザクション] タブで、既知の所有者アドレスへの最近の受信送金を調べます。不明な送信者からの突然のスパイクは、流動性操作またはラグプルを示している可能性があります。

5. 「分析」または「トークン所有者」セクションを確認します。正規のトークンには通常、数百または数千の所有者がいます。アクティブなアドレスが 10 未満のトークンには、即時の精査が必要です。

よくある質問

Q: コントラクトアドレスを追加した後、MetaMask に「不明なトークン」が表示されるのはなぜですか? MetaMask は、コントラクトに標準の ERC インターフェイスがないか、ブロック エクスプローラーで検証されていない場合にこれを表示します。これはトークンが無効であることを意味するのではなく、メタデータを自動フェッチできないということだけです。

Q: コントラクトアドレスの代わりに名前またはシンボルのみを使用してトークンを追加できますか?いいえ。MetaMask には正確なコントラクト アドレスが必要です。名前とシンボルだけでは不十分であり、グローバルに一意ではないため、複数の契約が同一の識別子を共有できます。

Q: わずかに異なるコントラクト アドレスを使用して同じトークンを 2 回追加するとどうなりますか? MetaMask は、各アドレスを個別の資産として扱います。重複するエントリは、オンチェーン上の同じ経済トークンを表す場合でも、資産リストに個別に表示されます。

Q: カスタム トークンを追加すると、秘密キーやシード フレーズが公開されますか?いいえ。MetaMask はすべての操作をクライアント側で実行します。コントラクトの対話は、RPC エンドポイント経由でルーティングされる署名付きメッセージを通じて行われます。機密データがブラウザー拡張機能から離れることはありません。