Skip to main content
El método RPC requestAirdrop te permite solicitar un airdrop de SOL (lamports) a una cuenta específica. Este método es exclusivo para entornos distintos de Mainnet, como Devnet y Testnet, donde funciona como un faucet que proporciona SOL gratuito a los desarrolladores para probar sus aplicaciones. Importante: Este método no funcionará en Mainnet Beta.

Casos de uso comunes

  • Financiar billeteras de prueba: Obtén SOL para pagar comisiones de transacción e implementar programas en Devnet o Testnet.
  • Pruebas automatizadas: Los scripts pueden usar requestAirdrop para garantizar que las cuentas de prueba tengan suficiente SOL antes de ejecutar conjuntos de pruebas.
  • Desarrollo y experimentación: Obtén SOL rápidamente para interactuar con programas on-chain durante el desarrollo.

Parámetros de la solicitud

  1. pubkey (string, obligatorio): La clave pública de la cuenta que recibirá los lamports del airdrop, proporcionada como una cadena codificada en base 58.
  2. lamports (u64, obligatorio): La cantidad de lamports que se solicitará. (1 SOL = 1,000,000,000 lamports).
  3. options (object, opcional): Un objeto de configuración opcional que puede incluir:
    • commitment (string, opcional): Especifica el nivel de compromiso que se debe esperar al confirmar la transacción del airdrop (por ejemplo, "finalized", "confirmed", "processed"). Si se omite, se usa el compromiso predeterminado del nodo para airdrops.

Estructura de la respuesta

El campo result de la respuesta JSON-RPC es una única cadena que representa la firma de la transacción del airdrop, codificada en base 58. Ejemplo de respuesta:
Luego puedes usar esta firma con getTransaction o con un explorador de Solana para consultar el estado de la transacción del airdrop.

Ejemplos de código

Consejos para desarrolladores

  • Específico de la red: Este método solo funciona en redes de prueba (Devnet, Testnet) que tengan un faucet habilitado. Fallará en Mainnet Beta.
  • Límites de frecuencia: Los faucets de airdrops suelen tener límites de frecuencia para evitar abusos. Si realizas demasiadas solicitudes en poco tiempo, podrías recibir errores.
  • Límites de cantidad: Puede haber límites en la cantidad de SOL que puedes solicitar por airdrop o por período.
  • Confirmación: Después de que requestAirdrop devuelva una firma, la red todavía debe procesar y confirmar la transacción. Puedes usar confirmTransaction (de @solana/web3.js) o consultar periódicamente getSignatureStatuses para esperar la confirmación.
Esta guía explica cómo usar requestAirdrop para financiar tus cuentas de prueba en las redes de desarrollo de Solana.

Métodos relacionados

getBalance

Consulta el saldo de SOL después de recibir un airdrop

getSignatureStatuses

Consulta periódicamente el estado de la transacción para confirmar el airdrop