PDAs como Autoridades

PDAs comumente atuam como autoridades de mint, autoridades de congelamento, proprietários de vaults e custodiantes de escrow. O programa garante quando a PDA pode assinar através da lógica de negócio.

Receita

// Seeds de PDA de autoridade de mint: [b"mint_auth", mint.key.as_ref()]

Quando usar:

Lançar tokens com mint controlado pelo programa.
Reter fundos de usuários em escrow até que as condições sejam atendidas.
Contas de tesouraria para taxas de protocolo.

Exemplo Prático

// Conceitual: programa verifica as condições de escrow e então assina a transferência de token da PDA de escrow
pub fn release_escrow(bump: u8, /* contas */) -> ProgramResult {
    // validar expiração, assinaturas, máquina de estados
    // transfer_checked CPI com invoke_signed seeds &[&[b"escrow", &[bump]]]
    // (spl_token::instruction::transfer é depreciado e rejeita Token-2022)
    Ok(())
}

O que isso demonstra:

Regras de negócio controlam a assinatura da PDA.
A PDA de escrow detém tokens SPL.
A máquina de estados é verificada antes do CPI.

Aprofundamento

Padrões

Papel	Seeds típicas
Vault	`[b"vault", user]`
Mint auth	`[b"mint", mint]`
Escrow	`[b"escrow", order_id]`

Risco

Bug no programa = comprometimento total da autoridade.

Notas Rust

// Nunca exponha um wrapper invoke_signed arbitrário sem verificações.

Erros Comuns

Wrapper CPI arbitrário - Qualquer um dispara a assinatura da PDA. Correção: Vincule a manipuladores de instrução.
Escrow sem expiração - Fundos travados para sempre. Correção: Caminhos de tempo ou cancelamento.
PDA de autoridade compartilhada - Uma violação atinge todos os usuários. Correção: Isolamento de seeds por usuário.
Autoridade de mint não revogada - Risco de mint infinito. Correção: Revogue após a configuração.
Incompatibilidade do proprietário da conta de token - A PDA deve ser proprietária da conta de token. Correção: Valide a ATA.

Alternativas

Alternativa	Use Quando	Não Use Quando
Autoridade multisig	Operações humanas	Automação total
Vault com proprietário de carteira	Custódia do usuário	Escrow de protocolo
Programas de escrow NFT	Especializado	Apenas token SPL

FAQs

Quem controla a PDA?

Código do programa no ID do programa.

Transferir autoridade de mint para PDA?

CPI set_authority.

Revogar mint?

Recomendado após o fornecimento fixo.

Vault de SOL?

A PDA detém lamports; o programa assina as transferências.

Escrow de NFT?

Mesmos padrões com verificações de metadados.

Risco de upgrade?

Upgrade malicioso rouba a autoridade.

Timelock de governança?

Padrão de operações off-chain.

ATA para PDA?

Derive o endereço de token associado.

Freeze authority PDA?

Possível com o programa de token.

Fechar escrow?

Retorne o aluguel; zere o estado.

Auditoria?

Alvo de achado de nível crítico.

init mint do Anchor?

Suporta autoridades PDA.

Relacionado

Vault e Escrow - Padrões
CPI para SPL Token - Operações de token
Controle de Acesso e Autoridades - Papéis

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.

Receita

// Seeds de PDA de autoridade de mint: [b"mint_auth", mint.key.as_ref()]

Quando usar:

Lançar tokens com mint controlado pelo programa.
Reter fundos de usuários em escrow até que as condições sejam atendidas.
Contas de tesouraria para taxas de protocolo.

Exemplo Prático

// Conceitual: programa verifica as condições de escrow e então assina a transferência de token da PDA de escrow
pub fn release_escrow(bump: u8, /* contas */) -> ProgramResult {
    // validar expiração, assinaturas, máquina de estados
    // transfer_checked CPI com invoke_signed seeds &[&[b"escrow", &[bump]]]
    // (spl_token::instruction::transfer é depreciado e rejeita Token-2022)
    Ok(())
}

O que isso demonstra:

Regras de negócio controlam a assinatura da PDA.
A PDA de escrow detém tokens SPL.
A máquina de estados é verificada antes do CPI.

Aprofundamento

Padrões

Papel	Seeds típicas
Vault	`[b"vault", user]`
Mint auth	`[b"mint", mint]`
Escrow	`[b"escrow", order_id]`

Risco

Bug no programa = comprometimento total da autoridade.

Notas Rust

// Nunca exponha um wrapper invoke_signed arbitrário sem verificações.

Erros Comuns

Wrapper CPI arbitrário - Qualquer um dispara a assinatura da PDA. Correção: Vincule a manipuladores de instrução.
Escrow sem expiração - Fundos travados para sempre. Correção: Caminhos de tempo ou cancelamento.
PDA de autoridade compartilhada - Uma violação atinge todos os usuários. Correção: Isolamento de seeds por usuário.
Autoridade de mint não revogada - Risco de mint infinito. Correção: Revogue após a configuração.
Incompatibilidade do proprietário da conta de token - A PDA deve ser proprietária da conta de token. Correção: Valide a ATA.

Alternativas

Alternativa	Use Quando	Não Use Quando
Autoridade multisig	Operações humanas	Automação total
Vault com proprietário de carteira	Custódia do usuário	Escrow de protocolo
Programas de escrow NFT	Especializado	Apenas token SPL

FAQs

Quem controla a PDA?

Código do programa no ID do programa.

Transferir autoridade de mint para PDA?

CPI set_authority.

Revogar mint?

Recomendado após o fornecimento fixo.

Vault de SOL?

A PDA detém lamports; o programa assina as transferências.

Escrow de NFT?

Mesmos padrões com verificações de metadados.

Risco de upgrade?

Upgrade malicioso rouba a autoridade.

Timelock de governança?

Padrão de operações off-chain.

ATA para PDA?

Derive o endereço de token associado.

Freeze authority PDA?

Possível com o programa de token.

Fechar escrow?

Retorne o aluguel; zere o estado.

Auditoria?

Alvo de achado de nível crítico.

init mint do Anchor?

Suporta autoridades PDA.

Relacionado

Vault e Escrow - Padrões
CPI para SPL Token - Operações de token
Controle de Acesso e Autoridades - Papéis

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.

PDAs como Autoridades

Buscar na documentação

PDAs como Autoridades