デスクトップ DApps に WalletConnect を使用するにはどうすればよいですか? (QRコードスキャン)

WalletConnect プロトコルについて

1. WalletConnect は、デスクトップ分散アプリケーションとモバイル暗号通貨ウォレット間の安全な通信を可能にするオープンソース プロトコルです。

2. エンドツーエンドの暗号化を通じて動作し、セッションの開始またはトランザクション署名中に秘密キーがユーザーのデバイスから流出することがないようにします。

3. このプロトコルはリレーサーバーを使用して、メッセージコンテンツにアクセスせずに、dApp とウォレットの間で暗号化されたペイロードを転送します。

4. デスクトップ dApp は、ハンドシェイクの基盤として機能する一時トピックとブリッジ URL を含む一意のペアリング URI を生成します。

5. セッションの確立には相互承認が必要です。dApp は接続を要求し、対話を進める前にウォレットは明示的に確認する必要があります。

デスクトップでの QR コードの生成

1. デスクトップ dApp を起動するとき、ユーザーは「ウォレットに接続」をクリックし、優先方法として WalletConnect を選択します。

2. アプリケーションは、WalletConnect v2.0 セッション提案形式、埋め込みプロジェクト ID、必要なチェーン、およびメタデータを使用して、動的に生成された QR コードをレンダリングします。

3. この QR コードは、wc:// または wc: 形式のディープ リンクをエンコードし、その後に Base64 でエンコードされたセッション パラメータとバージョン識別子が続きます。

4. 一部の dApp では、スキャンが失敗した場合に手動入力用に、12 単語のフレーズや英数字コードなどのフォールバック テキストが表示されます。

5. QR コードは約 3 分間有効です。有効期限が切れると、更新時に自動再生成がトリガーされます。

モバイルウォレットでスキャンする

1. ユーザーは、MetaMask Mobile、Trust Wallet、Rainbow などの互換性のあるウォレットを開き、WalletConnect スキャナ インターフェイスに移動します。

2. カメラが起動して QR コードを検出し、そのペイロードを構造化されたセッション リクエスト オブジェクトに解析します。

3. ウォレットには、dApp 名、要求された権限、サポートされているネットワーク、および dApp のメタデータ エンドポイントから取得したアイコンが表示されます。

4. ユーザーの承認後、ウォレットはリレー経由で確認ペイロードを送り返し、永続的な WebSocket チャネルを確立します。

5. 接続すると、ウォレットにアクティブなセッション バッジが表示され、トランザクションまたはサインイン メッセージの署名リクエストが可能になります。

セッション管理とセキュリティに関する考慮事項

1. アクティブな各 WalletConnect セッションには、最後に使用されたタイムスタンプとともにウォレットの接続リストに表示される一意のトピック ハッシュが割り当てられます。

2. ユーザーはウォレット アプリ内でセッションを手動で終了し、その dApp からのすべての保留中および今後の RPC 呼び出しを即座に切断できます。

3. デスクトップ dApp は任意の呼び出しを開始できません。権限は、eth_sendTransaction やpersonal_sign など、ペアリング中に宣言されたメソッドに限定されます。

4. dApp が不正な RPC メソッドを試みた場合、ウォレットは呼び出しを拒否し、エラーの詳細をリレーにブロードキャストせずにローカルに記録します。

5. リレー サーバーは、メッセージ配信を超えてセッション ペイロードを保存しません。ペイロードは、送信後に破棄される一時キーを使用して暗号化されます。

よくある質問

Q: デスクトップ上のハードウェア ウォレットで WalletConnect を使用できますか?はい - Ledger Live と Trezor Suite は、WalletConnect v2.0 をネイティブでサポートします。これらは仲介者として機能し、署名リクエストをデスクトップ dApp から USB または Bluetooth 経由で物理デバイスに転送します。

Q: QR コードをスキャンしたにもかかわらず、ウォレットに「不明な dApp」と表示されるのはなぜですか?これは、dApp がセッション提案に有効なメタデータ (名前、説明、アイコン) を含めることに失敗した場合に発生します。メタデータフィールドが欠落しているか形式が不正な場合、ウォレットはデフォルトで汎用ラベルを使用します。

Q: 信頼できない Web サイトから WalletConnect QR コードをスキャンしても安全ですか?いいえ。スキャンすると暗号化ハンドシェイクが開始され、dApp にウォレットへの限定的なアクセスが許可されます。接続する前に、必ずドメインの信頼性を検証し、dApp のソース コードまたは監査レポートを検査してください。

Q: WalletConnect セッションがアクティブなときにデスクトップ ブラウザを閉じるとどうなりますか?セッションは、手動で切断されるかタイムアウトになるまで、ウォレット側で開いたままになります。 dApp は新しいリクエストを送信できなくなりますが、ブラウザのタブを閉じるとウォレットを制御できなくなります。