若代幣已被 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”; // 必須為 HTTPStry {
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 係由 PandaTool 推出之 Web3 教育品牌，定位為 Web3 時代開放式技能學院
本文由PandaAcademy原创，如若转载，请注明出处：http://academy.pandatool.org/zh_HK/kn/974
。PandaAcademy是PandaTool旗下的Web3学习中心，专注于向普通用户提供区块链和加密货币知识输出
原创文章，作者：pandatool，如若转载，请注明出处：https://academy.pandatool.org/zh_HK/kn/974
