Struct ComputeBudget

pub struct ComputeBudget {

    pub compute_unit_limit: u64,
    pub log_64_units: u64,
    pub create_program_address_units: u64,
    pub invoke_units: u64,
    pub max_invoke_stack_height: usize,
    pub max_instruction_trace_length: usize,
    pub sha256_base_cost: u64,
    pub sha256_byte_cost: u64,
    pub sha256_max_slices: u64,
    pub max_call_depth: usize,
    pub stack_frame_size: usize,
    pub log_pubkey_units: u64,
    pub max_cpi_instruction_size: usize,
    pub cpi_bytes_per_unit: u64,
    pub sysvar_base_cost: u64,
    pub secp256k1_recover_cost: u64,
    pub syscall_base_cost: u64,
    pub curve25519_edwards_validate_point_cost: u64,
    pub curve25519_edwards_add_cost: u64,
    pub curve25519_edwards_subtract_cost: u64,
    pub curve25519_edwards_multiply_cost: u64,
    pub curve25519_edwards_msm_base_cost: u64,
    pub curve25519_edwards_msm_incremental_cost: u64,
    pub curve25519_ristretto_validate_point_cost: u64,
    pub curve25519_ristretto_add_cost: u64,
    pub curve25519_ristretto_subtract_cost: u64,
    pub curve25519_ristretto_multiply_cost: u64,
    pub curve25519_ristretto_msm_base_cost: u64,
    pub curve25519_ristretto_msm_incremental_cost: u64,
    pub heap_size: u32,
    pub heap_cost: u64,
    pub mem_op_base_cost: u64,
    pub alt_bn128_addition_cost: u64,
    pub alt_bn128_multiplication_cost: u64,
    pub alt_bn128_pairing_one_pair_cost_first: u64,
    pub alt_bn128_pairing_one_pair_cost_other: u64,
    pub big_modular_exponentiation_cost: u64,
    pub poseidon_cost_coefficient_a: u64,
    pub poseidon_cost_coefficient_c: u64,
    pub get_remaining_compute_units_cost: u64,
    pub alt_bn128_g1_compress: u64,
    pub alt_bn128_g1_decompress: u64,
    pub alt_bn128_g2_compress: u64,
    pub alt_bn128_g2_decompress: u64,
}

Fields

compute_unit_limit: u64

Number of compute units that a transaction or individual instruction is allowed to consume. Compute units are consumed by program execution, resources they use, etc…

log_64_units: u64

Number of compute units consumed by a log_u64 call

create_program_address_units: u64

Number of compute units consumed by a create_program_address call

invoke_units: u64

Number of compute units consumed by an invoke call (not including the cost incurred by the called program)

max_invoke_stack_height: usize

Maximum program instruction invocation stack height. Invocation stack height starts at 1 for transaction instructions and the stack height is incremented each time a program invokes an instruction and decremented when a program returns.

max_instruction_trace_length: usize

Maximum cross-program invocation and instructions per transaction

sha256_base_cost: u64

Base number of compute units consumed to call SHA256

sha256_byte_cost: u64

Incremental number of units consumed by SHA256 (based on bytes)

sha256_max_slices: u64

Maximum number of slices hashed per syscall

max_call_depth: usize

Maximum SBF to BPF call depth

stack_frame_size: usize

Size of a stack frame in bytes, must match the size specified in the LLVM SBF backend

log_pubkey_units: u64

Number of compute units consumed by logging a Pubkey

max_cpi_instruction_size: usize

Maximum cross-program invocation instruction size

cpi_bytes_per_unit: u64

Number of account data bytes per compute unit charged during a cross-program invocation

sysvar_base_cost: u64

Base number of compute units consumed to get a sysvar

secp256k1_recover_cost: u64

Number of compute units consumed to call secp256k1_recover

syscall_base_cost: u64

Number of compute units consumed to do a syscall without any work

curve25519_edwards_validate_point_cost: u64

Number of compute units consumed to validate a curve25519 edwards point

curve25519_edwards_add_cost: u64

Number of compute units consumed to add two curve25519 edwards points

curve25519_edwards_subtract_cost: u64

Number of compute units consumed to subtract two curve25519 edwards points

curve25519_edwards_multiply_cost: u64

Number of compute units consumed to multiply a curve25519 edwards point

curve25519_edwards_msm_base_cost: u64

