Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Financia el monedero y concede permisos a los agentes

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

El uso que hagas de proveedores de monederos externos se rige por sus condiciones. AWS no tiene la custodia ni el control de las carteras, los fondos, los activos digitales o las claves privadas asociadas, ni es responsable de ellos. Eres el único responsable de cualquier transacción, disputa o responsabilidad relacionada con el pago que surja del uso de AgentCore Payments, y de implementar las medidas de seguridad adecuadas (como la supervisión continua), según corresponda en cada caso de uso. Para obtener más información, consulta la sección 50.15 (Amazon Bedrock AgentCore Payments) de las Condiciones de servicio. AWS

Coinbase CDP

Cuando creas un instrumento de pago con el conector CDP de Coinbase, la CreatePaymentInstrument API muestra un enlace a Coinbase WalletHub, un portal redirectUrl que permite conceder permisos a los agentes y depositar fondos en el monedero. Dirige al usuario final a esta URL para que deposite fondos en su monedero y conceda permisos a los agentes desde una única interfaz.

Usa la WalletHub URL

La redirectUrl CreatePaymentInstrument respuesta abre Coinbase WalletHub, donde el usuario final puede financiar el monedero 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 el monedero

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

Para entornos de redes de prueba, financie el monedero con testnet USDC de Circle USDC. https://faucet.circle.com/

Otorga permisos a los agentes

Los permisos de agente en el CDP de Coinbase utilizan una delegación por monedero: cada monedero recibe su propia concesión independiente y temporal del usuario final, que autoriza al agente a firmar las transacciones.

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

Revoca los permisos

El usuario final puede revocar el acceso de un agente a cualquier monedero en cualquier momento desde la sección de permisos del panel de control WalletHub o de 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 necesitas una interfaz de usuario personalizable en lugar de la alojada WalletHub, implementa 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, depositar fondos en carteras y conceder permisos a los agentes mediante un flujo de configuración guiado.

Implementa la interfaz

Financia el monedero

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

Para entornos de redes de prueba, financie el monedero con testnet USDC de Circle USDC. https://faucet.circle.com/

Otorga permisos a los agentes

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

La interfaz llama addSessionSigners desde el Privy SDK 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 persisten hasta que se revoquen explícitamente.

(Opcional) Verifique la conexión del agente

La interfaz verifica que los permisos estén activos llamando 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 concedida la concesión, proceda a crear una sesión de pago.

Probando con testnet USDC

Para el desarrollo y las pruebas, usa redes de testnet y financia carteras con el USDC de prueba: