Derivando PDAs

PDAs são derivadas de seeds e um ID de programa. find_program_address retorna o endereço canônico off-curve e a seed de bump necessária para invoke_signed.

Receita

let (pda, bump) = Pubkey::find_program_address(
    &[b"metadata", mint.key.as_ref()],
    program_id,
);

Quando usar isto:

• Computar endereços em clientes antes de submeter transações.
• Verificar PDAs fornecidas pelo cliente on-chain.
• Projetar esquemas de seeds multi-tenant.

Exemplo Prático

pub fn verify_config(config: &AccountInfo, authority: &Pubkey, program_id: &Pubkey, stored_bump: u8) -> ProgramResult {
    let (expected, bump) = Pubkey::find_program_address(&[b"config", authority.as_ref()], program_id);
    if expected != *config.key || bump != stored_bump {
        return Err(ProgramError::InvalidSeeds);
    }
    Ok(())
}

O que isto demonstra:

• Inclui a pubkey de autoridade nas seeds para configurações por usuário.
• Compara a chave derivada e o bump com os valores armazenados.
• Retorna InvalidSeeds em caso de incompatibilidade.

Aprofundamento

Algoritmo

• Hash das seeds + ID do programa + bump até que um ponto off-curve seja encontrado.
• O bump canônico é o maior valor válido (de 255 para baixo).

Limites de Seeds

Notas Rust

let bump_seed = [bump];
let signer_seeds: &[&[u8]] = &[b"vault", owner.as_ref(), &bump_seed];
 
// invoke_signed espera &[&[&[u8]]] - envolva o grupo mais uma vez:
invoke_signed(&ix, account_infos, &[signer_seeds])?;

Erros Comuns

• ID de programa errado no cliente - Deriva um endereço diferente. Correção: Passe o ID do programa da chave implantada.
• Bump ausente nas seeds - invoke_signed falha. Correção: Anexe o slice &[bump].
• Seeds de string UTF-8 - Use .as_bytes() consistentemente. Correção: Documente a codificação.
• u64 em seeds - Use bytes em ordem little-endian: id.to_le_bytes(). Correção: Evite empacotamento ambíguo.
• Re-derivar a cada vez - Desperdiça CU on-chain. Correção: Armazene o bump canônico.

Alternativas

FAQs

Relacionado

• Noções Básicas de PDA - Introdução
• Bumps Canônicos - Armazenar bump
• Assinando com PDAs - invoke_signed

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. 3730363230327c3638336f6967637c6f692e73656469756765646f63