Noções Básicas de Token-2022

9 exemplos para você começar com Token-2022 (Token Extensions) - 7 básicos e 2 intermediários.

Pré-requisitos

solana config set --url devnet
spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb --version

cargo add anchor-lang@0.32.1 anchor-spl@0.32.1

ID do programa Token-2022: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb.

Exemplos Básicos

1. Criar um Mint Token-2022

Mesmo fluxo CLI do SPL clássico com ID de programa explícito.

spl-token create-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb --decimals 6

• A conta do mint é maior quando as extensões estão habilitadas
• O mint padrão sem extensões se comporta como o Token clássico
• Sempre passe o ID do programa nos caminhos de derivação do cliente

Relacionado: Taxas de Transferência - extensão de taxa

2. Criar ATA para Mint Token-2022

A derivação da ATA inclui o ID do programa do token.

spl-token create-account <MINT> --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

• Um ID de programa incorreto na derivação gera um endereço ATA incorreto
• O programa de Token Associado é compartilhado com o Token clássico
• O aluguel (rent) escala com o tamanho da conta quando as extensões se anexam às contas

Relacionado: Contas de Token Associadas (ATAs)

3. Inspecionar Layout de Extensão

A exibição mostra as extensões habilitadas no mint/conta.

spl-token display <MINT> --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

• Dados de extensão anexados ao layout SPL base
• Extensões imutáveis não podem ser removidas após a inicialização
• Planeje o conjunto de extensões antes da criação do mint na mainnet

Relacionado: Metadados e Ponteiro de Metadados

4. Mintar e Transferir (Sem Extensões)

O Token-2022 base sem extensões espelha o comportamento clássico.

spl-token mint <MINT> 1 --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
spl-token transfer <MINT> 0.5 <RECIPIENT> --fund-recipient --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

• Quantidades na CLI são quantidades de UI, não unidades base brutas - 1 minta um token
• Carteiras devem detectar o programa Token-2022 no campo owner da conta mint
• O pacote @solana-program/token-2022 fornece construtores de instrução
• O suporte DEX varia - verifique a compatibilidade do roteador

Relacionado: Migrando do SPL Token

5. Ler o Programa Owner do Mint via RPC

Clientes ramificam com base no programa do token antes de construir instruções.

import { createSolanaRpc, address } from "@solana/kit";
 
const TOKEN_2022 = address("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb");
const rpc = createSolanaRpc("https://api.devnet.solana.com");
 
const { value } = await rpc.getAccountInfo(address("MINT_PUBKEY")).send();
const isToken2022 = value?.owner === TOKEN_2022;
console.log("Token-2022 mint:", isToken2022);

• O campo owner do mint é o ID do programa do token
• Use o pacote correto para a codificação de instrução
• DAS pode unificar leituras; transações ainda precisam do programa correto

Relacionado: Lendo NFTs (API DAS)

6. Habilitar Extensão de Taxa de Transferência (CLI)

Extensão de receita comum configurada na inicialização do mint.

# Não há flag --enable-transfer-fees; a taxa é configurada por estas duas flags
spl-token create-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
  --decimals 6 \
  --transfer-fee-basis-points 100 \
  --transfer-fee-maximum-fee 1

• --transfer-fee-maximum-fee é uma quantidade de UI: 1 limita a taxa a um token
• Pontos base da taxa e taxa máxima definidos nos dados de inicialização da extensão
• Taxas retidas acumulam nas contas até serem colhidas
• Carteiras devem mostrar o valor líquido recebido

Relacionado: Taxas de Transferência

7. Usar token_interface no Anchor

Caminho de código único para mints Token e Token-2022.

use anchor_lang::prelude::*; // InterfaceAccount, Interface
use anchor_spl::token_interface::{Mint, TokenAccount, TokenInterface};
 
#[derive(Accounts)]
pub struct Deposit<'info> {
    pub mint: InterfaceAccount<'info, Mint>,
    #[account(mut, token::mint = mint)]
    pub user_token: InterfaceAccount<'info, TokenAccount>,
    pub token_program: Interface<'info, TokenInterface>,
}

• InterfaceAccount desserializa ambos os layouts de programa
• Nunca misture anchor_spl::token::{Mint, TokenAccount} - estes são apenas para Token clássico e sua verificação de proprietário rejeita contas Token-2022
• Passe a conta token_program real correspondendo ao proprietário do mint
• Necessário para protocolos que aceitam tokens listados arbitrários

Relacionado: SPL Token em Programas

Exemplos Intermediários

8. Visão Geral da Extensão Transfer Hook

Programa personalizado invocado em cada transferência.

// ID do programa de hook de transferência armazenado na extensão do mint
// Token-2022 faz CPI para o hook com contas extras de remaining_accounts

• O hook pode impor listas de permissão, royalties ou contabilidade
• Contas extras devem ser passadas nas transações do cliente
• CU avançado e modos de falha - teste no Surfpool 0.12.0

Relacionado: Transfer Hooks

9. Escolher Extensões para Requisitos de Produto

• Habilite apenas o que você precisa - extensões imutáveis adicionam complexidade permanente
• Documente o comportamento de carteiras não suportadas para os usuários

Relacionado: Melhores Práticas do Token-2022

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.

3730363230327c3137326f6967637c6f692e73656469756765646f63