Struct core_processor::Ext

pub struct Ext {
    pub context: ProcessorContext,
    /* private fields */
}

Structure providing externalities for running host functions.

Fields

context: ProcessorContext

Processor context.

Implementations

impl Ext

pub fn alloc_inner<G: GrowHandler>( &mut self, pages_num: u32, mem: &mut impl Memory ) -> Result<WasmPage, AllocExtError>

Inner alloc realization.

pub fn into_ext_info_inner( self, memory: &impl Memory, pages_for_data: impl FnOnce(WasmPage, &BTreeSet<WasmPage>) -> Vec<GearPage> ) -> Result<ExtInfo, MemoryError>

Into ext info inner impl. pages_for_data returns vector of pages which data will be stored in info.

Trait Implementations

impl BackendExternalities for Ext

fn into_ext_info(self, memory: &impl Memory) -> Result<ExtInfo, MemoryError>

fn gas_amount(&self) -> GasAmount

fn pre_process_memory_accesses( _reads: &[MemoryInterval], _writes: &[MemoryInterval], _gas_left: &mut GasLeft ) -> Result<(), ProcessAccessError>

Pre-process memory access if need.

impl CountersOwner for Ext

fn charge_gas_runtime(&mut self, cost: RuntimeCosts) -> Result<(), ChargeError>

Charge for runtime api call.

fn charge_gas_runtime_if_enough( &mut self, cost: RuntimeCosts ) -> Result<(), ChargeError>

Charge for runtime api call if has enough of gas, else just returns error.

fn charge_gas_if_enough(&mut self, amount: u64) -> Result<(), ChargeError>

Charge gas if enough, else just returns error.

fn gas_left(&self) -> GasLeft

Returns gas limit and gas allowance left.

fn set_gas_left(&mut self, gas_left: GasLeft)

Set gas limit and gas allowance left.

impl Externalities for Ext

type UnrecoverableError = UnrecoverableExtError

An error issued in infallible sys-call.

type FallibleError = FallibleExtError

An error issued in fallible sys-call.

type AllocError = AllocExtError

An error issued during allocation.

fn alloc( &mut self, pages_num: u32, mem: &mut impl Memory ) -> Result<WasmPage, Self::AllocError>

Allocate number of pages.

fn free(&mut self, page: WasmPage) -> Result<(), Self::AllocError>

Free specific memory page.

fn block_height(&self) -> Result<u32, Self::UnrecoverableError>

Get the current block height.

fn block_timestamp(&self) -> Result<u64, Self::UnrecoverableError>

Get the current block timestamp.

fn send_init(&mut self) -> Result<u32, Self::FallibleError>

Initialize a new incomplete message for another program and return its handle.

fn send_push( &mut self, handle: u32, buffer: &[u8] ) -> Result<(), Self::FallibleError>

Push an extra buffer into message payload by handle.

fn send_push_input( &mut self, handle: u32, offset: u32, len: u32 ) -> Result<(), Self::FallibleError>

Push the incoming message buffer into message payload by handle.

fn send_commit( &mut self, handle: u32, msg: HandlePacket, delay: u32 ) -> Result<MessageId, Self::FallibleError>

Complete message and send it to another program.

fn reservation_send_commit( &mut self, id: ReservationId, handle: u32, msg: HandlePacket, delay: u32 ) -> Result<MessageId, Self::FallibleError>

Complete message and send it to another program using gas from reservation.

fn reply_push(&mut self, buffer: &[u8]) -> Result<(), Self::FallibleError>

Push an extra buffer into reply message.

fn reply_commit( &mut self, msg: ReplyPacket ) -> Result<MessageId, Self::FallibleError>

Complete reply message and send it to source program.

fn reservation_reply_commit( &mut self, id: ReservationId, msg: ReplyPacket ) -> Result<MessageId, Self::FallibleError>

Complete reply message and send it to source program from reservation.

fn reply_to(&self) -> Result<MessageId, Self::FallibleError>

Get the message id of the initial message.

fn signal_from(&self) -> Result<MessageId, Self::FallibleError>

Get the message id which signal issues from.

fn reply_push_input( &mut self, offset: u32, len: u32 ) -> Result<(), Self::FallibleError>

Push the incoming message buffer into reply message.

fn source(&self) -> Result<ProgramId, Self::UnrecoverableError>

Get the source of the message currently being handled.

fn reply_code(&self) -> Result<ReplyCode, Self::FallibleError>

Get the reply code if the message being processed.

