如何修復 Phantom 錢包在收到 SPL 令牌後不顯示它的問題？

對 Phantom 錢包中的 SPL 令牌可見性進行故障排除

1. 驗證代幣的合約地址與在 Solana Explorer 上註冊的地址是否相符。 Phantom 僅顯示具有託管在官方令牌清單儲存庫上的已驗證元資料的令牌。

2. 透過檢查solscan.io或explorer.solana.com上的簽章雜湊來確認交易已在鏈上確認。未確認或失敗的交易不會觸發代幣顯示邏輯。

3. 確保錢包連接到正確的網路 - Phantom 必須設定為mainnet-beta ，而不是 devnet 或 testnet ，因為部署在備用叢集上的 SPL 代幣在生產視圖中仍然不可見。

4. 透過 Phantom 的「新增代幣」>「自訂代幣」流程，使用其鑄幣地址手動添加代幣。一些新推出的 SPL 代幣在預設代幣清單中缺少社群維護的條目。

5. 透過斷開所有 dApp 的連線、關閉擴充功能並重新開啟來清除 Phantom 的本機快取。持續的 UI 渲染錯誤有時會凍結代幣餘額更新，而無需完全重新加載。

自動偵測的代幣資料要求

1. SPL 令牌必須具有提交到solana-labs/token-list GitHub 儲存庫的有效token-list.json條目。

2. 元資料欄位（包括name 、 symbol 、 logoURI和小數）必須存在於 JSON 物件中且格式正確。

3. logoURI 必須指向可公開存取的 HTTPS 端點，傳回大小小於 1MB 的有效 PNG 或 SVG 檔案。

4. 代幣清單中列出的鑄幣地址必須與鏈上程式派生地址完全匹配－而不是包裝器或代理合約。

5. Phantom 在錢包初始化時拉取該清單；更改需要完全重新啟動擴充功能或刷新瀏覽器會話才能生效。

常見的交易級錯誤配置

1. 發送者使用代幣的包裝版本（例如，蟲洞包裝）而不是本機 SPL 鑄幣，導致 Phantom 將其視為不帶自動發現支援的獨特資產。

2. 接收帳戶是使用舊版的 SPL 代幣程式建立的，導致帳戶資料佈局不相容，無法進行餘額解析。

3. 轉帳指令包含備忘錄或自訂計算預算，會觸發後處理掛鉤中的靜默失敗，導致儘管交易成功，但餘額變化為零。

4. 令牌啟用了凍結權限，並且帳戶在收到之前被凍結，鎖定可見性，直到透過授權簽署者解凍。

5. 該事務與跨多個程式的其他指令捆綁在一起，導致 Phantom 的內部解析器因不完整的指令追蹤而跳過 SPL 餘額協調。

瀏覽器擴充功能與行動應用程式行為差異

1. Phantom Mobile 不會自動同步來自與瀏覽器擴充功能相同來源的令牌列表，它依賴於單獨的、不經常更新的內部快取。

2. v6.6.0之前的瀏覽器擴充版本會忽​​略小數位大於9的代幣，將餘額截斷為零並將其從資產清單中刪除。

3. 行動用戶必須從錢包設定選單手動觸發“刷新餘額”，而桌面用戶則依賴每 30 秒自動輪詢一次。

4. iOS Safari Web Clip 安裝繞過 Phantom 的後台服務工作人員，完全停用即時平衡偵聽器。

5. 基於 Chrome 的瀏覽器允許與 Solana 的 RPC 層進行更深入的集成，與基於 WebView 的移動環境相比，可以實現更豐富的令牌檢測。

常見問題解答

Q：為什麼我的 SPL 代幣出現在 Solflare 中而不是 Phantom 中？答：Solflare 維護自己獨立的令牌註冊表，並支援手動覆蓋遺失的元資料。 Phantom 嚴格執行官方 Solana 令牌列表，並拒絕具有格式錯誤的 URI 或校驗和不匹配的條目。

Q：我可以使用 Phantom 的開發者模式查看未經驗證的 SPL 代幣嗎？答：不會。 Phantom 不會公開未列出代幣的開發人員切換。它的 UI 層僅根據規範清單中的存在情況在渲染時過濾資產。

Q：Phantom 是否支援透過 Token-2022 擴充部署的代幣？答：Phantom 目前會忽略使用 Token-2022 功能初始化的帳戶，例如轉帳費用或保密轉帳。僅渲染與 Token-2022 相容且不含擴展的舊鑄幣廠。

Q：為什麼確認成功後代幣餘額顯示為0？答：Phantom 透過讀取關聯代幣帳戶的金額欄位來計算餘額。如果帳戶是使用零連接埠初始化的或缺乏適當的所有權委派，則解析器將傳回 null 而不是零，從而抑制顯示。