Finanzia il portafoglio e concedi le autorizzazioni all'agente

Dopo aver creato uno strumento di pagamento, l'utente finale deve finanziare il portafoglio con USDC e concedere all'agente l'autorizzazione a firmare le transazioni. Fino al completamento di entrambi i passaggi, l'operazione di pagamento fallisce con un'eccezione sul lato client.

Coinbase CDP

Quando crei uno strumento di pagamento con il connettore Coinbase CDP, l'CreatePaymentInstrumentAPI rimanda a Coinbase WalletHub, redirectUrl un portale per concedere le autorizzazioni agli agenti e finanziare il portafoglio. Indirizza l'utente finale a questo URL per finanziare il proprio portafoglio e concedere le autorizzazioni agli agenti da un'unica interfaccia.

Usa l'URL WalletHub

redirectUrlDalla CreatePaymentInstrument risposta si apre Coinbase WalletHub, dove l'utente finale può finanziare il portafoglio e concedere le autorizzazioni di firma all'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}")

In alternativa, puoi utilizzare il AgentCore modello Coinbase GitHub come Next.js frontend ospitato autonomamente che fornisce le stesse funzionalità di finanziamento e autorizzazioni con un'interfaccia utente personalizzabile. Vedi per le istruzioni di configurazione. (Alternativa) Implementa il frontend ospitato autonomamente

Finanzia il portafoglio

Dal frontend WalletHub (o dal frontend ospitato autonomamente), l'utente finale può finanziare il proprio portafoglio utilizzando uno dei seguenti metodi:

Per gli ambienti testnet, alimenta il portafoglio con testnet USDC dal rubinetto Circle USDC.

Concedi le autorizzazioni agli agenti

Le autorizzazioni degli agenti in Coinbase CDP utilizzano la delega basata sull'ambito del portafoglio: ogni portafoglio riceve una concessione indipendente e limitata nel tempo dall'utente finale che autorizza l'agente a firmare le transazioni.

Una volta concessa, l'agente può firmare le transazioni per conto dei portafogli dell'utente finale fino alla scadenza della concessione. L'utente finale può revocare le autorizzazioni in qualsiasi momento dalla stessa dashboard. Una volta fornita la sovvenzione, procedi con Crea una sessione di pagamento.

Revoca le autorizzazioni

L'utente finale può revocare l'accesso dell'agente a qualsiasi portafoglio in qualsiasi momento dalla sezione delle autorizzazioni della dashboard o del frontend. WalletHub Dopo la revoca, l'agente non può più firmare le transazioni per quel portafoglio finché l'utente non concede nuove autorizzazioni.

(Alternativa) Implementa il frontend ospitato autonomamente

Se hai bisogno di un'interfaccia utente personalizzabile anziché quella ospitata WalletHub, implementa il AgentCore modello Coinbase come applicazione ospitata autonomamente. Next.js

Il frontend ospitato autonomamente offre gli stessi flussi di finanziamento e concessione delle autorizzazioni descritti sopra, con il pieno controllo sullo stile e sull'esperienza utente.

Stripe (Privy)

Privy AgentCore SDK on GitHub è un frontend di Next.js riferimento che consente agli utenti finali di autenticarsi, finanziare i portafogli e concedere le autorizzazioni agli agenti attraverso un flusso di configurazione guidato.

Implementa il frontend

Trova il portafoglio

Quando l'utente finale si autentica tramite il frontend Privy, i portafogli integrati vengono creati automaticamente per le reti Base (EVM) e Solana. L'utente finale può finanziare il proprio portafoglio utilizzando uno dei seguenti metodi:

Per gli ambienti testnet, alimenta il portafoglio con testnet USDC dal rubinetto Circle USDC.

Concedi le autorizzazioni agli agenti

Le autorizzazioni degli agenti in Privy utilizzano i firmatari di sessione (chiamati anche chiavi di autorizzazione): l'utente finale registra la chiave di autorizzazione dell'agente su ogni portafoglio incorporato, concedendo all'agente il permesso di firmare le transazioni senza l'approvazione della singola transazione.

Il frontend chiama addSessionSigners dal Privy SDK per registrare la chiave di autorizzazione dell'agente su ogni portafoglio incorporato. L'operazione è idempotente: se il firmatario è già registrato, non viene restituito alcun errore.

Una volta connesso, l'agente può firmare le transazioni per conto dei portafogli dell'utente. Le autorizzazioni persistono fino a quando non vengono revocate esplicitamente.

(Facoltativo) Verifica la connessione dell'agente

Il frontend verifica che le autorizzazioni siano attive chiamando l'API Privy:

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

La risposta include un array. additional_signers Se l'ID di autorizzazione configurato appare in questo array, l'agente è connesso.

Una volta fornita la concessione, procedi con Crea una sessione di pagamento.

Test con testnet USDC

Per lo sviluppo e il test, utilizza le reti testnet e i portafogli di fondi con test USDC: