在 MetaMask 钱包里，若某个代币已经被收录在主流资料库（如 CoinGecko、CoinMarketCap、Etherscan 等），用户可通过这些平台的一键添加功能，将代币和其官方 Logo 一并添加进钱包；若代币尚未被收录，或你希望直营体验，可在自己的 DApp/网站中调用 MetaMask 的 wallet_watchAsset 接口，自动弹窗提示用户“添加资产”并展示自定义 Logo。
一、用户端快速添加方法
1. 通过 CoinGecko
-
打开代币在 CoinGecko 的页面。
-
点击页面中 “Add to MetaMask”（MetaMask 狐狸图标）按钮。
-
在弹出的 MetaMask 窗口中确认，即可将代币及其 Logo 一并导入钱包，并在“发送”“接收”时显示 Logo。
提示：MetaMask 桌面版与移动端均支持此方法；移动端需在内置浏览器中打开 CoinGecko，以便正确触发钱包交互。
2. 通过 CoinMarketCap
-
访问代币在 CoinMarketCap 的详情页。
-
点击代币名称右侧的 MetaMask 狐狸图标。
-
确认钱包弹窗，即可导入该代币和其 Logo。
3. 通过区块浏览器（Etherscan / BscScan / Polygonscan 等）
-
在对应网络的区块浏览器中搜索并访问代币合约页面。
-
点击“More”（更多）菜单中的“Add token to MetaMask”选项。
-
在钱包确认对话框中点击“确认”，Logo 即被添加到 MetaMask。
注意：若该平台本身没有展示 Logo（即 Logo 空白），需先在该浏览器上为代币上传 Logo（通常需提交 PR 或联系其团队）；随后用户方能通过此方式获取 Logo。
二、开发者自动推送方法（EIP‑747）
如果你是代币发行方或 DApp 开发者，可在自己的网站/前端项目中集成 MetaMask 提供的 wallet_watchAsset RPC 接口，自动弹窗提示用户“添加资产”并展示自定义 Logo（URL）。
1. 接口介绍
-
方法名：
wallet_watchAsset -
定义规范：Ethereum Improvement Proposal 747（EIP‑747）support.metamask.iodocs.metamask.io。
-
功能：在用户当前网络下，弹出 MetaMask 对话框，提示其将指定合约地址的代币（含 Logo）加入资产列表。
2. 示例代码
const tokenAddress = “0x你的代币合约地址”;
const tokenSymbol = “SYM”; // 不超过 5 个字符
const tokenDecimals= 18; // 代币小数位
const tokenImage = “https://你的域名/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：Logo URL 必须使用 HTTPS，否则 MetaMask 会因安全策略而拒绝加载。
-
网络一致性：确保用户切换至合约所在网络，否则会因链 ID 不符导致添加失败。
-
中央信任：MetaMask 默认的“代币搜索”与“自动检测”功能依赖其中心化数据库，若代币尚未上榜，仍需手动使用上述方法。
-
安全提醒：仅在信任的官网或区块浏览器上操作，避免遭遇钓鱼合约或恶意替换 Logo。
通过上述“用户端快捷”与“开发者集成”两种路径，便可在 MetaMask（小狐狸钱包）内顺利为代币添加并展示官方 Logo。
© PandaAcademy 原创内容
未经许可禁止转载，转载需注明出处
PandaAcademy 是由 PandaTool 推出的 Web3 教育品牌，定位 Web3 时代开放式技能学院
本文由PandaAcademy原创，如若转载，请注明出处：http://academy.pandatool.org/zh_CN/kn/974
。PandaAcademy是PandaTool旗下的Web3学习中心，专注于向普通用户提供区块链和加密货币知识输出
原创文章，作者：pandatool，如若转载，请注明出处：https://academy.pandatool.org/zh_CN/kn/974
