Class Pages

Manipulates memory pages by setting access rights (unreadable, readable, writable). Can preserve existing data or zero out the memory.

https://graypaper.fluffylabs.dev/#/1c979cb/349602349602?v=0.7.1

Implements

HostCallHandler

Index

Constructors

Properties

basicGasCost currentServiceId index tracedRegisters

Methods

Constructors

constructor

new Pages(refine: RefineExternalities): Pages
Parameters
- refine: RefineExternalities
Returns Pages
- Defined in packages/jam/jam-host-calls/refine/pages.ts:34

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,
): 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
Returns Promise<PvmExecution | undefined>
Implementation of HostCallHandler.execute
- Defined in packages/jam/jam-host-calls/refine/pages.ts:36