WalletConnect QR コードを正しくスキャンする方法

WalletConnect QR コードスキャンの仕組み

1. WalletConnect は、QR コードのスキャンによって開始される、安全なエンドツーエンドの暗号化されたペアリング プロセスに依存しています。

2. QR コードには、dApp のメタデータ、チェーン ID、一意のブリッジ URL を含む、base64 でエンコードされたセッション プロポーザル ペイロードが含まれています。

3. 秘密キーやシード フレーズが QR コードを通過することはありません。一時的なセッション パラメーターのみが交換されます。

4. モバイルウォレットは、WalletConnect の分散型リレーネットワークを介してリレー接続を確立する前に、dApp の発信元と署名を検証します。

5. スキャンが完了すると、ウォレットには、要求されたメソッド、アカウント、名前空間をリストした許可プロンプトが表示されます。トランザクションの署名が行われる前にユーザーの承認が必須です。

デバイス固有のスキャン要件

1. iOS デバイスでは、ウォレット アプリに対してカメラ アクセスが有効になっている必要があります。スキャン後のリレー接続を維持するには、アプリのバックグラウンド更新をアクティブにしておく必要があります。

2. Android 12 以降を実行している Android デバイスでは、より厳格なカメラ権限が適用されます。ユーザーは、最初の起動時に「アプリの使用中」アクセスを手動で許可する必要があります。

3. 一部の OEM スキン (Xiaomi MIUI、Huawei EMUI など) は、バッテリー セーバー モードがアクティブな場合、前景カメラの使用をブロックします。信頼性の高いスキャンを行うには、このモードを無効にする必要があります。

4. デュアルカメラ設定のタブレットでは、明示的に切り替えない限り、デフォルトで前面カメラが使用される場合があります。カメラの選択が間違っていると、フォーカスの失敗やタイムアウト エラーが発生します。

5. 破損したレンズや大きな傷が付いたデバイスでは、QR コード モジュールを誤って読み取ることがよくあります。レンズを清掃し、適切な周囲光を確保すると、スキャンの成功率が 68% 以上向上します。

一般的なスキャンの失敗と修正

1. ウォレット アプリ内のカメラ ビューが空白またはグレー表示になっている場合は、カメラの権限が欠落していることを示します。システム設定からカメラの権限を再付与すると、問題は即座に解決されます。

2. 永続的な「無効な QR コード」メッセージは、通常、期限切れのセッション URI から発生します。dApp は、通常 5 分間有効な、期限付きの提案を生成します。

3. QR コードが 200 × 200 ピクセル未満でレンダリングされている場合、または低解像度のプロジェクターで表示されている場合、スキャンは失敗します。推奨される最小レンダリング サイズは 72 dpi で 300 × 300 ピクセルです。

4. 画面の眩しさ、最新のディスプレイの反射防止コーティング、または偏光サングラスによる干渉により、光学的認識が妨げられます。視野角を調整すると、ほとんどの偽陰性が排除されます。

5. 古いリレーエンドポイントをキャッシュするウォレットアプリはハンドシェイクネゴシエーションに失敗する可能性があります。アプリデータをクリアするか、最新バージョンに更新すると互換性が復元されます。

スキャン中のセキュリティ検証

1. すべての WalletConnect セッションにはドメイン検証が含まれます。ウォレットには、フロントエンド URL だけでなく、プロポーザルから抽出された dApp の検証済みドメイン名が表示されます。

2.ウォレットは、承認プロンプトを表示する前に、dApp の ENS 名または SSL 証明書のフィンガープリントを既知の悪意のあるレジストリと照合します。

3. セッション暗号化では、secp256k1 上の楕円曲線ディフィー ヘルマン (ECDH) が使用されます。セッション キーの素材が dApp サーバーやリレー サーバーに公開されることはありません。

4.リレーメッセージはウォレットのセッションキーで署名され、ECDSA を使用して検証されます。改ざんの試みによりセッションが即時に終了されます。

5.生体認証の確認は、WalletConnect セッションから発信されるすべての署名リクエストに対して強制されます。パスワードのみのフォールバックはデフォルトで無効になっています。

よくある質問

Q: 同じ WalletConnect QR コードを複数回スキャンできますか? A: 各 QR コードには、1 回限り使用できるセッション URI が含まれています。期限切れのコードまたはすでに使用されているコードを再スキャンすると、リレー サーバーによって拒否されます。

Q: WalletConnect QR コードをスキャンすると、私のウォレット アドレスがすぐに dApp に公開されますか? A: いいえ。dApp はセッション確立後にウォレットの公開キーのみを受け取ります。アドレスの公開は、最初のアカウント要求時にユーザーの明示的な同意があった場合にのみ発生します。

Q: QR コードが表示されているにもかかわらず、ウォレットに「接続がタイムアウトしました」と表示されるのはなぜですか? A: これは、ネットワーク レベルの障害を示しています。ウォレットが WalletConnect のリレー インフラストラクチャに到達できないか、DNS の設定ミスまたはファイアウォールのブロックにより dApp のブリッジ エンドポイントに到達できないかのいずれかです。

Q: 信頼できない Web サイトから WalletConnect QR コードをスキャンしても安全ですか? A: スキャン自体は安全ですが、セッションリクエストを承認すると、dApp に制限付きの RPC アクセスが許可されます。確認する前に、ウォレットの承認画面に表示されるドメインが予想される dApp のオリジンと一致していることを必ず確認してください。