WalletConnect を使用してウォレットを安全に接続する方法

コアプロトコルアーキテクチャ

1. WalletConnect は、DApp もウォレットも直接のピアツーピア通信を確立しない、リレーベースのメッセージング システムを通じて動作します。

2. DApp フロントエンドと公式の WalletConnect リレーサーバー (wss://relay.walletconnect.com) の間で WebSocket 接続が開始されます。

3. DApp は固有のトピックと一時キーペアを生成し、それらを EIP-1328 仕様に従ってフォーマットされた URI に埋め込みます。

4. この URI は、有効期限タイムスタンプやリレー プロトコル識別子を含む暗号化されたセッション メタデータを含む、DApp インターフェイス上で表示される QR コードとしてレンダリングされます。

5. スキャン時に、モバイル ウォレットは URI を解析し、トピックと symKey を抽出し、同一の暗号化パラメータを使用して同じリレー チャネルにサブスクライブします。

ウォレットの統合要件

1. ウォレットは、マルチチェーン互換性のための EIP-155 名前空間ネゴシエーションをサポートする WalletConnect V2 クライアント SDK を実装する必要があります。

2. サポートされる各ブロックチェーンは、そのチェーン ID と要求されたメソッド (eth_sendTransaction やpersonal_sign など) を使用して宣言する必要があります。

3. ウォレットは厳密な権限スコープを強制します。秘密キーは決して公開せず、デバイスローカルの暗号化モジュールを使用してペイロードに署名するだけです。

4. セッションの承認には、RPC バインディングを確立する前に、DApp ID、要求されたチェーン、および機能権限の明示的なユーザー確認が必要です。

5. トランザクション リクエストや署名プロンプトを含む後続のすべてのメッセージは、共有 Diffie-Hellman シークレットから派生した AES-256-GCM を使用してエンドツーエンドで暗号化されます。

セキュリティ執行メカニズム

1. 秘密キーはウォレットの安全な実行環境内で完全に隔離されたままになります。送信されることも、Web コンテキストからアクセスできるメモリに公開されることもありません。

2. 中継サーバーはペイロードを復号化できません。コンテンツを解釈せずに、エンドポイント間で暗号テキストを転送するだけです。

3. セッションの有効期限はクライアント側とリレー側の両方で適用され、提案中に上書きされない限り、デフォルトの制限は 7 日に設定されます。

4. 各セッションには不変のペアリング識別子が含まれており、ウォレットが開始する切断コマンドによる決定的な取り消しが可能になります。

5.ユーザーによって明示的に再承認されない限り、アプリの再起動後はセッションが維持されません。自動再接続は設計により無効になっています。

マルチチェーン名前空間の処理

1. DApps はセッション提案で必要な名前空間を宣言し、eip155:1 (イーサリアム メインネット) や eip155:137 (ポリゴン) などのチェーンを指定します。

2. ウォレットは、承認された名前空間で応答します。これは、ユーザーの選択またはウォレットの機能制約に基づいて異なる場合があります。

3. アクティブなセッション中にチェーンを切り替えると、新しい権限プロンプトがトリガーされます。サイレント フォールバックや自動認証は発生しません。

4. RPC リクエストは、承認された名前空間に含まれるチェーンのみにルーティングされ、クロスチェーン漏洩や誤ったトランザクションの送信を防ぎます。

5.単一の WalletConnect セッションは、セッションを重複させることなく、複数の EVM 互換チェーンにわたってアクティブなコンテキストを同時に維持できます。

セッションのライフサイクル管理

1. 接続の開始は URI の生成と QR レンダリングから始まります。スキャンが完了するまでネットワーク ハンドシェイクは発生しません。

2. ペアリングされると、ウォレットはデバイスの生体認証または PIN に関連付けられた暗号化ストレージを使用してセッション状態をローカルに保存します。

3. ユーザーは、「接続されたアプリ」の下のウォレット UI 内のすべてのアクティブなセッションを、各 DApp のリアルタイムのステータス インジケーターとともに表示できます。

4. セッションを取り消すと、関連するすべてのサブスクリプションが終了し、共有キーが無効になり、キャッシュされた署名コンテキストがすぐに削除されます。

5.セッション メタデータ (DApp オリジン、チェーン スコープ、最後のインタラクション時刻など) は、サードパーティの分析サービスやテレメトリ サービスと共有されることはありません。

よくある質問

Q: WalletConnect は秘密キーを中継サーバーに保存しますか? WalletConnect リレーサーバーは秘密鍵を処理したり保存したりしません。暗号化されたペイロードのみを転送し、復号化機能はありません。

Q: 悪意のある DApp が接続後に不正なトランザクションをトリガーする可能性がありますか?いいえ。すべてのトランザクションリクエストには、ウォレットインターフェイス内で明示的なユーザーの承認が必要です。手動による確認がなければ操作は実行されません。

Q: 同じウォレットを 2 つの異なる DApps に同時に接続することはできますか?はい。 WalletConnect は同時セッションをサポートします。各 DApp は、個別の権限とチェーン スコープを持つ分離されたセッション コンテキストを受け取ります。

Q: アクティブなセッション中にリレー サーバーがオフラインになった場合はどうなりますか?メッセージ暗号化とルーティング ロジックは完全にクライアント側の実装内に存在するため、アクティブなセッションは機能し続けます。リレーが利用できない場合は、新しい接続の試行のみに影響します。