Phantom ウォレットが Bluetooth 経由でレジャーを検出しない問題を修正するにはどうすればよいですか?

Phantom Wallet と Ledger の Bluetooth ペアリングについて

1. Phantom Wallet は、Solana ネイティブのブラウザ拡張機能およびモバイル アプリケーションであり、SPL トークンの管理、dApp との対話、トランザクションの安全な署名を目的に設計されています。 iOS および Android プラットフォーム上の Bluetooth を介した、Ledger デバイスを含むハードウェア ウォレットの統合をサポートします。

2. 台帳デバイスは、Bluetooth Low Energy (BLE) を利用してモバイル ウォレットと通信します。 USB 接続とは異なり、BLE では正確なタイミング同期、近接性、整然とした 2.4 GHz 無線条件が必要です。これらの要素は、Phantom のデバイス検出能力に直接影響します。

3. Phantom はデスクトップブラウザでの Bluetooth ペアリングをサポートしていません。この機能は、公式 iOS および Android アプリに制限されています。 Chrome または Edge 拡張機能を介してペアリングしようとすると、すぐに検出に失敗します。

4. Ledger はファームウェア バージョン 2.1.0 以降を実行しており、Solana アプリがインストールされて開いている必要があります。古いファームウェア バージョンには、ファントム ハンドシェイクの開始に必要な BLE アドバタイジング パケットがありません。

5. Phantom は独自の BLE サービス UUID (0000fff0-0000-1000-8000-00805f9b34fb) を使用し、検出中に特定の GATT 特性を期待します。カスタム ファームウェア フォークやブートローダーの動作の変更など、何らかの逸脱が発生すると、ハンドシェイク プロトコルがサイレントに中断されます。

一般的な検出失敗と根本原因

1. Phantom のアプリ権限で Bluetooth スキャンが無効になっています。 iOS では、ユーザーは [設定] > [プライバシーとセキュリティ] > [Bluetooth] で「Bluetooth」を許可する必要があります。 Android では、Android の従来の BLE ポリシーの適用により、GPS データが使用されない場合でも、BLE スキャンに位置情報の許可も必要になります。

2. Ledger がアプリケーション モードではなくブートローダー モードでスタックします。電源を入れると、デバイスに「Solana」ではなく「Bootloader」が表示され、正しい BLE サービス アドバタイズメントをブロードキャストできなくなります。

3. Phantom の内部 BLE キャッシュには、古いデバイス エントリが保持されます。前回のペアリング試行がハンドシェイク中に失敗した場合、キャッシュされたボンディング情報により、手動でクリアされるまで、後続の検出試行がブロックされる場合があります。

4. 密集した環境では、他の BLE 周辺機器からの干渉が頻繁に発生します。スマートウォッチ、ワイヤレスイヤホン、近くのモバイルウォレットがハードウェアデバイスをアクティブにスキャンしていると、BLE 照会ウィンドウが飽和状態になり、Phantom が Ledger のアドバタイズ間隔を見逃す可能性があります。

5. Ledger の Bluetooth スタックは、60 秒間の非アクティブ状態が続くと低電力スリープに入ります。このタイムアウト後、かつユーザーがデバイスを手動でウェイクアップする前に Phantom がスキャンを開始した場合、Ledger は物理的に操作されるまで非表示のままになります。

段階的なデバイスレベルのリカバリ

1. 両方のデバイスの電源を入れ直します。画面が消えるまで両方のサイドボタンを 10 秒間押し続けて、Ledger を完全にオフにし、再起動します。 Phantom アプリを強制終了して再起動します。スワイプするだけでなく、アプリ マネージャーを使用してバックグラウンド プロセスを終了します。

2. Ledger Bluetooth を明示的に有効にします。Ledger デバイスで [設定] > [接続] > [Bluetooth] に移動し、オンに切り替えます。画面に「Bluetooth が有効になりました」と表示されていることを確認します。以前に有効にしていた場合でも、この手順をスキップしないでください。

