Struct CuBudget 

pub struct CuBudget { /* private fields */ }

Compute-unit budget tracker.

On BPF, uses sol_log_compute_units() to read the remaining budget. Off-chain, all operations are no-ops that succeed.

Implementations

impl CuBudget

pub fn snapshot() -> Self

Take a snapshot of the current compute budget.

On BPF this calls sol_log_compute_units() and captures the remaining CU from the log output. On native (off-chain), the snapshot is 0 and all checks pass trivially.

pub fn checkpoint()

Log the current compute unit consumption for profiling.

Emits via sol_log_compute_units on BPF. Use this to instrument hot paths and identify CU bottlenecks.

pub fn require_remaining(&self, _min_remaining: u64) -> ProgramResult

Assert that at least min_remaining CU are available.

On BPF, this is a conservative check: the Solana runtime does not expose a “get remaining CU” syscall, so this method logs the current usage and returns Ok. The real enforcement is that the runtime itself will abort if CU is exhausted.

The value of this method is that it makes the CU concern VISIBLE in the code and provides a hook point for future runtime features that may expose remaining CU programmatically.

Off-chain, this always returns Ok.

pub fn log_delta(&self, label: &str)

Log CU consumed since the snapshot.

Emits a structured log that off-chain tools can parse. Format: "cu-delta: <label>"

Trait Implementations

impl Clone for CuBudget

fn clone(&self) -> CuBudget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CuBudget