Financez le portefeuille et accordez les autorisations aux agents

Après avoir créé un instrument de paiement, l'utilisateur final doit approvisionner le portefeuille avec l'USDC et autoriser l'agent à signer des transactions. Tant que les deux étapes ne sont pas terminées, l'opération de traitement du paiement échoue avec une exception côté client.

Coinbase CDP

Lorsque vous créez un instrument de paiement avec le connecteur Coinbase CDP, l'CreatePaymentInstrumentAPI renvoie un redirectUrl pointeur vers Coinbase WalletHub, un portail permettant d'accorder des autorisations aux agents et de financer le portefeuille. Dirigez l'utilisateur final vers cette URL pour approvisionner son portefeuille et accorder des autorisations aux agents à partir d'une interface unique.

Utilisez l' WalletHub URL

La CreatePaymentInstrument réponse redirectUrl from ouvre la Coinbase WalletHub, où l'utilisateur final peut approvisionner le portefeuille et accorder des autorisations de signature à l'agent.

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}")

Vous pouvez également déployer le AgentCore modèle Coinbase en GitHub tant que Next.js frontend auto-hébergé qui fournit les mêmes fonctionnalités de financement et d'autorisations avec une interface utilisateur personnalisable. Consultez (Alternative) Déployez le frontend auto-hébergé les instructions de configuration.

Approvisionnez le portefeuille

Depuis le frontend WalletHub (ou depuis le frontend auto-hébergé), l'utilisateur final peut approvisionner son portefeuille en utilisant l'une des méthodes suivantes :

Pour les environnements testnet, approvisionnez le portefeuille avec le testnet USDC provenant du robinet Circle USDC.

Accorder des autorisations aux agents

Les autorisations d'agent dans Coinbase CDP utilisent une délégation à l'échelle du portefeuille : chaque portefeuille reçoit sa propre autorisation indépendante et limitée dans le temps de la part de l'utilisateur final qui autorise l'agent à signer des transactions.

Une fois l'autorisation accordée, l'agent peut signer les transactions pour le compte des portefeuilles de l'utilisateur final jusqu'à son expiration. L'utilisateur final peut révoquer les autorisations à tout moment depuis le même tableau de bord. Une fois la subvention accordée, passez à Créer une session de paiement.

Révoquer les autorisations

L'utilisateur final peut révoquer l'accès de l'agent à n'importe quel portefeuille à tout moment depuis la section des autorisations du tableau de bord WalletHub ou du frontend. Après la révocation, l'agent ne peut plus signer les transactions pour ce portefeuille tant que l'utilisateur n'a pas accordé de nouvelles autorisations.

(Alternative) Déployez le frontend auto-hébergé

Si vous avez besoin d'une interface utilisateur personnalisable au lieu d'une interface hébergée WalletHub, déployez le AgentCore modèle Coinbase en tant qu'application auto-hébergée Next.js .

Le frontend auto-hébergé fournit les mêmes flux de financement et d'octroi d'autorisations décrits ci-dessus, avec un contrôle total sur le style et l'expérience utilisateur.

Stripe (Privy)

Le AgentCore SDK Privy GitHub est une interface de Next.js référence qui permet aux utilisateurs finaux de s'authentifier, de financer des portefeuilles et d'accorder des autorisations aux agents via un flux de configuration guidé.

Déployer le frontend

Approvisionnez le portefeuille

Lorsque l'utilisateur final s'authentifie via le frontend Privy, des portefeuilles intégrés sont automatiquement créés pour les réseaux Base (EVM) et Solana. L'utilisateur final peut approvisionner son portefeuille en utilisant l'une des méthodes suivantes :

Pour les environnements testnet, approvisionnez le portefeuille avec le testnet USDC provenant du robinet Circle USDC.

Accorder des autorisations aux agents

Dans Privy, les autorisations d'agent utilisent des signataires de session (également appelés clés d'autorisation) : l'utilisateur final enregistre la clé d'autorisation de l'agent sur chaque portefeuille intégré, autorisant ainsi l'agent à signer des transactions sans approbation par transaction.

Le frontend appelle addSessionSigners depuis le Privy SDK pour enregistrer la clé d'autorisation de l'agent sur chaque portefeuille intégré. L'opération est inopérante : si le signataire est déjà enregistré, aucune erreur n'est renvoyée.

Une fois connecté, l'agent peut signer des transactions pour le compte des portefeuilles de l'utilisateur. Les autorisations sont conservées jusqu'à ce qu'elles soient explicitement révoquées.

(Facultatif) Vérifiez la connexion à l'agent

Le frontend vérifie que les autorisations sont actives en appelant l'API Privy :

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

La réponse inclut un additional_signers tableau. Si l'ID d'autorisation configuré apparaît dans ce tableau, l'agent est connecté.

Une fois la subvention accordée, passez à Créer une session de paiement.

Tester avec testnet USDC

Pour le développement et les tests, utilisez les réseaux testnet et financez des portefeuilles avec test USDC :