Class Invoke

Kick off (run) a PVM instance given the machine index and the destination memory (which contains gas and registers values).

https://graypaper.fluffylabs.dev/#/7e6ff6a/354301354301?v=0.6.7

Implements

HostCallHandler

Index

Constructors

Properties

basicGasCost currentServiceId index tracedRegisters

Methods

Constructors

constructor

new Invoke(refine: RefineExternalities): Invoke
Parameters
- refine: RefineExternalities
Returns Invoke
- Defined in packages/jam/jam-host-calls/refine/invoke.ts:45

Properties

basicGasCost

basicGasCost: number & WithBytesRepresentation<4> & WithOpaque<"SmallGas[U32]"> = ...

The gas cost of invocation of that host call.

NOTE: ((reg: HostCallRegisters) => Gas) function is for compatibility reasons: pre GP 0.7.2

currentServiceId

currentServiceId: number & WithBytesRepresentation<4> & WithOpaque<
"ServiceId[u32]",
> = CURRENT_SERVICE_ID

Currently executing service id.

index

index: number & WithBytesRepresentation<4> & WithOpaque<"HostCallIndex[U32]"> = ...

Index of that host call (i.e. what PVM invokes via ecalli)

tracedRegisters

tracedRegisters: (number & WithOpaque<"register index">)[] = ...

Input&Output registers that we should add to tracing log.

Methods

execute

execute(
    _gas: IGasCounter,
    regs: HostCallRegisters,
    memory: HostCallMemory,
): Promise<PvmExecution | undefined>
Actually execute the host call.

NOTE the call is ALLOWED and expected to modify registers and memory.
Parameters
- _gas: IGasCounter
- regs: HostCallRegisters
- memory: HostCallMemory
Returns Promise<PvmExecution | undefined>
Implementation of HostCallHandler.execute
- Defined in packages/jam/jam-host-calls/refine/invoke.ts:47