Interest-Bearing & Default Account State

Mints Token-2022 interest-bearing (com juros) acumulam rendimento ao longo do tempo por meio de um mecanismo de taxa on-chain. O estado de conta padrão (default account state) define se novas contas de token começam inicializadas (initialized) ou congeladas (frozen), controlando quem pode receber transferências até serem descongeladas.

Receita

# Mints com juros. A taxa é dada em pontos base (--interest-rate);
# não há flag --enable-interest-bearing ou --rate-authority. A autoridade de taxa
# é definida por padrão como a autoridade do mint (mude depois com
# `spl-token authorize <MINT> interest-rate <PUBKEY>`).
spl-token create-token \
  --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
  --decimals 6 \
  --interest-rate 500
 
# Congela novas contas por padrão. Isso REQUER uma autoridade de congelamento,
# então --enable-freeze deve ser passado no mesmo comando ou a criação do mint falha.
spl-token create-token \
  --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
  --enable-freeze \
  --default-account-state frozen

Quando usar isso:

• Produtos estilo poupança on-chain exibindo APY
• Tokens de conformidade exigindo descongelamento (thaw) via KYC antes de transferências
• Airdrops que os destinatários devem reivindicar por meio do fluxo de descongelamento
• Tokens de tesouraria acumulando rendimento nominal sem um programa de empréstimo externo

Exemplo de Trabalho

# Cria um mint com juros a 5.00% (500 pontos base)
MINT=$(spl-token create-token \
  --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
  --decimals 6 \
  --interest-rate 500 | awk '/Creating token/{print $3}')
 
spl-token display "$MINT" --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

use anchor_lang::prelude::*;
use anchor_spl::token_interface::{Mint, TokenAccount, TokenInterface};
 
#[derive(Accounts)]
pub struct ThawAfterKyc<'info> {
    pub mint: InterfaceAccount<'info, Mint>,
    #[account(mut)]
    pub holder_token: InterfaceAccount<'info, TokenAccount>,
    pub freeze_authority: Signer<'info>,
    pub token_program: Interface<'info, TokenInterface>,
}
 
pub fn thaw_after_kyc(ctx: Context<ThawAfterKyc>) -> Result<()> {
    // CPI ThawAccount após verificação KYC off-chain
    Ok(())
}

// UI: lê a taxa de juros da extensão do mint; mostra estimativa de saldo acumulado
// Nota: o rendimento exibido pode usar cálculo baseado em timestamp no lado do cliente

O que isso demonstra:

• A autoridade de taxa de juros pode atualizar parâmetros de APY de acordo com as regras da extensão
• O estado padrão congelado bloqueia transferências até a instrução ThawAccount pela autoridade de congelamento
• Novas ATAs (Associated Token Accounts) herdam o estado padrão no momento da criação

Mergulho Profundo

Como Funciona

• Interest-bearing (Com juros): A taxa reside na extensão do mint e afeta apenas o valor da UI. O amount armazenado não é alterado e nenhum novo token é emitido - o Token-2022 aplica capitalização contínua ao converter unidades brutas para um valor de UI (amount_to_ui_amount). O suprimento total não cresce, portanto, isso não pode financiar resgates por si só.
• Default account state (Estado de conta padrão): Initialized (normal) ou Frozen (congelado) para novas contas.
• Autoridade de congelamento (freeze authority) necessária para descongelar contas com acesso restrito.
• Carteiras devem chamar instruções de refresh/update conforme especificado.

Comparação de Extensões

Notas de TypeScript

// Antes da transferência: verifica o estado da conta via RPC jsonParsed
// if (state === "frozen") solicita ao usuário que complete o fluxo de descongelamento KYC

Armadilhas

• Exibição de APY sem refresh - valores de UI desatualizados. Correção: siga a cadência da instrução de refresh do Token-2022 nos clientes.
• Surpresa de airdrop congelado - usuários não conseguem mover tokens. Correção: documente os passos de reivindicação + descongelamento com antecedência.
• Centralização da autoridade de congelamento - o emissor pode travar todos os detentores. Correção: use autoridade de congelamento multisig ou revogue após a distribuição.
• Juros vs. rendimento DeFi - o acúmulo da extensão difere do APY de um protocolo de empréstimo. Correção: não confunda no marketing.
• Pools DEX com estado padrão congelado - ATAs de pool podem precisar de descongelamento explícito na configuração. Correção: teste o fluxo de criação de pool de ponta a ponta.

Alternativas

FAQs

Relacionados

• Autoridades - autoridade de congelamento
• Permanent Delegate & Non-Transferable - extensões de controle
• Token-2022 Best Practices - UX de controle de acesso

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.