Airdrops e Saldos
Financie wallets de dev e teste com airdrops de faucet e inspecione saldos SOL pela CLI antes de enviar transações.
Receita
Card de receita de referência rápida - pronto para copiar e colar.
solana config set --url devnet
solana airdrop 2
solana balance
solana balance <PUBKEY>Quando usar:
- Novo keypair tem zero lamports e não pode pagar fees.
- Verificando se transfer pousou na conta esperada.
- Checando saldo de destinatário antes de segunda transação.
- Confirmando funding de faucet localnet após iniciar
solana-test-validator.
Exemplo Funcional
solana config set --url devnet
solana config set --keypair ~/.config/solana/id.json
# Request 2 SOL (subject to faucet rate limits)
solana airdrop 2
solana confirm -v $(solana transfer --from ~/.config/solana/id.json \
"$(solana address)" 0.001 --allow-unfunded-recipient --dry-run 2>/dev/null | head -1) 2>/dev/null || true
solana balance
solana balance "$(solana address)"O que isso demonstra:
- Faucet de devnet financia o keypair padrão para fees de transação.
solana balancelê lamports e formata como SOL.- Passar pubkey explícita inspeciona qualquer conta, não apenas o signer configurado.
Aprofundamento
Como Funciona
- Saldos são armazenados como lamports no modelo de conta (1 SOL = 1.000.000.000 lamports).
solana airdropsolicita lamports do faucet do cluster (apenas devnet/testnet).- A CLI chama
getBalancevia JSON-RPC e converte para SOL na exibição. - Mainnet não tem faucet público - financie via exchange ou transfer.
Limites de Airdrop
| Cluster | Faucet | Limite típico |
|---|---|---|
| devnet | Faucet RPC público | Rate-limited por IP/key |
| testnet | Faucet público | Tráfego menor que devnet |
| mainnet-beta | Nenhum | SOL real necessário |
| localnet | solana-test-validator | Generoso para keys locais |
Notas bash
# Airdrop to a specific pubkey (not only default keypair)
solana airdrop 1 <RECIPIENT_PUBKEY>
# Watch balance after a transfer
watch -n 2 solana balanceErros Comuns
- Airdrop na mainnet - não existe faucet; comando falha ou você usa site scam. Correção: use devnet/localnet para SOL grátis, mainnet apenas com fundos reais.
- Erros de rate limit - faucet devnet limita requests por hora. Correção: espere, use IP diferente ou mude para localnet.
- Signer não financiado - transações falham com "insufficient funds for fee". Correção:
solana balanceprimeiro; airdrop 1-2 SOL em devnet. - Cluster errado - airdrop sucede mas config ainda aponta para RPC diferente. Correção:
solana config gete verifiqueRPC URL. - Assumir SOL da UI igual on-chain - algumas ferramentas arredondam; mínimos isentos de rent importam para contas. Correção: compare lamports raw via
solana accountao depurar.
Alternativas
| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
Faucet solana-test-validator | Iteração local ilimitada | Você precisa de state real da mainnet |
| Faucets devnet de provedor (Helius, etc.) | Rate limits maiores | Você quer zero deps externas |
| Transfer manual de wallet financiada | Pool dev compartilhado de time | Setup solo primeira vez |
Minting spl-token | Testando tokens, não SOL nativo | Pagando fees de transação |
FAQs
Quanto SOL devo fazer airdrop?
1-2 SOL bastam para milhares de transações devnet. Solicite mais apenas ao testar transfers grandes ou criação de conta pesada em rent.
Por que meu airdrop falhou com rate limit?
Faucets devnet limitam por IP e pubkey. Espere 24 horas, use localnet ou financie da wallet de colega.
Posso fazer airdrop para pubkey de outra pessoa?
Sim: solana airdrop 2 <PUBKEY> apontando para devnet ou testnet.
Saldo inclui reservas isentas de rent?
solana balance mostra lamports totais. Contas de token e data também guardam mínimos isentos de rent separados do contexto de exibição da wallet.
Como verificar saldo em localnet?
Aponte config para http://127.0.0.1:8899, inicie solana-test-validator, depois solana airdrop funciona contra faucet local.
Qual o mínimo para fees?
Transfer simples custa 5.000 lamports de fee base mais priority fee. Mantenha pelo menos 0,01 SOL em wallets de dev para folga.
Quão rápido saldo atualiza após airdrop?
Geralmente um slot (~400ms). Use solana confirm <SIGNATURE> ao scriptar passos de funding.
Posso fazer airdrop em testnet?
Sim com solana config set --url testnet. Disponibilidade de faucet varia - devnet é escolha padrão.
Como ver lamports em vez de SOL?
Use solana account <PUBKEY> e leia o campo lamports no output.
Airdrop funciona em CI?
Frequentemente bloqueado por rate limits de IP compartilhado. Pré-financie keypair CI uma vez e armazene como secret criptografado, ou use localnet em pipelines.
Relacionado
- Noções Básicas da Solana CLI - configuração de cluster
- Keypairs com solana-keygen - criar a wallet que você financia
- Enviando SOL e Transações - gastar o saldo
- solana-test-validator - faucet local
Versões do stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.