Derivación de PDAs

Los PDAs se derivan de semillas y un ID de programa. find_program_address devuelve la dirección canónica fuera de la curva y la semilla de "bump" necesaria para invoke_signed.

Receta

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

Cuándo recurrir a esto:

• Calcular direcciones en clientes antes de enviar transacciones.
• Verificar PDAs proporcionados por el cliente en la cadena.
• Diseñar esquemas de semillas multi-inquilino.

Ejemplo de Trabajo

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(())
}

Lo que esto demuestra:

• Incluye la clave pública de autoridad en las semillas para configuraciones por usuario.
• Compara la clave derivada y el "bump" con los valores almacenados.
• Devuelve InvalidSeeds en caso de discrepancia.

Análisis Profundo

Algoritmo

• Hashea las semillas + ID de programa + semilla de "bump" hasta encontrar un punto fuera de la curva.
• La semilla de "bump" canónica es la más alta válida (de 255 hacia abajo).

Límites de Semillas

Notas de Rust

let bump_seed = [bump];
let signer_seeds: &[&[u8]] = &[b"vault", owner.as_ref(), &bump_seed];
 
// invoke_signed espera &[&[&[u8]]] - envuelve el grupo una vez más:
invoke_signed(&ix, account_infos, &[signer_seeds])?;

Errores Comunes

• ID de programa incorrecto en el cliente - Deriva una dirección diferente. Solución: Pasar el ID del programa de la clave desplegada.
• Semilla de "bump" faltante en las semillas - invoke_signed falla. Solución: Añadir el slice &[bump].
• Semillas de cadena UTF-8 - Usar .as_bytes() consistentemente. Solución: Documentar la codificación.
• u64 en semillas - Usar bytes con orden de bytes fijo: id.to_le_bytes(). Solución: Evitar empaquetado ambiguo.
• Rederivar cada vez - Desperdicia CU en la cadena. Solución: Almacenar la semilla de "bump" canónica.

Alternativas

Preguntas Frecuentes

Relacionado

• Conceptos básicos de PDA - Introducción
• Semillas de Bump Canónicas - Almacenar la semilla de "bump"
• Firmar con PDAs - invoke_signed

Versiones de Stack: Esta página se escribió 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, y LiteSVM 0.6.x. 3730363230327c3638336f6967637c6f692e73656469756765646f63