Noções básicas da CLI Solana

Esta seção fornece alguns comandos e exemplos comuns para ajudar você a começar a usar a CLI da Solana.

Configuração da Solana

Sua configuração da Solana especifica as seguintes variáveis:

  • Arquivo de configuração: O caminho para seu arquivo de configuração
  • URL RPC & URL Websocket: O cluster da Solana para o qual a CLI faz solicitações
  • Caminho da keypair: O caminho para a carteira Solana padrão (keypair) usada para pagar taxas de transação e implantar programas. Por padrão, este arquivo é armazenado em ~/.config/solana/id.json.

Para ver suas configurações atuais, digite o seguinte comando no seu terminal.

Terminal
$
solana config get

Um comando bem-sucedido retornará uma saída semelhante à seguinte:

Example output
Config File: /Users/test/.config/solana/cli/config.yml
RPC URL: https://api.mainnet-beta.solana.com
WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
Keypair Path: /Users/test/.config/solana/id.json
Commitment: confirmed

Você pode alterar o cluster da CLI da Solana com os seguintes comandos:

Terminal
$
solana config set --url mainnet-beta
$
solana config set --url devnet
$
solana config set --url localhost
$
solana config set --url testnet

Criar uma carteira

Antes de enviar transações usando a CLI da Solana, você precisa de uma carteira Solana financiada com SOL.

Para gerar uma keypair no caminho padrão, execute o seguinte comando:

Terminal
$
solana-keygen new

Um comando bem-sucedido retornará uma saída semelhante à seguinte:

Example output
Generating a new keypair
For added security, enter a BIP39 passphrase
NOTE! This passphrase improves security of the recovery seed phrase NOT the
keypair file itself, which is stored as insecure plain text
BIP39 Passphrase (empty for none):
Wrote new keypair to /Users/test/.config/solana/id.json
===========================================================================
pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT
===========================================================================
Save this seed phrase and your BIP39 passphrase to recover your new keypair:
cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing
===========================================================================

Este comando não substituirá uma conta existente no local padrão, a menos que você use a flag --force.

Para visualizar o endereço da sua carteira (chave pública), execute:

Terminal
$
solana address

Airdrop de SOL

Solicite um airdrop de SOL para sua carteira para pagar por transações e implantações de programas.

  1. Configure seu cluster para Devnet:
Terminal
$
solana config set -ud
  1. Solicite um airdrop de SOL na Devnet:
Terminal
$
solana airdrop 2

Os airdrops da Devnet limitam as solicitações a 5 SOL por pedido. Se você atingir limites de taxa ou encontrar erros, tente usar o Web Faucet como alternativa.

Para verificar o saldo de SOL da sua carteira, execute o seguinte comando:

Terminal
$
solana balance

Executar validador local

A CLI da Solana inclui um validador de teste integrado para desenvolvimento local.

Abra um novo terminal e atualize sua CLI para usar o localhost:

Terminal
$
solana config set -ul

Execute o seguinte comando para iniciar um validador local:

Terminal
$
solana-test-validator

Is this page helpful?

Índice

Editar Página

Gerenciado por

© 2025 Fundação Solana.
Todos os direitos reservados.