requestAirdrop vous permet de demander un airdrop de SOL (lamports) sur un compte spécifié. Cette méthode est exclusivement pour les environnements non-mainnet comme Devnet et Testnet, où elle sert de faucet pour fournir aux développeurs du SOL gratuit afin de tester leurs applications.
Important : Cette méthode ne fonctionnera pas sur Mainnet Beta.
Cas d’utilisation courants
- Financement des portefeuilles de test : Obtenir du SOL pour payer les frais de transaction et déployer des programmes sur Devnet ou Testnet.
- Tests automatisés : Les scripts peuvent utiliser
requestAirdroppour s’assurer que les comptes de test ont suffisamment de SOL avant d’exécuter les suites de tests. - Développement et expérimentation : Acquérir rapidement du SOL pour interagir avec des programmes on-chain pendant le développement.
Paramètres de requête
pubkey(string, requis) : La clé publique du compte qui recevra les lamports airdrop, fournie sous forme de chaîne encodée en base-58.lamports(u64, requis) : Le montant de lamports à demander. (1 SOL = 1 000 000 000 lamports).options(objet, optionnel) : Un objet de configuration optionnel qui peut inclure :commitment(string, optionnel) : Spécifie le niveau d’engagement à attendre pour confirmer la transaction d’airdrop (par ex.,"finalized","confirmed","processed"). Si omis, l’engagement par défaut du nœud pour les airdrops est utilisé.
Structure de la réponse
Le champresult dans la réponse JSON-RPC est une chaîne unique représentant la signature de la transaction de l’airdrop, encodée en base-58.
Exemple de réponse :
getTransaction ou un explorateur Solana pour suivre le statut de la transaction d’airdrop.
Exemples de code
Conseils pour les développeurs
- Spécifique au réseau : Cette méthode est uniquement fonctionnelle sur les réseaux de test (Devnet, Testnet) qui ont un faucet activé. Elle échouera sur Mainnet Beta.
- Limitation du débit : Les faucets d’airdrop sont souvent limités en débit pour éviter les abus. Si vous faites trop de requêtes en peu de temps, vous pourriez recevoir des erreurs.
- Limites de montant : Il peut y avoir des limites sur le montant de SOL que vous pouvez demander par airdrop ou par période de temps.
- Confirmation : Après que
requestAirdroprenvoie une signature, la transaction doit encore être traitée et confirmée par le réseau. Vous pouvez utiliserconfirmTransaction(de@solana/web3.js) ou interrogergetSignatureStatusespour attendre la confirmation.
requestAirdrop pour financer vos comptes de test sur les réseaux de développement de Solana.
Méthodes associées
getBalance
Vérifiez le solde SOL après avoir reçu un airdrop
getSignatureStatuses
Interroger le statut de la transaction pour confirmer l’airdrop