@typeberry/lib 0.5.10 → 0.5.11-1fbacf3

package/packages/core/pvm-interpreter/basic-blocks/basic-blocks.test.js

@@ -7,7 +7,7 @@ import { BasicBlocks } from "./basic-blocks.js";
 describe("BasicBlocks", () => {
     it("should return true for the first instruction even it is a termination block instruction", () => {
         const code = new Uint8Array([Instruction.TRAP]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0000_0001]), code.length));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0000_0001]), code.length));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const index = 0;
@@ -16,7 +16,7 @@ describe("BasicBlocks", () => {
     });
     it("should return true for the first instruction after a termination block instruction", () => {
         const code = new Uint8Array([Instruction.TRAP, Instruction.ADD_32, 5, 7]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0000_0011]), code.length));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0000_0011]), code.length));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const index = 1;
@@ -25,7 +25,7 @@ describe("BasicBlocks", () => {
     });
     it("should return false for the second instruction after a termination block instruction", () => {
         const code = new Uint8Array([Instruction.TRAP, Instruction.ADD_32, 5, 7, Instruction.SUB_32, 5, 7]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0001_0011]), code.length));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0001_0011]), code.length));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const index = 4;
@@ -34,7 +34,7 @@ describe("BasicBlocks", () => {
     });
     it("should return false for a termination block instruction that is not the first instruction in the program", () => {
         const code = new Uint8Array([Instruction.TRAP, Instruction.ADD_32, 5, 7, Instruction.TRAP]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0001_0011]), code.length));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0001_0011]), code.length));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const index = 4;
@@ -43,7 +43,7 @@ describe("BasicBlocks", () => {
     });
     it("should return true for a beginning of basic block instruction that is not the first instruction after a block termination instruction that has some args", () => {
         const code = new Uint8Array([Instruction.BRANCH_EQ, 135, 25, Instruction.ADD_32, 5, 7, Instruction.TRAP]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0100_1001]), code.length));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0100_1001]), code.length));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const index = 3;
@@ -52,7 +52,7 @@ describe("BasicBlocks", () => {
     });
     it("should return true for a termination block instruction that is the after a termination instruction", () => {
         const code = new Uint8Array([Instruction.TRAP, Instruction.TRAP]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0000_0011]), code.length));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0000_0011]), code.length));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const index = 1;
@@ -61,7 +61,7 @@ describe("BasicBlocks", () => {
     });
     it("should return false for a negative number", () => {
         const code = new Uint8Array([Instruction.TRAP, Instruction.TRAP]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0000_0011]), code.length));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0000_0011]), code.length));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const index = -1;
@@ -103,7 +103,7 @@ describe("BasicBlocks", () => {
             0,
             Instruction.JUMP_IND,
         ]);
-        const mask = new Mask(BitVec.fromBlob(new Uint8Array([0b0000_0001, 0b0000_0000, 0b0000_0000, 0b1000_0000]), 32));
+        const mask = Mask.new(BitVec.fromBlob(new Uint8Array([0b0000_0001, 0b0000_0000, 0b0000_0000, 0b1000_0000]), 32));
         const basicBlocks = new BasicBlocks();
         basicBlocks.reset(code, mask);
         const expectedStartingBasicBlockIndices = [0, 26];

package/packages/core/pvm-interpreter/bin.js

@@ -4,7 +4,7 @@ const program = new Uint8Array([
     0, 0, 33, 51, 8, 1, 51, 9, 1, 40, 3, 0, 149, 119, 255, 81, 7, 12, 100, 138, 200, 152, 8, 100, 169, 40, 243, 100, 135,
     51, 8, 51, 9, 1, 50, 0, 73, 147, 82, 213, 0,
 ]);
-const pvm = new Interpreter();
+const pvm = Interpreter.new();
 pvm.resetGeneric(program, 0, tryAsGas(1000));
 // biome-ignore lint/suspicious/noConsole: We do want to print that.
 console.table(pvm.dumpProgram());

package/packages/core/pvm-interpreter/debugger-adapter.d.ts

