requestAirdrop permite solicitar um airdrop de SOL (lamports) para uma conta especificada. Este método é exclusivo para ambientes não-mainnet como Devnet e Testnet, onde serve como uma torneira para fornecer SOL gratuito aos desenvolvedores para testar suas aplicações.
Importante: Este método não funcionará na Mainnet Beta.
Casos de Uso Comuns
- Financiamento de Carteiras de Teste: Obter SOL para pagar taxas de transação e implantar programas na Devnet ou Testnet.
- Teste Automatizado: Scripts podem usar
requestAirdroppara garantir que contas de teste tenham SOL suficiente antes de executar suítes de teste. - Desenvolvimento & Experimentação: Adquirir rapidamente SOL para interagir com programas on-chain durante o desenvolvimento.
Parâmetros de Solicitação
pubkey(string, obrigatório): A chave pública da conta que receberá os lamports do airdrop, fornecida como uma string codificada em base-58.lamports(u64, obrigatório): A quantidade de lamports a solicitar. (1 SOL = 1.000.000.000 lamports).options(objeto, opcional): Um objeto de configuração opcional que pode incluir:commitment(string, opcional): Especifica o nível de compromisso a aguardar ao confirmar a transação de airdrop (por exemplo,"finalized","confirmed","processed"). Se omitido, o compromisso padrão do nó para airdrops é usado.
Estrutura de Resposta
O camporesult na resposta JSON-RPC é uma única string representando a assinatura da transação do airdrop, codificada em base-58.
Exemplo de Resposta:
getTransaction ou um explorador Solana para rastrear o status da transação de airdrop.
Exemplos de Código
Dicas para Desenvolvedores
- Específico da Rede: Este método é funcional apenas em redes de teste (Devnet, Testnet) que têm uma torneira habilitada. Falhará na Mainnet Beta.
- Limite de Taxa: Torneiras de airdrop são frequentemente limitadas para prevenir abuso. Se você fizer muitas solicitações em um curto período, poderá receber erros.
- Limites de Quantidade: Pode haver limites na quantidade de SOL que você pode solicitar por airdrop ou por período de tempo.
- Confirmação: Após
requestAirdropretornar uma assinatura, a transação ainda precisa ser processada e confirmada pela rede. Você pode usarconfirmTransaction(de@solana/web3.js) ou fazer polling emgetSignatureStatusespara aguardar confirmação.
requestAirdrop para financiar suas contas de teste nas redes de desenvolvimento da Solana.
Métodos Relacionados
getBalance
Verifique o saldo de SOL após receber um airdrop
getSignatureStatuses
Verifique o status da transação para confirmar o airdrop