CLI spl-token

Crie mints de SPL Token, contas de token associadas (ATAs), minte tokens e transfira saldos do terminal.

Receita

Card de receita de referência rápida - pronto para copiar e colar.

spl-token create-token
spl-token create-account <MINT>
spl-token mint <MINT> 1000
spl-token transfer <MINT> 50 <RECIPIENT_TOKEN_ACCOUNT>

Quando usar:

• Criar um mint de teste na devnet antes da integração do cliente.
• Financiar carteiras de testadores com tokens mock.
• Verificar a derivação de ATA e os decimais sem TypeScript.
• Transferências manuais de tesouraria de tokens SPL.

Exemplo Funcional

solana config set --url devnet
solana airdrop 2
 
# Crie um mint com 6 decimais (comum para tokens fungíveis)
MINT=$(spl-token create-token --decimals 6 | grep "Creating token" | awk '{print $3}')
echo "Mint: $MINT"
 
# Crie uma ATA para sua carteira
spl-token create-account "$MINT"
ATA=$(spl-token accounts --token "$MINT" | grep -v "Token accounts" | awk '{print $1}')
echo "ATA: $ATA"
 
# Minte 1.0 token. A CLI aceita quantidades de UI e escala pelos decimais do mint,
# então isso é `1`, NÃO 1000000. Passar 1000000 aqui minteria um milhão de tokens.
spl-token mint "$MINT" 1
 
spl-token balance "$MINT"
spl-token supply "$MINT"

O que isso demonstra:

• create-token inicializa um novo mint com decimais escolhidos.
• create-account cria a ATA pertencente à sua carteira para aquele mint.
• mint aumenta o supply quando seu keypair detém a autoridade de mintagem.

Aprofundamento

Como Funciona

• O programa SPL Token possui contas de mint e de token com estado codificado em Borsh.
• ATAs são PDAs derivadas da carteira + mint para endereços determinísticos.
• Quantidades na CLI spl-token são quantidades de UI - ela aplica os decimais do mint para você. Unidades base brutas aparecem apenas nos dados da instrução.
• As autoridades de mint e de congelamento podem ser revogadas após a configuração.

Comandos Comuns

Notas bash

# Transferir para a chave pública da carteira (CLI resolve a ATA)
spl-token transfer "$MINT" 100 <RECIPIENT_WALLET_PUBKEY> --fund-recipient
 
# Revogar autoridade de mintagem (supply fixo)
spl-token authorize "$MINT" mint --disable

Problemas Comuns

• Confusão de decimais - spl-token mint <MINT> 1000 minteria 1000 tokens, não 0.001. A CLI aceita quantidades de UI. Correção: passe a quantidade humana diretamente; nunca multiplique previamente por 10^decimals para a CLI. Multiplique apenas ao construir os dados da instrução você mesmo.
• ATA ausente - a transferência falha se o destinatário não tiver uma conta de token. Correção: use --fund-recipient ou create-account primeiro.
• Autoridade de mintagem errada - apenas o keypair da autoridade pode mintear. Correção: use spl-token display para ver as autoridades.
• Usar solana transfer para tokens - move SOL, não saldos SPL. Correção: sempre use spl-token transfer.
• Contas congeladas - a autoridade de congelamento pode bloquear transferências. Correção: verifique o status de congelamento com display.

Alternativas

FAQs

Relacionado

• Airdrops e Saldos - SOL para taxas e aluguel
• Inspecionando Contas e Programas - bytes brutos da conta
• Noções Básicas de SPL Token - modelo de token on-chain
• Enviando SOL e Transações - transferências de SOL nativo

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.