Financie a carteira e conceda permissões ao agente

Depois de criar um instrumento de pagamento, o usuário final deve financiar a carteira com USDC e conceder permissão ao agente para assinar transações. Até que ambas as etapas sejam concluídas, a operação de pagamento do processo falhará com uma exceção do lado do cliente.

Coinbase CDP

Quando você cria um instrumento de pagamento com o conector CDP da Coinbase, a CreatePaymentInstrument API retorna um redirectUrl apontamento para o Coinbase WalletHub, um portal para conceder permissões ao agente e financiar a carteira. Direcione o usuário final para esse URL para financiar sua carteira e conceder permissões ao agente em uma única interface.

Use o WalletHub URL

O redirectUrl formulário da CreatePaymentInstrument resposta abre a Coinbase WalletHub, onde o usuário final pode financiar a carteira e conceder permissões de assinatura ao 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, você pode implantar o AgentCore modelo Coinbase GitHub como um Next.js front-end auto-hospedado que fornece a mesma funcionalidade de financiamento e permissões com uma interface de usuário personalizável. Consulte (Alternativa) Implemente o front-end auto-hospedado para obter instruções de configuração.

Financie a carteira

A partir do WalletHub (ou do frontend auto-hospedado), o usuário final pode financiar sua carteira usando qualquer um dos seguintes métodos:

Para ambientes de testnet, financie a carteira com testnet USDC da torneira Circle USDC.

Conceda permissões ao agente

As permissões do agente no Coinbase CDP usam a delegação no escopo da carteira — cada carteira recebe sua própria concessão independente e com prazo determinado do usuário final, que autoriza o agente a assinar transações.

Depois de concedida, o agente pode assinar transações em nome das carteiras do usuário final até que a concessão expire. O usuário final pode revogar as permissões a qualquer momento no mesmo painel. Depois que o subsídio for fornecido, vá para Criar uma sessão de pagamento.

Revogar permissões

O usuário final pode revogar o acesso do agente a qualquer carteira a qualquer momento na seção de permissões WalletHub ou no painel de front-end. Após a revogação, o agente não poderá mais assinar transações para essa carteira até que o usuário conceda novas permissões.

(Alternativa) Implemente o front-end auto-hospedado

Se você precisar de uma interface de usuário personalizável em vez da hospedada WalletHub, implante o AgentCore modelo Coinbase como um aplicativo Next.js auto-hospedado.

O frontend auto-hospedado fornece os mesmos fluxos de financiamento e concessão de permissões descritos acima, com controle total sobre o estilo e a experiência do usuário.

Stripe (Privado)

O Privy AgentCore SDK on GitHub é um front-end de Next.js referência que permite que os usuários finais se autentiquem, financiem carteiras e concedam permissões aos agentes por meio de um fluxo de configuração guiado.

Implemente o front-end

Financie a carteira

Quando o usuário final se autentica por meio do frontend Privy, carteiras incorporadas são criadas automaticamente para as redes Base (EVM) e Solana. O usuário final pode financiar sua carteira usando qualquer um dos seguintes métodos:

Para ambientes de testnet, financie a carteira com testnet USDC da torneira Circle USDC.

Conceda permissões ao agente

As permissões do agente no Privy usam signatários de sessão (também chamadas de chaves de autorização) — o usuário final registra a chave de autorização do agente em cada carteira incorporada, concedendo ao agente permissão para assinar transações sem aprovação por transação.

O front-end usa addSessionSigners o Privy SDK para registrar a chave de autorização do agente em cada carteira incorporada. A operação é idempotente — se o assinante já estiver registrado, nenhum erro será retornado.

Uma vez conectado, o agente pode assinar transações em nome das carteiras do usuário. As permissões persistem até serem revogadas explicitamente.

(Opcional) Verifique a conexão do agente

O front-end verifica se as permissões estão ativas chamando a API Privy:

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

A resposta inclui uma additional_signers matriz. Se a ID de autorização configurada aparecer nessa matriz, o agente está conectado.

Depois que o subsídio for fornecido, vá para Criar uma sessão de pagamento.

Testando com testnet USDC

Para desenvolvimento e teste, use redes testnet e carteiras de fundos com o teste USDC: