Mendanai dompet dan memberikan izin agen

Setelah Anda membuat instrumen pembayaran, pengguna akhir harus mendanai dompet dengan USDC dan memberikan izin agen untuk menandatangani transaksi. Sampai kedua langkah selesai, operasi pembayaran proses gagal dengan pengecualian sisi klien.

CDP Coinbase

Saat Anda membuat instrumen pembayaran dengan konektor Coinbase CDP, CreatePaymentInstrument API mengembalikan redirectUrl titik ke Coinbase WalletHub, portal untuk memberikan izin agen dan mendanai dompet. Arahkan pengguna akhir ke URL ini untuk mendanai dompet mereka dan memberikan izin agen dari satu antarmuka.

Gunakan WalletHub URL

redirectUrlDari CreatePaymentInstrument tanggapan membuka Coinbase WalletHub, di mana pengguna akhir dapat mendanai dompet dan memberikan izin penandatanganan kepada agen.

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

Atau, Anda dapat menerapkan AgentCore template Coinbase GitHub sebagai Next.js frontend yang dihosting sendiri yang menyediakan fungsionalitas pendanaan dan izin yang sama dengan UI yang dapat disesuaikan. Lihat (Alternatif) Terapkan frontend yang dihosting sendiri untuk petunjuk penyiapan.

Danai dompet

Dari WalletHub (atau frontend yang dihosting sendiri), pengguna akhir dapat mendanai dompet mereka menggunakan salah satu metode berikut:

Untuk lingkungan testnet, danai dompet dengan testnet USDC dari faucet Circle USDC.

Berikan izin agen

Izin agen di Coinbase CDP menggunakan delegasi lingkup dompet — setiap dompet menerima hibah independen dan terikat waktu sendiri dari pengguna akhir yang memberi wewenang kepada agen untuk menandatangani transaksi.

Setelah diberikan, agen dapat menandatangani transaksi atas nama dompet pengguna akhir sampai hibah berakhir. Pengguna akhir dapat mencabut izin kapan saja dari dasbor yang sama. Setelah hibah diberikan, lanjutkan ke Buat sesi pembayaran.

Mencabut izin

Pengguna akhir dapat mencabut akses agen ke dompet apa pun kapan saja dari bagian izin di dasbor WalletHub atau frontend. Setelah pencabutan, agen tidak dapat lagi menandatangani transaksi untuk dompet itu sampai pengguna memberikan izin baru.

(Alternatif) Terapkan frontend yang dihosting sendiri

Jika Anda memerlukan UI yang dapat disesuaikan alih-alih yang dihosting WalletHub, gunakan AgentCore template Coinbase sebagai aplikasi yang dihosting sendiri. Next.js

Frontend yang dihosting sendiri menyediakan aliran pendanaan dan pemberian izin yang sama seperti yang dijelaskan di atas, dengan kontrol penuh atas gaya dan pengalaman pengguna.

Stripe (Garis)

Privy AgentCore SDK on GitHub adalah frontend Next.js referensi yang memungkinkan pengguna akhir untuk mengautentikasi, mendanai dompet, dan memberikan izin agen melalui alur penyiapan yang dipandu.

Terapkan frontend

Danai dompet

Saat pengguna akhir mengautentikasi melalui frontend Privy, dompet tertanam secara otomatis dibuat untuk jaringan Base (EVM) dan Solana. Pengguna akhir dapat mendanai dompet mereka menggunakan salah satu metode berikut:

Untuk lingkungan testnet, danai dompet dengan testnet USDC dari faucet Circle USDC.

Berikan izin agen

Izin agen dalam penandatangan sesi penggunaan Privy (juga disebut kunci otorisasi) —pengguna akhir mendaftarkan kunci otorisasi agen pada setiap dompet yang disematkan, memberikan izin agen untuk menandatangani transaksi tanpa persetujuan per transaksi.

Frontend memanggil addSessionSigners dari Privy SDK untuk mendaftarkan kunci otorisasi agen pada setiap dompet yang disematkan. Operasi ini idempoten—jika penandatangan sudah terdaftar, tidak ada kesalahan yang dikembalikan.

Setelah terhubung, agen dapat menandatangani transaksi atas nama dompet pengguna. Izin tetap ada sampai dicabut secara eksplisit.

(Opsional) Verifikasi koneksi agen

Frontend memverifikasi bahwa izin aktif dengan memanggil Privy API:

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

Responsnya mencakup additional_signers array. Jika ID Otorisasi yang dikonfigurasi muncul dalam array ini, agen terhubung.

Setelah hibah diberikan, lanjutkan ke Buat sesi pembayaran.

Pengujian dengan testnet USDC

Untuk pengembangan dan pengujian, gunakan jaringan testnet dan dompet dana dengan uji USDC: