如何修复 Phantom 钱包无法通过蓝牙检测到我的 Ledger 的问题？

了解 Phantom 钱包和 Ledger 蓝牙配对

1. Phantom Wallet 是一款 Solana 原生浏览器扩展和移动应用程序，旨在管理 SPL 代币、与 dApp 交互以及安全地签署交易。它支持硬件钱包集成，包括 Ledger 设备，通过 iOS 和 Android 平台上的蓝牙。

2. 账本设备依靠低功耗蓝牙 (BLE) 与移动钱包进行通信。与 USB 连接不同，BLE 需要精确的定时同步、邻近性和整洁的 2.4 GHz 无线电条件，这些因素直接影响 Phantom 检测设备的能力。

3. Phantom不支持桌面浏览器蓝牙配对；此功能仅限于其官方 iOS 和 Android 应用程序。尝试通过 Chrome 或 Edge 扩展程序配对将导致立即检测失败。

4. Ledger 必须运行固件版本 2.1.0 或更高版本，并且安装并打开 Solana 应用程序。较旧的固件版本缺少 Phantom 握手启动所需的 BLE 广告数据包。

5. Phantom 使用专有的 BLE 服务 UUID (0000fff0-0000-1000-8000-00805f9b34fb)，并在发现过程中期望特定的 GATT 特征。任何偏差（例如自定义固件分支或修改的引导加载程序行为）都会默默地破坏握手协议。

常见检测失败及根本原因

1. Phantom的应用程序权限中禁用了蓝牙扫描。在 iOS 上，用户必须在“设置”>“隐私和安全”>“蓝牙”下授予“蓝牙”权限。在 Android 上，由于 Android 的传统 BLE 策略强制执行，即使不使用 GPS 数据，BLE 扫描也​​需要位置权限。

2. Ledger 卡在引导加载程序模式而不是应用程序模式。上电时，设备显示“Bootloader”而不是“Solana”，从而阻止其广播正确的 BLE 服务广告。

3. Phantom 的内部 BLE 缓存保留陈旧的设备条目。如果先前的配对尝试在握手过程中失败，则缓存的绑定信息可能会阻止后续的发现尝试，直到手动清除。

4. 在密集环境中，来自其他 BLE 外设的干扰频繁发生。智能手表、无线耳机和附近的移动钱包主动扫描硬件设备可能会导致 BLE 查询窗口饱和，导致 Phantom 错过 Ledger 的广告间隔。

5. Ledger 的蓝牙堆栈在 60 秒不活动后进入低功耗睡眠状态。如果 Phantom 在此超时之后且在用户手动唤醒设备之前启动扫描，则 Ledger 将保持不可见，直到进行物理交互。

逐步设备级恢复

1. 重新启动两台设备：按住两侧按钮 10 秒直至屏幕空白，然后重新启动，完全关闭 Ledger。强制退出 Phantom 应用程序并重新启动它——不仅仅是滑动，而是使用应用程序管理器终止后台进程。

2. 明确启用 Ledger 蓝牙：导航至 Ledger 设备上的“设置”>“连接”>“蓝牙”并将其切换为“打开”。确认屏幕上出现“蓝牙已启用”。即使之前已启用，也不要跳过此步骤。

3. 在启动 Phantom之前，在 Ledger 上打开 Solana 应用程序。该应用程序必须处于活动状态并显示 Solana 主屏幕。仅当 Solana 应用程序处于前台且响应时，Phantom 才会检测到 Ledger。

4. 从 Phantom 开始配对：点击“连接钱包”>“Ledger”>“继续”。等待至少 90 秒，不要触摸任何设备。 Phantom 执行三个连续扫描窗口；过早的交互会扰乱发生大多数成功检测的第三个窗口。

5. 重置 Ledger 蓝牙绑定：在 Ledger Live 桌面应用程序中，转到管理器 > 设置 > 重置蓝牙配对。这将清除所有存储的密钥，并在下一次 Phantom 握手期间强制交换新的密钥。

网络和固件验证检查

1. 使用 Ledger Live 验证 Ledger 固件版本。 2.1.0 之前的版本不公开所需的 BLE 描述符。如果固件已过时，请在尝试幻像配对之前更新固件 - 切勿跳过此验证。

2. 确认 Solana 应用程序版本为 2.2.1 或更高版本。早期版本省略了关键的 BLE 数据包签名字段，导致 Phantom 的身份验证阶段出现静默拒绝。

3. 在 App Store 或 Play Store 中检查 Phantom 应用程序版本。低于 2.17.0 的版本号在 BLE GATT 描述符枚举中包含已知的竞争条件，导致设备可见性不一致。

4. 暂时禁用手机上所有其他支持 BLE 的应用程序，包括 Ledger Live mobile、MetaMask Mobile 和 Trezor Suite。并发 BLE 扫描会干扰 Phantom 的专用查询时隙分配。

5. 使用另一部兼容手机（如果有）进行测试。这样可以区分问题是存在于 Phantom 的本地 BLE 堆栈实现还是主要设备特有的环境 RF 限制中。

常见问题解答

问：Phantom 是否通过 iPad 上的蓝牙支持 Ledger Nano X？ Phantom 不支持 iPadOS 进行 Ledger 蓝牙配对。 iOS 应用程序二进制文件专为 iPhone 架构编译，缺乏针对 iPad 优化的 BLE 堆栈绑定。 iPad 用户必须通过 USB-C 转 Lightning 适配器连接或使用基于 Web 的签名工作流程。

问：为什么即使 Ledger Live 检测到设备，Phantom 仍显示“未找到 Ledger 设备”？ Ledger Live 使用不同的 BLE 服务 UUID 和 GATT 结构来实现管理功能。 Phantom 仅通过 Solana 特定的 BLE 接口进行通信，除非 Solana 应用程序打开并位于 Ledger 的前台，否则该接口将保持不活动状态。

问：我可以通过蓝牙将 Phantom 与 Ledger Stax 一起使用吗？不会。Ledger Stax 不会公开用于第三方钱包集成的 BLE 接口。其蓝牙堆栈专门用于 Ledger Live 同步和固件更新。在任何配置下，Phantom 都无法与 Stax 设备建立安全通道。

问：有没有办法在不重新启动应用程序的情况下强制 Phantom 重新扫描？是的。在 Phantom 钱包连接屏幕上向下滑动可触发手动刷新。这会绕过缓存的扫描结果，并使用更新的时序参数启动新的 BLE 查询周期。