no_std y el Entorno del Programa

Los programas de Solana compilan a SBF y se ejecutan en un entorno aislado sin std. Tienes las llamadas al sistema solana_program, alloc opcional y un presupuesto estricto de CUs.

Receta

#![no_std]
 
extern crate alloc;
 
use solana_program::{
    account_info::AccountInfo, entrypoint, program_error::ProgramError,
    pubkey::Pubkey,
};

Cuándo recurrir a esto:

• Al iniciar cualquier crate de programa nativo (no Anchor).
• Al auditar por qué una dependencia falla al compilar para cargo build-sbf.
• Al elegir entre colecciones de alloc y diseños de cuentas de tamaño fijo.

Ejemplo de Trabajo

#![no_std]
 
extern crate alloc;
 
use alloc::vec::Vec;
use solana_program::{
    account_info::AccountInfo, entrypoint, entrypoint::ProgramResult,
    program_error::ProgramError, pubkey::Pubkey,
};
 
entrypoint!(process_instruction);
 
pub fn process_instruction(
    _program_id: &Pubkey,
    accounts: &[AccountInfo],
    instruction_data: &[u8],
) -> ProgramResult {
    if instruction_data.is_empty() {
        return Err(ProgramError::InvalidInstructionData);
    }
    let _owner = accounts.get(0).ok_or(ProgramError::NotEnoughAccountKeys)?;
    let buf: Vec<u8> = instruction_data.to_vec();
    solana_program::msg!("bytes: {}", buf.len());
    Ok(())
}

Lo que esto demuestra:

• #![no_std] junto con extern crate alloc es la disposición predeterminada del programa nativo.
• Los datos de la instrucción llegan como un slice de bytes; cópialos solo cuando sea necesaria la mutación.
• El acceso a las cuentas se realiza a través de referencias AccountInfo proporcionadas por el runtime.

Análisis Profundo

Cómo Funciona

• El runtime Agave 4.1.1 carga tu .so e invoca el símbolo registrado por entrypoint!.
• Las llamadas al sistema (registro, CPI, préstamo de cuentas) son la única forma de interactuar con el estado de la cadena.
• Los panic abortan la instrucción; no hay desenrollado (unwinding) a través del límite del host.

Crates Disponibles

Notas de Rust

// Prefiere &[u8] sobre Vec a menos que necesites poseer los bytes.
// solana_program reexporta Pubkey, ProgramError y sysvars.

Trampas

• Importar std - Añadir un crate que importe std rompe cargo build-sbf. Solución: Fija las dependencias con cargo tree y prefiere crates compatibles con no_std.
• Agitación del heap - Vec::push en rutas críticas asigna y cuesta CUs. Solución: Usa tamaños de cuenta fijos o arrays en la pila con límites conocidos.
• Panic al parsear - unwrap en datos incorrectos del cliente aborta toda la transacción. Solución: Devuelve ProgramError::InvalidAccountData en su lugar.
• Falta de alloc - Usar Vec sin extern crate alloc falla al enlazar. Solución: Añade extern crate alloc en la raíz del crate.
• Impresiones de depuración - println! no está disponible en la cadena. Solución: Usa msg! o errores personalizados con moderación.

Alternativas

Preguntas Frecuentes

Relacionado

• Fundamentos de Rust para Solana - Orientación de la sección
• Serialización Borsh - Codificación de datos
• Disciplina de Tamaño de Programa y CU - Rendimiento

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.