Financie la billetera y otorgue permisos a los agentes

Tras crear un instrumento de pago, el usuario final debe depositar fondos en la cartera con el USDC y conceder al agente permiso para firmar las transacciones. Hasta que no se completen ambos pasos, la operación de pago del proceso fallará con una excepción del lado del cliente.

Coinbase CDP

Al crear un instrumento de pago con el conector CDP de Coinbase, la CreatePaymentInstrument API devuelve un mensaje que redirectUrl apunta a Coinbase WalletHub, un portal para conceder permisos a los agentes y depositar fondos en la cartera. Dirige al usuario final a esta URL para depositar fondos en su cartera y conceder permisos de agente desde una única interfaz.

Utilice la WalletHub URL

redirectUrlA partir de la CreatePaymentInstrument respuesta, se abre la Coinbase WalletHub, donde el usuario final puede depositar fondos en la cartera y conceder permisos de firma al agente.

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

Como alternativa, puedes implementar la AgentCore plantilla de Coinbase GitHub como una Next.js interfaz autohospedada que proporcione la misma funcionalidad de financiación y permisos con una interfaz de usuario personalizable. Consulte (Alternativa) Implemente la interfaz autohospedada para obtener instrucciones de configuración.

Financia la cartera

Desde la interfaz WalletHub (o desde la interfaz autohospedada), el usuario final puede depositar fondos en su cartera mediante cualquiera de los siguientes métodos:

Para los entornos de redes de prueba, financie el monedero con el USDC de testnet del grifo Circle USDC.

Otorgue permisos a los agentes

Los permisos de agente en Coinbase CDP utilizan la delegación por monedero: cada monedero recibe su propia autorización independiente y con un plazo determinado del usuario final, que autoriza al agente a firmar transacciones.

Una vez concedido, el agente puede firmar las transacciones en nombre de los monederos del usuario final hasta que venza la concesión. El usuario final puede revocar los permisos en cualquier momento desde el mismo panel de control. Una vez que se haya otorgado la subvención, proceda a Crear una sesión de pago.

Revoca los permisos

El usuario final puede revocar el acceso del agente a cualquier monedero en cualquier momento desde la sección de permisos del panel de control WalletHub o desde la interfaz de usuario. Tras la revocación, el agente ya no podrá firmar las transacciones de esa cartera hasta que el usuario conceda nuevos permisos.

(Alternativa) Implemente la interfaz autohospedada

Si necesita una interfaz de usuario personalizable en lugar de una alojada WalletHub, implemente la AgentCore plantilla de Coinbase como una aplicación autohospedada. Next.js

La interfaz autohospedada proporciona los mismos flujos de financiación y concesión de permisos descritos anteriormente, con un control total sobre el estilo y la experiencia del usuario.

Stripe (privado)

El Privy AgentCore SDK on GitHub es una interfaz de Next.js referencia que permite a los usuarios finales autenticarse, financiar carteras y conceder permisos a los agentes mediante un flujo de configuración guiado.

Implemente la interfaz

Financie la cartera

Cuando el usuario final se autentica a través de la interfaz Privy, se crean automáticamente carteras integradas para las redes Base (EVM) y Solana. El usuario final puede depositar fondos en su cartera mediante cualquiera de los siguientes métodos:

Para los entornos de redes de prueba, financie el monedero con el USDC de testnet del grifo Circle USDC.

Otorgue permisos a los agentes

Los permisos de los agentes en Privy utilizan a los firmantes de sesión (también denominados claves de autorización): el usuario final registra la clave de autorización del agente en cada cartera integrada, lo que le otorga permiso para firmar transacciones sin la aprobación de cada transacción.

La interfaz utiliza el SDK addSessionSigners de Privy para registrar la clave de autorización del agente en cada cartera integrada. La operación es idempotente: si el firmante ya está registrado, no se devuelve ningún error.

Una vez conectado, el agente puede firmar las transacciones en nombre de las carteras del usuario. Los permisos se conservan hasta que se revoquen de forma explícita.

(Opcional) Compruebe la conexión del agente

La interfaz verifica que los permisos estén activos mediante una llamada a la API Privy:

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

La respuesta incluye una matriz. additional_signers Si el identificador de autorización configurado aparece en esta matriz, el agente está conectado.

Una vez que se haya otorgado la subvención, proceda a Crear una sesión de pago.

Probando con testnet USDC

Para el desarrollo y las pruebas, utilice redes de redes de prueba y financie carteras con el USDC de prueba: