Coinbase WalletをDAppに接続するにはどうすればよいですか?

ウォレット統合アーキテクチャ

1. Coinbase Wallet は、EIP-1193 および EIP-1474 標準と互換性のある挿入プロバイダーとして動作します。ブラウザ拡張機能としてインストールされるか、モバイルディープリンク経由で起動されると、ブラウザコンテキストでグローバルイーサリアムオブジェクトを公開します。

2. ウォレットは、イーサリアムメインネットと、Base、Optimism、Arbitrum、Polygon を含む複数の EVM 互換チェーンの両方をサポートします。チェーン構成は、DApp の対象となるネットワーク パラメーターと一致する必要があります。

3. 接続の開始には、モーダル インターフェイスを介した明示的なユーザーの同意が必要です。 Coinbase Wallet のクライアント側 SDK によって強制される現在のセキュリティ ポリシーでは、自動認証またはサイレント認証は許可されません。

4. セッションの永続性は、ドメインの起点をスコープとするローカル ストレージに依存します。各 dApp は独自の分離されたセッション状態を維持し、クロスサイトのウォレット状態の漏洩を防ぎます。

5. 切断イベントは、アカウント公開やトランザクション署名機能を含む、以前に付与されたすべてのアクセス許可の即時取り消しをトリガーします。

フロントエンドの実装手順

1. npm 経由で公式 Coinbase Wallet SDK をインポートします: npm install @coinbase/wallet-sdk 。このパッケージには、型付きインターフェイス、エラー処理ユーティリティ、チェーン対応プロバイダー ラッパーが含まれています。

2. CoinbaseWalletSDKを使用して、ターゲットのブロックチェーン RPC エンドポイントに対応する必須フィールド appName、appLogoUrl、および jsonRpcUrl を使用してウォレット コネクタをインスタンス化します。

3. プロバイダー インスタンスを初期化し、 activate()を呼び出して接続フローを開始します。これにより、ユーザーにアクセスを承認または拒否するよう求めるネイティブ モーダルが開きます。

4. 成功すると、返されたプロバイダー オブジェクトはaccountsChangedおよびchainChangedイベントを発行し、接続されたアドレスとネットワーク ステータスの反応的な UI 更新を有効にします。

5. 後続のすべてのコントラクト呼び出しまたはトランザクション送信は、署名ルーティングがアクティブなセッションと一貫性を保つように、このプロバイダー インスタンスを通じてルーティングされる必要があります。

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

1. すべてのトランザクション リクエストは、署名が生成される前にデバイス上で検証されます。ウォレットには、受信者、値、ガスパラメータ、関数呼び出しデータを含む完全なペイロードの詳細が表示されます。

2. スマート コントラクトの対話には、明示的な関数名とパラメーターの型の検証が必要です。 ABI デコードは、ウォレットのサンドボックス化されたランタイム環境内でローカルに実行されます。

3. 拒否されたトランザクションはタイムスタンプと操作ハッシュとともにウォレットの内部監査証跡に記録され、ウォレットの履歴タブを介してユーザーのみがアクセスできます。

4. 既知の悪意のあるドメインに対してフィッシング検出がリアルタイムで実行されます。ブラックリストに登録されたオリジンから接続しようとすると、即座に警告バナーが表示され、それ以降の対話がブロックされます。

5. 秘密キーのマテリアルがデバイスの安全な領域から出ることはありません。署名操作は、ウォレットの分離された暗号化モジュール内でのみ行われます。

共通の許可範囲

1. eth_accounts : 現在選択されている Ethereum アドレスへの読み取り専用アクセスを許可します。基本的なウォレットの検出と残高表示に必要です。

2. eth_signTypedData_v4 : EIP-712 に準拠した構造化メッセージ署名を有効にします。ログイン フローとオフチェーン認証に使用されます。

3. eth_sendTransaction : 署名された Ethereum トランザクションのブロードキャストを許可します。ユーザーによる手動確認後にのみトリガーされます。

4.personal_sign : 従来の平文署名をサポートします。型付きデータを優先するため非推奨になりましたが、下位互換性のために残されています。

5. eth_sign : 生のハッシュ署名を許可します。検証済みのドメイン レピュテーション スコアを持つホワイトリストに登録された dApp に制限されます。

よくある質問

Q: Coinbase Wallet が開発中にローカルホストからの接続試行を拒否するのはなぜですか? A: デフォルトでは、ウォレットはセキュリティ上の理由から HTTPS のみのオリジンを強制します。開発者は、mkcert などのツールを使用して HTTPS 経由でローカル dApp を提供するか、設定で利用可能なウォレットの開発者モード切り替えを使用する必要があります。

Q: 接続後にプログラムでネットワークを切り替えることはできますか? A: はい、 wallet_switchEthereumChain RPC メソッドを使用します。ウォレットには、変更を適用する前に、ターゲットチェーンID、ブロックエクスプローラーURL、およびネイティブ通貨記号をリストした確認画面が表示されます。

Q: ユーザーが接続中にウォレット内で選択したアカウントを変更するとどうなりますか? A: ウォレットは、新しいアドレス配列を含むaccountsChangedイベントを発行します。 DApps は、再接続を必要とせずに、このイベントをリッスンし、それに応じて UI 要素を更新する必要があります。

Q: 接続プロンプトを表示せずに、Coinbase Wallet がインストールされているかどうかを検出することはできますか? A: はい、アクティベーション メソッドを呼び出す前にwindow.ethereum?.isCoinbaseWalletの存在を確認します。このプロパティは、公式のウォレット拡張機能またはモバイル アプリが検出された場合にのみ true を返します。