若代幣已被 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 等）
注意： 若該瀏覽器尚未展示 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。
© Panda Academy 原創內容
未經許可禁止轉載，轉載需註明出處
PandaAcademy 係由 PandaTool 推出之 Web3 教育品牌，定位為 Web3 時代開放式技能學院
