Skip to main content
La méthode RPC 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 requestAirdrop pour 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

  1. pubkey (string, requis) : La clé publique du compte qui recevra les lamports airdrop, fournie sous forme de chaîne encodée en base-58.
  2. lamports (u64, requis) : Le montant de lamports à demander. (1 SOL = 1 000 000 000 lamports).
  3. 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 champ result 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 :
Cette signature peut ensuite être utilisée avec 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 requestAirdrop renvoie une signature, la transaction doit encore être traitée et confirmée par le réseau. Vous pouvez utiliser confirmTransaction (de @solana/web3.js) ou interroger getSignatureStatuses pour attendre la confirmation.
Ce guide explique comment utiliser 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