Trabajando con Pubkeys y Cuentas

Pubkey identifica cuentas y programas. AccountInfo es el manejador en tiempo de ejecución para lamports, datos, propietario y banderas de firmante. Un slicing y validación correctos previenen la escalada de privilegios.

Receta

use solana_program::{account_info::AccountInfo, pubkey::Pubkey};
 
fn assert_signer(ai: &AccountInfo) -> ProgramResult {
    if !ai.is_signer { return Err(ProgramError::MissingRequiredSignature); }
    Ok(())
}

Cuándo usar esto:

• Validando listas de cuentas suministradas por el cliente en programas nativos.
• Comparando propietarios, PDAs e IDs de programa.
• Iterando cuentas con next_account_info.

Ejemplo de Trabajo

use solana_program::{
    account_info::{next_account_info, AccountInfo},
    program_error::ProgramError,
    pubkey::Pubkey,
};
 
pub fn process_transfer(accounts: &[AccountInfo], expected_owner: &Pubkey) -> ProgramResult {
    let iter = &mut accounts.iter();
    let payer = next_account_info(iter)?;
    let vault = next_account_info(iter)?;
 
    if !payer.is_signer {
        return Err(ProgramError::MissingRequiredSignature);
    }
    if vault.owner != expected_owner {
        return Err(ProgramError::IncorrectProgramId);
    }
    if !vault.is_writable {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}

Lo que esto demuestra:

• Las banderas de firmante y escribible se imponen explícitamente.
• La comprobación del propietario vincula la bóveda a tu programa.
• next_account_info avanza el iterador de cuentas en el orden del cliente.

Análisis Profundo

Campos de AccountInfo

Consejos sobre Pubkey

• Compara con == en referencias.
• Las PDAs tienen is_on_curve == false fuera de la cadena; en la cadena trátalas como claves normales.

Notas de Rust

let (pda, bump) = Pubkey::find_program_address(&[b"vault", owner.as_ref()], program_id);

Errores Comunes

• Desfase en el orden de las cuentas - El cliente reordena y pasa la cuenta incorrecta para la comprobación. Solución: Documenta el orden fijo; usa restricciones de Anchor o índices explícitos.
• PDA sin verificar - Deriva el bump en la cadena y compáralo con el bump canónico almacenado. Solución: Ver la página de Bumps Canónicos.
• Cuentas duplicadas - Pasar la misma clave dos veces puede eludir las comprobaciones de débito/crédito. Solución: Rechaza claves duplicadas en instrucciones sensibles.
• Propietario vs. clave - Comprobar key cuando se pretendía owner permite la suplantación. Solución: Nombra las variables claramente y revisa el linting.
• Lamports mut sin firmante - Para debitar SOL se requiere un firmante o autoridad de PDA. Solución: Valida el firmante antes de los cambios de **lamports.

Alternativas

Preguntas Frecuentes

Relacionado

• Validación Manual de Cuentas - Lista de verificación completa
• Derivación de PDAs - Direcciones PDA
• Conceptos Básicos de PDA - Por qué existen las PDAs

Versiones de la pila: Esta página fue 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, y LiteSVM 0.6.x.