为什么Phantom钱包显示的代币余额错误？

代币余额显示机制

1. Phantom Wallet 通过查询用户设置中配置的 Solana RPC 端点来检索代币余额。

2. 它使用getParsedTokenAccountsByOwner RPC 方法来获取与公钥关联的 SPL 令牌持有量。

3. 钱包不在本地存储链上状态——它完全依赖实时 RPC 响应来进行余额计算。

4. 如果 RPC 节点不同步或返回不完整的帐户数据，Phantom 将显示陈旧或丢失的令牌条目。

5. 自定义令牌元数据是从令牌列表存储库中单独获取的；此处的不匹配会导致符号或小数点渲染不正确。

RPC节点同步问题

1. https://api.mainnet-beta.solana.com等公共 RPC 端点在网络拥塞或验证器停机期间可能会遇到短暂的延迟。

2. Phantom 不验证多个 RPC 提供者之间的块高度一致性 - 它默认为单个配置的端点。

3. 即使交易在其他节点上得到确认，未处理最近代币传输的节点似乎仍显示零余额。

4. 一些 RPC 服务会删除旧的令牌帐户记录以节省存储空间，从而导致虚拟帐户从余额查询中消失。

5. 跨集群分叉（尽管很少见）可能会导致暂时的余额差异，直到所有验证者达成最终结果。

令牌列表和元数据不匹配

1. Phantom 从社区维护的列表（例如 GitHub 上托管的solana-token-list）中提取代币元数据（包括小数、徽标和名称）。

2. 如果列表中缺少代币的铸造地址或包含过时的小数，Phantom 会将原始 lamport 值误解为代币。

3. 部署在开发网或测试网上的代币有时会泄漏到主网代币列表中，从而在错误的环境中触发误报余额。

4. 手动添加代币绕过列表验证，但不正确的小数输入会导致余额缩放错误仅在转账确认后可见。

5. 在重叠的代币列表中以不同名称注册的重复铸币地址混淆了 Phantom 的内部映射逻辑。

钱包缓存行为

1. Phantom 将令牌帐户数据缓存长达 30 秒，以减少 RPC 负载并提高 UI 响应能力。

2. 缓存失效仅发生在显式用户操作（例如切换网络）或超时后，而不是链上事件检测。

3. 在没有会话同步的情​​况下跨设备并发使用钱包会导致缓存状态不同。

4. 浏览器扩展存储限制可能会截断大型令牌帐户数组，从而默默地从显示中忽略低余额令牌。

5. 持久存储中的 IndexedDB 损坏可能会锁定在重新加载和重新启动后仍然存在的过时余额快照。

常见问题解答

问：为什么我的代币余额在 Solscan 上显示正确，但在 Phantom 中显示错误？ Phantom 依赖于 RPC 节点状态和 token 列表的准确性； Solscan 可能会使用不同的 RPC 提供者或直接账本解析，从而导致观点不同。

问：我可以强制 Phantom 立即刷新代币余额吗？是——断开钱包与 dApp 的连接并重新连接，或者通过设置 > 网络 > RPC URL 手动切换 RPC 端点，以触发完整缓存重置和新查询。

问：为什么新收到的代币需要几分钟才能出现在 Phantom 中？延迟源于 RPC 传播延迟、Phantom 的 30 秒缓存窗口以及缺乏对令牌帐户更改的实时 WebSocket 订阅。

问：Phantom 是否支持使用 WebSocket 订阅的自定义 RPC 端点？否 - Phantom 专门使用基于 HTTP 的 RPC 调用，并且不为帐户更改事件实现 WebSocket 侦听器，从而限制了实时余额更新。