Passando Contas Restantes

Encaminhe remaining_accounts para CPIs quando o chamado espera listas de contas variáveis (roteamento, oráculos, trocas multi-hop).

Receita

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(),
);

Quando usar isso: O programa chamado documenta contas além do seu layout fixo de IDL.

Exemplo Funcional

use anchor_lang::prelude::*;
 
declare_program!(target);
 
pub const MAX_REMAINING: usize = 8;
 
#[error_code]
pub enum RelayError {
    #[msg("Remaining account has unexpected owner")]
    BadAccount,
    #[msg("Too many remaining accounts")]
    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(())
}

O que isso demonstra:

• Valide cada conta restante antes da CPI
• A ordem deve corresponder às expectativas do chamado
• Combine com structs de CPI declare_program
• Documente o formato de roteamento para clientes

Análise Detalhada

Responsabilidade do Cliente

Clientes anexam contas após as contas fixas da IDL nas metadados da transação. Incompatibilidade causa falha do chamado ou bugs de segurança.

Impacto de CU

Iterar grandes conjuntos restantes consome CU; limite a contagem com require!(len <= MAX).

Armadilhas

• Contas restantes não validadas - Vulnerabilidade crítica. Correção: Verifique o proprietário, signatário, discriminador.
• Ordem incorreta encaminhada - O chamado lê a conta errada como oráculo. Correção: Publique uma especificação de ordenação rigorosa.
• Comprimento ilimitado - Exaustão de CU. Correção: Aplique a contagem máxima de contas restantes.
• Mistura de contas restantes com inicialização - Confusão de ordenação do Anchor. Correção: Mantenha contas fixas apenas na struct.
• Assumir que o chamado valida o mesmo que você - Falta de defesa em profundidade. Correção: Valide em ambos os lados.

Alternativas

FAQs

Relacionados

• remaining_accounts - lado do programa
• Acessando Contas - ctx.remaining_accounts
• Segurança de CPI - validação

Versões da Stack: Esta página foi 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, e LiteSVM 0.6.x.