@@ -3,7 +3,8 @@ import { type Memory } from "./memory/index.js";
 import { Registers } from "./registers.js";
 export declare class DebuggerAdapter {
     private readonly pvm;
-    constructor(useSbrkGas?: boolean);
+    static new(useSbrkGas?: boolean): DebuggerAdapter;
+    private constructor();
     resetJAM(jamProgram: Uint8Array, pc: number, gas: bigint, args: Uint8Array, hasMetadata?: boolean): void;
     resetGeneric(rawProgram: Uint8Array, flatRegisters: Uint8Array, initialGas: bigint): void;
     reset(rawProgram: Uint8Array, pc: number, gas: bigint, maybeRegisters?: Registers, maybeMemory?: Memory): void;

package/packages/core/pvm-interpreter/debugger-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debugger-adapter.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter/debugger-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEtB,UAAU,UAAQ;IAI9B,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,UAAQ;IAI/F,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM;IAIlF,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM;IAIvG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU;IAmBlD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAI5C,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,OAAO;IAInB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAW9B,YAAY,IAAI,UAAU;IAI1B,YAAY,CAAC,SAAS,EAAE,UAAU;IAIlC,iBAAiB,IAAI,MAAM;IAI3B,qBAAqB,CAAC,MAAM,EAAE,MAAM;IAIpC,UAAU,IAAI,MAAM;IAIpB,UAAU,CAAC,GAAG,EAAE,MAAM;CAGvB"}
+{"version":3,"file":"debugger-adapter.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter/debugger-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAElC,MAAM,CAAC,GAAG,CAAC,UAAU,UAAQ;IAI7B,OAAO;IAIP,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,UAAQ;IAI/F,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM;IAIlF,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM;IAIvG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU;IAmBlD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAI5C,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,OAAO;IAInB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAW9B,YAAY,IAAI,UAAU;IAI1B,YAAY,CAAC,SAAS,EAAE,UAAU;IAIlC,iBAAiB,IAAI,MAAM;IAI3B,qBAAqB,CAAC,MAAM,EAAE,MAAM;IAIpC,UAAU,IAAI,MAAM;IAIpB,UAAU,CAAC,GAAG,EAAE,MAAM;CAGvB"}

package/packages/core/pvm-interpreter/debugger-adapter.js

@@ -6,14 +6,17 @@ import { PAGE_SIZE } from "./memory/memory-consts.js";
 import { Registers } from "./registers.js";
 export class DebuggerAdapter {
     pvm;
+    static new(useSbrkGas = false) {
+        return new DebuggerAdapter(useSbrkGas);
+    }
     constructor(useSbrkGas = false) {
-        this.pvm = new Interpreter({ useSbrkGas });
+        this.pvm = Interpreter.new({ useSbrkGas });
     }
     resetJAM(jamProgram, pc, gas, args, hasMetadata = false) {
         this.pvm.resetJam(jamProgram, args, pc, tryAsGas(gas), hasMetadata);
     }
     resetGeneric(rawProgram, flatRegisters, initialGas) {
-        this.pvm.resetGeneric(rawProgram, 0, tryAsGas(initialGas), new Registers(flatRegisters));
+        this.pvm.resetGeneric(rawProgram, 0, tryAsGas(initialGas), Registers.fromBytes(flatRegisters));
     }
     reset(rawProgram, pc, gas, maybeRegisters, maybeMemory) {
         this.pvm.resetGeneric(rawProgram, pc, tryAsGas(gas), maybeRegisters, maybeMemory);
@@ -59,7 +62,7 @@ export class DebuggerAdapter {
         return this.pvm.registers.getAllEncoded();
     }
     setRegisters(registers) {
-        this.pvm.registers.copyFrom(new Registers(registers));
+        this.pvm.registers.copyFrom(Registers.fromBytes(registers));
     }
     getProgramCounter() {
         return this.pvm.getPC();

package/packages/core/pvm-interpreter/gas.js

@@ -2,11 +2,14 @@ import { tryAsU64 } from "#@typeberry/numbers";
 import { tryAsGas } from "#@typeberry/pvm-interface";
 /** Create a new gas counter instance depending on the gas value. */
 export function gasCounter(gas) {
-    return new GasCounterU64(tryAsU64(gas));
+    return GasCounterU64.new(tryAsU64(gas));
 }
 class GasCounterU64 {
     gas;
     initialGas;
+    static new(gas) {
+        return new GasCounterU64(gas);
+    }
     constructor(gas) {
         this.gas = gas;
         this.initialGas = tryAsGas(gas);

package/packages/core/pvm-interpreter/interpreter.d.ts

@@ -32,7 +32,8 @@ export declare class Interpreter implements IPvmInterpreter {
     private argsDecodingResults;
     private basicBlocks;
     private jumpTable;
-    constructor({ useSbrkGas }?: InterpreterOptions);
+    static new(options?: InterpreterOptions): Interpreter;
+    private constructor();
     resetJam(program: Uint8Array, args: Uint8Array, pc: number, gas: Gas, hasMetadata?: boolean): void;
     resetGeneric(rawProgram: Uint8Array, pc: number, gas: Gas, maybeRegisters?: Registers, maybeMemory?: Memory): void;
     dumpProgram(): (string | number)[][];

package/packages/core/pvm-interpreter/interpreter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter/interpreter.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,eAAe,EAAE,MAAM,EAAY,MAAM,0BAA0B,CAAC;AAW5F,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAsC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,KAAK,kBAAkB,GAAG;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAIF,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,QAAQ,CAAC,SAAS,YAAmB;IACrC,QAAQ,CAAC,MAAM,SAAgB;IAC/B,GAAG,iDAA2B;IAC9B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,uBAAuB,CAA0B;IACzD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,+BAA+B,CAAkC;IACzE,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,uBAAuB,CAA0B;IACzD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,wBAAwB,CAA2B;IAC3D,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,yBAAyB,CAA4B;IAC7D,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,mBAAmB,CAAmB;IAC9C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAqB;gBAE1B,EAAE,UAAkB,EAAE,GAAE,kBAAuB;IA0C3D,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,UAAO;IAKxF,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM;IA0B3G,WAAW;IAIX,UAAU;IAIV,QAAQ;IAgHR,KAAK;IAIL,SAAS,CAAC,MAAM,EAAE,MAAM;IAIxB,SAAS;IAIT,YAAY,IAAI,IAAI,GAAG,GAAG;IAK1B,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU;IAIpD,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAsB7C"}
+{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter/interpreter.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,eAAe,EAAE,MAAM,EAAY,MAAM,0BAA0B,CAAC;AAW5F,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAsC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,KAAK,kBAAkB,GAAG;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAIF,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,QAAQ,CAAC,SAAS,YAAqB;IACvC,QAAQ,CAAC,MAAM,SAAgB;IAC/B,GAAG,iDAA2B;IAC9B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,uBAAuB,CAA0B;IACzD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,+BAA+B,CAAkC;IACzE,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,uBAAuB,CAA0B;IACzD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,wBAAwB,CAA2B;IAC3D,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,yBAAyB,CAA4B;IAC7D,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,mBAAmB,CAAmB;IAC9C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAqB;IAEtC,MAAM,CAAC,GAAG,CAAC,OAAO,GAAE,kBAAuB;IAI3C,OAAO;IA0CP,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,UAAO;IAKxF,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM;IA0B3G,WAAW;IAIX,UAAU;IAIV,QAAQ;IAgHR,KAAK;IAIL,SAAS,CAAC,MAAM,EAAE,MAAM;IAIxB,SAAS;IAIT,YAAY,IAAI,IAAI,GAAG,GAAG;IAK1B,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU;IAIpD,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAsB7C"}

package/packages/core/pvm-interpreter/interpreter.js

@@ -26,8 +26,8 @@ import { Result } from "./result.js";
 const logger = Logger.new(import.meta.filename, "pvm");
 export class Interpreter {
     useSbrkGas;
-    registers = new Registers();
-    memory = new Memory();
+    registers = Registers.empty();
+    memory = Memory.new();
     gas = gasCounter(tryAsGas(0));
     code = new Uint8Array();
     mask = Mask.empty();
@@ -51,23 +51,26 @@ export class Interpreter {
     argsDecodingResults = createResults();
     basicBlocks;
     jumpTable = JumpTable.empty();
+    static new(options = {}) {
+        return new Interpreter(options);
+    }
     constructor({ useSbrkGas = false } = {}) {
         this.useSbrkGas = useSbrkGas;
         this.argsDecoder = new ArgsDecoder();
         this.basicBlocks = new BasicBlocks();
-        const mathOps = new MathOps(this.registers);
-        const shiftOps = new ShiftOps(this.registers);
-        const bitOps = new BitOps(this.registers);
-        const booleanOps = new BooleanOps(this.registers);
-        const moveOps = new MoveOps(this.registers);
-        const branchOps = new BranchOps(this.registers, this.instructionResult, this.basicBlocks);
-        const loadOps = new LoadOps(this.registers, this.memory, this.instructionResult);
-        const storeOps = new StoreOps(this.registers, this.memory, this.instructionResult);
-        const noArgsOps = new NoArgsOps(this.instructionResult);
-        const dynamicJumpOps = new DynamicJumpOps(this.registers, this.jumpTable, this.instructionResult, this.basicBlocks);
-        const hostCallOps = new HostCallOps(this.instructionResult);
-        const memoryOps = new MemoryOps(this.registers, this.memory, this.instructionResult);
-        const bitRotationOps = new BitRotationOps(this.registers);
+        const mathOps = MathOps.new(this.registers);
+        const shiftOps = ShiftOps.new(this.registers);
+        const bitOps = BitOps.new(this.registers);
+        const booleanOps = BooleanOps.new(this.registers);
+        const moveOps = MoveOps.new(this.registers);
+        const branchOps = BranchOps.new(this.registers, this.instructionResult, this.basicBlocks);
+        const loadOps = LoadOps.new(this.registers, this.memory, this.instructionResult);
+        const storeOps = StoreOps.new(this.registers, this.memory, this.instructionResult);
+        const noArgsOps = NoArgsOps.new(this.instructionResult);
+        const dynamicJumpOps = DynamicJumpOps.new(this.registers, this.jumpTable, this.instructionResult, this.basicBlocks);
+        const hostCallOps = HostCallOps.new(this.instructionResult);
+        const memoryOps = MemoryOps.new(this.registers, this.memory, this.instructionResult);
+        const bitRotationOps = BitRotationOps.new(this.registers);
         this.threeRegsDispatcher = new ThreeRegsDispatcher(mathOps, shiftOps, bitOps, booleanOps, moveOps, bitRotationOps);
         this.twoRegsOneImmDispatcher = new TwoRegsOneImmDispatcher(mathOps, shiftOps, bitOps, booleanOps, moveOps, storeOps, loadOps, bitRotationOps);
         this.twoRegsDispatcher = new TwoRegsDispatcher(moveOps, memoryOps, bitOps, bitRotationOps);
@@ -87,7 +90,7 @@ export class Interpreter {
         this.resetGeneric(p.code, pc, gas, p.registers, p.memory);
     }
     resetGeneric(rawProgram, pc, gas, maybeRegisters, maybeMemory) {
-        const programDecoder = new ProgramDecoder(rawProgram);
+        const programDecoder = ProgramDecoder.new(rawProgram);
         this.code = programDecoder.getCode();
         this.mask = programDecoder.getMask();
         this.jumpTable.copyFrom(programDecoder.getJumpTable());

package/packages/core/pvm-interpreter/memory/memory-builder.js

@@ -44,7 +44,7 @@ export class MemoryBuilder {
         for (let i = 0; i < noOfPages; i++) {
             const pageNumber = pages[i];
             const dataChunk = data.subarray(i * PAGE_SIZE, (i + 1) * PAGE_SIZE);
-            const page = new ReadablePage(pageNumber, dataChunk);
+            const page = ReadablePage.new(pageNumber, dataChunk);
             this.initialMemory.set(pageNumber, page);
         }
         return this;
@@ -72,7 +72,7 @@ export class MemoryBuilder {
         for (let i = 0; i < noOfPages; i++) {
             const pageNumber = pages[i];
             const dataChunk = data.subarray(i * PAGE_SIZE, (i + 1) * PAGE_SIZE);
-            const page = new WriteablePage(pageNumber, dataChunk);
+            const page = WriteablePage.new(pageNumber, dataChunk);
             this.initialMemory.set(pageNumber, page);
         }
         return this;

package/packages/core/pvm-interpreter/memory/memory-builder.test.js

@@ -12,8 +12,8 @@ describe("MemoryBuilder", () => {
         it("should work correctly (happy path)", () => {
             const builder = new MemoryBuilder();
             const pageMap = new Map();
-            pageMap.set(RESERVED_NUMBER_OF_PAGES, new ReadablePage(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES), new Uint8Array()));
-            pageMap.set(RESERVED_NUMBER_OF_PAGES + 1, new WriteablePage(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1), new Uint8Array()));
+            pageMap.set(RESERVED_NUMBER_OF_PAGES, ReadablePage.new(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES), new Uint8Array()));
+            pageMap.set(RESERVED_NUMBER_OF_PAGES + 1, WriteablePage.new(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1), new Uint8Array()));
             const expectedMemory = {
                 endHeapIndex: (RESERVED_NUMBER_OF_PAGES + 4) * PAGE_SIZE,
                 sbrkIndex: (RESERVED_NUMBER_OF_PAGES + 2) * PAGE_SIZE,
@@ -53,7 +53,7 @@ describe("MemoryBuilder", () => {
         it("should add readable page", () => {
             const builder = new MemoryBuilder();
             const pageMap = new Map();
-            pageMap.set(RESERVED_NUMBER_OF_PAGES, new ReadablePage(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES), new Uint8Array()));
+            pageMap.set(RESERVED_NUMBER_OF_PAGES, ReadablePage.new(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES), new Uint8Array()));
             const expectedMemory = {
                 endHeapIndex: (RESERVED_NUMBER_OF_PAGES + 3) * PAGE_SIZE,
                 sbrkIndex: (RESERVED_NUMBER_OF_PAGES + 2) * PAGE_SIZE,
@@ -68,7 +68,7 @@ describe("MemoryBuilder", () => {
         it("should add writeable page", () => {
             const builder = new MemoryBuilder();
             const pageMap = new Map();
-            pageMap.set(RESERVED_NUMBER_OF_PAGES + 2, new WriteablePage(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 2), new Uint8Array()));
+            pageMap.set(RESERVED_NUMBER_OF_PAGES + 2, WriteablePage.new(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 2), new Uint8Array()));
             const expectedMemory = {
                 endHeapIndex: (RESERVED_NUMBER_OF_PAGES + 4) * PAGE_SIZE,
                 sbrkIndex: (RESERVED_NUMBER_OF_PAGES + 3) * PAGE_SIZE,
@@ -83,8 +83,8 @@ describe("MemoryBuilder", () => {
         it("should add two pages", () => {
             const builder = new MemoryBuilder();
             const pageMap = new Map();
-            pageMap.set(RESERVED_NUMBER_OF_PAGES, new ReadablePage(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES), new Uint8Array()));
-            pageMap.set(RESERVED_NUMBER_OF_PAGES + 1, new WriteablePage(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1), new Uint8Array()));
+            pageMap.set(RESERVED_NUMBER_OF_PAGES, ReadablePage.new(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES), new Uint8Array()));
+            pageMap.set(RESERVED_NUMBER_OF_PAGES + 1, WriteablePage.new(tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1), new Uint8Array()));
             const expectedMemory = {
                 endHeapIndex: (RESERVED_NUMBER_OF_PAGES + 4) * PAGE_SIZE,
                 sbrkIndex: (RESERVED_NUMBER_OF_PAGES + 2) * PAGE_SIZE,
@@ -105,7 +105,7 @@ describe("MemoryBuilder", () => {
             const data = new Uint8Array(PAGE_SIZE).fill(1);
             const pageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const address = tryAsMemoryIndex(pageNumber * PAGE_SIZE);
-            pageMap.set(pageNumber, new WriteablePage(pageNumber, data));
+            pageMap.set(pageNumber, WriteablePage.new(pageNumber, data));
             const expectedMemory = {
                 endHeapIndex: (RESERVED_NUMBER_OF_PAGES + 4) * PAGE_SIZE,
                 sbrkIndex: (RESERVED_NUMBER_OF_PAGES + 2) * PAGE_SIZE,

package/packages/core/pvm-interpreter/memory/memory.d.ts

@@ -16,7 +16,8 @@ export declare class Memory implements IMemory {
     private endHeapIndex;
     private memory;
     static fromInitialMemory(initialMemoryState: InitialMemoryState): Memory;
-    constructor(sbrkIndex?: number & import("@typeberry/utils").WithOpaque<"sbrk index">, virtualSbrkIndex?: number & import("@typeberry/utils").WithOpaque<"sbrk index">, endHeapIndex?: number & import("@typeberry/utils").WithOpaque<"sbrk index">, memory?: Map<number & import("@typeberry/utils").WithOpaque<"memory page number">, MemoryPage>);
+    static new(sbrkIndex?: number & import("@typeberry/utils").WithOpaque<"sbrk index">, virtualSbrkIndex?: number & import("@typeberry/utils").WithOpaque<"sbrk index">, endHeapIndex?: number & import("@typeberry/utils").WithOpaque<"sbrk index">, memory?: Map<number & import("@typeberry/utils").WithOpaque<"memory page number">, MemoryPage>): Memory;
+    private constructor();
     store(address: U32, bytes: Uint8Array): Result<OK, InretpreterPageFault>;
     read(address: U32, output: Uint8Array): Result<OK, InretpreterPageFault>;
     reset(): void;

package/packages/core/pvm-interpreter/memory/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/memory/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,IAAI,oBAAoB,EAAoB,MAAM,0BAA0B,CAAC;AAClH,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAe,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAKvG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,uBAAuB,CAAC;AAExE,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,SAAS,CAAC;CACzB,CAAC;AASF,qBAAa,MAAO,YAAW,OAAO;IAWlC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;IAbhB,MAAM,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,kBAAkB;gBAUrD,SAAS,+DAA4C,EACrD,gBAAgB,+DAA4C,EAC5D,YAAY,+DAAmC,EAC/C,MAAM,wFAAoC;IAGpD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAIxE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAIxE,KAAK;IAOL,QAAQ,CAAC,MAAM,EAAE,MAAM;IAOvB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IA8BzE,OAAO,CAAC,QAAQ;IAoChB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAgC9E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAkC/B,WAAW,CAAC,UAAU,EAAE,UAAU;IAKlC,aAAa;CAGd"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/memory/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,IAAI,oBAAoB,EAAoB,MAAM,0BAA0B,CAAC;AAClH,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAe,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAKvG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,uBAAuB,CAAC;AAExE,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,SAAS,CAAC;CACzB,CAAC;AASF,qBAAa,MAAO,YAAW,OAAO;IAoBlC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;IAtBhB,MAAM,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,kBAAkB;IAS/D,MAAM,CAAC,GAAG,CACR,SAAS,+DAA4C,EACrD,gBAAgB,+DAA4C,EAC5D,YAAY,+DAAmC,EAC/C,MAAM,wFAAoC;IAK5C,OAAO;IAOP,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAIxE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAIxE,KAAK;IAOL,QAAQ,CAAC,MAAM,EAAE,MAAM;IAOvB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IA8BzE,OAAO,CAAC,QAAQ;IAoChB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAgC9E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAkC/B,WAAW,CAAC,UAAU,EAAE,UAAU;IAKlC,aAAa;CAGd"}

package/packages/core/pvm-interpreter/memory/memory.js

@@ -24,6 +24,9 @@ export class Memory {
     static fromInitialMemory(initialMemoryState) {
         return new Memory(initialMemoryState?.sbrkIndex, initialMemoryState?.sbrkIndex, initialMemoryState?.endHeapIndex, initialMemoryState?.memory);
     }
+    static new(sbrkIndex = tryAsSbrkIndex(RESERVED_MEMORY_RANGE.end), virtualSbrkIndex = tryAsSbrkIndex(RESERVED_MEMORY_RANGE.end), endHeapIndex = tryAsSbrkIndex(MAX_MEMORY_INDEX), memory = new Map()) {
+        return new Memory(sbrkIndex, virtualSbrkIndex, endHeapIndex, memory);
+    }
     constructor(sbrkIndex = tryAsSbrkIndex(RESERVED_MEMORY_RANGE.end), virtualSbrkIndex = tryAsSbrkIndex(RESERVED_MEMORY_RANGE.end), endHeapIndex = tryAsSbrkIndex(MAX_MEMORY_INDEX), memory = new Map()) {
         this.sbrkIndex = sbrkIndex;
         this.virtualSbrkIndex = virtualSbrkIndex;
@@ -142,7 +145,7 @@ export class Memory {
         const pagesToAllocate = (newSbrkIndex - currentSbrkIndex) / PAGE_SIZE;
         const rangeToAllocate = PageRange.fromStartAndLength(firstPageNumber, pagesToAllocate);
         for (const pageNumber of rangeToAllocate) {
-            const page = new WriteablePage(pageNumber);
+            const page = WriteablePage.new(pageNumber);
             this.memory.set(pageNumber, page);
         }
         this.virtualSbrkIndex = newVirtualSbrkIndex;

package/packages/core/pvm-interpreter/memory/memory.test.js

@@ -11,7 +11,7 @@ import { tryAsPageNumber } from "./pages/page-utils.js";
 describe("Memory", () => {
     describe("loadInto", () => {
         it("should return PageFault if the page does not exist", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const lengthToLoad = 4;
             const result = new Uint8Array(lengthToLoad);
             const addressToLoad = tryAsMemoryIndex(1 + RESERVED_NUMBER_OF_PAGES * PAGE_SIZE);
@@ -21,7 +21,7 @@ describe("Memory", () => {
         it("should correctly load data from one page", () => {
             const pageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const bytes = new Uint8Array([1, 2, 3, 4, 5]);
-            const page = new ReadablePage(pageNumber, bytes);
+            const page = ReadablePage.new(pageNumber, bytes);
             const memoryMap = new Map();
             memoryMap.set(pageNumber, page);
             const sbrkIndex = tryAsSbrkIndex(20 * PAGE_SIZE);
@@ -39,8 +39,8 @@ describe("Memory", () => {
             const firstPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const secondPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1);
             const bytes = new Uint8Array([1, 2, 3, 4, 5]);
-            const firstPage = new ReadablePage(firstPageNumber, new Uint8Array([...new Uint8Array(PAGE_SIZE - bytes.length), ...bytes]));
-            const secondPage = new ReadablePage(secondPageNumber, bytes);
+            const firstPage = ReadablePage.new(firstPageNumber, new Uint8Array([...new Uint8Array(PAGE_SIZE - bytes.length), ...bytes]));
+            const secondPage = ReadablePage.new(secondPageNumber, bytes);
             const memoryMap = new Map();
             memoryMap.set(firstPageNumber, firstPage);
             memoryMap.set(secondPageNumber, secondPage);
@@ -58,7 +58,7 @@ describe("Memory", () => {
         it("should return PageFault if case of loading data from 2 pages but one of them does not exist", () => {
             const pageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const bytes = new Uint8Array();
-            const page = new ReadablePage(pageNumber, bytes);
+            const page = ReadablePage.new(pageNumber, bytes);
             const memoryMap = new Map();
             memoryMap.set(pageNumber, page);
             const sbrkIndex = tryAsSbrkIndex(0);
@@ -74,8 +74,8 @@ describe("Memory", () => {
             const firstPageNumber = tryAsPageNumber((MAX_MEMORY_INDEX - PAGE_SIZE + 1) / PAGE_SIZE);
             const secondPageNumber = tryAsPageNumber(0);
             const bytes = new Uint8Array([1, 2, 3, 4, 5]);
-            const firstPage = new ReadablePage(firstPageNumber, new Uint8Array([...new Uint8Array(PAGE_SIZE - bytes.length), ...bytes]));
-            const secondPage = new ReadablePage(secondPageNumber, new Uint8Array([...bytes, ...new Uint8Array(PAGE_SIZE - bytes.length)]));
+            const firstPage = ReadablePage.new(firstPageNumber, new Uint8Array([...new Uint8Array(PAGE_SIZE - bytes.length), ...bytes]));
+            const secondPage = ReadablePage.new(secondPageNumber, new Uint8Array([...bytes, ...new Uint8Array(PAGE_SIZE - bytes.length)]));
             const memoryMap = new Map();
             memoryMap.set(firstPageNumber, firstPage);
             memoryMap.set(secondPageNumber, secondPage);
@@ -93,27 +93,27 @@ describe("Memory", () => {
     });
     describe("storeFrom", () => {
         it("should return PageFault if the page does not exist", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const addressToStore = tryAsMemoryIndex(RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + 1);
             const dataToStore = new Uint8Array([1, 2, 3, 4]);
             const storeResult = memory.storeFrom(addressToStore, dataToStore);
             deepEqual(storeResult, Result.error(PageFault.fromMemoryIndex(addressToStore), () => "Page fault: page 16 not allocated"));
         });
         it("should not return PageFault if the page does not exist and stored array length is 0 (standard page)", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const addressToStore = tryAsMemoryIndex(RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + 1);
             const storeResult = memory.storeFrom(addressToStore, new Uint8Array());
             assert.deepStrictEqual(storeResult, Result.ok(OK));
         });
         it("should not return PageFault if the page does not exist and stored array length is 0 - even it is a reserved page", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const addressToStore = tryAsMemoryIndex(1);
             const storeResult = memory.storeFrom(addressToStore, new Uint8Array());
             assert.deepStrictEqual(storeResult, Result.ok(OK));
         });
         it("should correctly store data on one page", () => {
             const pageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
-            const page = new WriteablePage(pageNumber, new Uint8Array());
+            const page = WriteablePage.new(pageNumber, new Uint8Array());
             const memoryMap = new Map();
             const sbrkIndex = tryAsSbrkIndex((RESERVED_NUMBER_OF_PAGES + 4) * PAGE_SIZE);
             const endHeapIndex = tryAsSbrkIndex(MAX_MEMORY_INDEX);
@@ -122,7 +122,7 @@ describe("Memory", () => {
             const dataToStore = new Uint8Array([1, 2, 3, 4]);
             const addressToStore = tryAsMemoryIndex(RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + 1);
             const expectedMemoryMap = new Map();
-            expectedMemoryMap.set(pageNumber, new WriteablePage(pageNumber, new Uint8Array([0, ...dataToStore, ...new Uint8Array(MIN_ALLOCATION_LENGTH - dataToStore.length - 1)])));
+            expectedMemoryMap.set(pageNumber, WriteablePage.new(pageNumber, new Uint8Array([0, ...dataToStore, ...new Uint8Array(MIN_ALLOCATION_LENGTH - dataToStore.length - 1)])));
             const expectedMemory = {
                 sbrkIndex,
                 virtualSbrkIndex: sbrkIndex,
@@ -136,8 +136,8 @@ describe("Memory", () => {
         it("should correctly store data on two pages", () => {
             const firstPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const secondPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1);
-            const firstPage = new WriteablePage(firstPageNumber, new Uint8Array(PAGE_SIZE));
-            const secondPage = new WriteablePage(secondPageNumber, new Uint8Array());
+            const firstPage = WriteablePage.new(firstPageNumber, new Uint8Array(PAGE_SIZE));
+            const secondPage = WriteablePage.new(secondPageNumber, new Uint8Array());
             const memoryMap = new Map();
             const sbrkIndex = tryAsSbrkIndex(20 * PAGE_SIZE);
             const endHeapIndex = tryAsSbrkIndex(MAX_MEMORY_INDEX);
@@ -147,8 +147,8 @@ describe("Memory", () => {
             const dataToStore = new Uint8Array([1, 2, 3, 4]);
             const addressToStore = tryAsMemoryIndex(17 * PAGE_SIZE - 2);
             const expectedMemoryMap = new Map();
-            expectedMemoryMap.set(firstPageNumber, new WriteablePage(firstPageNumber, new Uint8Array([...new Uint8Array(PAGE_SIZE - 2), 1, 2])));
-            expectedMemoryMap.set(secondPageNumber, new WriteablePage(secondPageNumber, new Uint8Array([3, 4, ...new Uint8Array(MIN_ALLOCATION_LENGTH - 2)])));
+            expectedMemoryMap.set(firstPageNumber, WriteablePage.new(firstPageNumber, new Uint8Array([...new Uint8Array(PAGE_SIZE - 2), 1, 2])));
+            expectedMemoryMap.set(secondPageNumber, WriteablePage.new(secondPageNumber, new Uint8Array([3, 4, ...new Uint8Array(MIN_ALLOCATION_LENGTH - 2)])));
             const expectedMemory = {
                 sbrkIndex,
                 virtualSbrkIndex: sbrkIndex,
@@ -162,7 +162,7 @@ describe("Memory", () => {
         it("should return PageFault if case of storing data on 2 pages but one of them does not exist", () => {
             const pageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const bytes = new Uint8Array();
-            const page = new WriteablePage(pageNumber, bytes);
+            const page = WriteablePage.new(pageNumber, bytes);
             const memoryMap = new Map();
             memoryMap.set(pageNumber, page);
             const sbrkIndex = tryAsSbrkIndex(RESERVED_NUMBER_OF_PAGES * PAGE_SIZE);
@@ -175,8 +175,8 @@ describe("Memory", () => {
         it("should return fault when store data on two pages - the last page and the first page", () => {
             const firstPageNumber = tryAsPageNumber((MAX_MEMORY_INDEX - PAGE_SIZE + 1) / PAGE_SIZE);
             const secondPageNumber = tryAsPageNumber(0);
-            const firstPage = new WriteablePage(firstPageNumber, new Uint8Array(PAGE_SIZE));
-            const secondPage = new WriteablePage(secondPageNumber, new Uint8Array(PAGE_SIZE));
+            const firstPage = WriteablePage.new(firstPageNumber, new Uint8Array(PAGE_SIZE));
+            const secondPage = WriteablePage.new(secondPageNumber, new Uint8Array(PAGE_SIZE));
             const memoryMap = new Map();
             const sbrkIndex = tryAsSbrkIndex(0);
             const endHeapIndex = tryAsSbrkIndex(MAX_MEMORY_INDEX);
@@ -186,8 +186,8 @@ describe("Memory", () => {
             const dataToStore = new Uint8Array([1, 2, 3, 4]);
             const addressToStore = tryAsMemoryIndex(MAX_MEMORY_INDEX - 2);
             const expectedMemoryMap = new Map();
-            expectedMemoryMap.set(firstPageNumber, new WriteablePage(firstPageNumber, new Uint8Array(PAGE_SIZE)));
-            expectedMemoryMap.set(secondPageNumber, new WriteablePage(secondPageNumber, new Uint8Array(PAGE_SIZE)));
+            expectedMemoryMap.set(firstPageNumber, WriteablePage.new(firstPageNumber, new Uint8Array(PAGE_SIZE)));
+            expectedMemoryMap.set(secondPageNumber, WriteablePage.new(secondPageNumber, new Uint8Array(PAGE_SIZE)));
             const expectedMemory = {
                 sbrkIndex,
                 virtualSbrkIndex: sbrkIndex,
@@ -201,11 +201,11 @@ describe("Memory", () => {
     });
     describe("sbrk", () => {
         it("should allocate one page", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const lengthToAllocate = 5;
             const expectedMemoryMap = new Map();
             const pageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
-            expectedMemoryMap.set(pageNumber, new WriteablePage(pageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
+            expectedMemoryMap.set(pageNumber, WriteablePage.new(pageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
             const expectedMemory = {
                 sbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + PAGE_SIZE,
                 virtualSbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + lengthToAllocate,
@@ -216,13 +216,13 @@ describe("Memory", () => {
             assert.deepEqual(memory, expectedMemory);
         });
         it("should allocate two pages", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const lengthToAllocate = PAGE_SIZE + 5;
             const expectedMemoryMap = new Map();
             const firstPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const secondPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1);
-            expectedMemoryMap.set(firstPageNumber, new WriteablePage(firstPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
-            expectedMemoryMap.set(secondPageNumber, new WriteablePage(secondPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
+            expectedMemoryMap.set(firstPageNumber, WriteablePage.new(firstPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
+            expectedMemoryMap.set(secondPageNumber, WriteablePage.new(secondPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
             const expectedMemory = {
                 sbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + 2 * PAGE_SIZE,
                 virtualSbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + lengthToAllocate,
@@ -233,11 +233,11 @@ describe("Memory", () => {
             assert.deepEqual(memory, expectedMemory);
         });
         it("should not allocate if virtualSbrkIndex + length < sbrkIndex", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const lengthToAllocate = 5;
             const expectedMemoryMap = new Map();
             const pageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
-            expectedMemoryMap.set(pageNumber, new WriteablePage(pageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
+            expectedMemoryMap.set(pageNumber, WriteablePage.new(pageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
             const expectedMemoryAfterFirstAllocation = {
                 sbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + PAGE_SIZE,
                 virtualSbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + lengthToAllocate,
@@ -256,13 +256,13 @@ describe("Memory", () => {
             assert.deepEqual(memory, expectedMemoryAfterSecondAllocation);
         });
         it("should allocate two pages one by one", () => {
-            const memory = new Memory();
+            const memory = Memory.new();
             const lengthToAllocate = PAGE_SIZE;
             const expectedMemoryMap = new Map();
             const firstPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES);
             const secondPageNumber = tryAsPageNumber(RESERVED_NUMBER_OF_PAGES + 1);
-            expectedMemoryMap.set(firstPageNumber, new WriteablePage(firstPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
-            expectedMemoryMap.set(secondPageNumber, new WriteablePage(secondPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
+            expectedMemoryMap.set(firstPageNumber, WriteablePage.new(firstPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
+            expectedMemoryMap.set(secondPageNumber, WriteablePage.new(secondPageNumber, new Uint8Array(MIN_ALLOCATION_LENGTH)));
             const expectedMemory = {
                 sbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + 2 * PAGE_SIZE,
                 virtualSbrkIndex: RESERVED_NUMBER_OF_PAGES * PAGE_SIZE + 2 * PAGE_SIZE,

package/packages/core/pvm-interpreter/memory/pages/readable-page.d.ts

@@ -4,7 +4,8 @@ import { MemoryPage } from "./memory-page.js";
 import type { PageIndex, PageNumber } from "./page-utils.js";
 export declare class ReadablePage extends MemoryPage {
     private data;
-    constructor(pageNumber: PageNumber, data: Uint8Array);
+    static new(pageNumber: PageNumber, data: Uint8Array): ReadablePage;
+    private constructor();
     loadInto(result: Uint8Array, startIndex: PageIndex, length: number): Result<OK, PageFault>;
     storeFrom(_address: PageIndex, _data: Uint8Array): Result<OK, PageFault>;
     setData(pageIndex: PageIndex, data: Uint8Array): void;

package/packages/core/pvm-interpreter/memory/pages/readable-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readable-page.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/pvm-interpreter/memory/pages/readable-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D,qBAAa,YAAa,SAAQ,UAAU;IAGxC,OAAO,CAAC,IAAI;gBADZ,UAAU,EAAE,UAAU,EACd,IAAI,EAAE,UAAU;IAK1B,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAiB1F,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAOxE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU;IAI9C,WAAW;IAIX,WAAW;CAGZ"}
+{"version":3,"file":"readable-page.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/pvm-interpreter/memory/pages/readable-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D,qBAAa,YAAa,SAAQ,UAAU;IAOxC,OAAO,CAAC,IAAI;IANd,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU;IAInD,OAAO;IAOP,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAiB1F,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAOxE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU;IAI9C,WAAW;IAIX,WAAW;CAGZ"}

package/packages/core/pvm-interpreter/memory/pages/readable-page.js

@@ -4,6 +4,9 @@ import { PAGE_SIZE } from "../memory-consts.js";
 import { MemoryPage } from "./memory-page.js";
 export class ReadablePage extends MemoryPage {
     data;
+    static new(pageNumber, data) {
+        return new ReadablePage(pageNumber, data);
+    }
     constructor(pageNumber, data) {
         super(pageNumber);
         this.data = data;

package/packages/core/pvm-interpreter/memory/pages/readable-page.test.js

@@ -11,7 +11,7 @@ describe("ReadablePage", () => {
         const initialMemory = new Uint8Array([0, ...bytes]);
         const startIndex = tryAsMemoryIndex(0);
         const pageNumber = tryAsPageNumber(0);
-        const readablePage = new ReadablePage(pageNumber, initialMemory);
+        const readablePage = ReadablePage.new(pageNumber, initialMemory);
         const lengthToLoad = 4;
         const result = new Uint8Array(lengthToLoad);
         const expectedResult = bytes;
@@ -25,7 +25,7 @@ describe("ReadablePage", () => {
         const initialMemory = new Uint8Array([0, ...bytes]);
         const startIndex = tryAsMemoryIndex(0);
         const pageNumber = tryAsPageNumber(0);
-        const readablePage = new ReadablePage(pageNumber, initialMemory);
+        const readablePage = ReadablePage.new(pageNumber, initialMemory);
         const lengthToLoad = 4;
         const result = new Uint8Array(lengthToLoad);
         const expectedResult = new Uint8Array([3, 4, 0, 0]);
@@ -38,7 +38,7 @@ describe("ReadablePage", () => {
         const initialMemory = new Uint8Array();
         const storeIndex = tryAsPageIndex(0);
         const pageNumber = tryAsPageNumber(0);
-        const readablePage = new ReadablePage(pageNumber, initialMemory);
+        const readablePage = ReadablePage.new(pageNumber, initialMemory);
         const storeResult = readablePage.storeFrom(storeIndex, new Uint8Array());
         deepEqual(storeResult, Result.error(PageFault.fromPageNumber(0, true), () => "Page fault: attempted to write to read-only page at 0"));
     });

package/packages/core/pvm-interpreter/memory/pages/writeable-page.d.ts

@@ -20,7 +20,8 @@ declare global {
 export declare class WriteablePage extends MemoryPage {
     private buffer;
     private view;
-    constructor(pageNumber: PageNumber, initialData?: Uint8Array);
+    static new(pageNumber: PageNumber, initialData?: Uint8Array): WriteablePage;
+    private constructor();
     loadInto(result: Uint8Array, startIndex: PageIndex, length: number): Result<OK, PageFault>;
     storeFrom(startIndex: PageIndex, bytes: Uint8Array): Result<OK, PageFault>;
     setData(pageIndex: PageIndex, data: Uint8Array): void;

package/packages/core/pvm-interpreter/memory/pages/writeable-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeable-page.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/pvm-interpreter/memory/pages/writeable-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;GAIG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,sBAAsB;QAC9B,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,aAAa,EAAE,MAAM,CAAA;SAAE,GAAG,WAAW,CAAC;KACxE;IAED,UAAU,WAAW;QACnB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B;CACF;AAED,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,IAAI,CAAa;gBAEb,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,UAAU;IAW5D,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAiB1F,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAU1E,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU;IAQ9C,WAAW;IAIX,WAAW;CAGZ"}
+{"version":3,"file":"writeable-page.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/pvm-interpreter/memory/pages/writeable-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;GAIG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,sBAAsB;QAC9B,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,aAAa,EAAE,MAAM,CAAA;SAAE,GAAG,WAAW,CAAC;KACxE;IAED,UAAU,WAAW;QACnB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B;CACF;AAED,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,IAAI,CAAa;IAEzB,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,UAAU;IAI3D,OAAO;IAWP,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAiB1F,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAU1E,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU;IAQ9C,WAAW;IAIX,WAAW;CAGZ"}