Autoridades

Las acuñaciones de SPL (SPL mints) tienen dos autoridades opcionales: la autoridad de acuñación (para inflar la oferta) y la autoridad de congelación (para congelar cuentas de tokens). Revocar las autoridades es una señal común de inmutabilidad y confianza para los tokens lanzados.

Receta

spl-token display <MINT>
spl-token authorize <MINT> mint --disable
spl-token authorize <MINT> freeze --disable

use anchor_spl::token::spl_token::instruction::AuthorityType;
use anchor_spl::token::{self, SetAuthority};
 
token::set_authority(cpi_ctx, AuthorityType::MintTokens, None)?;

Cuándo recurrir a esto:

• Bloquear la oferta fija después de la acuñación inicial
• Eliminar el poder de congelación antes del lanzamiento a la comunidad
• Transferir la autoridad a una PDA de multisig o DAO
• Auditar las suposiciones de confianza de tokens de terceros

Ejemplo Funcional

MINT=<TU_MINT>
 
# Inspeccionar autoridades actuales
spl-token display "$MINT"
 
# Revocar la autoridad de acuñación permanentemente
spl-token authorize "$MINT" mint --disable
 
# Revocar la autoridad de congelación (los usuarios no pueden ser congelados)
spl-token authorize "$MINT" freeze --disable
 
spl-token display "$MINT"

use anchor_lang::prelude::*;
use anchor_lang::solana_program::program_option::COption;
use anchor_spl::token::spl_token::instruction::AuthorityType;
use anchor_spl::token::{self, Mint, SetAuthority, Token};
 
#[derive(Accounts)]
pub struct RevokeMintAuthority<'info> {
    #[account(mut, mint::authority = current_authority)]
    pub mint: Account<'info, Mint>,
    pub current_authority: Signer<'info>,
    pub token_program: Program<'info, Token>,
}
 
pub fn revoke_mint_authority(ctx: Context<RevokeMintAuthority>) -> Result<()> {
    // `mint_authority` es un COption, no un Option - compara contra COption::Some.
    require!(
        ctx.accounts.mint.mint_authority == COption::Some(ctx.accounts.current_authority.key()),
        ErrorCode::NotMintAuthority
    );
    let cpi = CpiContext::new(
        ctx.accounts.token_program.to_account_info(),
        SetAuthority {
            current_authority: ctx.accounts.current_authority.to_account_info(),
            account_or_mint: ctx.accounts.mint.to_account_info(),
        },
    );
    token::set_authority(cpi, AuthorityType::MintTokens, None)?;
    Ok(())
}
 
#[error_code]
pub enum ErrorCode {
    NotMintAuthority,
}

Lo que esto demuestra:

• authorize --disable establece el campo de autoridad a None
• La revocación es irreversible para ese tipo de autoridad
• Los programas en cadena usan la CPI set_authority con el firmante de la autoridad actual

Análisis Profundo

Cómo Funciona

• La cuenta de acuñación (Mint account) almacena mint_authority: COption<Pubkey> y freeze_authority: COption<Pubkey>
• Se requiere la autoridad de acuñación para MintTo; la autoridad de congelación para FreezeAccount / ThawAccount
• La autoridad de cierre en las cuentas de token (separada de la acuñación) controla quién puede cerrar cuentas vacías
• El propietario de la cuenta de token es distinto de las autoridades de acuñación

Tipos de Autoridad

Notas de Rust

// Siempre registra los cambios de estado de la autoridad para los indexadores
emit!(AuthorityRevoked { mint: mint.key(), kind: "mint" });

Errores Comunes

• Revocar la acuñación antes de terminar la distribución - no se puede acuñar la asignación restante. Solución: completar las acuñaciones primero, luego revocar.
• Dejar la autoridad de congelación en manos de un equipo anónimo - los titulares pueden ser congelados. Solución: revocar la congelación o transferir a un multisig transparente.
• Asumir que revocar la acuñación revoca la congelación - campos independientes. Solución: revocar ambos explícitamente.
• Transferir la autoridad a la pubkey incorrecta - pérdida irreversible de control. Solución: verificar la pubkey en una simulación en devnet.
• La UI oculta el estado de la autoridad - los usuarios confían en tokens fraudulentos. Solución: mostrar los campos de spl-token display en los exploradores.

Alternativas

Preguntas Frecuentes

Relacionado

• Acuñación y Quema - usa la autoridad de acuñación
• Mejores Prácticas de SPL Token - lista de verificación de lanzamiento de autoridad
• Transferencias y Delegados - impacto de la congelación

Versiones de la pila: 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.