如何修復 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 限制。

常見問題解答

Q：Phantom 是否透過 iPad 上的藍牙支援 Ledger Nano X？ Phantom 不支援 iPadOS 進行 Ledger 藍牙配對。 iOS 應用程式二進位檔案專為 iPhone 架構編譯，缺乏針對 iPad 最佳化的 BLE 堆疊綁定。 iPad 使用者必須透過 USB-C 轉 Lightning 轉接器連線或使用基於 Web 的簽章工作流程。

Q：為什麼即使 Ledger Live 偵測到設備，Phantom 仍顯示「未找到 Ledger 設備」？ Ledger Live 使用不同的 BLE 服務 UUID 和 GATT 結構來實現管理功能。 Phantom 僅透過 Solana 特定的 BLE 介面進行通信，除非 Solana 應用程式開啟並位於 Ledger 的前台，否則該介面將保持不活動狀態。

Q：我可以透過藍牙將 Phantom 與 Ledger Stax 一起使用嗎？不會。 Ledger Stax 不會公開用於第三方錢包整合的 BLE 介面。其藍牙堆疊專門用於 Ledger Live 同步和韌體更新。在任何配置下，Phantom 都無法與 Stax 設備建立安全通道。

Q：有沒有辦法在不重新啟動應用程式的情況下強制 Phantom 重新掃描？是的。在 Phantom 錢包連接畫面上向下滑動可觸發手動刷新。這會繞過快取的掃描結果，並使用更新的時序參數啟動新的 BLE 查詢週期。