WalletConnect を使用してモバイルウォレットをデスクトップ dApp にリンクするにはどうすればよいですか?

WalletConnect プロトコルについて

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

2. エンドツーエンドの暗号化を使用して、秘密キーや機密性の高いユーザー データを公開することなく、ブリッジ サーバー経由でメッセージを中継します。

3. このプロトコルは、セッション URI (接続パラメータとメタデータをエンコードする暗号的に署名された文字列) を介して動作します。

4. デスクトップ dApp は、セッション URI を含む QR コードを生成します。モバイル ウォレットはこれをスキャンしてペアリングを開始します。

5. スキャンが完了すると、モバイル ウォレットは dApp の ID を検証し、永続的な暗号化セッションを確立する前にユーザーに承認を求めます。

デスクトップからモバイルへのリンクの前提条件

1. MetaMask または別の Web3 対応拡張機能がインストールされた Chrome、Brave、Firefox などの互換性のあるデスクトップ ブラウザ。

2. WalletConnect v2.x をサポートするモバイル ウォレット — 例には、Trust Wallet、Rainbow、Phantom、Coinbase Wallet などがあります。

3. WalletConnect リレー ネットワークを通じてセッション要求と応答を同期するには、両方のデバイスに安定したインターネット接続が必要です。

4. モバイル ウォレットの設定で WalletConnect 機能が有効になっている必要があります。この機能は、多くの場合「DApp ブラウザ」または「WalletConnect」トグル オプションにあります。

5. 広告ブロッカーやプライバシー拡張機能が、dApp 側の WalletConnect SDK によって使用される WebSocket 接続を妨げていないことを確認します。

段階的な接続ワークフロー

1. デスクトップブラウザを使用して対象の dApp に移動し、ウォレット接続ボタン (通常は「Connect Wallet」または「WalletConnect」というラベルが付いています) を見つけます。

2. 使用可能なコネクタから WalletConnect オプションを選択します。これにより、画面上に QR コードが生成されます。

3. モバイル ウォレット アプリを開き、内蔵の WalletConnect スキャナーにアクセスします。通常、+ アイコン、QR タブ、または専用の「QR をスキャン」メニュー項目からアクセスできます。

4. デスクトップ画面に表示された QR コードに携帯電話のカメラを向けます。モバイルウォレットはセッションURIをデコードし、dAppの名前、URL、および要求された権限を表示します。

5. モバイルデバイスで接続要求を確認します。承認されると、デスクトップ dApp はセッション確認を受け取り、アカウント アドレスへの読み取り専用アクセスとトランザクションの署名機能を獲得します。

アクティブなセッションの管理

1. 確立された各 WalletConnect セッションは、モバイル ウォレットの「アクティブ セッション」の下に表示され、dApp ドメイン、接続されたチェーン、最後のアクティビティのタイムスタンプがリストされます。

2. モバイル ウォレット インターフェイスからリモートでセッションを終了し、dApp との以降のやり取りを即座に遮断できます。

3. セッションの永続性は、クライアント側のタイムアウトとリレー サーバーの動作の両方に依存します。非アクティブ状態が長時間続いた場合、またはいずれかのエンドポイントが突然切断された場合、セッションは期限切れになる場合があります。

4. 一部のウォレットでは、特に Ethereum、Polygon、Arbitrum などの EVM 互換チェーン間で複数の dApp を接続する場合、識別を容易にするためにセッションの名前を変更できます。

5. 再接続には再スキャンは必要ありません。セッションが有効なままであれば、dApp はページのリロード時に自動的に通信を再開できます。

よくある質問

Q: WalletConnect を Ledger や Trezor などのハードウェア ウォレットで使用できますか?はい - ハードウェアウォレットが、Ledger LiveやTrust WalletなどのWalletConnectをサポートするモバイルまたはデスクトップウォレットアプリケーションとペアになっている場合に限ります。ハードウェア デバイス自体は直接接続しませんが、署名バックエンドとして機能します。

Q: スキャン後にモバイルウォレットに「接続に失敗しました」と表示されるのはなぜですか?これは多くの場合、チェーン ID の不一致、セッション URI の期限切れ、または WalletConnect リレー (wss://relay.walletconnect.com など) へのアクセスをブロックするネットワーク制限によって発生します。両方のデバイスで時刻が同期していることを確認し、ファイアウォール設定を確認します。

Q: WalletConnect を使用して不明な dApp に接続しても安全ですか?いいえ — WalletConnect はトランスポートのみを保護します。 dApp の正当性を検証するものではありません。権限を承認したりトランザクションに署名したりする前に、必ず契約アドレス、監査レポート、コミュニティの評判を確認してください。

Q: 複数のモバイル ウォレットを同じデスクトップ dApp に同時に接続できますか?はい — WalletConnect は複数の同時セッションをサポートします。各セッションは分離され、一意のトピック識別子によって識別されます。ただし、マルチウォレット コンテキストを処理するように明示的にコード化されていない限り、ほとんどの dApp はアクティブなアカウントを 1 つだけ表示します。