ウォレットをdAppに接続するにはどうすればよいですか? (Web3の基本)

ウォレット統合の仕組みを理解する

1. 分散型アプリケーションは、暗号化 ID に依存してユーザーを認証し、トランザクションに署名します。この ID はウォレット内に存在し、秘密キーが保持され、デジタル署名が管理されます。

2. MetaMask、Phantom、Trust Wallet などのウォレットは、Ethereum Provider API (EIP-1193) として知られる標準化されたインターフェイスを公開し、dApps がそれらを検出して通信できるようにします。

3. dApp は初期化時に、ブラウザ拡張機能やモバイル ウォレットによって挿入されたwindow.ethereumまたは同様のプロバイダー オブジェクトの存在を確認します。

4. そのようなオブジェクトが存在しない場合、フォールバック ロジックがトリガーされ、インストールを促すか、モバイル ユーザーにウォレット接続モーダルを提案します。

5. 検出されると、dApp はethereum.request({ method: 'eth_requestAccounts' })を使用してユーザーのアカウントにアクセスする許可を要求し、安全なユーザー承認のハンドシェイクを開始します。

接続状態とイベントの処理

1. ウォレットの接続は静的ではありません。アカウントの切り替え、ネットワークの切り替え、または切断によって変化する可能性があります。 dApp は、 'accountsChanged' 、 'chainChanged' 、 'disconnect'などのイベントをリッスンする必要があります。

2. ユーザーが別のアカウントを選択するか、アクセスを削除すると、「accountsChanged」イベントが発生します。新しいアドレスの配列、またはアクセス許可が取り消された場合は空の配列を渡します。

3. 「chainChanged」イベントは、ネットワーク間の切り替えを通知します (例: Ethereum Mainnet から Sepolia)。アプリケーションは、それに応じてコントラクト インスタンスをリロードまたは再初期化する必要があります。

4. 切断は、特にウォレットのロックや拡張機能の無効化の後など、サイレントに発生する可能性があるため、 ethereum.isConnected()による定期的なヘルス チェックは、UI の一貫性を維持するのに役立ちます。

5. 永続的な状態管理では、選択したチェーン ID とアカウント アドレスをメモリまたはローカル ストレージに保存する必要がありますが、秘密キーやシード フレーズを保存する必要はありません。

秘密を暴露せずにトランザクションに署名する

1. すべてのトランザクション署名は、dApp の JavaScript コンテキストではなく、ウォレット環境内で行われます。 dApp は生のトランザクション パラメーターを構築し、それらをethereum.request({ method: 'eth_sendTransaction', params: [...] })に渡します。

2. ウォレットは、受信者、価値、ガス見積もり、およびデータ ペイロードを示す確認 UI をレンダリングします。ユーザーは、秘密キーを外部コードに公開することなく、承認または拒否します。

3. ログインチャレンジやガバナンス投票などのオフチェーンメッセージの場合、dApp はpersonal_signまたはeth_signTypedData_v4を使用して、暗号的に検証可能な署名を要求します。

4. 型付きデータ署名により、構造化されたドメイン分離が強制され、ドメイン固有のソルトとバージョン管理によるチェーンまたはアプリケーション間での再生が防止されます。

5. オンチェーンまたはバックエンド サービスでの署名検証は、 ecrecoverまたは同等の暗号化プリミティブに依存して、署名とメッセージ ハッシュから署名者のアドレスを導出します。

モバイルおよび非拡張シナリオ用の WalletConnect プロトコル

1. WalletConnect v2 は、リレーサーバーとペアリング URI を使用して、dApp とウォレットの間にエンドツーエンドの暗号化セッションを確立します。ブラウザーのインジェクションを完全に回避します。

2. dApp は、必要なチェーン、メソッド、メタデータを含むセッション提案を生成し、ペアリング URI を含む QR コードを表示します。

3. ユーザーは、Rainbow や Coinbase Wallet などの互換性のあるウォレット アプリで QR コードをスキャンし、セッションを承認する前に提案を検証します。

4. 接続されると、すべての JSON-RPC リクエストはリレー ネットワークを介して流れ、暗号化キーはペアリング中にネゴシエートされ、セッションごとにローテーションされます。

5. セッションの永続性はクライアント側で管理されます。取り消しは、いずれかの当事者がsession.disconnect()を呼び出し、関連付けられているすべてのキーを無効にし、保存されているメタデータをクリアすると発生します。

よくある質問

Q1: dApp は接続中に私の秘密キーを読み取ることができますか? A1.いいえ、ウォレットが秘密キーを dApp に公開することはありません。署名は常にウォレットの安全な境界内で行われます。

Q2: ネットワークを切り替えるたびにウォレットが承認を求めるのはなぜですか? A2.各 EVM 互換チェーンには、独自の名前空間とアカウント導出パスがあります。権限はチェーンごとにスコープが定められており、明示的な再承認が必要です。

Q3: 接続後にブラウザのキャッシュをクリアするとどうなりますか? A3. dApp が WalletConnect 経由でセッション回復を実装するか、ウォレット アドレスやチェーン ID などの機密性のない識別子を個別に保存しない限り、接続状態は失われます。

Q4: Etherscan で検証されていない dApp に接続しても安全ですか? A4.いいえ。未検証の dApp は、悪意のあるスクリプトを挿入したり、ウォレット プロンプトを偽装したりする可能性があります。常に契約アドレスを検証し、ドメインの正当性を確認し、シード フレーズをどこにも入力しないようにしてください。