pinocchio & steel

Pinocchio é um framework Rust minimalista para programas Solana nativos, com ênfase em binários pequenos e baixo overhead de CU no Agave 4.1.1. Steel adiciona estrutura (contas, instruções, registro) sobre os padrões do Pinocchio para equipes que desejam convenções sem a geração completa de código do Anchor 0.32.1. Ambos visam desenvolvedores que otimizam além dos padrões do anchor-lang.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

[dependencies]
pinocchio = "0.8"
# steel = "4.0"  # adicione ao usar crates do framework Steel

use pinocchio::{
    account_info::AccountInfo,
    entrypoint,
    program_error::ProgramError,
    pubkey::Pubkey,
    ProgramResult,
};
 
entrypoint!(process_instruction);
 
fn process_instruction(
    _program_id: &Pubkey,
    accounts: &[AccountInfo],
    data: &[u8],
) -> ProgramResult {
    if data.is_empty() {
        return Err(ProgramError::InvalidInstructionData);
    }
    let _ = accounts;
    Ok(())
}

Quando usar isso:

• Orçamentos de CU e tamanho de binário são apertados em instruções críticas.
• Você recusa a mágica de macros do Anchor, mas deseja padrões mais seguros do que solana-program puro.
• Modelos de registro do Steel se encaixam no layout do seu programa multi-instrução.
• Migrando caminhos de desempenho críticos do Anchor com testes no LiteSVM 0.6.x.

Exemplo de Trabalho

use pinocchio::{
    account_info::AccountInfo,
    entrypoint,
    msg,
    program_error::ProgramError,
    pubkey::Pubkey,
    ProgramResult,
};
 
entrypoint!(process_instruction);
 
enum MyInstruction {
    Ping,
}
 
impl MyInstruction {
    fn unpack(data: &[u8]) -> Result<Self, ProgramError> {
        match data.first() {
            Some(0) => Ok(MyInstruction::Ping),
            _ => Err(ProgramError::InvalidInstructionData),
        }
    }
}
 
fn process_instruction(
    _program_id: &Pubkey,
    accounts: &[AccountInfo],
    data: &[u8],
) -> ProgramResult {
    match MyInstruction::unpack(data)? {
        MyInstruction::Ping => {
            let payer = accounts.get(0).ok_or(ProgramError::NotEnoughAccountKeys)?;
            if !payer.is_signer() {
                return Err(ProgramError::MissingRequiredSignature);
            }
            msg!("ping from {}", payer.key());
            Ok(())
        }
    }
}

O que isso demonstra:

• Enumeração manual de instruções substitui os discriminadores do Anchor.
• Indexação explícita de contas com validação de signatário.
• Log msg! compatível com análise de logs RPC.
• Nenhuma IDL gerada - clientes empacotam bytes de instrução correspondentes.

Mergulho Profundo

Como Funciona

• Pinocchio fornece helpers de entrypoint e acessadores de conta leves.
• Steel adiciona registros de conta, manipuladores tipados e utilitários de teste.
• Ambos compilam com cargo build-sbf como programas nativos.
• Clientes devem empacotar manualmente ou usar IDLs Codama/Shank se você publicar uma separadamente.

Tabela de Crates Rust

Tabela TypeScript / NPM

Notas Rust

// Meça a CU antes/depois de migrar do Anchor
// helpers cpi do pinocchio existem para programas comuns - verifique a documentação para cobertura

Armadilhas

• Sem restrições de conta Anchor - fácil de perder verificações de proprietário. Correção: checklist por instrução; testes LiteSVM.
• Layout da instrução não documentado - bugs do cliente. Correção: publique IDL ou especificação rigorosa no repositório.
• Descompasso de versão do Steel com Pinocchio - falhas de compilação. Correção: siga a tabela de compatibilidade de lançamento do Steel.
• Otimização excessiva prematura - entrega mais lenta. Correção: perfil do Anchor primeiro; migre apenas os caminhos críticos.
• Verbosidade do CPI SPL - mais boilerplate do que anchor-spl. Correção: helpers internos finos.

Alternativas

FAQs

Relacionado

• Noções Básicas do Pinocchio - introdução ao framework
• Framework Steel - guia do Steel
• Quando Usar Nativo - enquadramento de decisão
• solana-program & solana-sdk - crates base

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.