dApps と Web3 で Coinbase Pay を使用するにはどうすればよいですか?

Coinbase Pay の統合を理解する

1. Coinbase Pay は、ユーザーが Coinbase に保持されている法定通貨または仮想通貨の残高から直接 Web3 ウォレットに資金を供給できるようにする組み込みの支払いインフラストラクチャです。

2. 開発者は Coinbase Pay SDK を dApp フロントエンドに埋め込み、ユーザーを外部取引所にリダイレクトすることなくシームレスなオンランプ機能を可能にします。

3. この統合により、Ethereum、Base、Polygon、Arbitrum ネットワーク全体で、USDC、DAI、ETH を含む複数の法定通貨とステーブルコインがサポートされます。

4. ユーザーは Coinbase Wallet または Coinbase.com ログインを介して認証し、資金調達後の秘密鍵の非保管管理を維持しながらセッションの継続性を維持します。

5. 宛先ウォレット アドレス、トークン タイプ、金額などのトランザクション メタデータは、資金調達フローを開始する前に SDK によって事前検証されます。

ユーザーエクスペリエンスの流れ

1. ユーザーが Coinbase Pay を利用した dApp インターフェース内で「暗号通貨の購入」をクリックすると、ローカライズされた法定通貨オプションを含むモーダル ウィンドウがトリガーされます。

2. ユーザーは USD、EUR、または GBP を選択して希望の購入金額を入力し、銀行振込、デビット カード、または既存の Coinbase 残高のいずれかを選択します。

3. 確認後、Coinbase は購入を処理し、カードベースの購入の場合は 30 秒以内にトークンを接続されたウォレットのアドレスに直接ルーティングします。

4. dApp は、トークンの配信が成功したことを確認する Webhook 通知またはクライアント側のコールバックを受信し、スマート コントラクトとの即時対話を可能にします。

5. ユーザーがすでに Coinbase で本人確認を完了している場合、KYC の繰り返しは発生しません。セッション トークンはコンプライアンス検証のために再利用されます。

開発者の実装手順

1. Coinbase Developer Portal に dApp ドメインを登録し、Pay スコープが有効になっている API キーを取得します。

2. npm 経由で@coinbase/pay-sdkをインストールし、環境固有の構成フラグを使用してクライアントを初期化します。

3. SDK の初期化中に、 supportedNetworks パラメータとsupportedTokensパラメータを使用して、サポートされるチェーンとトークンのペアを定義します。

4. launchPayWidget()メソッドを UI 要素にバインドし、ウォレット アドレス、チェーン ID、および最小必要残高を引数として渡します。

5. onSuccessおよびonErrorコールバックを使用して成功イベントとエラー イベントを処理し、dApp の状態を更新したり、通知を表示したりします。

セキュリティとコンプライアンスの考慮事項

1. すべての支払いセッションは TLS で暗号化され、OAuth2 にバインドされたユーザー ID に関連付けられるため、トークン インジェクションやアドレス スプーフィングが防止されます。

2. Coinbase は、資金を外部ウォレットにリリースする前に、Chainaracy と Elliptic の統合を通じてリアルタイムの制裁スクリーニングを実施します。

3. 開発者は生の Coinbase Pay セッション トークンを保存または記録してはなりません。これらは短期間であり、1 回限りの資金調達イベントのみに限定されます。

4. Coinbase Pay を表示する dApp は、欧州の MiCA などの地域の金融規制に準拠し、開始前に料金体系を明確に開示する必要があります。

5. ウォレットアドレスの検証には、クロスチェーンのミスルーティングを防ぐための EIP-1559 ガス推定とチェーン対応チェックサムフォーマットが含まれます。

よくある質問

Q: Coinbase Pay は、Ledger や Trezor などのハードウェア ウォレットで使用できますか? A: はい。資金調達ステップ中に、WalletConnect または Coinbase Wallet 拡張機能を介してハードウェア ウォレットが接続され、ロックが解除されている場合に限ります。

Q: Coinbase Pay はサブスクリプションベースの dApp の定期支払いをサポートしていますか? A: いいえ、Coinbase Pay は法定通貨から暗号通貨への 1 回限りの移行を目的として設計されています。定期的な請求には、別個のオフチェーン請求書または ERC-20 許容パターンが必要です。

Q: ユーザーがフローの途中で Coinbase Pay モーダルを閉じた場合はどうなりますか? A: セッションは 120 秒後に自動的に期限切れになります。資金は差し引かれず、開発者は UI 状態をリセットするためのonCancelイベントを受け取ります。

Q: ユーザーが 1 回の取引で Coinbase Pay 経由で購入できる金額に制限はありますか? A: はい、制限は地域と検証レベルによって異なります。米国レベル 2 の検証済みユーザーは 1 日あたり最大 50,000 ドルまで取引できますが、未検証のアカウントには 200 ドルの上限があります。