Struct solana_program_runtime::invoke_context::InvokeContext

pub struct InvokeContext<'a> {
    pub sysvars: &'a [(Pubkey, Vec<u8>)],
    pub instruction_recorder: Option<&'a InstructionRecorder>,
    pub feature_set: Arc<FeatureSet>,
    pub timings: ExecuteDetailsTimings,
    pub blockhash: Hash,
    pub lamports_per_signature: u64,
    pub return_data: (Pubkey, Vec<u8>),
    // some fields omitted
}

Fields

sysvars: &'a [(Pubkey, Vec<u8>)]

instruction_recorder: Option<&'a InstructionRecorder>

feature_set: Arc<FeatureSet>

timings: ExecuteDetailsTimings

blockhash: Hash

lamports_per_signature: u64

return_data: (Pubkey, Vec<u8>)

Implementations

impl<'a> InvokeContext<'a>

pub fn new(
    rent: Rent,
    accounts: &'a [TransactionAccountRefCell],
    builtin_programs: &'a [BuiltinProgram],
    sysvars: &'a [(Pubkey, Vec<u8>)],
    log_collector: Option<Rc<RefCell<LogCollector>>>,
    compute_budget: ComputeBudget,
    executors: Rc<RefCell<Executors>>,
    feature_set: Arc<FeatureSet>,
    blockhash: Hash,
    lamports_per_signature: u64
) -> Self

pub fn new_mock(
    accounts: &'a [TransactionAccountRefCell],
    builtin_programs: &'a [BuiltinProgram]
) -> Self

pub fn push(
    &mut self,
    message: &Message,
    instruction: &CompiledInstruction,
    program_indices: &[usize],
    account_indices: &[usize]
) -> Result<(), InstructionError>

Push a stack frame onto the invocation stack

pub fn pop(&mut self)

Pop a stack frame from the invocation stack

pub fn invoke_depth(&self) -> usize

Current depth of the invocation stack

pub fn native_invoke(
    &mut self,
    instruction: Instruction,
    signers: &[Pubkey]
) -> Result<(), InstructionError>

Entrypoint for a cross-program invocation from a builtin program

pub fn create_message(
    &mut self,
    instruction: &Instruction,
    signers: &[Pubkey]
) -> Result<(Message, Vec<bool>, Vec<usize>), InstructionError>

Helper to prepare for process_instruction()

pub fn process_instruction(
    &mut self,
    message: &Message,
    instruction: &CompiledInstruction,
    program_indices: &[usize],
    account_indices: &[usize],
    caller_write_privileges: &[bool]
) -> Result<(), InstructionError>

Process a cross-program instruction

pub fn get_caller(&self) -> Result<&Pubkey, InstructionError>

Get the program ID of the currently executing program

pub fn get_loader(&self) -> Result<Pubkey, InstructionError>

Get the owner of the currently executing program

pub fn remove_first_keyed_account(&mut self) -> Result<(), InstructionError>

👎 Deprecated since 1.9.0:

To be removed together with remove_native_loader

Removes the first keyed account

pub fn get_keyed_accounts(
    &self
) -> Result<&[KeyedAccount<'_>], InstructionError>

Get the list of keyed accounts

pub fn get_instruction_keyed_accounts(
    &self
) -> Result<&[KeyedAccount<'_>], InstructionError>

Get the list of keyed accounts skipping first_instruction_account many entries

pub fn get_log_collector(&self) -> Option<Rc<RefCell<LogCollector>>>

Get this invocation’s LogCollector

pub fn get_compute_meter(&self) -> Rc<RefCell<ComputeMeter>>

Get this invocation’s ComputeMeter

pub fn add_executor(&self, pubkey: &Pubkey, executor: Arc<dyn Executor>)

Loaders may need to do work in order to execute a program. Cache the work that can be re-used across executions

pub fn get_executor(&self, pubkey: &Pubkey) -> Option<Arc<dyn Executor>>

Get the completed loader work that can be re-used across execution

pub fn get_account(
    &self,
    pubkey: &Pubkey
) -> Option<(usize, Rc<RefCell<AccountSharedData>>)>

Find an account_index and account by its key

pub fn get_compute_budget(&self) -> &ComputeBudget

Get this invocation’s compute budget

pub fn get_sysvar<T: Sysvar>(&self, id: &Pubkey) -> Result<T, InstructionError>

Get the value of a sysvar by its id