내 토큰 가격이나 로고가 Trust Wallet에 올바르게 표시되지 않는 이유는 무엇입니까?

토큰 계약 확인 문제

1. EVM 호환 체인에 배포된 토큰 계약은 Trust Wallet이 정확한 가격과 로고 데이터를 표시하기 전에 해당 블록 탐색기에서 확인되어야 합니다.

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. 가격 데이터는 CoinMarketCap이나 다른 수집자가 아닌 CoinGecko의 토큰 목록과 API 인덱싱에만 의존합니다.

2. Trust Wallet이 실시간 가격을 검색하기 전에 올바른 계약 주소, 체인 ID 및 기호 매핑을 사용하여 공식 CoinGecko 토큰 목록에 토큰을 추가해야 합니다.

3. CoinGecko 항목의 소수가 누락되거나 일치하지 않으면 가격 스케일링 오류가 발생합니다. 잘못된 밑수 10 나누기로 인해 $100 대신 $0.0001이 표시됩니다.

4. 여러 체인에 걸쳐 연결되는 토큰에는 네트워크당 개별 목록이 필요합니다. BSC 목록은 Polygon 또는 Arbitrum으로 자동 전파되지 않습니다.

5. CoinGecko의 일일 동기화 주기 지연은 새로 상장된 토큰이 승인 후 최대 24시간 동안 오래되거나 누락된 가격으로 나타날 수 있음을 의미합니다.

지갑 캐시 및 로컬 저장소 동작

1. 트러스트 월렛은 로고 URL 및 가격 타임스탬프를 포함한 토큰 메타데이터를 계약 변경 시 자동으로 새로 고쳐지지 않는 로컬 SQLite 데이터베이스에 저장합니다.

2. 새로운 메타데이터를 강제로 가져오려면 사용자는 전체 계약 주소를 사용하여 토큰을 수동으로 제거하고 다시 추가해야 합니다.

3. Android 및 iOS 버전은 캐시 무효화를 다르게 처리합니다. iOS는 백그라운드 앱 새로 고침이 활성화되지 않는 한 오래된 자산을 더 오랫동안 유지합니다.

4. 앱 저장소를 지우면 모든 맞춤 토큰 기본 설정이 재설정되고 관심 목록 항목을 개별적으로 다시 가져와야 합니다.

5. 네트워크 전환(예: 이더리움 메인넷에서 베이스로)은 이전 체인에서 캐시된 자산을 제거하지 않으므로 크로스체인 로고 불일치가 발생합니다.

자주 묻는 질문

Q: Trust Wallet은 토큰 검색을 위한 맞춤형 RPC 엔드포인트를 지원합니까? A: 아니요. 트러스트 월렛은 내부 목록에 등록된 토큰이나 기본 RPC의 알려진 계약 주소와 일치하는 토큰만 인식합니다. 토큰 스캔 중에는 사용자 정의 엔드포인트가 무시됩니다.

Q: 계약을 재배포하지 않고 로고 업데이트를 강제할 수 있나요? 답변: 예. 로고 URL은 변경되지 않았지만 콘텐츠가 업데이트된 경우 CDN 캐시를 무효화하고 Trust Wallet이 이를 감지하기 전에 브라우저에서 새 이미지가 올바르게 로드되는지 확인해야 합니다.

Q: 내 토큰이 MetaMask에 올바른 데이터를 표시하지만 Trust Wallet에는 표시되지 않는 이유는 무엇입니까? 답변: MetaMask는 tokenlists.org와 같은 분산형 토큰 목록을 사용하고 사용자가 제출한 메타데이터를 허용하는 반면, Trust Wallet은 CoinGecko 및 자체 검증된 자산 등록을 통해 중앙 집중식 검증을 시행합니다.

Q: 메인넷 출시 전에 로고와 가격 표시를 테스트할 수 있는 방법이 있나요? A: 예. Trust Wallet이 지원하는 테스트넷(예: Sepolia, Mumbai)에 동일한 계약 로직과 메타데이터를 배포한 다음 먼저 그곳에서 자산을 확인하고 호스팅하여 렌더링 동작을 검증합니다.