Number of compute units consumed for a multiscalar multiplication (msm) of edwards points. The total cost is calculated as msm_base_cost + (length - 1) * msm_incremental_cost.

curve25519_edwards_msm_incremental_cost: u64

Number of compute units consumed for a multiscalar multiplication (msm) of edwards points. The total cost is calculated as msm_base_cost + (length - 1) * msm_incremental_cost.

curve25519_ristretto_validate_point_cost: u64

Number of compute units consumed to validate a curve25519 ristretto point

curve25519_ristretto_add_cost: u64

Number of compute units consumed to add two curve25519 ristretto points

curve25519_ristretto_subtract_cost: u64

Number of compute units consumed to subtract two curve25519 ristretto points

curve25519_ristretto_multiply_cost: u64

Number of compute units consumed to multiply a curve25519 ristretto point

curve25519_ristretto_msm_base_cost: u64

Number of compute units consumed for a multiscalar multiplication (msm) of ristretto points. The total cost is calculated as msm_base_cost + (length - 1) * msm_incremental_cost.

curve25519_ristretto_msm_incremental_cost: u64

Number of compute units consumed for a multiscalar multiplication (msm) of ristretto points. The total cost is calculated as msm_base_cost + (length - 1) * msm_incremental_cost.

heap_size: u32

program heap region size, default: solana_sdk::entrypoint::HEAP_LENGTH

heap_cost: u64

Number of compute units per additional 32k heap above the default (~.5 us per 32k at 15 units/us rounded up)

mem_op_base_cost: u64

Memory operation syscall base cost

alt_bn128_addition_cost: u64

Number of compute units consumed to call alt_bn128_addition

alt_bn128_multiplication_cost: u64

Number of compute units consumed to call alt_bn128_multiplication.

alt_bn128_pairing_one_pair_cost_first: u64

Total cost will be alt_bn128_pairing_one_pair_cost_first

• alt_bn128_pairing_one_pair_cost_other * (num_elems - 1)

alt_bn128_pairing_one_pair_cost_other: u64

big_modular_exponentiation_cost: u64

Big integer modular exponentiation cost

poseidon_cost_coefficient_a: u64

Coefficient a of the quadratic function which determines the number of compute units consumed to call poseidon syscall for a given number of inputs.

poseidon_cost_coefficient_c: u64

Coefficient c of the quadratic function which determines the number of compute units consumed to call poseidon syscall for a given number of inputs.

get_remaining_compute_units_cost: u64

Number of compute units consumed for accessing the remaining compute units.

alt_bn128_g1_compress: u64

Number of compute units consumed to call alt_bn128_g1_compress.

alt_bn128_g1_decompress: u64

Number of compute units consumed to call alt_bn128_g1_decompress.

alt_bn128_g2_compress: u64

Number of compute units consumed to call alt_bn128_g2_compress.

alt_bn128_g2_decompress: u64

Number of compute units consumed to call alt_bn128_g2_decompress.

Implementations

impl ComputeBudget

pub fn new(compute_unit_limit: u64) -> Self

pub fn try_from_instructions<'a>( instructions: impl Iterator<Item = (&'a Pubkey, &'a CompiledInstruction)>, ) -> Result<Self>

pub fn poseidon_cost(&self, nr_inputs: u64) -> Option<u64>

Returns cost of the Poseidon hash function for the given number of inputs is determined by the following quadratic function:

61*n^2 + 542

Which aproximates the results of benchmarks of light-posiedon library[0]. These results assume 1 CU per 33 ns. Examples:

• 1 input
  • light-poseidon benchmark: 18,303 / 33 ≈ 555
  • function: 61*1^2 + 542 = 603
• 2 inputs
  • light-poseidon benchmark: 25,866 / 33 ≈ 784
  • function: 61*2^2 + 542 = 786
• 3 inputs
  • light-poseidon benchmark: 37,549 / 33 ≈ 1,138
  • function; 61*3^2 + 542 = 1091

[0] https://github.com/Lightprotocol/light-poseidon#performance

Trait Implementations

impl AbiExample for ComputeBudget

fn example() -> Self

impl Clone for ComputeBudget

fn clone(&self) -> ComputeBudget

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ComputeBudget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ComputeBudget

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for ComputeBudget

fn eq(&self, other: &ComputeBudget) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ComputeBudget

impl Eq for ComputeBudget

impl StructuralPartialEq for ComputeBudget