invoke vs invoke_signed

invoke encaminha apenas assinaturas de transação. invoke_signed adiciona assinaturas de PDA derivadas de fatias de sementes (seeds), permitindo que programas movam fundos que eles custodiam.

Receita

invoke(&ix, accounts)?;           // apenas signers da carteira
invoke_signed(&ix, accounts, seeds)?; // + signers de PDA

Quando usar isso:

• Debitar um PDA de cofre (vault).
• Mintar com autoridade de mint de PDA.
• Criar contas pertencentes ao seu programa.

Exemplo Funcional

pub fn move_from_vault(bump: u8, amount: u64, from: &AccountInfo, to: &AccountInfo, sys: &AccountInfo) -> ProgramResult {
    let ix = system_instruction::transfer(from.key, to.key, amount);
    invoke_signed(&ix, &[from.clone(), to.clone(), sys.clone()], &[&[b"vault", &[bump]]])
}

O que isso demonstra:

• O PDA do cofre assina a transferência do sistema.
• Grupo de sementes único com byte de bump.
• Sem invoke_signed, o CPI falha por falta de assinatura.

Análise Detalhada

Comparação

Notas de Rust

// signers_seeds: &[&[&[u8]]]
//   outer = uma entrada por signer de PDA
//   inner = as sementes desse PDA + [bump]
&[
    &[b"vault", user.key.as_ref(), &[vault_bump]],
    &[b"mint_auth", &[mint_bump]],
]

Armadilhas

• invoke para autoridade de PDA - MissingRequiredSignature. Correção: Use invoke_signed.
• Seeds incorretas - Falha silenciosa ou erro. Correção: Centralize o construtor de seeds.
• Carteira pode assinar PDA? - Não existe chave privada. Correção: Apenas programa.
• Confusão de delegado - O delegado de token não é um signatário de programa PDA. Correção: Ler regras de token.
• Múltiplos grupos de seeds - A ordem importa para CPIs de múltiplos PDAs. Correção: Testar cada caminho.

Alternativas

FAQs

Relacionado

• Assinando com PDAs - Assinatura de PDA
• CPI para o Programa do Sistema - Transferências de SOL
• Passando Contas para CPIs - Metas de conta

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.