Autoridades

Mints SPL carregam duas autoridades opcionais: mint authority (inflar supply) e freeze authority (congelar contas de token). Revogar autoridades é um sinal comum de imutabilidade e confiança para tokens lançados.

Receita

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

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

Quando usar isso:

• Travar supply fixo após mint inicial
• Remover poder de freeze antes do lançamento comunitário
• Transferir autoridade para multisig ou PDA de DAO
• Auditar suposições de confiança de tokens de terceiros

Exemplo de Trabalho

MINT=<YOUR_MINT>
 
# Inspecionar autoridades atuais
spl-token display "$MINT"
 
# Revogar mint authority permanentemente
spl-token authorize "$MINT" mint --disable
 
# Revogar freeze authority (usuários não podem ser congelados)
spl-token authorize "$MINT" freeze --disable
 
spl-token display "$MINT"

use anchor_lang::prelude::*;
use anchor_spl::token::{self, Mint, Token, SetAuthority};
 
#[derive(Accounts)]
pub struct RevokeMintAuthority<'info> {
    #[account(mut)]
    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<()> {
    require!(
        ctx.accounts.mint.mint_authority == 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,
        spl_token::instruction::AuthorityType::MintTokens,
        None,
    )?;
    Ok(())
}
 
#[error_code]
pub enum ErrorCode {
    NotMintAuthority,
}

O que isso demonstra:

• authorize --disable define campo de autoridade para None
• Revogação é irreversível para aquele tipo de autoridade
• Programas on-chain usam CPI set_authority com signer da autoridade atual

Deep Dive

Como Funciona

• Conta mint armazena mint_authority: COption<Pubkey> e freeze_authority: COption<Pubkey>
• Mint authority é necessária para MintTo; freeze authority para FreezeAccount / ThawAccount
• Close authority em contas de token (separada do mint) controla quem pode fechar contas vazias
• Owner da conta de token é distinto das autoridades do mint

Tipos de Autoridade

Notas Rust

// Sempre registre mudanças de autoridade para indexadores
emit!(AuthorityRevoked { mint: mint.key(), kind: "mint" });

Armadilhas

• Revogar mint antes de terminar distribuição - não pode mintar alocação restante. Correção: complete mints primeiro, depois revogue.
• Deixar freeze authority com equipe anônima - holders podem ser congelados. Correção: revogue freeze ou transfira para multisig transparente.
• Assumir que revogar mint revoga freeze - campos independentes. Correção: revogue ambos explicitamente.
• Transferir autoridade para pubkey errada - perda irreversível de controle. Correção: verifique pubkey em dry-run devnet.
• UI ocultando estado de autoridade - usuários confiam em tokens scam. Correção: exiba campos de spl-token display em explorers.

Alternativas

FAQs

Relacionado

• Minting e Burning - usa mint authority
• Boas Práticas de SPL Token - checklist de autoridades no lançamento
• Transferências e Delegates - impacto de freeze

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.