fn signal_code(&self) -> Result<SignalCode, Self::FallibleError>

Get the signal code if the message being processed.

fn message_id(&self) -> Result<MessageId, Self::UnrecoverableError>

Get the id of the message currently being handled.

fn pay_program_rent( &mut self, program_id: ProgramId, rent: u128 ) -> Result<(u128, u32), Self::FallibleError>

Pay rent for the specified program.

fn program_id(&self) -> Result<ProgramId, Self::UnrecoverableError>

Get the id of program itself

fn debug(&self, data: &str) -> Result<(), Self::UnrecoverableError>

Send debug message.

fn lock_payload( &mut self, at: u32, len: u32 ) -> Result<PayloadSliceLock, Self::FallibleError>

Takes ownership over payload of the executing message and returns it in the wrapper PayloadSliceLock, which acts like lock.

fn unlock_payload( &mut self, payload_holder: &mut PayloadSliceLock ) -> UnlockPayloadBound

Reclaims ownership from the payload lock over previously taken payload from the currently executing message..

fn size(&self) -> Result<usize, Self::UnrecoverableError>

Size of currently handled message payload.

fn reserve_gas( &mut self, amount: u64, duration: u32 ) -> Result<ReservationId, Self::FallibleError>

Reserve some gas for a few blocks.

fn unreserve_gas( &mut self, id: ReservationId ) -> Result<u64, Self::FallibleError>

Unreserve gas using reservation ID.

fn system_reserve_gas(&mut self, amount: u64) -> Result<(), Self::FallibleError>

Do system reservation.

fn gas_available(&self) -> Result<u64, Self::UnrecoverableError>

Tell how much gas is left in running context.

fn value(&self) -> Result<u128, Self::UnrecoverableError>

Value associated with message.

fn value_available(&self) -> Result<u128, Self::UnrecoverableError>

Tell how much value is left in running context.

fn wait(&mut self) -> Result<(), Self::UnrecoverableError>

Interrupt the program and reschedule execution for maximum.

fn wait_for(&mut self, duration: u32) -> Result<(), Self::UnrecoverableError>

Interrupt the program and reschedule execution in duration.

fn wait_up_to( &mut self, duration: u32 ) -> Result<bool, Self::UnrecoverableError>

Interrupt the program and reschedule execution for maximum, but not more than duration.

fn wake( &mut self, waker_id: MessageId, delay: u32 ) -> Result<(), Self::FallibleError>

Wake the waiting message and move it to the processing queue.

fn create_program( &mut self, packet: InitPacket, delay: u32 ) -> Result<(MessageId, ProgramId), Self::FallibleError>

Send init message to create a new program.

fn reply_deposit( &mut self, message_id: MessageId, amount: u64 ) -> Result<(), Self::FallibleError>

Create deposit to handle reply on given message.

fn random(&self) -> Result<(&[u8], u32), Self::UnrecoverableError>

Returns a random seed for the current block with message id as a subject, along with the time in the past since when it was determinable by chain observers.

fn forbidden_funcs(&self) -> &BTreeSet<SysCallName>

Return the set of functions that are forbidden to be called.

fn send( &mut self, msg: HandlePacket, delay: u32 ) -> Result<MessageId, Self::FallibleError>

Send message to another program.

fn reservation_send( &mut self, id: ReservationId, msg: HandlePacket, delay: u32 ) -> Result<MessageId, Self::FallibleError>

Send message to another program using gas from reservation.

fn reply(&mut self, msg: ReplyPacket) -> Result<MessageId, Self::FallibleError>

Produce reply to the current message.

fn reservation_reply( &mut self, id: ReservationId, msg: ReplyPacket ) -> Result<MessageId, Self::FallibleError>

Produce reply to the current message from reservation.

impl ProcessorExternalities for Ext

Empty implementation for non-substrate (and non-lazy-pages) using

const LAZY_PAGES_ENABLED: bool = false

Whether this extension works with lazy pages.

fn new(context: ProcessorContext) -> Self

Create new

fn lazy_pages_init_for_program( _mem: &mut impl Memory, _prog_id: ProgramId, _stack_end: Option<WasmPage>, _globals_config: GlobalsAccessConfig, _lazy_pages_weights: LazyPagesWeights )

Protect and save storage keys for pages which has no data

fn lazy_pages_post_execution_actions(_mem: &mut impl Memory)

Lazy pages contract post execution actions

fn lazy_pages_status() -> Status

Returns lazy pages status