Noções Básicas de SPL Token

9 exemplos para você começar com o SPL Token - 7 básicos e 2 intermediários.

Pré-requisitos

solana config set --url devnet
solana airdrop 2
spl-token --version

cargo add anchor-lang@0.32.1 anchor-spl@0.32.1
npm install @solana/kit@7.0.0

ID do programa SPL Token: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA.

Exemplos Básicos

1. Criar um Mint

Uma conta mint define decimais, supply e autoridades.

spl-token create-token --decimals 6

• decimals define como quantidades brutas são mapeadas para valores legíveis por humanos
• A autoridade do mint pode emitir mais tokens até ser revogada
• A autoridade de congelamento é opcional; None significa que as contas não podem ser congeladas

Relacionado: Minting e Burning - mudanças de supply

2. Inspecionar Estado do Mint

Leia os campos de supply e autoridade antes de integrar clientes.

spl-token display <MINT>

• Supply são unidades inteiras brutas (não a quantidade da UI)
• A chave pública Mint authority controla a inflação
• Freeze authority como disabled significa sem capacidade de congelamento

Relacionado: Autoridades - padrões de revogação

3. Criar uma Conta de Token (ATA)

Carteiras detêm saldos em contas de token, não no próprio mint.

spl-token create-account <MINT>

• O endereço da Associated Token Account (ATA) é um PDA derivado da carteira + mint
• Uma ATA por carteira por mint é o padrão de UX
• O tamanho da conta é de 165 bytes (~2M lamports para isenção de aluguel)

Relacionado: Contas de Token Associadas (ATAs)

4. Mintar Tokens para uma ATA

Aumente o supply creditando uma conta de token.

spl-token mint <MINT> 1

• Quantidades do spl-token são quantidades da UI: 1 emite 1.0 token (quantidade bruta 1000000 com 6 decimais). Passar 1000000 aqui emitiria um milhão de tokens
• Requer que o signer possua a autoridade do mint
• O supply é atualizado na conta mint atomicamente

Relacionado: Decimais e Quantidades

5. Transferir Entre Contas de Token

Mova saldos sem alterar o supply total.

spl-token transfer <MINT> 0.5 <RECIPIENT_WALLET> --fund-recipient

• A quantidade é uma quantidade da UI (0.5 = meio token), não unidades base brutas
• A origem deve ser sua ATA para aquele mint
• --fund-recipient cria a ATA do destinatário se ela não existir
• Delegados podem transferir em nome do proprietário quando aprovados

Relacionado: Transferências e Delegados

6. Ler Saldos com @solana/kit

Clientes consultam contas de token via RPC padrão.

import { createSolanaRpc, address } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const owner = address("YOUR_WALLET");
 
const { value } = await rpc
  .getTokenAccountsByOwner(owner, { mint: address("MINT_PUBKEY") }, { encoding: "jsonParsed" })
  .send();
 
const balance = value[0]?.account.data.parsed.info.tokenAmount.uiAmount;
console.log("Balance:", balance);

• jsonParsed retorna a quantidade da UI e a quantidade bruta juntas
• Um array vazio significa que ainda não existe uma ATA para aquele mint
• Use DAS para metadados de NFT; use RPC de token para saldos fungíveis

Relacionado: SOL Wrapped - SOL nativo como SPL

7. Burn para Reduzir o Supply

Remova tokens da circulação permanentemente.

# burn recebe o endereço da CONTA DE TOKEN, não do mint
spl-token burn "$(spl-token address --token <MINT> --verbose | awk '/Associated token address/{print $NF}')" 0.1

• A quantidade é uma quantidade da UI (0.1 = um décimo de um token)
• Queima a partir da conta de token que você nomeia, não de detentores arbitrários
• Diminui o campo supply do mint
• Comum antes de revogar a autoridade do mint para tokens de supply fixo

Relacionado: Minting e Burning

Exemplos Intermediários

8. Transferência CPI em um Programa Anchor

Programas movem tokens via invocação entre programas (CPI).

use anchor_lang::prelude::*;
use anchor_spl::token::{self, Mint, Token, TokenAccount, TransferChecked};
 
#[derive(Accounts)]
pub struct PayFee<'info> {
    pub mint: Account<'info, Mint>,
    #[account(mut, token::mint = mint, token::authority = authority)]
    pub user_token: Account<'info, TokenAccount>,
    #[account(mut, token::mint = mint)]
    pub treasury_token: Account<'info, TokenAccount>,
    pub authority: Signer<'info>,
    pub token_program: Program<'info, Token>,
}
 
pub fn pay_fee(ctx: Context<PayFee>, amount: u64) -> Result<()> {
    let decimals = ctx.accounts.mint.decimals;
    let cpi = CpiContext::new(
        ctx.accounts.token_program.to_account_info(),
        TransferChecked {
            mint: ctx.accounts.mint.to_account_info(),
            from: ctx.accounts.user_token.to_account_info(),
            to: ctx.accounts.treasury_token.to_account_info(),
            authority: ctx.accounts.authority.to_account_info(),
        },
    );
    token::transfer_checked(cpi, amount, decimals)?;
    Ok(())
}

• Account<'info, TokenAccount> desserializa o layout SPL e valida que o proprietário é o programa de Token clássico
• TransferChecked passa o mint e verifica os decimais on-chain; o Transfer não verificado está obsoleto
• token::mint fixa ambos os lados ao mesmo ativo - uma origem não fixada é o clássico bug de dreno
• O signer deve ser o proprietário da conta de token ou um delegado aprovado
• Esses tipos anchor_spl::token rejeitam contas Token-2022 - use anchor_spl::token_interface para essas

Relacionado: SPL Token em Programas

9. Revogar Autoridade do Mint (Supply Fixo)

Trave o supply após a distribuição inicial.

spl-token authorize <MINT> mint --disable

• Irreversível naquele mint - nenhuma inflação adicional é possível
• Padrão de lançamento: alocação do mint, airdrop, depois revogação
• Documente as mudanças de autoridade para transparência e indexadores

Relacionado: Melhores Práticas de SPL Token - checklist de lançamento

Versões da 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.