Argumentos de Instrucción

Los argumentos después de Context<T> se serializan con Borsh en los datos de la instrucción. Usa #[instruction(...)] en las estructuras de cuentas para referenciar argumentos en las restricciones.

Receta

#[derive(Accounts)]
#[instruction(amount: u64, recipient: Pubkey)]
pub struct Transfer<'info> { /* usa amount en la restricción */ }
 
pub fn transfer(ctx: Context<Transfer>, amount: u64, recipient: Pubkey) -> Result<()> {
    require!(amount > 0, MyError::InvalidAmount);
    Ok(())
}

Cuándo usar esto: Cuando los clientes pasan parámetros numéricos o de tipo Pubkey más allá de la lista de cuentas.

Ejemplo Funcional

#[derive(Accounts)]
#[instruction(id: u64)]
pub struct CreatePool<'info> {
    #[account(
        init,
        payer = payer,
        space = 8 + Pool::INIT_SPACE,
        seeds = [b"pool", id.to_le_bytes().as_ref()],
        bump,
    )]
    pub pool: Account<'info, Pool>,
    #[account(mut)]
    pub payer: Signer<'info>,
    pub system_program: Program<'info, System>,
}
 
pub fn create_pool(ctx: Context<CreatePool>, id: u64, fee_bps: u16) -> Result<()> {
    require!(fee_bps <= 10_000, PoolError::InvalidFee);
    ctx.accounts.pool.fee_bps = fee_bps;
    Ok(())
}

Qué demuestra esto:

• El orden de los argumentos en el manejador coincide con la serialización del cliente.
• #[instruction] expone los argumentos a las restricciones.
• Valida rangos con require! temprano.
• Los argumentos Pubkey a menudo duplican las claves de cuenta para las semillas de PDA.

Análisis Profundo

Serialización

Anchor antepone un discriminador de instrucción de 8 bytes y luego codifica Borsh los argumentos en el orden de los parámetros del manejador.

Consejos de Validación

• Rechaza cantidades cero y Pubkey centinela.
• Mantén la lista de argumentos pequeña para reducir las CU (unidades de cómputo) y los errores del cliente.
• Prefiere las cuentas sobre los argumentos cuando la Pubkey deba firmar o contener datos.

Errores Comunes

• Desajuste en el orden de los argumentos del cliente - La deserialización falla. Solución: Genera clientes a partir de la IDL.
• Falta #[instruction] en la estructura - No se pueden usar argumentos en las semillas. Solución: Añade el atributo con los mismos nombres.
• Confiar en argumentos en lugar de cuentas - La Pubkey del argumento no está vinculada al firmante. Solución: Requiere una cuenta Signer coincidente.
• Vec grande en argumentos - Desbordamiento de CU y tamaño. Solución: Usa remaining_accounts o un patrón de carga separado.
• Desbordamiento de fee o amount - Matemáticas sin verificar en el manejador. Solución: Usa checked_add/checked_mul.

Alternativas

Preguntas Frecuentes

Relacionado

• Manejadores de Instrucciones - firmas
• Restricciones de Semillas y Bump - argumentos en semillas
• Construcción de Instrucciones - codificación del cliente

Versiones de la pila: 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.