> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Cómo usar requestAirdrop
> Conoce los casos de uso de requestAirdrop, ejemplos de código, parámetros de solicitud, estructura de respuesta y consejos.
El método RPC [`requestAirdrop`](https://www.helius.dev/docs/api-reference/rpc/http/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](https://www.helius.dev/blog/solana-commitment-levels) 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:**
```json theme={"system"}
{
"jsonrpc": "2.0",
"result": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"id": 1
}
```
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
```bash cURL theme={"system"}
# Request 1 SOL (1,000,000,000 lamports) to a Devnet address
# Replace with an actual base-58 public key
# Ensure you are targeting a Devnet RPC URL
curl -X POST -H "Content-Type: application/json" -d \
'{
"jsonrpc": "2.0",
"id": 1,
"method": "requestAirdrop",
"params": [
"",
1000000000
]
}' \
https://devnet.helius-rpc.com/?api-key=
# Request 0.5 SOL with "confirmed" commitment
curl -X POST -H "Content-Type: application/json" -d \
'{
"jsonrpc": "2.0",
"id": 1,
"method": "requestAirdrop",
"params": [
"",
500000000,
{
"commitment": "confirmed"
}
]
}' \
https://devnet.helius-rpc.com/?api-key=
```
```javascript JavaScript (using @solana/web3.js) theme={"system"}
const { Connection, PublicKey, LAMPORTS_PER_SOL } = require('@solana/web3.js');
async function getAirdrop(walletAddress) {
// Connect to Devnet
const connection = new Connection('https://devnet.helius-rpc.com/?api-key=', 'confirmed');
const publicKey = new PublicKey(walletAddress);
try {
console.log(`Requesting airdrop of 1 SOL to ${walletAddress} on Devnet...`);
// Request an airdrop of 1 SOL
const airdropSignature = await connection.requestAirdrop(
publicKey,
LAMPORTS_PER_SOL // 1 SOL
);
console.log(`Airdrop requested. Transaction signature: ${airdropSignature}`);
// Confirm the transaction
// Note: The `confirmTransaction` method in web3.js has evolved.
// For newer versions, you might use `connection.confirmTransaction({ signature: airdropSignature, blockhash: latestBlockhash.blockhash, lastValidBlockHeight: latestBlockhash.lastValidBlockHeight }, 'confirmed');`
// For simplicity, we'll log the signature and you can check on an explorer.
// Or, more robustly, you can poll getSignatureStatuses.
await connection.confirmTransaction(airdropSignature);
console.log(`Airdrop successful for ${walletAddress}!`);
const balance = await connection.getBalance(publicKey);
console.log(`Current balance for ${walletAddress}: ${balance / LAMPORTS_PER_SOL} SOL`);
} catch (error) {
console.error(`Error requesting airdrop for ${walletAddress}:`, error);
}
}
// Replace with a Devnet wallet address you control
const myDevnetWallet = 'REPLACE_WITH_YOUR_DEVNET_WALLET_ADDRESS';
// Example: const myDevnetWallet = new Keypair().publicKey.toBase58(); // For a new temporary wallet
if (myDevnetWallet === 'REPLACE_WITH_YOUR_DEVNET_WALLET_ADDRESS') {
console.warn("Please replace 'REPLACE_WITH_YOUR_DEVNET_WALLET_ADDRESS' with an actual Devnet wallet address to run the example.");
} else {
// getAirdrop(myDevnetWallet);
console.log("Uncomment the line above and replace the placeholder to run the airdrop example.");
}
```
## 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
Consulta el saldo de SOL después de recibir un airdrop
Consulta periódicamente el estado de la transacción para confirmar el airdrop