如何修复 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 的移动环境相比，可以实现更丰富的令牌检测。

常见问题解答

问：为什么我的 SPL 代币出现在 Solflare 中而不是 Phantom 中？答：Solflare 维护自己独立的令牌注册表，并支持手动覆盖丢失的元数据。 Phantom 严格执行官方 Solana 令牌列表，并拒绝具有格式错误的 URI 或校验和不匹配的条目。

问：我可以使用 Phantom 的开发者模式查看未经验证的 SPL 代币吗？答：不会。Phantom 不会公开未列出代币的开发人员切换。它的 UI 层仅根据规范列表中的存在情况在渲染时过滤资产。

问：Phantom 是否支持通过 Token-2022 扩展部署的代币？答：Phantom 目前会忽略使用 Token-2022 功能初始化的账户，例如转账费用或保密转账。仅渲染与 Token-2022 兼容且不带扩展的旧铸币厂。

Q：为什么确认成功后代币余额显示为0？答：Phantom 通过读取关联代币账户的金额字段来计算余额。如果帐户是使用零端口初始化的或缺乏适当的所有权委派，则解析器将返回 null 而不是零，从而抑制显示。