requestAirdrop memungkinkan Anda meminta airdrop SOL (lamport) ke akun tertentu. Metode ini khusus untuk lingkungan non-mainnet seperti Devnet dan Testnet, tempat metode ini berfungsi sebagai faucet untuk menyediakan SOL gratis kepada pengembang guna menguji aplikasi mereka.
Penting: Metode ini tidak akan berfungsi di Mainnet Beta.
Kasus Penggunaan Umum
- Mendanai Dompet Pengujian: Mendapatkan SOL untuk membayar biaya transaksi dan menerapkan program di Devnet atau Testnet.
- Pengujian Otomatis: Skrip dapat menggunakan
requestAirdropuntuk memastikan akun pengujian memiliki SOL yang cukup sebelum menjalankan rangkaian pengujian. - Pengembangan & Eksperimen: Mendapatkan SOL dengan cepat untuk berinteraksi dengan program on-chain selama pengembangan.
Parameter Permintaan
pubkey(string, wajib): Kunci publik akun yang akan menerima lamport dari airdrop, diberikan sebagai string yang dikodekan dalam base-58.lamports(u64, wajib): Jumlah lamport yang akan diminta. (1 SOL = 1.000.000.000 lamport).options(object, opsional): Objek konfigurasi opsional yang dapat mencakup:commitment(string, opsional): Menentukan tingkat komitmen yang akan ditunggu saat mengonfirmasi transaksi airdrop (misalnya,"finalized","confirmed","processed"). Jika dihilangkan, komitmen default node untuk airdrop akan digunakan.
Struktur Respons
Bidangresult dalam respons JSON-RPC adalah satu string yang mewakili tanda tangan transaksi airdrop dan dikodekan dalam base-58.
Contoh Respons:
getTransaction atau penjelajah Solana untuk melacak status transaksi airdrop.
Contoh Kode
Tips untuk Pengembang
- Khusus Jaringan: Metode ini hanya berfungsi pada jaringan pengujian (Devnet, Testnet) yang mengaktifkan faucet. Metode ini akan gagal di Mainnet Beta.
- Pembatasan Laju: Faucet airdrop sering kali menerapkan pembatasan laju untuk mencegah penyalahgunaan. Jika Anda membuat terlalu banyak permintaan dalam waktu singkat, Anda mungkin menerima pesan kesalahan.
- Batas Jumlah: Mungkin terdapat batas jumlah SOL yang dapat Anda minta per airdrop atau per periode waktu.
- Konfirmasi: Setelah
requestAirdropmengembalikan tanda tangan, transaksi masih perlu diproses dan dikonfirmasi oleh jaringan. Anda dapat menggunakanconfirmTransaction(dari@solana/web3.js) atau melakukan polling padagetSignatureStatusesuntuk menunggu konfirmasi.
requestAirdrop untuk mendanai akun pengujian Anda di jaringan pengembangan Solana.
Metode Terkait
getBalance
Periksa saldo SOL setelah menerima airdrop
getSignatureStatuses
Lakukan polling status transaksi untuk mengonfirmasi airdrop