Finanzieren Sie das Wallet und gewähren Sie Agentenberechtigungen

Nachdem Sie ein Zahlungsinstrument erstellt haben, muss der Endbenutzer die Wallet mit USDC finanzieren und dem Agenten die Erlaubnis erteilen, Transaktionen zu signieren. Bis beide Schritte abgeschlossen sind, schlägt der Zahlungsvorgang mit einer clientseitigen Ausnahme fehl.

Coinbase CDP

Wenn Sie ein Zahlungsinstrument mit dem Coinbase CDP-Connector erstellen, gibt die CreatePaymentInstrument API einen Verweis auf Coinbase zurück, ein redirectUrl Portal WalletHub, über das Agentenberechtigungen erteilt und die Wallet finanziert werden können. Leiten Sie den Endbenutzer zu dieser URL weiter, um seine Wallet zu finanzieren und Agentenberechtigungen von einer einzigen Oberfläche aus zu gewähren.

Verwenden Sie die WalletHub URL

redirectUrlVon der CreatePaymentInstrument Antwort aus wird die Coinbase geöffnet WalletHub, wo der Endbenutzer die Wallet finanzieren und dem Agenten Signierberechtigungen erteilen kann.

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

Alternativ können Sie die AgentCore Coinbase-Vorlage GitHub als selbst gehostetes Next.js Frontend bereitstellen, das dieselben Finanzierungs- und Berechtigungsfunktionen mit einer anpassbaren Benutzeroberfläche bietet. Anweisungen (Alternative) Stellen Sie das selbst gehostete Frontend bereit zur Einrichtung finden Sie unter.

Finanzieren Sie die Brieftasche

Über das WalletHub (oder das selbst gehostete Frontend) kann der Endbenutzer sein Wallet mit einer der folgenden Methoden aufladen:

Für Testnet-Umgebungen finanzieren Sie das Wallet mit Testnet USDC aus dem Circle USDC-Faucet.

Gewähren Sie Agentenberechtigungen

Agentenberechtigungen in Coinbase CDP verwenden Delegierung im Wallet-Bereich — jedes Wallet erhält seinen eigenen unabhängigen, zeitlich begrenzten Zuschuss vom Endbenutzer, der den Agenten autorisiert, Transaktionen zu signieren.

Nach der Erteilung kann der Agent Transaktionen im Namen der Wallets des Endbenutzers unterzeichnen, bis die Genehmigung abläuft. Der Endbenutzer kann Berechtigungen jederzeit über dasselbe Dashboard widerrufen. Sobald der Zuschuss gewährt wurde, fahren Sie mit „Zahlungssitzung erstellen“ fort.

Widerrufen Sie die Berechtigungen

Der Endbenutzer kann den Agentenzugriff auf jedes Wallet jederzeit über den Berechtigungsbereich des Frontend-Dashboards WalletHub oder des Frontend-Dashboards widerrufen. Nach dem Widerruf kann der Agent keine Transaktionen mehr für dieses Wallet signieren, bis der Benutzer neue Berechtigungen erteilt.

(Alternative) Stellen Sie das selbst gehostete Frontend bereit

Wenn Sie anstelle der gehosteten eine anpassbare Benutzeroberfläche benötigen WalletHub, stellen Sie die AgentCore Coinbase-Vorlage als selbst gehostete Anwendung bereit. Next.js

Das selbst gehostete Frontend bietet dieselben Finanzierungs- und Genehmigungsabläufe wie oben beschrieben, mit voller Kontrolle über das Design und die Benutzererfahrung.

Stripe (Privy)

Das Privy AgentCore SDK on GitHub ist ein Next.js Referenz-Frontend, das es Endbenutzern ermöglicht, sich über einen geführten Einrichtungsablauf zu authentifizieren, Wallets zu finanzieren und Agentenberechtigungen zu erteilen.

Stellen Sie das Frontend bereit

Finanzieren Sie die Brieftasche

Wenn sich der Endbenutzer über das Privy-Frontend authentifiziert, werden automatisch eingebettete Wallets sowohl für Base- (EVM) als auch für Solana-Netzwerke erstellt. Der Endbenutzer kann seine Brieftasche mit einer der folgenden Methoden aufladen:

Für Testnet-Umgebungen finanzieren Sie das Wallet mit Testnet USDC aus dem Circle USDC-Faucet.

Gewähren Sie Agentenberechtigungen

Agentenberechtigungen in Privy verwenden Sitzungssignierer (auch Autorisierungsschlüssel genannt). Der Endbenutzer registriert den Autorisierungsschlüssel des Agenten in jedem eingebetteten Wallet und erteilt dem Agenten so die Erlaubnis, Transaktionen ohne Genehmigung pro Transaktion zu signieren.

Das Frontend ruft addSessionSigners vom Privy SDK aus auf, um den Autorisierungsschlüssel des Agenten in jeder eingebetteten Wallet zu registrieren. Der Vorgang ist idempotent — wenn der Unterzeichner bereits registriert ist, wird kein Fehler zurückgegeben.

Sobald die Verbindung hergestellt ist, kann der Agent Transaktionen im Namen der Wallets des Benutzers signieren. Die Berechtigungen bleiben bestehen, bis sie ausdrücklich widerrufen werden.

(Optional) Überprüfen Sie die Agentenverbindung

Das Frontend überprüft, ob die Berechtigungen aktiv sind, indem es die Privy-API aufruft:

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

Die Antwort enthält ein Array. additional_signers Wenn die konfigurierte Autorisierungs-ID in diesem Array erscheint, ist der Agent verbunden.

Sobald der Zuschuss gewährt wurde, fahren Sie mit „Zahlungssitzung erstellen“ fort.

Testen mit Testnet USDC

Verwenden Sie für Entwicklung und Tests Testnet-Netzwerke und finanzieren Sie Wallets mit Test USDC: