@typeberry/lib 0.5.10-7338c21 → 0.5.10-9ffd7ac

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"}

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

@@ -5,6 +5,9 @@ import { MemoryPage } from "./memory-page.js";
 export class WriteablePage extends MemoryPage {
     buffer;
     view;
+    static new(pageNumber, initialData) {
+        return new WriteablePage(pageNumber, initialData);
+    }
     constructor(pageNumber, initialData) {
         super(pageNumber);
         const dataLength = initialData?.length ?? 0;

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

@@ -11,7 +11,7 @@ describe("WriteablePage", () => {
         const initialMemory = new Uint8Array([0, ...bytes]);
         const startIndex = tryAsMemoryIndex(0);
         const pageNumber = tryAsPageNumber(0);
-        const readablePage = new WriteablePage(pageNumber, initialMemory);
+        const readablePage = WriteablePage.new(pageNumber, initialMemory);
         const lengthToLoad = 4;
         const result = new Uint8Array(lengthToLoad);
         const expectedResult = bytes;
@@ -25,7 +25,7 @@ describe("WriteablePage", () => {
         const initialMemory = new Uint8Array([0, ...bytes]);
         const startIndex = tryAsMemoryIndex(0);
         const pageNumber = tryAsPageNumber(0);
-        const readablePage = new WriteablePage(pageNumber, initialMemory);
+        const readablePage = WriteablePage.new(pageNumber, initialMemory);
         const lengthToLoad = 4;
         const result = new Uint8Array(lengthToLoad);
         const expectedResult = new Uint8Array([3, 4, 0, 0]);
@@ -39,7 +39,7 @@ describe("WriteablePage", () => {
         const pageNumber = tryAsPageNumber(0);
         const bytesToStore = new Uint8Array([1, 2, 3, 4]);
         const indexToStore = tryAsPageIndex(1);
-        const writeablePage = new WriteablePage(pageNumber);
+        const writeablePage = WriteablePage.new(pageNumber);
         const expectedBuffer = new ArrayBuffer(MIN_ALLOCATION_LENGTH);
         const expectedView = new Uint8Array(expectedBuffer);
         expectedView.set(bytesToStore, indexToStore);
@@ -57,7 +57,7 @@ describe("WriteablePage", () => {
         const pageNumber = tryAsPageNumber(0);
         const bytesToStore = new Uint8Array([1, 2, 3, 4]);
         const indexToStore = tryAsPageIndex(MIN_ALLOCATION_LENGTH);
-        const writeablePage = new WriteablePage(pageNumber);
+        const writeablePage = WriteablePage.new(pageNumber);
         const expectedBuffer = new ArrayBuffer(MIN_ALLOCATION_LENGTH + bytesToStore.length);
         const expectedView = new Uint8Array(expectedBuffer);
         expectedView.set(bytesToStore, MIN_ALLOCATION_LENGTH);

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

@@ -2,7 +2,8 @@ import type { ImmediateDecoder } from "../args-decoder/decoders/immediate-decode
 import type { Registers } from "../registers.js";
 export declare class BitOps {
     private regs;
-    constructor(regs: Registers);
+    static new(regs: Registers): BitOps;
+    private constructor();
     or(firstIndex: number, secondIndex: number, resultIndex: number): void;
     orImmediate(firstIndex: number, immediate: ImmediateDecoder, resultIndex: number): void;
     and(firstIndex: number, secondIndex: number, resultIndex: number): void;

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

@@ -1 +1 @@
-{"version":3,"file":"bit-ops.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/ops/bit-ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,qBAAa,MAAM;IACL,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,SAAS;IAEnC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAI/D,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAIhF,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIhE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAIjF,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIhE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAIjF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAInE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIlE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIjE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAItD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAItD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIzD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIzD,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAI1D,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAI1D,OAAO,CAAC,UAAU;IAYlB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKnD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKpD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAIrD"}
+{"version":3,"file":"bit-ops.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/ops/bit-ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,qBAAa,MAAM;IAKG,OAAO,CAAC,IAAI;IAJhC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS;IAI1B,OAAO;IAEP,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAI/D,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAIhF,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIhE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAIjF,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIhE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAIjF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAInE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIlE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIjE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAItD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAItD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIzD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAIzD,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAI1D,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAI1D,OAAO,CAAC,UAAU;IAYlB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKnD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKpD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAIrD"}

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

@@ -1,6 +1,9 @@
 import { clz64, countBits32, countBits64, ctz32, ctz64 } from "./bit-utils.js";
 export class BitOps {
     regs;
+    static new(regs) {
+        return new BitOps(regs);
+    }
     constructor(regs) {
         this.regs = regs;
     }

package/packages/core/pvm-interpreter/ops/bit-ops.test.js

@@ -6,15 +6,15 @@ import { bigintToUint8ArrayLE } from "../test-utils.js";
 import { BitOps } from "./bit-ops.js";
 describe("BitOps", () => {
     function prepareData(firstValue, secondValue = 0n) {
-        const regs = new Registers();
+        const regs = Registers.empty();
         const firstRegisterIndex = 0;
         const secondRegisterIndex = 1;
         const resultRegisterIndex = 12;
         regs.setU64(firstRegisterIndex, firstValue);
         regs.setU64(secondRegisterIndex, secondValue);
-        const immediate = new ImmediateDecoder();
+        const immediate = ImmediateDecoder.new();
         immediate.setBytes(bigintToUint8ArrayLE(secondValue));
-        const bitOps = new BitOps(regs);
+        const bitOps = BitOps.new(regs);
         return { regs, bitOps, immediate, firstRegisterIndex, secondRegisterIndex, resultRegisterIndex };
     }
     it("or", () => {

package/packages/core/pvm-interpreter/ops/bit-rotation-ops.d.ts

@@ -2,7 +2,8 @@ import type { ImmediateDecoder } from "../args-decoder/decoders/immediate-decode
 import type { Registers } from "../registers.js";
 export declare class BitRotationOps {
     private regs;
-    constructor(regs: Registers);
+    static new(regs: Registers): BitRotationOps;
+    private constructor();
     reverseBytes(valueIndex: number, resultIndex: number): void;
     private rotate32Left;
     private rotate64Left;

package/packages/core/pvm-interpreter/ops/bit-rotation-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bit-rotation-ops.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/ops/bit-rotation-ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,SAAS;IAEnC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAYpD,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAQrB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAM9E,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAMjF,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAM9E,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAMjF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMnE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMnE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMnE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAKpE"}
+{"version":3,"file":"bit-rotation-ops.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/ops/bit-rotation-ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,qBAAa,cAAc;IAKL,OAAO,CAAC,IAAI;IAJhC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS;IAI1B,OAAO;IAEP,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAYpD,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAQrB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAM9E,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAMjF,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAM9E,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAMjF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMnE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMnE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMnE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAKpE"}

package/packages/core/pvm-interpreter/ops/bit-rotation-ops.js

@@ -1,6 +1,9 @@
 import { unsignedRightShiftBigInt } from "./math-utils.js";
 export class BitRotationOps {
     regs;
+    static new(regs) {
+        return new BitRotationOps(regs);
+    }
     constructor(regs) {
         this.regs = regs;
     }

package/packages/core/pvm-interpreter/ops/bit-rotation-ops.test.js

@@ -7,11 +7,11 @@ import { BitRotationOps } from "./bit-rotation-ops.js";
 describe("BitRotationOps", () => {
     describe("reverseBytes", () => {
         function prepareData(firstValue) {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const valueRegisterIndex = 0;
             const resultRegisterIndex = 12;
             regs.setU64(valueRegisterIndex, firstValue);
-            const bitRotationOps = new BitRotationOps(regs);
+            const bitRotationOps = BitRotationOps.new(regs);
             return { regs, bitRotationOps, valueRegisterIndex, resultRegisterIndex };
         }
         it("should reverse bytes in positive number", () => {
@@ -30,15 +30,15 @@ describe("BitRotationOps", () => {
         });
     });
     function prepareData(firstValue, secondValue) {
-        const regs = new Registers();
+        const regs = Registers.empty();
         const firstRegisterIndex = 0;
         const secondRegisterIndex = 1;
         const resultRegisterIndex = 12;
         regs.setU64(firstRegisterIndex, firstValue);
         regs.setU64(secondRegisterIndex, secondValue);
-        const immediate = new ImmediateDecoder();
+        const immediate = ImmediateDecoder.new();
         immediate.setBytes(bigintToUint8ArrayLE(secondValue));
-        const bitRotationOps = new BitRotationOps(regs);
+        const bitRotationOps = BitRotationOps.new(regs);
         return { regs, bitRotationOps, immediate, firstRegisterIndex, secondRegisterIndex, resultRegisterIndex };
     }
     describe("rot left", () => {