Busca en todas las páginas de la documentación
El estado del programa es un buffer de bytes en el campo data de una cuenta. Anchor 0.32.1 usa Borsh serialization con un prefijo discriminador de 8 bytes. Un dimensionamiento correcto del diseño previene fallos de inicialización y exploits de deserialización.
#[account]
#[derive(InitSpace)]
pub struct Market {
pub authority: Pubkey,
pub price: u64,
pub name: String, // max 32 en InitSpace vía #[max_len(32)]
}
// space = 8 + Market::INIT_SPACECuándo recurrir a esto:
init para nuevos tipos de cuentasuse anchor_lang::prelude::*;
#[account]
#[derive(InitSpace)]
pub struct UserStats {
pub authority: Pubkey,
#[max_len(16)]
pub nickname: String,
pub wins: u32,
pub losses: u32,
}
#[derive(Accounts)]
pub struct InitStats<'info> {
#[account(
init,
payer = authority,
space = 8 + UserStats::INIT_SPACE,
seeds = [b"stats", authority.key().as_ref()],
bump,
)]
pub stats: Account<'info, UserStats>,
#[account(mut)]
pub authority: Signer<'info>,
pub system_program: Program<'info, System>,
}
#[program]
pub mod stats {
use super::*;
pub fn init(ctx: Context<InitStats>, nickname: String) -> Result<()> {
require!(nickname.len() <= 16, StatsError::NameTooLong);
ctx.accounts.stats.nickname = nickname;
ctx.accounts.stats.wins = 0;
ctx.accounts.stats.losses = 0;
Ok(())
}
}Lo que esto demuestra:
InitSpace calcula el tamaño de Borsh incluyendo cadenas max_len[ 8 bytes discriminador ][ Campo Borsh 1 ][ Campo 2 ]...Pubkey 32, u64 8, bool 1String/Vec: longitud de 4 bytes + bytes de contenido máximoversion: u8 como primer campo después del discriminadormax_len en String/Vec - error de compilación o tamaño ilimitado. Solución: siempre establecer #[max_len(N)] en Anchor 0.32.1.InitSpace.| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Borsh + Anchor | Estado de programa predeterminado | Conjuntos de datos de varios MB |
Zero-copy (AccountLoader) | Estructuras grandes, ahorro de CU | Estructuras pequeñas y simples |
bytemuck POD | Diseños empaquetados de tamaño fijo | Cadenas de longitud variable |
| Compresión externa | Datos a escala NFT | Campos mutables de acceso frecuente |
Los primeros 8 bytes de SHA256("account:StructName") en Anchor - identifica el tipo de cuenta.
Suma los tamaños de Borsh + 8. Para String(máx N): 4 + N bytes.
No - rompe la deserialización de cuentas existentes.
Macro derive de Anchor 0.32.1 que calcula la constante INIT_SPACE para el atributo space.
Usar clientes Codama/@solana/kit de la IDL, o lecturas manuales del buffer que coincidan con el diseño de Borsh.
10 MB por cuenta en Agave 4.1.1 - los límites prácticos son menores debido al alquiler/CU.
Desperdicio y sin límites. Usar diseños binarios tipados.
Borsh usa una etiqueta de variante de 1 byte + el tamaño de la carga útil de la variante más grande.
#[account(zero_copy)] mapea la estructura directamente a los bytes de la cuenta sin asignación de deserialización.
Solo para optimización extrema de CU. El diseño predeterminado de Borsh está bien para la mayoría de los programas.
Usar Option<T> en Borsh (etiqueta de 1 byte + T) o valores centinela.
No - cada tipo de cuenta de Anchor tiene un discriminador único.
realloc para crecimientoVersiones 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.
Revisado por Chris St. John·Última actualización: 16 jul 2026