Coinbase Wallet を Web3 アプリに接続するにはどうすればよいですか?

Coinbase ウォレットの統合を理解する

1. Coinbase Wallet は、非保管モバイルおよびブラウザ拡張ウォレットとして動作し、Ethereum、Solana、Base、および複数の EVM 互換チェーンをサポートします。

2. Coinbase Exchange アカウントとは異なり、Coinbase Wallet ではユーザーが秘密鍵を完全に制御でき、基本的な使用に KYC は必要ありません。

3. Web3 アプリケーションは、拡張機能がインストールされ有効になっているときに、挿入されたwindow.coinbaseWalletプロバイダーを通じて Coinbase Wallet を検出します。

4. ウォレットは EIP-1193 と EIP-3085 の両方に準拠したメソッドをサポートしているため、dApp はネットワーク スイッチをリクエストし、カスタム RPC をシームレスに追加できます。

5. ユーザーは接続リクエストを手動で承認する必要があります。自動またはサイレント認証は行われず、アクセス許可の境界が維持されます。

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

1. Coinbase Wallet 拡張機能が Chrome、Edge、または Brave ブラウザにインストールされているか、モバイル アプリがバージョン 23.0 以降に更新されていることを確認します。

2. ターゲットの dApp に移動し、「ウォレットに接続」ボタンを見つけます。通常は UI の右上隅にあります。

3. ウォレット選択モーダルから「Coinbase Wallet」を選択します。表示されない場合は、「もっと見る」をクリックするか、検索バーを使用してください。

4. アカウントへのアクセスを要求するポップアップが表示されます。権限を確認し、生体認証またはパスワード認証で確認します。

5. 承認されると、dApp は、アカウント アドレス、チェーン ID、およびネットワーク/アカウント変更のイベント リスナーを含む Ethereum プロバイダー オブジェクトを受け取ります。

チェーンの不一致と切り替えの処理

1. dApp が特定のチェーン (Arbitrum One など) を必要とする場合、チェーン ID パラメーターを使用してWallet_switchEthereumChainをトリガーします。

2. Coinbase Wallet は、ユーザーに切り替えを確認するよう求めるネイティブ プロンプトを表示します。拒否されると、解決されるまで対話が停止されます。

3. サポートされていないネットワークを追加する場合、dApps は、 wallet_addEthereumChainを呼び出し、RPC URL、チェーン名、シンボル、およびブロック エクスプローラーを渡します。

4. ユーザーには、編集可能なフィールドを含む事前に入力されたフォームが表示されます。保存する前に、構成を拒否、変更、または受け入れることができます。

5. 障害が発生したスイッチは自動的に復帰しません。開発者はエラーを処理し、ユーザーを手動で正しいネットワーク設定に戻すように誘導する必要があります。

トランザクション署名とイベント処理

1. 各トランザクション呼び出しにより、Coinbase Wallet 内で安全な署名画面が開始され、ガス見積もり、受信者、値、およびデータ ペイロードが表示されます。

2. ユーザーは、「遅い」、「平均」、または「速い」というラベルの付いたスライダー コントロールを使用してガス料金を調整し、確認速度とコストに影響を与えることができます。

3. ウォレットは、 accountsChanged 、 chainChanged 、 disconnectなどのイベントを発行します。dApp は状態の一貫性を維持するためにこれらのイベントをリッスンする必要があります。

4. 再接続ロジックは、イベントごとにプロバイダー リスナーを再初期化し、アカウントとネットワークのステータスを再クエリする必要があります。

5. Coinbase Wallet には、オンチェーンのレシート以外の取引メタデータは保存されません。dApp は、保留中のアクションまたは確認されたアクションを追跡する責任を負います。

よくある質問

Q: Coinbase Wallet がインストールされているにもかかわらず、dApp に「ウォレットが検出されません」と表示されるのはなぜですか? A: これは通常、拡張機能が無効になっているか、広告/トラッカー ブロッカーによってブロックされているか、拡張機能のアクセス許可が有効になっていない状態でシークレット ウィンドウで実行されていることを示します。

Q: ブラウザ拡張機能をインストールせずに Coinbase Wallet を dApp に接続できますか? A: はい — モバイル Coinbase Wallet アプリから QR コードをスキャンすると、WalletConnect v2 セッションが確立され、デスクトップ dApps 全体ですべての機能が有効になります。

Q: dApp に接続中にウォレットのデフォルトのネットワークを変更するとどうなりますか? A: dApp はchainChangedイベントを受け取りますが、自動的には適応しません。フロントエンド ロジックはアセットをリロードし、コントラクト インスタンスを更新し、潜在的な不一致についてユーザーに警告する必要があります。

Q: dApps からの「読み取り専用アクセス」リクエストを承認しても安全ですか? A: はい — 読み取り専用リクエストはパブリック アドレスと残高情報のみを公開します。このような対話中には、署名や承認の機能は付与されません。