3. Phantom を起動する前に、 Ledger で Solana アプリを開きます。アプリがアクティブで、Solana ホーム画面が表示されている必要があります。 Phantom は、Solana アプリがフォアグラウンドで応答している場合にのみ Ledger を検出します。

4. Phantom からペアリングを開始します。「Connect Wallet」>「Ledger」>「Continue」をタップします。どちらのデバイスにも触れずに、少なくとも 90 秒待ちます。 Phantom は 3 つの連続スキャン ウィンドウを実行します。時期尚早な相互作用により、最も成功した検出が行われる 3 番目のウィンドウが中断されます。

5. Ledger Bluetooth ボンディングのリセット: Ledger Live デスクトップ アプリで、[マネージャー] > [設定] > [Bluetooth ペアリングのリセット] に移動します。これにより、保存されているすべてのキーがクリアされ、次のファントム ハンドシェイク中に新しいキーの交換が強制されます。

ネットワークとファームウェアの検証チェック

1. Ledger Liveを使用してLedgerファームウェアのバージョンを確認します。 2.1.0 より前のバージョンでは、必要な BLE 記述子が公開されていません。古い場合は、Phantom ペアリングを試行する前にファームウェアを更新してください。この検証は決してスキップしないでください。

2. Solana アプリのバージョンが 2.2.1 以降であることを確認します。以前のバージョンでは重要な BLE パケット署名フィールドが省略されており、その結果、Phantom の認証フェーズ中にサイレント拒否が発生しました。

3. App Store または Play ストアで Phantom アプリのバージョンを確認します。 2.17.0 より前のビルド番号には、BLE GATT 記述子の列挙に既知の競合状態が含まれており、デバイスの可視性の一貫性が失われます。

4. 電話機上の他のすべての BLE 対応アプリ (Ledger Live モバイル、MetaMask Mobile、Trezor Suite など) を一時的に無効にします。同時 BLE スキャンは、Phantom の専用照会スロット割り当てを妨げます。

5. 利用可能な場合は、互換性のある別の携帯電話でテストします。これにより、問題が Phantom のローカル BLE スタック実装にあるのか、プライマリ デバイスに固有の環境 RF 制約にあるのかが特定されます。

よくある質問

Q: Phantom は iPad の Bluetooth 経由で Ledger Nano X をサポートしていますか? Phantom は、iPadOS の Ledger Bluetooth ペアリングをサポートしていません。 iOS アプリのバイナリは iPhone アーキテクチャ専用にコンパイルされており、iPad に最適化された BLE スタック バインディングがありません。 iPad ユーザーは、USB-C to Lightning アダプター経由で接続するか、Web ベースの署名ワークフローを使用する必要があります。

Q: Ledger Live がデバイスを検出した場合でも、Phantom に「Ledger デバイスが見つかりません」と表示されるのはなぜですか? Ledger Live は、管理機能に別の BLE サービス UUID と GATT 構造を使用します。 Phantom は、Solana 固有の BLE インターフェイスを通じて排他的に通信します。このインターフェイスは、Solana アプリが開いていて Ledger 上でフォアグラウンドに設定されていない限り、非アクティブのままです。

Q: Bluetooth 経由で Ledger Stax で Phantom を使用できますか?いいえ。Ledger Stax は、サードパーティのウォレット統合用の BLE インターフェイスを公開していません。その Bluetooth スタックは、Ledger Live 同期とファームウェア更新のためにのみ予約されています。 Phantom は、どのような構成でも Stax デバイスとの安全なチャネルを確立できません。

Q: アプリを再起動せずに、Phantom に再スキャンを強制する方法はありますか?はい。 Phantom ウォレット接続画面を下にスワイプして、手動更新をトリガーします。これにより、キャッシュされたスキャン結果がバイパスされ、更新されたタイミング パラメーターを使用して新しい BLE 照会サイクルが開始されます。