no_std e o Ambiente de Programa

Programas Solana compilam para SBF e executam em sandbox sem std. Você obtém syscalls solana_program, alloc opcional e orçamento estrito de CU.

Receita

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

Quando usar:

• Iniciar qualquer crate de programa nativo (não-Anchor).
• Auditar por que uma dependência falha em cargo build-sbf.
• Escolher entre coleções alloc e layouts de conta de tamanho fixo.

Exemplo Funcional

#![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(())
}

O que isso demonstra:

• #![no_std] mais extern crate alloc é o layout padrão de programa nativo.
• Dados de instrução chegam como slice de bytes - copie só quando mutação for necessária.
• Acesso a conta passa por referências AccountInfo fornecidas pelo runtime.

Aprofundamento

Como Funciona

• Runtime Agave 4.1.1 carrega seu .so e invoca o símbolo registrado por entrypoint!.
• Syscalls (logging, CPI, borrow de conta) são a única forma de interagir com estado da chain.
• Panics abortam a instrução; não há unwinding através da fronteira do host.

Crates Disponíveis

Notas Rust

// Prefira &[u8] sobre Vec a menos que precise possuir bytes.
// solana_program re-exporta Pubkey, ProgramError e sysvars.

Armadilhas

• Importar std - Crate que puxa std quebra cargo build-sbf. Correção: Fixe deps com cargo tree e prefira crates compatíveis com no_std.
• Churn de heap - Vec::push em caminhos quentes aloca e custa CUs. Correção: Use tamanhos fixos de conta ou arrays na stack com limites conhecidos.
• Panic no parse - unwrap em dados ruins do cliente aborta a transação inteira. Correção: Retorne ProgramError::InvalidAccountData.
• alloc ausente - Usar Vec sem extern crate alloc falha no link. Correção: Adicione extern crate alloc na raiz do crate.
• Debug prints - println! indisponível on-chain. Correção: Use msg! ou erros customizados com moderação.

Alternativas

FAQs

Relacionado

• Rust for Solana Basics - Orientação da seção
• Borsh Serialization - Codificação de dados
• Program Size & CU Discipline - Performance

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.