回復フレーズを公開せずに Trust Wallet を Web3 dApp に接続する方法

トラストウォレットの統合メカニズムを理解する

1. Trust Wallet は、WalletConnect v2 プロトコルをネイティブに実装する非保管型モバイルウォレットとして動作します。デスクトップ拡張機能のようなブラウザー インジェクションには依存しません。

2. 接続フローは dApp フロントエンドから開始され、チェーン ID、要求された権限、アプリ名やロゴなどのメタデータを含むセッション プロポーザルが生成されます。

3. QR コードまたはディープ リンクは、特定のリレー サーバーを範囲とする暗号化されたセッション URI を伝送します。この URI には、秘密キー素材やリカバリ フレーズ データは含まれません。

4. スキャン時に、Trust Wallet はローカルに保存されているペアリング キーを使用してセッション リクエストを復号化し、リレーの署名によってドメインの整合性を検証します。

5. 承認されると、ウォレットはリレーを通じて dApp とのエンドツーエンドの暗号化チャネルを確立し、シード フレーズを公開することなく安全な JSON-RPC メッセージ交換を可能にします。

WalletConnect v2 セッションセキュリティアーキテクチャ

1. 各セッションは、dApp とウォレットの間の ECDH キー交換から派生した一時的な対称キーを使用します。これらのキーはセッション終了後に破棄されます。

2. 中継サーバーは復号化されたペイロードを決して認識しません。すべてのメッセージは送信前に AES-256-GCM 暗号化されます。

3. セッション提案には、必須のピア メタデータ フィールド ( appUrl 、 appIcon 、およびappDescription )が含まれており、ドメイン スプーフィングを防止します。

4. Trust Wallet は厳格なオリジン検証を強制します。セッション開始時に登録されたredirectUriに対して dApp のドメインをクロスチェックします。

5. 接続中にリカバリ フレーズを含む暗号化操作は行われません。署名リクエストは、承認後のウォレットの安全なエンクレーブ内でのみ処理されます。

漏洩の危険性がある一般的な構成ミス

1. 非推奨の WalletConnect v1 ブリッジを使用すると、暗号化されていないハンドシェイクの脆弱性が生じ、ドメイン バインディングの強制が行われなくなります。

2. ウォレット固有の URI ( trust://など) をハードコーディングすると、WalletConnect の標準化された検出レイヤーがバイパスされ、Android 上で安全でないインテントの処理がトリガーされる可能性があります。

3. sessionNamespacesオブジェクトの検証に失敗すると、権限のエスカレーションが発生します。たとえば、Solana チェーンに接続しているときに Ethereum メソッドを受け入れるなどです。

4. セッション キーをメモリ専用コンテキストではなく localStorage に保存すると、悪意のあるスクリプトがアクティブなセッションをハイジャックする可能性があります。

5. Trust Wallet の公式 SDK の外部でカスタム QR スキャナを実装すると、URI 解析中の中間者による傍受のリスクが増加します。

クライアント側の実装の安全対策

1. 必ず、WalletConnect Cloud ダッシュボードで検証済みの dApp ID に関連付けられたprojectIdを使用して WalletConnect を初期化します。

2. requiredNamespacesを強制して RPC メソッドを制限します。たとえば、コントラクトの相互作用が確認されない限り、 eth_signTypedData_v4 を明示的に拒否します。

3. web3wallet SDK はウォレットで開始されるペアリングにのみ使用します。 iframe サンドボックスが無効になっているコンテキストに@walletconnect/modalを埋め込むことは避けてください。

4. トランザクションリクエストをディスパッチする前に、 sessionEventペイロードとweb3.eth.getChainId()の間のチェーン ID の一貫性を確認します。

5. eth_requestAccounts をセッションごとに複数回呼び出さないでください。呼び出しを繰り返すと、冗長な署名プロンプトがトリガーされ、UI が混乱する可能性があります。

よくある質問

Q: 悪意のある dApp を承認した場合、Trust Wallet から回復フレーズが漏洩する可能性がありますか? A: いいえ。リカバリ フレーズは、WalletConnect セッション中に送信、処理、参照されることはありません。承認では、範囲指定された署名権限のみが付与されます。

Q: WalletConnect QR コードをスキャンすると、dApp がウォレットの取引履歴にアクセスできるようになりますか? A: eth_getLogsまたは同様の読み取りメソッドを介して明示的にリクエストされた場合に限り、その場合でも、結果はリクエストで定義されたブロック範囲とコントラクト アドレスによってフィルターされます。

Q: Trust Wallet に接続中に「不明な dApp」が表示されることがあるのはなぜですか? A: これは、dApp がセッション提案で有効なappUrlまたはappIcon を提供できず、Trust Wallet のフォールバック セキュリティ警告がトリガーされた場合に発生します。

Q: Trust Wallet をローカルホスト上で実行されている dApp に接続しても安全ですか? A: はい、ローカル サーバーが HTTPS を使用しているか、WalletConnect の開発モードが有効になっている127.0.0.1経由で提供されている場合、両方ともセッション URI の外部ネットワーク漏洩を防ぎます。