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
requestAirdroppara 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
pubkey(string, obligatorio): La clave pública de la cuenta que recibirá los lamports del airdrop, proporcionada como una cadena codificada en base 58.lamports(u64, obligatorio): La cantidad de lamports que se solicitará. (1 SOL = 1,000,000,000 lamports).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 camporesult 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:
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
requestAirdropdevuelva una firma, la red todavía debe procesar y confirmar la transacción. Puedes usarconfirmTransaction(de@solana/web3.js) o consultar periódicamentegetSignatureStatusespara esperar la confirmación.
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