如何在MetaMask為代幣上載 Logo？

若代幣已被 CoinGecko、CoinMarketCap、Etherscan 等主流平臺收錄，用戶可透過這些平臺的一鍵添加功能，將代幣及官方 Logo 一併導入 MetaMask；若代幣尚未被收錄，或想要掌控展示效果，可在自家 DApp/網站中調用 MetaMask 的 wallet_watchAsset 接口，自動彈出“添加資產”提示並顯示自訂 Logo。

一、用戶端快速添加方法

1. 透過 CoinGecko

開啟代幣在 CoinGecko 的頁面。
點擊 「Add to MetaMask」（小狐狸圖示）按鈕。
在 MetaMask 彈窗中確認，即可將代幣與 Logo 一併導入。

小提示： 桌面與行動裝置皆支援，行動端需在 MetaMask 內建瀏覽器開啟 CoinGecko。

2. 透過 CoinMarketCap

造訪代幣在 CoinMarketCap 的詳細頁面。
點擊代幣名稱旁的小狐狸圖示。
在錢包彈窗中確認，完成添加。

3. 透過區塊瀏覽器（Etherscan、BscScan、Polygonscan 等）

在對應網絡的區塊瀏覽器搜尋並開啟代幣合約頁面。
點擊「More（更多）」選單中的 「Add token to MetaMask」。
在 MetaMask 對話框中確認，即可導入 Logo 與代幣。

注意： 若該瀏覽器尚未展示 Logo，需要先向其提出 PR 或聯絡團隊上傳 Logo，再進行添加。

二、開發者自動推送方法（EIP‑747）

代幣發行者或 DApp 開發者可在網站或前端整合 MetaMask 的 wallet_watchAsset RPC，觸發「添加資產」彈窗並顯示自訂 Logo。

1. 接口介紹

方法名稱： wallet_watchAsset
標準： Ethereum Improvement Proposal 747（EIP‑747）
功能： 在用戶當前網絡下，彈出 MetaMask 對話框，提示加入該合約地址的代幣及 Logo。

2. 範例程式碼

const tokenAddress = “0xYourTokenContractAddress”;
const tokenSymbol = “SYM”; // 最多 5 字元
const tokenDecimals= 18; // 小數位
const tokenImage = “https://yourdomain/logo.png”; // 必須為 HTTPS

try {
const wasAdded = await window.ethereum.request({
method: “wallet_watchAsset”,
params: {
type: “ERC20”, // 或其他支援類型
options: {
address: tokenAddress,
symbol: tokenSymbol,
decimals: tokenDecimals,
image: tokenImage,
},
},
});
if (wasAdded) {
console.log(“代幣已成功添加至 MetaMask！”);
} else {
console.log(“用戶拒絕添加代幣。”);
}
} catch (error) {
console.error(“添加代幣失敗：”, error);
}

此範例亦適用於實驗性 NFT 支援及其他 EVM 網絡代幣。

三、注意事項

HTTPS Logo： 圖片 URL 必須使用 HTTPS。
網絡一致： 確保用戶切換至代幣所屬網絡，避免因 Chain ID 不符而失敗。
集中索引： MetaMask 的內建搜尋依賴其中心化資料庫，若代幣未上榜，仍須手動或 API 方式添加。
安全提醒： 僅在信任官網或區塊瀏覽器操作，謹防釣魚合約或假冒 Logo。

通過上述「用戶端快捷」與「開發者整合」兩種途徑，即可在 MetaMask（小狐狸錢包）中順利為代幣添加並顯示官方 Logo。

本文由PandaAcademy原创，如若转载，请注明出处：https://academy.pandatool.org/zh_HK/kn/974

。PandaAcademy是PandaTool旗下的Web3学习中心，专注于向普通用户提供区块链和加密货币知识输出