翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

サードパーティーのウォレットプロバイダーの使用には、その条項が適用されます。 AWS は、ウォレット、資金、デジタルアセット、または関連するプライベートキーを保管または管理するものではなく、責任を負いません。エージェントAgentCore支払いの使用に起因する取引、論争、または支払い責任、およびユースケースに応じて適切な保護 (ヒューhuman-in-the-loop監視など) を実装する責任は、お客様が単独で負います。詳細については、 AWS サービス条件のセクション 50.15 (Amazon Bedrock AgentCore Payments) を参照してください。

コインベース 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 を使用してウォレットに資金を提供します。