ウォレットに資金を提供し、エージェントにアクセス許可を付与する

支払い手段を作成した後、エンドユーザーはウォレットに USDC の資金を提供し、トランザクションに署名するアクセス許可をエージェントに付与する必要があります。両方のステップが完了するまで、プロセス支払いオペレーションはクライアント側の例外で失敗します。

コインベース CDP

Coinbase CDP コネクタを使用して支払い手段を作成すると、CreatePaymentInstrumentAPI は、エージェントのアクセス許可を付与し、ウォレットに資金を提供するポータルである Coinbase WalletHub redirectUrlを指す を返します。この URL にエンドユーザーを誘導してウォレットに資金を提供し、単一のインターフェイスからエージェントにアクセス許可を付与します。

WalletHub URL を使用する

CreatePaymentInstrument レスポンスredirectUrlの が Coinbase WalletHub を開き、エンドユーザーはウォレットに資金を提供し、エージェントに署名許可を付与できます。

instrument = dp_client.create_payment_instrument(
    userId="test-user-123",
    paymentManagerArn=PAYMENT_MANAGER_ARN,
    paymentConnectorId=PAYMENT_CONNECTOR_ID,
    paymentInstrumentType="EMBEDDED_CRYPTO_WALLET",
    paymentInstrumentDetails={
        "embeddedCryptoWallet": {
            "network": "ETHEREUM",
            "linkedAccounts": [{"email": {"emailAddress": "user@example.com"}}]
        }
    },
    clientToken=str(uuid.uuid4()),
)

# Direct the end user to this URL
wallet_hub_url = instrument["paymentInstrumentDetails"]["redirectUrl"]
print(f"Open the WalletHub: {wallet_hub_url}")

または、GitHub の Coinbase AgentCore テンプレートをセルフホスト Next.js フロントエンドとしてデプロイして、カスタマイズ可能な UI で同じ資金とアクセス許可の機能を提供することもできます。セットアップ手順については、「(代替) セルフホスト型フロントエンドをデプロイする」を参照してください。

ウォレットに資金を提供する

WalletHub (またはセルフホストフロントエンド) から、エンドユーザーは次のいずれかの方法を使用してウォレットに資金を提供できます。

テストネット環境の場合は、Circle USDC 蛇口からテストネット USDC でウォレットに資金を提供します。

エージェントにアクセス許可を付与する

Coinbase CDP のエージェントアクセス許可は、ウォレットスコープの委任を使用します。各ウォレットは、エージェントがトランザクションに署名することを許可するエンドユーザーから独自の独立した期限付き許可を受け取ります。

付与されると、エージェントは付与の有効期限が切れるまでエンドユーザーのウォレットに代わってトランザクションに署名できます。エンドユーザーは、同じダッシュボードからいつでもアクセス許可を取り消すことができます。許可が提供されたら、支払いセッションの作成に進みます。

アクセス許可を取り消す

エンドユーザーは、WalletHub またはフロントエンドダッシュボードのアクセス許可セクションから、任意のウォレットへのエージェントアクセスをいつでも取り消すことができます。取り消し後、ユーザーが新しいアクセス許可を付与するまで、エージェントはそのウォレットのトランザクションに署名できなくなります。

(代替) セルフホスト型フロントエンドをデプロイする

ホストされた WalletHub の代わりにカスタマイズ可能な UI が必要な場合は、Coinbase AgentCore テンプレートをセルフホストの Next.js アプリケーションとしてデプロイします。

セルフホストフロントエンドは、スタイルとユーザーエクスペリエンスを完全に制御しながら、上記ののと同じ資金とアクセス許可の付与フローを提供します。

ストライプ (プライベート)

GitHub の Privy AgentCore SDK は Next.js リファレンスフロントエンドであり、エンドユーザーはガイド付きセットアップフローを通じて認証、ウォレットへの資金供給、エージェントのアクセス許可の付与を行うことができます。

フロントエンドをデプロイする

ウォレットに資金を提供する

エンドユーザーが Privy フロントエンドを介して認証すると、ベース (EVM) ネットワークと Solana ネットワークの両方で埋め込みウォレットが自動的に作成されます。エンドユーザーは、次のいずれかの方法を使用してウォレットに資金を提供できます。

テストネット環境の場合は、Circle USDC 蛇口からテストネット USDC でウォレットに資金を提供します。

エージェントにアクセス許可を付与する

Privy のエージェントアクセス許可は、セッション署名者 (認可キーとも呼ばれます) を使用します。エンドユーザーは、埋め込みウォレットごとにエージェントの認可キーを登録し、トランザクションごとの承認なしでトランザクションに署名するアクセス許可をエージェントに付与します。

フロントエンドは Privy SDK addSessionSignersから を呼び出して、各埋め込みウォレットにエージェントの認可キーを登録します。オペレーションはべき等です。署名者が既に登録されている場合、エラーは返されません。

接続すると、エージェントはユーザーのウォレットに代わってトランザクションに署名できます。アクセス許可は、明示的に取り消されるまで保持されます。

(オプション) エージェント接続の検証

フロントエンドは、Privy API を呼び出してアクセス許可がアクティブであることを確認します。

GET https://auth.privy.io/api/v1/wallets/{walletId}
Authorization: Basic <base64(appId:appSecret)>

レスポンスには additional_signers配列が含まれます。設定された認可 ID がこの配列に表示される場合、エージェントは接続されます。

許可が提供されたら、支払いセッションの作成に進みます。

テストネット USDC を使用したテスト

開発とテストには、テストネットワークを使用し、テスト USDC でウォレットに資金を提供します。