View a markdown version of this page

Danai dompet dan berikan izin agen - Batu Dasar Amazon AgentCore

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Danai dompet dan berikan izin agen

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

Penggunaan Anda atas penyedia dompet pihak ketiga diatur oleh persyaratan mereka. AWS tidak memiliki hak asuh atau kontrol atas, dan tidak bertanggung jawab atas, dompet, dana, aset digital, atau kunci pribadi terkait. Anda bertanggung jawab penuh atas transaksi, perselisihan, atau kewajiban pembayaran yang timbul dari penggunaan AgentCore Pembayaran oleh Anda, dan untuk menerapkan perlindungan yang tepat (seperti pengawasan manusia dalam lingkaran) sebagaimana sesuai untuk kasus penggunaan Anda. Untuk detail selengkapnya, lihat Bagian 50.15 (Pembayaran Amazon Bedrock AgentCore ) dari Ketentuan AWS Layanan.

Tip

Anda dapat mengotomatiskan langkah-langkah di halaman ini dengan keterampilan AgentCore Pembayaran di toolkit AWS agen. Keterampilan adalah bagian dari plugin aws-agents. Dengan itu, agen pengkodean AI dapat membuat Manajer Pembayaran, konektor, penyedia kredensia, instrumen pembayaran, dan sesi menggunakan agentcore CLI, dan menambahkan alat pembayaran proses ke agen Anda. Untuk detailnya, lihat Quickstart dan toolkit AWS agen aktif. GitHub

CDP Coinbase

Saat Anda membuat instrumen pembayaran dengan konektor Coinbase CDP, CreatePaymentInstrument API mengembalikan penunjuk ke Coinbase WalletHub, portal untuk memberikan izin agen dan mendanai dompet. redirectUrl 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}")
Coinbase WalletHub untuk pendanaan dan pemberian izin

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

Danai dompet

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

Metode Deskripsi Ketersediaan

Coinbase Onramp () card/bank

Beli USDC secara langsung menggunakan kartu kredit, kartu debit, Apple Pay, Google Pay, atau ACH melalui alur pembelian yang dihosting Coinbase.

Hanya Mainnet

Terima (kode QR)

Tampilkan kode QR dan alamat dompet. Pengguna memindai QR atau menyalin alamat untuk mengirim dana dari dompet atau pertukaran eksternal.

Mainnet dan testnet

Transfer dari dompet eksternal

Hubungkan dompet ekstensi browser (MetaMask, Phantom, Coinbase Wallet) dan transfer USDC langsung ke dompet tertanam.

Mainnet dan testnet

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

Berikan izin agen

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

  1. Pengguna akhir menavigasi ke bagian Izin dari dasbor frontend Coinbase.

  2. Pengguna akhir memilih satu atau lebih dompet (EVM and/or Solana) untuk diotorisasi.

  3. Pengguna akhir memilih Ber ikan izin dan memilih durasi kedaluwar sa: 7 hari, 30 hari (default), 60 hari, atau 90 hari.

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

Cabut izin

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

(Alternatif) Terapkan frontend yang di-host sendiri

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

  1. Kloning repositori:

    git clone https://github.com/coinbase/cdp-agentcore-template.git cd cdp-agentcore-template
  2. Buat .env.local file dengan kredenSIAL CDP Anda:

    NEXT_PUBLIC_CDP_PROJECT_ID=<YOUR_CDP_PROJECT_ID> CDP_API_KEY_ID=<YOUR_CDP_API_KEY_ID> CDP_API_KEY_SECRET=<YOUR_CDP_API_KEY_SECRET> CDP_WALLET_SECRET=<YOUR_CDP_WALLET_SECRET> NEXT_PUBLIC_NETWORK_MODE=testnet
  3. Instal dependensi dan mulai aplikasi:

    npm install npm run dev
  4. Di Portal Pengembang Coinbase, tambahkan URL aplikasi Anda ke daftar Asal yang Di izinkan di bawah Dom pet > Dom Non-custodial pet > Keamanan.

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

Garis (Privy)

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

Terapkan frontend

  1. Izinkan daftar titik akhir localhost di dasbor Privy di bawah Pengaturan Aplikasi > Dasar-Dasar > Domain

Dasbor Privy yang menampilkan bidang Domain di bawah Pengaturan Aplikasi tempat localhost ditambahkan ke daftar asal yang diizinkan
  1. Kloning repositori:

    git clone https://github.com/privy-io/aws-agentcore-sdk.git cd aws-agentcore-sdk
  2. Buat .env.local file dengan kredenSIAL Privy Anda:

    NEXT_PUBLIC_PRIVY_APP_ID=<YOUR_PRIVY_APP_ID> PRIVY_APP_SECRET=<YOUR_PRIVY_APP_SECRET> NEXT_PUBLIC_PRIVY_SIGNER_ID=<YOUR_PRIVY_AUTHORIZATION_ID> NEXT_PUBLIC_NETWORK_MODE=testnet

    Nil NEXT_PUBLIC_PRIVY_SIGNER_ID ainya adalah ID Otorisasi (ID Kunci) dari dasbor Privy Anda di bawah Infrastruktur Dom pet > Otor isasi. Ini adalah pengenal publik dan aman untuk mengekspos sisi klien.

  3. Instal dependensi dan mulai aplikasi:

    pnpm install pnpm dev

Danai dompet

Ketika pengguna akhir mengotentikasi 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:

Metode Deskripsi Ketersediaan

Bayar dengan kartu (Stripe)

Beli USDC menggunakan kartu kredit atau debit melalui onramp kripto yang dihosting Stripe di. crypto.link.com

Hanya Mainnet

Terima (kode QR)

Tampilkan kode QR dan alamat dompet menggunakan EIP-681 (EVM) atau format URI Solana Pay. Pengguna memindai QR atau menyalin alamat untuk mengirim dana dari dompet atau pertukaran eksternal.

Mainnet dan testnet

Transfer dari dompet eksternal

Hubungkan dompet ekstensi browser (MetaMask untuk Base, Phantom untuk Solana) dan transfer USDC langsung ke dompet tertanam.

Mainnet dan testnet

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

Berikan izin agen

Izin agen di Privy menggunakan pen andatangan sesi (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.

  1. Di frontend Privy, pengguna akhir masuk dan dompet tertanam otomatis dibuat (satu EVM, satu Solana).

  2. Layar beranda menampilkan kartu pengaturan agen Connect.

  3. Pengguna akhir memilih Connect agent, dan modal menampilkan: “Berikan agen Anda akses ke dompet Anda.”

  4. Pengguna akhir memilih Ber ikan akses.

Frontend memanggil addSessionSigners dari Privy SDK untuk mendaftarkan kunci otorisasi agen pada setiap dompet yang disematkan. Operasi ini idempotent—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 API Privy:

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

Responsnya termasuk 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:

  1. Tetapkan NEXT_PUBLIC_NETWORK_MODE=testnet di .env.local file frontend.

  2. Dapatkan testnet USDC dari faucet Circle USDC:

    • Pilih Base Sepolia untuk dompet EVM

    • Pilih Solana Devnet untuk dompet Solana

  3. Tempelkan alamat dompet yang disematkan (ditampilkan di dasbor frontend atau layar kode QR) ke keran.

  4. Keran mengeluarkan tes USDC ke dompet Anda dalam hitungan detik.

catatan

Kartu Stripe onramp (Privy) dan Coinbase Onramp tidak tersedia di testnet. Gunakan keran Circle, transfer dompet eksternal, atau transfer alamat langsung untuk pendanaan testnet.