為什麼我的代幣價格或徽標在 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、孟買）部署相同的合約邏輯和元數據，然後首先在那裡驗證和託管資產以驗證渲染行為。