Autoridades

Mints SPL carregam duas autoridades opcionais: autoridade de mint (inflar o suprimento) e autoridade de freeze (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::spl_token::instruction::AuthorityType;
use anchor_spl::token::{self, SetAuthority};
 
token::set_authority(cpi_ctx, AuthorityType::MintTokens, None)?;

Quando usar isso:

• Bloquear um suprimento fixo após o mint inicial
• Remover o poder de freeze antes do lançamento para a comunidade
• Transferir a autoridade para um 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 autoridade de mint permanentemente
spl-token authorize "$MINT" mint --disable
 
# Revogar autoridade de freeze (usuários não podem 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` é um COption, não um Option - compare com 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,
}

O que isso demonstra:

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

Análise Detalhada

Como Funciona

• A conta mint armazena mint_authority: COption<Pubkey> e freeze_authority: COption<Pubkey>
• A autoridade de mint é necessária para MintTo; a autoridade de freeze para FreezeAccount / ThawAccount
• A autoridade de fechamento em contas de token (separada do mint) controla quem pode fechar contas vazias
• O proprietário 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 finalizar a distribuição - não é possível mintar a alocação restante. Correção: complete os mints primeiro, depois revogue.
• Deixar a autoridade de freeze com uma equipe anônima - detentores podem ser congelados. Correção: revogue o freeze ou transfira para um multisig transparente.
• Assumir que revogar mint também revoga freeze - campos independentes. Correção: revogue ambos explicitamente.
• Transferir autoridade para a pubkey errada - perda irreversível de controle. Correção: verifique a pubkey em um dry-run na devnet.
• UI ocultando o estado da autoridade - usuários confiam em tokens fraudulentos. Correção: exiba os campos de spl-token display em exploradores.

Alternativas

FAQs

Relacionado

• Minting e Burning - usa autoridade de mint
• Boas Práticas de SPL Token - checklist de autoridades no lançamento
• Transferências e Delegates - impacto do 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.