Skip to main content
O método RPC 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 requestAirdrop para 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

  1. pubkey (string, obrigatório): A chave pública da conta que receberá os lamports do airdrop, fornecida como uma string codificada em base-58.
  2. lamports (u64, obrigatório): A quantidade de lamports a solicitar. (1 SOL = 1.000.000.000 lamports).
  3. 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 campo result na resposta JSON-RPC é uma única string representando a assinatura da transação do airdrop, codificada em base-58. Exemplo de Resposta:
Esta assinatura pode então ser usada com 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 requestAirdrop retornar uma assinatura, a transação ainda precisa ser processada e confirmada pela rede. Você pode usar confirmTransaction (de @solana/web3.js) ou fazer polling em getSignatureStatuses para aguardar confirmação.
Este guia explica como usar 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