Contas Zero-Copy

Contas zero-copy usam layout bytemuck e AccountLoader para evitar serializar/desserializar Borsh em structs grandes, economizando CU para estados grandes.

Receita

#[account(zero_copy)]
pub struct Market {
    pub bids: [u64; 1024],
}
 
#[derive(Accounts)]
pub struct Update<'info> {
    #[account(mut)]
    pub market: AccountLoader<'info, Market>,
}

Quando usar isso: Os dados da conta são grandes (livros de ofertas, arrays de ticks) e o custo de Borsh em CU é muito alto.

Exemplo de Trabalho

use anchor_lang::prelude::*;
 
#[account(zero_copy)]
#[repr(C)]
pub struct LargeState {
    pub head: u64,
    pub data: [u8; 10_000],
}
 
pub fn touch(ctx: Context<Touch>) -> Result<()> {
    let mut market = ctx.accounts.state.load_mut()?;
    market.head += 1;
    Ok(())
}
 
#[derive(Accounts)]
pub struct Touch<'info> {
    #[account(mut)]
    pub state: AccountLoader<'info, LargeState>,
}

O que isso demonstra:

• zero_copy requer layout repr(C)
• AccountLoader::load_mut para mutação
• Sem INIT_SPACE para dimensionamento Borsh da mesma forma
• O discriminador ainda se aplica

Mergulho Profundo

Disciplina de Layout

• Apenas arrays de tamanho fixo, a menos que se use gerenciamento manual cuidadoso.
• O alinhamento é importante; siga as regras do bytemuck.
• Migrações são mais difíceis do que contas Borsh.

Vitória em CU

Evita a cópia completa da conta (memcpy) em cada instrução.

Armadilhas

• Campos desalinhados - Comportamento indefinido. Correção: Use repr(C) e bytemuck Pod.
• Misturar Borsh e zero_copy - Tipo de carregador errado. Correção: Escolha um por conta.
• Vec dinâmico em zero_copy - Não suportado nativamente. Correção: Buffers fixos ou conta Borsh.
• Esqueceu mut na conta do carregador - Não é possível persistir. Correção: Marque a conta como mut.
• Atualizar layout sem migração - Corrompe a conta. Correção: Versionar e migrar.

Alternativas

FAQs

Relacionado

• Contas Zero-Copy - visão de serialização
• Otimização de CU e Tamanho - CU
• Tipos de Conta Personalizados - traits

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.