Trust Wallet でトークンの価格またはロゴが正しく表示されないのはなぜですか?

トークン契約の検証の問題

1. Trust Wallet が正確な価格とロゴのデータを表示する前に、EVM 互換チェーンにデプロイされたトークン コントラクトをそれぞれのブロック エクスプローラーで検証する必要があります。

2. 未検証の契約はフォールバック動作をトリガーし、Trust Wallet が汎用のプレースホルダー アイコンを取得し、価格フィードを完全に省略します。

3. 検証には、オンチェーンのバイトコードと正確に一致するように、ソース コード、コンパイラーのバージョン、最適化設定、およびコンストラクター引数を送信する必要があります。

4. プロキシ パターンを介して、または複雑な初期化ロジックを使用してデプロイされたコントラクトは、すべてのアップグレード可能なコンポーネントが個別に送信されない限り、検証に失敗することがよくあります。

5. 検証が成功した後でも、手動でキャッシュをクリアしたりウォレットを再起動しないと、Trust Wallet 内のキャッシュ層により更新が最大 72 時間遅れる可能性があります。

ロゴのホスティングと形式の要件

1. Trust Wallet は、直接画像アクセスを使用して HTTPS エンドポイントでホストされているロゴのみを受け入れます。リダイレクト、認証ウォール、動的 CDN トークンは許可されません。

2. サポートされている形式には PNG と SVG が含まれます。 JPEG ファイルは、有効な HTTPS 経由で提供された場合でも、サイレントに拒否されます。

3. 寸法は正方形で、少なくとも 256×256 ピクセルでなければなりません。サイズが小さいと、デバイス密度全体でレンダリングの失敗やピクセル化が発生します。

4. ファイル名には特殊文字やスペースを含めることはできません。パスには英数字とハイフンのみが許可されます。

5. CORS ヘッダーは、trustwallet.com および関連するサブドメインからのリクエストを明示的に許可する必要があります。許可しないと、クライアント側でのイメージのロードが失敗します。

価格フィード統合の依存関係

1. 価格データは、CoinMarketCap や他のアグリゲーターではなく、CoinGecko のトークン リストと API インデックスのみに依存します。

2. Trust Wallet がリアルタイムの価格を取得する前に、正しいコントラクト アドレス、チェーン ID、シンボル マッピングを使用してトークンを公式 CoinGecko トークン リストに追加する必要があります。

3. CoinGecko エントリの小数点が欠落しているか不一致であると、価格スケーリング エラーが発生します。10 進数の除算が間違っているため、$100 ではなく $0.0001 が表示されます。

4. 複数のチェーンにまたがるトークンには、ネットワークごとに個別のリストが必要です。 BSC リストは Polygon または Arbitrum に自動伝播されません。

5. CoinGecko の毎日の同期サイクルの遅延により、承認後最大 24 時間、新しく上場されたトークンの価格が古いか、表示されない可能性があります。

ウォレットキャッシュとローカルストレージの動作

1. Trust Wallet は、ロゴ URL や価格タイムスタンプを含むトークン メタデータを、契約変更時に自動更新されないローカル SQLite データベースに保存します。

2. ユーザーは、完全なコントラクト アドレスを使用してトークンを手動で削除し、再度追加して新しいメタデータを強制的に取得する必要があります。

3. Android と iOS のバージョンでは、キャッシュの無効化の処理方法が異なります。iOS では、アプリのバックグラウンド更新が有効になっていない限り、古いアセットがより長く保持されます。

4. アプリのストレージをクリアすると、すべてのカスタム トークンの設定がリセットされ、ウォッチリストのエントリを個別に再インポートする必要があります。

5. ネットワーク切り替え (例: Ethereum メインネットから Base へ) は、​​キャッシュされたアセットを前のチェーンからパージしないため、クロスチェーンのロゴの不一致が発生します。

よくある質問

Q: Trust Wallet は、トークン検出用のカスタム RPC エンドポイントをサポートしていますか? A: いいえ。Trust Wallet は、内部リストに登録されているトークン、またはデフォルト RPC 上の既知のコントラクト アドレスに一致するトークンのみを認識します。カスタム エンドポイントは、トークン スキャン中に無視されます。

Q: 契約を再展開せずにロゴを強制的に更新できますか? A: はい。ロゴ URL が変更されていないがコンテンツが更新されている場合は、Trust Wallet が新しい画像を検出する前に、CDN キャッシュを無効にして、新しい画像がブラウザに正しく読み込まれることを確認する必要があります。

Q: 私のトークンは MetaMask では正しいデータを表示するのに、Trust Wallet では正しいデータを表示しないのはなぜですか? A: MetaMask は tokenlists.org のような分散型トークン リストを使用し、ユーザーが送信したメタデータを許可します。一方、Trust Wallet は CoinGecko と独自の検証済み資産レジストリを通じて一元的な検証を強制します。

Q: メインネットのローンチ前にロゴと価格の表示をテストする方法はありますか? A: はい - Trust Wallet がサポートするテストネット (セポリア、ムンバイなど) に同一のコントラクト ロジックとメタデータをデプロイし、最初にそこでアセットを検証してホストし、レンダリング動作を検証します。