如何在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);
}