Estado de Cuentas con Intereses y por Defecto

Las mints de Token-2022 con intereses acumulan rendimiento con el tiempo a través de un mecanismo de tasa en cadena. El estado de cuenta por defecto establece si las nuevas cuentas de token comienzan inicializadas o congeladas, controlando quién puede recibir transferencias hasta que se descongele.

Receta

# Menta con intereses. La tasa se da en puntos básicos con --interest-rate;
# no hay bandera --enable-interest-bearing ni --rate-authority. La autoridad de tasa
# por defecto es la autoridad de la menta (cámbiala más tarde con
# `spl-token authorize <MINT> interest-rate <PUBKEY>`).
spl-token create-token \
  --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
  --decimals 6 \
  --interest-rate 500
 
# Congelar nuevas cuentas por defecto. Esto REQUIERE una autoridad de congelación, por lo que
# --enable-freeze debe pasarse en el mismo comando o la creación de la menta falla.
spl-token create-token \
  --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
  --enable-freeze \
  --default-account-state frozen

Cuándo usar esto:

• Productos de estilo de ahorro en cadena que muestran APY
• Tokens de cumplimiento que requieren descongelación KYC antes de las transferencias
• Airdrops que los destinatarios deben reclamar a través del flujo de descongelación
• Tokens del tesoro que acumulan rendimiento nominal sin un programa de préstamos externo

Ejemplo Funcional

# Crear menta con intereses al 5.00% (500 puntos básicos)
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 después de la verificación KYC fuera de cadena
    Ok(())
}

// UI: leer la tasa de interés de la extensión de la menta; mostrar estimación del saldo acumulado
// Nota: el rendimiento mostrado puede usar un cálculo basado en marca de tiempo en el lado del cliente

Lo que esto demuestra:

• La autoridad de la tasa de interés puede actualizar los parámetros de APY según las reglas de la extensión
• El estado congelado por defecto bloquea las transferencias hasta ThawAccount por la autoridad de congelación
• Las ATAs nuevas heredan el estado por defecto en el momento de la creación

Análisis Profundo

Cómo Funciona

• Con intereses: la tasa vive en la extensión de la menta y afecta solo a la cantidad de la UI. La amount almacenada no cambia y no se acuñan nuevos tokens; Token-2022 aplica interés compuesto continuo al convertir unidades brutas a una cantidad de UI (amount_to_ui_amount). El suministro total no crece, por lo que esto no puede financiar redenciones por sí solo.
• Estado de cuenta por defecto: Initialized (normal) o Frozen para cuentas nuevas.
• Se requiere autoridad de congelación para descongelar cuentas bloqueadas.
• Las billeteras deben llamar a las instrucciones de actualización/refresco donde lo requiera la especificación.

Comparación de Extensiones

Notas de TypeScript

// Antes de la transferencia: verificar el estado de la cuenta a través de RPC jsonParsed
// if (state === "frozen") solicitar al usuario que complete el flujo de descongelación KYC

Errores Comunes

• Visualización de APY sin actualización - cantidades de UI obsoletas. Solución: seguir la cadencia de instrucciones de actualización de Token-2022 en los clientes.
• Sorpresa de airdrop congelado - los usuarios no pueden mover tokens. Solución: documentar los pasos de reclamación + descongelación por adelantado.
• Centralización de la autoridad de congelación - el emisor puede bloquear a todos los tenedores. Solución: autoridad de congelación multisig o revocar después de la distribución.
• Intereses vs. rendimiento DeFi - la acumulación de la extensión difiere del APY del protocolo de préstamos. Solución: no confundir en el marketing.
• Pools DEX con estado por defecto congelado - las ATAs del pool pueden necesitar descongelación explícita al configurarse. Solución: probar el flujo de creación del pool de extremo a extremo.

Alternativas

Preguntas Frecuentes

Relacionado

• Autoridades - autoridad de congelación
• Delegado Permanente y No Transferible - extensiones de control
• Mejores Prácticas de Token-2022 - UX de bloqueo

Versiones de Stack: Esta página fue 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, y LiteSVM 0.6.x.