Pasar Cuentas Restantes

Pasa remaining_accounts a las CPIs cuando el programa llamado espera listas de cuentas variables (enrutamiento, oráculos, swaps de múltiples saltos).

Receta

let mut cpi_ctx = CpiContext::new(program, accounts);
cpi_ctx = cpi_ctx.with_remaining_accounts(
    ctx.remaining_accounts.iter().map(|a| a.to_account_info()).collect(),
);

Cuándo usar esto: El programa llamado documenta cuentas más allá de su diseño fijo de IDL.

Ejemplo Funcional

use anchor_lang::prelude::*;
 
declare_program!(target);
 
pub const MAX_REMAINING: usize = 8;
 
#[error_code]
pub enum RelayError {
    #[msg("La cuenta restante tiene un propietario inesperado")]
    BadAccount,
    #[msg("Demasiadas cuentas restantes")]
    TooMany,
}
 
#[derive(Accounts)]
pub struct Relay<'info> {
    pub admin: Signer<'info>,
    pub target_program: Program<'info, target::program::Target>,
}
 
pub fn relay(ctx: Context<Relay>) -> Result<()> {
    require!(
        ctx.remaining_accounts.len() <= MAX_REMAINING,
        RelayError::TooMany
    );
    for acc in ctx.remaining_accounts.iter() {
        require_keys_eq!(*acc.owner, target::ID, RelayError::BadAccount);
    }
 
    let mut cpi_ctx = CpiContext::new(
        ctx.accounts.target_program.to_account_info(),
        target::cpi::accounts::Handle { admin: ctx.accounts.admin.to_account_info() },
    );
    cpi_ctx = cpi_ctx.with_remaining_accounts(ctx.remaining_accounts.to_vec());
 
    target::cpi::handle(cpi_ctx)?;
    Ok(())
}

Lo que esto demuestra:

• Valida cada cuenta restante antes de la CPI
• El orden debe coincidir con las expectativas del llamado
• Combina con las estructuras CPI declare_program
• Documenta el formato de enrutamiento para los clientes

Análisis Profundo

Responsabilidad del Cliente

Los clientes añaden cuentas después de las cuentas fijas de la IDL en las metadatos de la transacción. Un desajuste causa fallos en el programa llamado o errores de seguridad.

Impacto de CU

Iterar sobre grandes conjuntos restantes cuesta CU; limita el número con require!(len <= MAX).

Trampas Comunes

• Cuentas restantes no validadas - Vulnerabilidad crítica. Solución: Comprobar propietario, firmante, discriminador.
• Orden incorrecto al pasar - El programa llamado lee la cuenta incorrecta como oráculo. Solución: Publicar una especificación de orden estricta.
• Longitud ilimitada - Agotamiento de CU. Solución: Forzar un número máximo de cuentas restantes.
• Mezclar cuentas restantes con inicialización - Confusión en el orden de Anchor. Solución: Mantener las cuentas fijas solo en la estructura.
• Asumir que el programa llamado valida lo mismo que tú - Falta de defensa en profundidad. Solución: Validar en ambos lados.

Alternativas

Preguntas Frecuentes

Relacionados

• remaining_accounts - lado del programa
• Accediendo a Cuentas - ctx.remaining_accounts
• Seguridad de CPI - validació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.