#entrypoint #solana #account #programs #pubkey #instructions #layout

solana-nostd-entrypoint

A zerocopy, no_alloc/no_std entrypoint for solana programs

8 releases (4 breaking)

0.6.0 Nov 7, 2024
0.5.1 Oct 28, 2024
0.4.2 Oct 12, 2024
0.3.3 Aug 25, 2024
0.1.0 Feb 24, 2024

#341 in Magic Beans

Download history 15/week @ 2024-07-29 56/week @ 2024-08-19 258/week @ 2024-08-26 44/week @ 2024-09-16 11/week @ 2024-09-23 43/week @ 2024-09-30 409/week @ 2024-10-07 275/week @ 2024-10-14 55/week @ 2024-10-21 219/week @ 2024-10-28 192/week @ 2024-11-04 45/week @ 2024-11-11

520 downloads per month
Used in sealevel-tools

MIT/Apache

48KB
938 lines

solana-nostd-entrypoint

The entrypoint function in solana_program is grossly inefficient. With an empty process_instruction function, it uses upwards of 8000 bpf cus when the program receives 32 non-duplicate accounts. We use a new NoStdAccountInfo struct whose layout is consistent with that in the vm flat buffer input: *mut u8; unlike the usual entrypoint, it reads everything with no copies and no allocations.

This crate also includes a simple reference program that invokes another program. See lib.rs:

#[cfg(feature = "example-program")]
pub mod entrypoint {
    use super::*;
    use solana_program::{
        entrypoint::ProgramResult, log, program_error::ProgramError, pubkey::Pubkey, system_program,
    };

    entrypoint_nostd!(process_instruction, 32);

    pub const ID: Pubkey = solana_program::pubkey!("EWUt9PAjn26zCUALRRt56Gutaj52Bpb8ifbf7GZX3h1k");

    noalloc_allocator!();
    basic_panic_impl!();

    pub fn process_instruction(
        _program_id: &Pubkey,
        accounts: &[NoStdAccountInfo],
        _data: &[u8],
    ) -> ProgramResult {
        log::sol_log("nostd_c");

        // Unpack accounts
        let [user, config, _rem @ ..] = accounts else {
            return Err(ProgramError::NotEnoughAccountKeys);
        };

        // Transfer has discriminant 2_u32 (little endian), followed u64 lamport amount
        let mut instruction_data = [0; 12];
        instruction_data[0] = 2;
        instruction_data[4..12].copy_from_slice(&100_000_000_u64.to_le_bytes());

        // Instruction accounts are are from, to
        let instruction_accounts = [user.to_meta_c(), config.to_meta_c()];

        // Build instruction expected by sol_invoke_signed_c
        let instruction = InstructionC {
            program_id: &system_program::ID,
            accounts: instruction_accounts.as_ptr(),
            accounts_len: instruction_accounts.len() as u64,
            data: instruction_data.as_ptr(),
            data_len: instruction_data.len() as u64,
        };

        // Get infos and seeds
        let infos = [user.to_info_c(), config.to_info_c()];
        let seeds: &[&[&[u8]]] = &[];

        // Invoke system program
        #[cfg(target_os = "solana")]
        unsafe {
            solana_program::syscalls::sol_invoke_signed_c(
                &instruction as *const InstructionC as *const u8,
                infos.as_ptr() as *const u8,
                infos.len() as u64,
                seeds.as_ptr() as *const u8,
                seeds.len() as u64,
            );
        }

        // For clippy
        #[cfg(not(target_os = "solana"))]
        core::hint::black_box(&(&instruction, &infos, &seeds));

        Ok(())
    }
}

Dependencies

~16–24MB
~414K SLoC