メタマスクにトークンアイコンを手動で追加する方法は？

メタマスクユーザーは、カスタムトークンリストを更新するか、開発者ツールを使用してサポートされていないERC-20トークンの認識を改善することにより、手動でトークンアイコンを追加できます。

2025/06/12 03:49

メタマスクとは何ですか？トークンアイコンを追加する必要があるのはなぜですか？

Metamaskは、ユーザーがEthereumブロックチェーンと対話できるようにする人気のある暗号通貨ウォレットです。エーテル（ETH）だけでなく、さまざまなERC-20トークンもサポートします。多くの一般的に使用されるトークンは、メタマスクインターフェイス内にアイコンを自動的に表示しますが、あまり知られていないまたは新しく起動されたトークンの一部はアイコンを表示しないため、一目で識別するのが難しくなります。

トークンアイコンを手動で追加すると、各トークンが認識可能な視覚的表現を確保することにより、ユーザビリティを改善することができます。これは、複数のトークンを定期的に管理するユーザーにとって特に便利です。アイコンなしでトークンに遭遇した場合、メタマスクがトークンのメタデータをまだインデックス化していないか、トークン開発者が公開リポジトリに含めるためにそれを提出していないためです。

Metamaskはトークンアイコンをどのように表示しますか？

Metamaskは、Coingeckoやコミュニティに維持されたトークンリストなど、 tokenlists.orgなどのGitHubリポジトリなどのトークンリストを含むいくつかのソースからトークン情報を引き出します。トークンがユーザーのウォレットに追加されると、メタマスクはこれらのソースからシンボル、名前、アイコンを取得しようとします。データが利用できない場合、トークンは一般的なプレースホルダーアイコンで表示されます。

アイコン自体は、通常、オンラインでホストされている画像ファイルを指すURLとして保存されます。メタマスクが正しいアイコンを表示するには、トークン契約アドレスを、認識されているトークンリストの1つでこの画像URLに関連付ける必要があります。トークンアイコンを手動で追加するには、これらのリストのいずれかを更新するか、カスタムアイコンパスを認識するためにローカルウォレットを構成することが含まれます。

カスタムトークンリストを介してトークンアイコンを手動で追加する手順

メタマスクにトークンアイコンを手動で追加するには、1つのメソッドには、目的のトークンのアイコンURLを含むカスタムトークンリストJSONファイルの作成または変更が含まれます。方法は次のとおりです。

• トークン契約アドレスとアイコンURLの準備ができていることを確認してください。

• 新しいJSONファイルを作成するか、フォーマットに従って既存のファイルを変更します。

   {
   'name': 'Custom Token List',
   'logoURI': 'https://example.com/icon.png',
   'timestamp': '2024-03-15T12:00:00Z',
   'tokens': [ { 'chainId': 1, 'address': '0x...', 'symbol': 'TKN', 'name': 'Token Name', 'decimals': 18, 'logoURI': 'https://example.com/tkn-icon.png' }

  ]
  }

• ファイルを保存して、公開されているサーバーまたはホスティングサービス（GitHubページなど）にアップロードします。

• メタマスクでは、 [設定]> [Advanced]> [トークン]リストを管理します。

• [トークンリストの追加]をクリックし、ホストされたJSONファイルのURLを貼り付けます。

• 必要に応じてメタマスクを確認してリロードします。

これらの手順を完了した後、カスタムトークンアイコンがウォレットのトークン名と一緒に表示されるようになりました。

トークンリストを変更せずにトークンアイコンを追加します

外部トークンリストを処理したくない場合は、開発者ツールを使用してメタマスクインスタンス内のトークンアイコンを手動でオーバーライドできます。この方法は、ローカルインストールにのみ適用され、他のユーザーには影響しません。

• メタマスクを開き、カスタマイズするトークンが既に追加されていることを確認してください。
• ブラウザのメタマスク拡張機能を右クリックし、 [検査]を選択して開発者ツールを開きます。
• [アプリケーション]タブに移動してから、ローカルストレージの下で、 metamask-controller-stateのエントリを見つけます。
• tokensセクションを見つけて、契約アドレスに対応するトークンオブジェクトを見つけます。
• トークンオブジェクト内に、新しいキー値ペアを追加します： 'iconUrl': 'https://example.com/tkn-icon.png' 。
• メタマスクをリロードして、更新されたアイコンを表示します。

このアプローチには、ブラウザ開発者ツールにある程度の精通が必要であり、バックアップされない限り、デバイスやセッション全体で永続的ではありません。

手動追加のトークンアイコンはどこにありますか？

特定のトークンの正しいアイコンを見つけることは、メタマスクに手動で追加する場合に不可欠です。最も信頼できる情報源には次のものがあります。

• 公式トークンのWebサイト：ほとんどのプロジェクトは、公式サイトで高品質のアイコンをホストしています。
• GitHubリポジトリ：多くのトークン開発者は、アイコンを含む資産を公開リポジトリに維持しています。
• コミュニティ主導のトークンリスト： tokenlists.orgのようなプラットフォームには、多くの場合、さまざまなトークンの検証済みアイコンURLが含まれています。
• サードパーティの資産ディレクトリ：一部のサービスはトークンメタデータを集め、ダウンロード可能なアイコンを提供します。

アイコンURLを使用する前に、 .pngファイルを直接指すようにし、認証なしで公開されていることを確認してください。壊れたリンクまたは不正なリンクを使用すると、アイコンがロードに失敗したり、メタマスクでブロックされたりする可能性があります。

---

よくある質問（FAQ）

Q：メタマスクのトークンアイコンに画像形式を使用できますか？

Metamaskは、透明性のサポートと幅広い互換性により、主にトークンアイコンの.pngファイルをサポートしています。 .jpgや.svgなどの他の形式を使用すると、表示の問題やサポートされていないレンダリングが発生する可能性があります。

Q：メタマスクを更新した後、手動で追加されたトークンアイコンは留まりますか？

ローカルの変更（ローカルストレージの編集など）を介して追加されたアイコンは、更新やキャッシュクリアの後にリセットされる場合があります。ただし、カスタムトークンリストを介して追加されたアイコンは、リストがアクティブで変更されていない限り保存されます。

Q：メタマスク内のトークンアイコンにサイズの要件はありますか？

厳密なサイズの要件はありませんが、明確にするために少なくとも64x64ピクセルの正方形の画像を使用することをお勧めします。高解像度ディスプレイには、より大きなサイズ（例、256x256）が推奨されます。

Q：Tokenのアイコンを送信して、Metamaskのデフォルトリストに含めることはできますか？

はい、トークンをCoingeckoやUniswapのトークンリストなどのプラットフォームに提出することができます。これらのサービスに提出すると、手動介入なしにメタマスクで自動アイコン検出の可能性が高まります。