La Estructura de Cuentas

Cada instrucción declara una estructura de cuentas con #[derive(Accounts)]. Anchor ejecuta las restricciones antes de que se ejecute tu manejador, aplicando la propiedad, la mutabilidad y las relaciones de forma fallida y cerrada.

Receta

#[derive(Accounts)]
pub struct Transfer<'info> {
    #[account(mut)]
    pub from: Signer<'info>,
    #[account(mut, constraint = to.owner == from.key())]
    pub to: Account<'info, TokenAccount>,
    pub token_program: Program<'info, Token>,
}

Cuándo usar esto: Diseñas cualquier instrucción que toque cuentas en la cadena.

Ejemplo Funcional

#[derive(Accounts)]
pub struct UpdateMetadata<'info> {
    #[account(
        mut,
        seeds = [b"meta", authority.key().as_ref()],
        bump = metadata.bump,
        has_one = authority,
    )]
    pub metadata: Account<'info, Metadata>,
    pub authority: Signer<'info>,
}
 
#[account]
pub struct Metadata {
    pub authority: Pubkey,
    pub bump: u8,
    pub uri: String,
}

Lo que esto demuestra:

• Los tipos de campo (Signer, Account<T>, Program<T>) implican comprobaciones básicas.
• Las restricciones de atributo añaden seeds, init, has_one y expresiones personalizadas.
• El mapa bumps está disponible en los manejadores para los bumps canónicos almacenados.
• El orden de validación es importante para la seguridad de init y CPI.

Análisis Profundo

Tipos de Cuentas Comunes

Categorías de Restricciones

• Mutabilidad - mut para cuentas escribibles.
• Propiedad - owner, has_one, restricciones de token.
• Dirección - address = expr, seeds/bump para PDAs.
• Ciclo de vida - init, init_if_needed, close.

Errores Comunes

• UncheckedAccount sin restricciones - Cualquier cuenta pasa la validación. Solución: Añade address, owner o constraint.
• Falta mut en cuenta escribible - Fallo en tiempo de ejecución al escribir. Solución: Marca cada cuenta escrita como mut.
• has_one en campo incorrecto - La relación no se aplica. Solución: Haz coincidir el nombre del campo con el campo de la estructura en los datos de la cuenta.
• init sin pagador - La creación de la cuenta falla. Solución: Establece payer = signer e incluye el programa del sistema.
• Confiar en PDAs proporcionados por el cliente - Semillas incorrectas agotan los fondos. Solución: Usa siempre restricciones seeds + bump.

Alternativas

Preguntas Frecuentes

Relacionados

• Tipos de Cuentas - referencia de tipos
• Las Restricciones #[account] - catálogo de restricciones
• Orden de Validación de Cuentas - secuencia de comprobación

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.