Struct Context

pub struct Context<'env, 'pc, 'vm, 'state, 'linkage, 'gas> {
    pub env: &'env Env<'pc, 'vm, 'state, 'linkage>,
    pub metrics: Arc<LimitsMetrics>,
    pub native_extensions: NativeContextExtensions<'env>,
    pub tx_context: Rc<RefCell<TxContext>>,
    pub gas_charger: &'gas mut GasCharger,
    /* private fields */
}

Maintains all runtime state specific to programmable transactions

Fields

env: &'env Env<'pc, 'vm, 'state, 'linkage>

metrics: Arc<LimitsMetrics>

Metrics for reporting exceeded limits

native_extensions: NativeContextExtensions<'env>

tx_context: Rc<RefCell<TxContext>>

A shared transaction context, contains transaction digest information and manages the creation of new object IDs

gas_charger: &'gas mut GasCharger

The gas charger used for metering

Implementations

impl<'env, 'pc, 'vm, 'state, 'linkage, 'gas> Context<'env, 'pc, 'vm, 'state, 'linkage, 'gas>

pub fn new( env: &'env Env<'pc, 'vm, 'state, 'linkage>, metrics: Arc<LimitsMetrics>, tx_context: Rc<RefCell<TxContext>>, gas_charger: &'gas mut GasCharger, inputs: Inputs, ) -> Result<Self, ExecutionError>

where 'pc: 'state,

pub fn finish<Mode: ExecutionMode>( self, ) -> Result<ExecutionResults, ExecutionError>

pub fn object_runtime(&self) -> Result<&ObjectRuntime<'_>, ExecutionError>

pub fn take_user_events( &mut self, function: &LoadedFunction, ) -> Result<(), ExecutionError>

pub fn argument<V>(&mut self, arg: Argument) -> Result<V, ExecutionError>

where VMValue: VMValueCast<V>,

pub fn arguments<V>( &mut self, args: Vec<Argument>, ) -> Result<Vec<V>, ExecutionError>

where VMValue: VMValueCast<V>,

pub fn result(&mut self, result: Vec<CtxValue>) -> Result<(), ExecutionError>

pub fn copy_value( &mut self, value: &CtxValue, ) -> Result<CtxValue, ExecutionError>

pub fn new_coin(&mut self, amount: u64) -> Result<CtxValue, ExecutionError>

pub fn destroy_coin(&mut self, coin: CtxValue) -> Result<u64, ExecutionError>

pub fn new_upgrade_cap( &mut self, storage_id: ObjectID, ) -> Result<CtxValue, ExecutionError>

pub fn upgrade_receipt( &self, upgrade_ticket: UpgradeTicket, upgraded_package_id: ObjectID, ) -> CtxValue

pub fn vm_move_call( &mut self, function: LoadedFunction, args: Vec<CtxValue>, trace_builder_opt: Option<&mut MoveTraceBuilder>, ) -> Result<Vec<CtxValue>, ExecutionError>

pub fn execute_function_bypass_visibility( &mut self, storage_id: &ModuleId, function_name: &IdentStr, ty_args: &[Type], args: Vec<CtxValue>, linkage: &RootedLinkage, tracer: Option<&mut MoveTraceBuilder>, ) -> Result<Vec<CtxValue>, ExecutionError>

pub fn deserialize_modules( &mut self, module_bytes: &[Vec<u8>], is_upgrade: bool, ) -> Result<Vec<CompiledModule>, ExecutionError>

pub fn publish_and_init_package<Mode: ExecutionMode>( &mut self, modules: Vec<CompiledModule>, dep_ids: &[ObjectID], linkage: ResolvedLinkage, trace_builder_opt: Option<&mut MoveTraceBuilder>, ) -> Result<ObjectID, ExecutionError>

pub fn upgrade( &mut self, modules: Vec<CompiledModule>, dep_ids: &[ObjectID], current_package_id: ObjectID, upgrade_ticket_policy: u8, linkage: ResolvedLinkage, ) -> Result<ObjectID, ExecutionError>

pub fn transfer_object( &mut self, recipient: Owner, ty: Type, object: CtxValue, ) -> Result<(), ExecutionError>

pub fn location_updates( &mut self, args: Vec<(Location, Type)>, ) -> Result<Vec<(Argument, Vec<u8>, TypeTag)>, ExecutionError>

pub fn tracked_results( &self, results: &[CtxValue], result_tys: &ResultType, ) -> Result<Vec<(Vec<u8>, TypeTag)>, ExecutionError>