为什么我的代币价格或徽标在 Trust Wallet 中无法正确显示？

代币合约验证问题

1. 在 Trust Wallet 显示准确的价格和徽标数据之前，部署在 EVM 兼容链上的代币合约必须在相应的区块浏览器上进行验证。

2. 未经验证的合约会触发回退行为，Trust Wallet 会提取通用占位符图标并完全忽略价格反馈。

3. 验证需要提交源代码、编译器版本、优化设置和构造函数参数，以准确匹配链上字节码。

4. 通过代理模式或具有复杂初始化逻辑部署的合约通常无法通过验证，除非所有可升级组件都单独提交。

5. 即使验证成功，Trust Wallet 内的缓存层也可能会延迟更新最多 72 小时，而无需手动清除缓存或重启钱包。

徽标托管和格式要求

1. Trust Wallet 仅接受托管在具有直接图像访问功能的 HTTPS 端点上的徽标，不允许重定向、身份验证墙或动态 CDN 令牌。

2.支持的格式包括PNG和SVG；即使通过有效的 HTTPS 提供 JPEG 文件，也会被静默拒绝。

3. 尺寸必须为正方形且至少256×256像素；较小的尺寸会导致渲染失败或跨设备密度的像素化。

4. 文件名不得包含特殊字符或空格 - 路径中仅允许使用字母数字字符和连字符。

5. CORS 标头必须明确允许来自 trustwallet.com 和相关子域的请求，否则客户端图像加载失败。

价格反馈集成依赖性

1. 价格数据完全依赖于 CoinGecko 的代币列表和 API 索引，而不是 CoinMarketCap 或其他聚合器。

2. 在 Trust Wallet 检索实时定价之前，必须将代币添加到 CoinGecko 官方代币列表中，并提供正确的合约地址、链 ID 和符号映射。

3. CoinGecko 条目中小数点缺失或不匹配会导致价格缩放错误 — 由于不正确的 10 基数除法，显示为 0.0001 美元而不是 100 美元。

4.跨多个链桥接的代币需要每个网络单独列出； BSC 列表不会自动传播到 Polygon 或 Arbitrum。

5. CoinGecko 每日同步周期的延迟意味着新上市的代币在批准后的 24 小时内可能会显示陈旧或缺失的价格。

钱包缓存和本地存储行为

1. Trust Wallet 将代币元数据（包括徽标 URL 和价格时间戳）存储在本地 SQLite 数据库中，该数据库不会在合约更改时自动刷新。

2. 用户必须使用其完整合约地址手动删除并重新添加令牌，以强制获取新的元数据。

3. Android 和 iOS 版本处理缓存失效的方式不同 - iOS 会更长时间地保留过时的资源，除非启用后台应用程序刷新。

4. 清除应用程序存储会重置所有自定义令牌首选项，并需要单独重新导入监视列表条目。

5.网络切换（例如从以太坊主网切换到Base）不会清除之前链上的缓存资产，导致跨链标识不匹配。

常见问题解答

问：Trust Wallet 是否支持用于令牌发现的自定义 RPC 端点？答：不能。Trust Wallet 仅识别在其内部列表中注册的代币或与默认 RPC 上已知合约地址匹配的代币。令牌扫描期间将忽略自定义端点。

问：我可以在不重新部署合约的情况下强制更新徽标吗？答：是的，如果徽标 URL 保持不变但内容更新，您必须使 CDN 缓存失效并确认新图像在 Trust Wallet 检测到之前在浏览器中正确加载。

问：为什么我的代币在 MetaMask 上显示正确的数据，但在 Trust Wallet 上不显示？答：MetaMask 使用 tokenlists.org 等去中心化代币列表，并允许用户提交元数据，而 Trust Wallet 通过 CoinGecko 及其自己的经过验证的资产注册表强制执行集中验证。

问：在主网上线之前，有没有办法测试徽标和价格显示？答：是的——在 Trust Wallet 支持的测试网上（例如，Sepolia、孟买）部署相同的合约逻辑和元数据，然后首先在那里验证和托管资产以验证渲染行为。