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

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

@@ -8,7 +8,8 @@ export declare class ProgramDecoder {
     private code;
     private mask;
     private jumpTable;
-    constructor(rawProgram: Uint8Array);
+    static new(rawProgram: Uint8Array): ProgramDecoder;
+    private constructor();
     private decodeProgram;
     getMask(): Mask;
     getCode(): Uint8Array<ArrayBufferLike>;

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

@@ -1 +1 @@
-{"version":3,"file":"program-decoder.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/program-decoder/program-decoder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,oBAAY,mBAAmB;IAC7B,mBAAmB,IAAI;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,SAAS,CAAY;gBAEjB,UAAU,EAAE,UAAU;IAQlC,OAAO,CAAC,aAAa;IAwBrB,OAAO;IAIP,OAAO;IAIP,YAAY;IAIZ,sEAAsE;IACtE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC;CAQhF"}
+{"version":3,"file":"program-decoder.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/program-decoder/program-decoder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,oBAAY,mBAAmB;IAC7B,mBAAmB,IAAI;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,SAAS,CAAY;IAE7B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU;IAIjC,OAAO;IAQP,OAAO,CAAC,aAAa;IAwBrB,OAAO;IAIP,OAAO;IAIP,YAAY;IAIZ,sEAAsE;IACtE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC;CAQhF"}

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

@@ -12,11 +12,14 @@ export class ProgramDecoder {
     code;
     mask;
     jumpTable;
+    static new(rawProgram) {
+        return new ProgramDecoder(rawProgram);
+    }
     constructor(rawProgram) {
         const { code, mask, jumpTable, jumpTableItemLength } = this.decodeProgram(rawProgram);
         this.code = new Uint8Array(code);
-        this.mask = new Mask(mask);
-        this.jumpTable = new JumpTable(jumpTableItemLength, jumpTable);
+        this.mask = Mask.new(mask);
+        this.jumpTable = JumpTable.fromRaw(jumpTableItemLength, jumpTable);
     }
     decodeProgram(program) {
         const decoder = Decoder.fromBlob(program);
@@ -50,7 +53,7 @@ export class ProgramDecoder {
     /** https://graypaper.fluffylabs.dev/#/68eaa1f/23f400234701?v=0.6.4 */
     static deblob(program) {
         try {
-            return Result.ok(new ProgramDecoder(program));
+            return Result.ok(ProgramDecoder.new(program));
         }
         catch (e) {
             logger.error `Invalid program: ${e}`;

package/packages/core/pvm-interpreter/program-decoder/program-decoder.test.js

@@ -11,18 +11,18 @@ const bitMask = [73, 6];
 const program = new Uint8Array([jumpTable.length, jumpTableItemLength, 16, ...jumpTable, ...code, ...bitMask]);
 describe("ProgramDecoder", () => {
     it("should corectly decode instructions", () => {
-        const programDecoder = new ProgramDecoder(program);
+        const programDecoder = ProgramDecoder.new(program);
         const result = programDecoder.getCode();
         assert.deepStrictEqual(result, new Uint8Array(code));
     });
     it("should corectly decode mask", () => {
-        const programDecoder = new ProgramDecoder(program);
+        const programDecoder = ProgramDecoder.new(program);
         const result = programDecoder.getMask();
-        assert.deepStrictEqual(result, new Mask(BitVec.fromBlob(new Uint8Array(bitMask), code.length)));
+        assert.deepStrictEqual(result, Mask.new(BitVec.fromBlob(new Uint8Array(bitMask), code.length)));
     });
     it("should corectly decode jump table", () => {
-        const programDecoder = new ProgramDecoder(program);
+        const programDecoder = ProgramDecoder.new(program);
         const result = programDecoder.getJumpTable();
-        assert.deepStrictEqual(result, new JumpTable(jumpTableItemLength, new Uint8Array(jumpTable)));
+        assert.deepStrictEqual(result, JumpTable.fromRaw(jumpTableItemLength, new Uint8Array(jumpTable)));
     });
 });

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

@@ -11,7 +11,7 @@ export class Program {
     static fromSpi(blob, args, hasMetadata) {
         const { code: spiCode, metadata } = hasMetadata ? extractCodeAndMetadata(blob) : { code: blob };
         const { code, memory: rawMemory, registers } = decodeStandardProgram(spiCode, args);
-        const regs = new Registers();
+        const regs = Registers.empty();
         regs.copyFrom(registers);
         const memoryBuilder = new MemoryBuilder();
         for (const { start, end, data } of rawMemory.readable) {
@@ -31,8 +31,8 @@ export class Program {
     }
     static fromGeneric(blob, hasMetadata) {
         const { code, metadata } = hasMetadata ? extractCodeAndMetadata(blob) : { code: blob };
-        const regs = new Registers();
-        const memory = new Memory();
+        const regs = Registers.empty();
+        const memory = Memory.new();
         return new Program(code, regs, memory, metadata);
     }
     constructor(code, registers, memory, metadata = new Uint8Array()) {

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

@@ -6,10 +6,13 @@ export declare class Registers implements IRegisters {
     private readonly bytes;
     private asSigned;
     private asUnsigned;
-    constructor(bytes?: Uint8Array<ArrayBufferLike>);
+    /** Creates an empty registers object backed by a freshly allocated buffer. */
+    static empty(): Registers;
+    /** Wraps an existing byte buffer, validating its size. */
+    static fromBytes(bytes: Uint8Array): Registers;
+    private constructor();
     getAllEncoded(): Uint8Array;
     setAllEncoded(bytes: Uint8Array): void;
-    static fromBytes(bytes: Uint8Array): Registers;
     getBytesAsLittleEndian(index: number, len: number): Uint8Array<ArrayBufferLike>;
     copyFrom(regs: Registers | BigUint64Array): void;
     reset(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"registers.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter/registers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAuB,KAAK,MAAM,EAAuB,MAAM,kBAAkB,CAAC;AAIzF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE7D,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,aAGlD,CAAC;AAEF,qBAAa,SAAU,YAAW,UAAU;IAI9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,UAAU,CAAiB;gBAEN,KAAK,8BAA8D;IAMhG,aAAa,IAAI,UAAU;IAI3B,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKtC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU;IAKlC,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAKjD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc;IAKzC,KAAK;IAML,WAAW,CAAC,aAAa,EAAE,MAAM;IAIjC,WAAW,CAAC,aAAa,EAAE,MAAM;IAIjC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,MAAM,CAAC,aAAa,EAAE,MAAM;IAI5B,MAAM,CAAC,aAAa,EAAE,MAAM;IAI5B,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,SAAS;CAGV;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgB/D"}
+{"version":3,"file":"registers.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter/registers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAuB,KAAK,MAAM,EAAuB,MAAM,kBAAkB,CAAC;AAIzF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE7D,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,aAGlD,CAAC;AAEF,qBAAa,SAAU,YAAW,UAAU;IAetB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAd1C,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,UAAU,CAAiB;IAEnC,8EAA8E;IAC9E,MAAM,CAAC,KAAK;IAIZ,0DAA0D;IAC1D,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU;IAKlC,OAAO;IAKP,aAAa,IAAI,UAAU;IAI3B,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKtC,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAKjD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc;IAKzC,KAAK;IAML,WAAW,CAAC,aAAa,EAAE,MAAM;IAIjC,WAAW,CAAC,aAAa,EAAE,MAAM;IAIjC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,MAAM,CAAC,aAAa,EAAE,MAAM;IAI5B,MAAM,CAAC,aAAa,EAAE,MAAM;IAI5B,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI3C,SAAS;CAGV;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgB/D"}

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

@@ -9,9 +9,17 @@ export class Registers {
     bytes;
     asSigned;
     asUnsigned;
-    constructor(bytes = safeAllocUint8Array(NO_OF_REGISTERS << REGISTER_SIZE_SHIFT)) {
-        this.bytes = bytes;
+    /** Creates an empty registers object backed by a freshly allocated buffer. */
+    static empty() {
+        return new Registers(safeAllocUint8Array(NO_OF_REGISTERS << REGISTER_SIZE_SHIFT));
+    }
+    /** Wraps an existing byte buffer, validating its size. */
+    static fromBytes(bytes) {
         check `${bytes.length === NO_OF_REGISTERS << REGISTER_SIZE_SHIFT} Invalid size of registers array.`;
+        return new Registers(bytes);
+    }
+    constructor(bytes) {
+        this.bytes = bytes;
         this.asSigned = new BigInt64Array(bytes.buffer, bytes.byteOffset);
         this.asUnsigned = new BigUint64Array(bytes.buffer, bytes.byteOffset);
     }
@@ -22,10 +30,6 @@ export class Registers {
         check `${bytes.length === this.bytes.length} Incorrect size of input registers. Got: ${bytes.length}, need: ${this.bytes.length}`;
         this.bytes.set(bytes, 0);
     }
-    static fromBytes(bytes) {
-        check `${bytes.length === NO_OF_REGISTERS << REGISTER_SIZE_SHIFT} Invalid size of registers array.`;
-        return new Registers(bytes);
-    }
     getBytesAsLittleEndian(index, len) {
         const offset = index << REGISTER_SIZE_SHIFT;
         return this.bytes.subarray(offset, offset + len);

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

@@ -6,7 +6,7 @@ const U64_BYTES = 8;
 describe("Registers", () => {
     describe("loading values", () => {
         it("should return 0xff_ff_ff_ff correctly loaded into register", () => {
-            const registers = new Registers();
+            const registers = Registers.empty();
             const expectedSignedNumber = -1;
             const expectedUnsignedNumber = 2 ** 32 - 1;
             registers.setU32(0, 0xff_ff_ff_ff);
@@ -14,7 +14,7 @@ describe("Registers", () => {
             assert.strictEqual(registers.getLowerU32(0), expectedUnsignedNumber);
         });
         it("should return 0x00_00_00_01 correctly loaded into register", () => {
-            const registers = new Registers();
+            const registers = Registers.empty();
             const expectedSignedNumber = 1;
             const expectedUnsignedNumber = 1;
             registers.setU32(0, 0x00_00_00_01);
@@ -22,7 +22,7 @@ describe("Registers", () => {
             assert.strictEqual(registers.getLowerU32(0), expectedUnsignedNumber);
         });
         it("should return 0x80_00_00_00 correctly loaded into register", () => {
-            const registers = new Registers();
+            const registers = Registers.empty();
             const expectedSignedNumber = -(2 ** 31);
             const expectedUnsignedNumber = 2 ** 31;
             registers.setU32(0, 0x80_00_00_00);
@@ -32,28 +32,28 @@ describe("Registers", () => {
     });
     describe("getBytesAsLittleEndian", () => {
         it("should return empty bytes array", () => {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const num = 0;
             const expectedBytes = new Uint8Array([0, 0, 0, 0]);
             regs.setU32(1, num);
             assert.deepStrictEqual(regs.getBytesAsLittleEndian(1, U32_BYTES), expectedBytes);
         });
         it("should return u8 number correctly encoded as little endian", () => {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const num = 0xff;
             const expectedBytes = new Uint8Array([0xff, 0, 0, 0]);
             regs.setU32(1, num);
             assert.deepStrictEqual(regs.getBytesAsLittleEndian(1, U32_BYTES), expectedBytes);
         });
         it("should return u16 number correctly encoded as little endian", () => {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const num = 0xff_ee;
             const expectedBytes = new Uint8Array([0xee, 0xff, 0, 0]);
             regs.setU32(1, num);
             assert.deepStrictEqual(regs.getBytesAsLittleEndian(1, U32_BYTES), expectedBytes);
         });
         it("should return u32 number correctly encoded as little endian", () => {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const num = 0xff_ee_dd_cc;
             const expectedBytes = new Uint8Array([0xcc, 0xdd, 0xee, 0xff]);
             regs.setU32(1, num);
@@ -62,7 +62,7 @@ describe("Registers", () => {
     });
     describe("Implemented IRegister", () => {
         it("should correctly get all registers into bytes encoded", () => {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const num = 0xefcdab8967452301n;
             const bytesReg = new Uint8Array([0x01, 0x23, 0x45, 0x67, 0x89, 0xab, 0xcd, 0xef]);
             const fill = new Uint8Array(12 * U64_BYTES).fill(0); // we set 1st register so we fill remaining 12 with 0
@@ -75,7 +75,7 @@ describe("Registers", () => {
             assert.deepStrictEqual(encodedAllRegisters, expected);
         });
         it("should correctly set all registers from bytes encoded", () => {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const bytesReg = new Uint8Array([0x01, 0x23, 0x45, 0x67, 0x89, 0xab, 0xcd, 0xef]);
             const fill = new Uint8Array(12 * U64_BYTES).fill(0); // we set 1st register so we fill remaining 12 with 0
             const bytes = new Uint8Array([...bytesReg, ...fill]);
@@ -85,7 +85,7 @@ describe("Registers", () => {
             assert.deepStrictEqual(reg, expected);
         });
         it("should throw when trying to set all registers from bytes encoded with incorrect size", () => {
-            const regs = new Registers();
+            const regs = Registers.empty();
             const bytesReg = new Uint8Array([0x01, 0x23, 0x45, 0x67, 0x89, 0xab, 0xcd, 0xef]);
             const fill = new Uint8Array(12 * U64_BYTES).fill(0); // we set 1st register so we fill remaining 12 with 0
             const bytes = new Uint8Array([...bytesReg, ...fill, 0x00]);

package/packages/core/pvm-interpreter/spi-decoder/decode-standard-program.d.ts

@@ -4,20 +4,23 @@ export declare class MemorySegment extends WithDebug {
     readonly end: number;
     readonly data: Uint8Array | null;
     static from({ start, end, data }: Omit<MemorySegment, never>): MemorySegment;
-    constructor(start: number, end: number, data: Uint8Array | null);
+    static new(start: number, end: number, data: Uint8Array | null): MemorySegment;
+    private constructor();
 }
 export declare class SpiMemory extends WithDebug {
     readonly readable: MemorySegment[];
     readonly writeable: MemorySegment[];
     readonly sbrkIndex: number;
     readonly heapEnd: number;
-    constructor(readable: MemorySegment[], writeable: MemorySegment[], sbrkIndex: number, heapEnd: number);
+    static new(readable: MemorySegment[], writeable: MemorySegment[], sbrkIndex: number, heapEnd: number): SpiMemory;
+    private constructor();
 }
 export declare class SpiProgram extends WithDebug {
     readonly code: Uint8Array;
     readonly memory: SpiMemory;
     readonly registers: BigUint64Array;
-    constructor(code: Uint8Array, memory: SpiMemory, registers: BigUint64Array);
+    static new(code: Uint8Array, memory: SpiMemory, registers: BigUint64Array): SpiProgram;
+    private constructor();
 }
 /**
  * program = E_3(|o|) ++ E_3(|w|) ++ E_2(z) ++ E_3(s) ++ o ++ w ++ E_4(|c|) ++ c

package/packages/core/pvm-interpreter/spi-decoder/decode-standard-program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decode-standard-program.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/spi-decoder/decode-standard-program.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAapD,qBAAa,aAAc,SAAQ,SAAS;aAMxB,KAAK,EAAE,MAAM;aACb,GAAG,EAAE,MAAM;aACX,IAAI,EAAE,UAAU,GAAG,IAAI;IAPzC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;gBAK1C,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GAAG,IAAI;CAI1C;AACD,qBAAa,SAAU,SAAQ,SAAS;aAEpB,QAAQ,EAAE,aAAa,EAAE;aACzB,SAAS,EAAE,aAAa,EAAE;aAC1B,SAAS,EAAE,MAAM;aACjB,OAAO,EAAE,MAAM;gBAHf,QAAQ,EAAE,aAAa,EAAE,EACzB,SAAS,EAAE,aAAa,EAAE,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM;CAIlC;AAED,qBAAa,UAAW,SAAQ,SAAS;aAErB,IAAI,EAAE,UAAU;aAChB,MAAM,EAAE,SAAS;aACjB,SAAS,EAAE,cAAc;gBAFzB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,cAAc;CAI5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,cAgD1E"}
+{"version":3,"file":"decode-standard-program.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/pvm-interpreter/spi-decoder/decode-standard-program.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAapD,qBAAa,aAAc,SAAQ,SAAS;aAUxB,KAAK,EAAE,MAAM;aACb,GAAG,EAAE,MAAM;aACX,IAAI,EAAE,UAAU,GAAG,IAAI;IAXzC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;IAI5D,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAI9D,OAAO;CAOR;AACD,qBAAa,SAAU,SAAQ,SAAS;aAMpB,QAAQ,EAAE,aAAa,EAAE;aACzB,SAAS,EAAE,aAAa,EAAE;aAC1B,SAAS,EAAE,MAAM;aACjB,OAAO,EAAE,MAAM;IARjC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAIpG,OAAO;CAQR;AAED,qBAAa,UAAW,SAAQ,SAAS;aAMrB,IAAI,EAAE,UAAU;aAChB,MAAM,EAAE,SAAS;aACjB,SAAS,EAAE,cAAc;IAP3C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc;IAIzE,OAAO;CAOR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,cAgD1E"}

package/packages/core/pvm-interpreter/spi-decoder/decode-standard-program.js

@@ -8,6 +8,9 @@ export class MemorySegment extends WithDebug {
     end;
     data;
     static from({ start, end, data }) {
+        return MemorySegment.new(start, end, data);
+    }
+    static new(start, end, data) {
         return new MemorySegment(start, end, data);
     }
     constructor(start, end, data) {
@@ -22,6 +25,9 @@ export class SpiMemory extends WithDebug {
     writeable;
     sbrkIndex;
     heapEnd;
+    static new(readable, writeable, sbrkIndex, heapEnd) {
+        return new SpiMemory(readable, writeable, sbrkIndex, heapEnd);
+    }
     constructor(readable, writeable, sbrkIndex, heapEnd) {
         super();
         this.readable = readable;
@@ -34,6 +40,9 @@ export class SpiProgram extends WithDebug {
     code;
     memory;
     registers;
+    static new(code, memory, registers) {
+        return new SpiProgram(code, memory, registers);
+    }
     constructor(code, memory, registers) {
         super();
         this.code = code;
@@ -92,10 +101,10 @@ export function decodeStandardProgram(program, args) {
         heapDataEnd < heapZerosEnd && getMemorySegment(heapDataEnd, heapZerosEnd),
         stackStart < stackEnd && getMemorySegment(stackStart, stackEnd),
     ].filter(nonEmpty);
-    return new SpiProgram(code, new SpiMemory(readableMemory, writeableMemory, heapZerosEnd, stackStart), getRegisters(args.length));
+    return SpiProgram.new(code, SpiMemory.new(readableMemory, writeableMemory, heapZerosEnd, stackStart), getRegisters(args.length));
 }
 function getMemorySegment(start, end, data = null) {
-    return new MemorySegment(start, end, data);
+    return MemorySegment.new(start, end, data);
 }
 function getRegisters(argsLength) {
     const regs = new BigUint64Array(NO_OF_REGISTERS);

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

@@ -5,21 +5,24 @@ import { OK, Result } from "#@typeberry/utils";
 type Ananas = Awaited<ReturnType<typeof instantiate>>;
 declare class AnanasRegisters implements IRegisters {
     private readonly instance;
-    constructor(instance: Ananas);
+    static new(instance: Ananas): AnanasRegisters;
+    private constructor();
     getAllEncoded(): Uint8Array;
     setAllEncoded(bytes: Uint8Array): void;
     getAllU64(): BigUint64Array;
 }
 declare class AnanasMemory implements IMemory {
     private readonly instance;
-    constructor(instance: Ananas);
+    static new(instance: Ananas): AnanasMemory;
+    private constructor();
     store(address: U32, bytes: Uint8Array): Result<OK, PageFault>;
     read(address: U32, result: Uint8Array): Result<OK, PageFault>;
 }
 declare class AnanasGasCounter implements IGasCounter {
     private readonly instance;
     initialGas: Gas;
-    constructor(instance: Ananas);
+    static new(instance: Ananas): AnanasGasCounter;
+    private constructor();
     get(): Gas;
     set(g: Gas): void;
     sub(g: Gas): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter-ananas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,KAAK,GAAG,EAER,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,UAAU,EAEf,KAAK,SAAS,EAEd,MAAM,EAGP,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAS,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,KAAK,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC;AAKtD,cAAM,eAAgB,YAAW,UAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,aAAa,IAAI,UAAU;IAI3B,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOtC,SAAS,IAAI,cAAc;CAI5B;AAED,cAAM,YAAa,YAAW,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAO7D,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;CAW9D;AAED,cAAM,gBAAiB,YAAW,WAAW;IAG/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,UAAU,EAAE,GAAG,CAAgB;gBAEF,QAAQ,EAAE,MAAM;IAE7C,GAAG,IAAI,GAAG;IAIV,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI;IAIjB,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO;IAUpB,IAAI,IAAI,GAAG;CASZ;AAED,qBAAa,iBAAkB,YAAW,eAAe;IAKnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ7C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAE/B,OAAO;WAMM,GAAG;IAWhB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAO3E,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAS9D,QAAQ,IAAI,OAAO;IAInB,UAAU,IAAI,IAAI;IAMlB,SAAS,IAAI,MAAM;IASnB,KAAK,IAAI,MAAM;IAIf,YAAY,IAAI,GAAG,GAAG,IAAI;CAG3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-interpreter-ananas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,KAAK,GAAG,EAER,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,UAAU,EAEf,KAAK,SAAS,EAEd,MAAM,EAGP,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAS,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,KAAK,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC;AAKtD,cAAM,eAAgB,YAAW,UAAU;IAKrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ7C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM;IAI3B,OAAO;IAEP,aAAa,IAAI,UAAU;IAI3B,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOtC,SAAS,IAAI,cAAc;CAI5B;AAED,cAAM,YAAa,YAAW,OAAO;IAKf,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ7C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM;IAI3B,OAAO;IAEP,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAO7D,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;CAW9D;AAED,cAAM,gBAAiB,YAAW,WAAW;IAOvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN7C,UAAU,EAAE,GAAG,CAAgB;IAE/B,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM;IAI3B,OAAO;IAEP,GAAG,IAAI,GAAG;IAIV,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI;IAIjB,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO;IAUpB,IAAI,IAAI,GAAG;CASZ;AAED,qBAAa,iBAAkB,YAAW,eAAe;IAKnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ7C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAE/B,OAAO;WAMM,GAAG;IAWhB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAO3E,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAS9D,QAAQ,IAAI,OAAO;IAInB,UAAU,IAAI,IAAI;IAMlB,SAAS,IAAI,MAAM;IASnB,KAAK,IAAI,MAAM;IAIf,YAAY,IAAI,GAAG,GAAG,IAAI;CAG3B"}

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

@@ -6,6 +6,9 @@ import { check, OK, Result } from "#@typeberry/utils";
 const INF_STEPS = 2 ** 32 - 1;
 class AnanasRegisters {
     instance;
+    static new(instance) {
+        return new AnanasRegisters(instance);
+    }
     constructor(instance) {
         this.instance = instance;
     }
@@ -25,6 +28,9 @@ class AnanasRegisters {
 }
 class AnanasMemory {
     instance;
+    static new(instance) {
+        return new AnanasMemory(instance);
+    }
     constructor(instance) {
         this.instance = instance;
     }
@@ -49,6 +55,9 @@ class AnanasMemory {
 class AnanasGasCounter {
     instance;
     initialGas = tryAsGas(0n);
+    static new(instance) {
+        return new AnanasGasCounter(instance);
+    }
     constructor(instance) {
         this.instance = instance;
     }
@@ -82,9 +91,9 @@ export class AnanasInterpreter {
     gas;
     constructor(instance) {
         this.instance = instance;
-        this.registers = new AnanasRegisters(instance);
-        this.memory = new AnanasMemory(instance);
-        this.gas = new AnanasGasCounter(instance);
+        this.registers = AnanasRegisters.new(instance);
+        this.memory = AnanasMemory.new(instance);
+        this.gas = AnanasGasCounter.new(instance);
     }
     static async new() {
         const instance = await instantiate({

package/packages/core/trie/nodes.d.ts

@@ -82,8 +82,11 @@ export declare class TrieNode {
  */
 export declare class BranchNode {
     readonly node: TrieNode;
-    constructor(node: TrieNode);
+    /** Build a branch node from its left and right sub-node hashes. */
     static fromSubNodes(left: TrieNodeHash, right: TrieNodeHash): BranchNode;
+    /** View an existing raw trie node as a branch node (validates node type). */
+    static viewOf(node: TrieNode): BranchNode;
+    private constructor();
     /** Get the hash of the left sub-trie. */
     getLeft(): TrieNodeHash;
     /** Get the hash of the right sub-trie. */
@@ -109,8 +112,10 @@ export declare class BranchNode {
  */
 export declare class LeafNode {
     readonly node: TrieNode;
-    constructor(node: TrieNode);
     static fromValue(key: InputKey, value: BytesBlob, valueHash: () => ValueHash): LeafNode;
+    /** View an existing raw trie node as a leaf node (validates node type). */
+    static viewOf(node: TrieNode): LeafNode;
+    private constructor();
     /** Get the key (truncated to 31 bytes). */
     getKey(): TruncatedStateKey;
     hasEmbeddedValue(): boolean;

package/packages/core/trie/nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../../../packages/core/trie/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAS,KAAK,MAAM,EAAuB,MAAM,kBAAkB,CAAC;AAG3E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,cAAc,CAAC,CAAC;AAEnF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEtD,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAExD,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,MAAM,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACrC,eAAO,MAAM,kBAAkB,QAA0B,CAAC;AAE1D,qDAAqD;AACrD,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAKjD;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,gDAAgD;IAChD,MAAM,IAAI;IACV,6BAA6B;IAC7B,IAAI,IAAI;IACR,6CAA6C;IAC7C,SAAS,IAAI;CACd;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,QAAQ;IAEjB,kCAAkC;aAClB,GAAG,EAAE,UAAU;;IAD/B,kCAAkC;IAClB,GAAG,GAAE,UAAiD;IAGxE,mCAAmC;IACnC,WAAW,IAAI,QAAQ;IAYvB,sCAAsC;IACtC,YAAY,IAAI,UAAU;IAK1B,oCAAoC;IACpC,UAAU,IAAI,QAAQ;IAKtB,QAAQ;CAGT;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IAET,QAAQ,CAAC,IAAI,EAAE,QAAQ;gBAAd,IAAI,EAAE,QAAQ;IAEnC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY;IAW3D,yCAAyC;IACzC,OAAO,IAAI,YAAY;IAIvB,0CAA0C;IAC1C,QAAQ,IAAI,YAAY;CAGzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IAEnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAEZ,IAAI,EAAE,QAAQ;IAI1B,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,GAAG,QAAQ;IAoBvF,2CAA2C;IAC3C,MAAM,IAAI,iBAAiB;IAI3B,gBAAgB,IAAI,OAAO;IAI3B;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAMxB;;;;OAIG;IACH,QAAQ,IAAI,SAAS;IAKrB;;;;OAIG;IACH,YAAY,IAAI,SAAS;IAIzB,QAAQ;CAGT"}
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../../../packages/core/trie/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAS,KAAK,MAAM,EAAuB,MAAM,kBAAkB,CAAC;AAG3E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,cAAc,CAAC,CAAC;AAEnF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEtD,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAExD,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,MAAM,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACrC,eAAO,MAAM,kBAAkB,QAA0B,CAAC;AAE1D,qDAAqD;AACrD,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAKjD;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,gDAAgD;IAChD,MAAM,IAAI;IACV,6BAA6B;IAC7B,IAAI,IAAI;IACR,6CAA6C;IAC7C,SAAS,IAAI;CACd;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,QAAQ;IAEjB,kCAAkC;aAClB,GAAG,EAAE,UAAU;;IAD/B,kCAAkC;IAClB,GAAG,GAAE,UAAiD;IAGxE,mCAAmC;IACnC,WAAW,IAAI,QAAQ;IAYvB,sCAAsC;IACtC,YAAY,IAAI,UAAU;IAI1B,oCAAoC;IACpC,UAAU,IAAI,QAAQ;IAItB,QAAQ;CAGT;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IAoBD,QAAQ,CAAC,IAAI,EAAE,QAAQ;IAnB3C,mEAAmE;IACnE,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY;IAW3D,6EAA6E;IAC7E,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU;IAMzC,OAAO;IAEP,yCAAyC;IACzC,OAAO,IAAI,YAAY;IAIvB,0CAA0C;IAC1C,QAAQ,IAAI,YAAY;CAGzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IAEnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAExB,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,GAAG,QAAQ;IAoBvF,2EAA2E;IAC3E,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ;IAKvC,OAAO;IAIP,2CAA2C;IAC3C,MAAM,IAAI,iBAAiB;IAI3B,gBAAgB,IAAI,OAAO;IAI3B;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAMxB;;;;OAIG;IACH,QAAQ,IAAI,SAAS;IAKrB;;;;OAIG;IACH,YAAY,IAAI,SAAS;IAIzB,QAAQ;CAGT"}

package/packages/core/trie/nodes.js

@@ -66,13 +66,11 @@ export class TrieNode {
     }
     /** View this node as a branch node */
     asBranchNode() {
-        check `${this.getNodeType() === NodeType.Branch} not a branch!`;
-        return new BranchNode(this);
+        return BranchNode.viewOf(this);
     }
     /** View this node as a leaf node */
     asLeafNode() {
-        check `${this.getNodeType() !== NodeType.Branch} not a leaf!`;
-        return new LeafNode(this);
+        return LeafNode.viewOf(this);
     }
     toString() {
         return BytesBlob.blobFrom(this.raw).toString();
@@ -92,10 +90,7 @@ export class TrieNode {
  */
 export class BranchNode {
     node;
-    // Underlying raw node.
-    constructor(node) {
-        this.node = node;
-    }
+    /** Build a branch node from its left and right sub-node hashes. */
     static fromSubNodes(left, right) {
         const node = new TrieNode();
         node.raw.set(left.raw, 0);
@@ -104,6 +99,15 @@ export class BranchNode {
         node.raw[0] &= FIRST_BIT_SET_NEG;
         return new BranchNode(node);
     }
+    /** View an existing raw trie node as a branch node (validates node type). */
+    static viewOf(node) {
+        check `${node.getNodeType() === NodeType.Branch} not a branch!`;
+        return new BranchNode(node);
+    }
+    // Underlying raw node.
+    constructor(node) {
+        this.node = node;
+    }
     /** Get the hash of the left sub-trie. */
     getLeft() {
         return Bytes.fromBlob(this.node.raw.subarray(0, HASH_SIZE), HASH_SIZE).asOpaque();
@@ -134,9 +138,6 @@ export class BranchNode {
 export class LeafNode {
     // Underlying raw node.
     node;
-    constructor(node) {
-        this.node = node;
-    }
     static fromValue(key, value, valueHash) {
         const node = new TrieNode();
         // The value will fit in the leaf itself.
@@ -156,6 +157,14 @@ export class LeafNode {
         }
         return new LeafNode(node);
     }
+    /** View an existing raw trie node as a leaf node (validates node type). */
+    static viewOf(node) {
+        check `${node.getNodeType() !== NodeType.Branch} not a leaf!`;
+        return new LeafNode(node);
+    }
+    constructor(node) {
+        this.node = node;
+    }
     /** Get the key (truncated to 31 bytes). */
     getKey() {
         return Bytes.fromBlob(this.node.raw.subarray(1, TRUNCATED_KEY_BYTES + 1), TRUNCATED_KEY_BYTES).asOpaque();

package/packages/core/trie/nodesDb.d.ts

@@ -8,7 +8,8 @@ export type TrieHasher = {
 export declare class NodesDb {
     readonly hasher: TrieHasher;
     protected readonly nodes: HashDictionary<TrieNodeHash, TrieNode>;
-    constructor(hasher: TrieHasher);
+    static new(hasher: TrieHasher): NodesDb;
+    protected constructor(hasher: TrieHasher);
     get(hash: TrieNodeHash): TrieNode | null;
     hashNode(n: TrieNode): TrieNodeHash;
     leaves(): Generator<LeafNode>;
@@ -25,6 +26,7 @@ export declare class NodesDb {
  * A version of `NodesDb` augmented with mutating methods.
  */
 export declare class WriteableNodesDb extends NodesDb {
+    static new(hasher: TrieHasher): WriteableNodesDb;
     remove(hash: TrieNodeHash): void;
     insert(node: TrieNode, hash?: TrieNodeHash): TrieNodeHash;
 }

package/packages/core/trie/nodesDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodesDb.d.ts","sourceRoot":"","sources":["../../../../../packages/core/trie/nodesDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,KAAK,QAAQ,EAAY,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvF,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC;CAC3D,CAAC;AAEF,mDAAmD;AACnD,qBAAa,OAAO;aAGU,MAAM,EAAE,UAAU;IAF9C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAwB;gBAE5D,MAAM,EAAE,UAAU;IAE9C,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI;IAMxC,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,YAAY;IAIlC,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC;IAU9B;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,CAAC,GAAG,CAAC;CAS1F;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,OAAO;IAC3C,MAAM,CAAC,IAAI,EAAE,YAAY;IAMzB,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY;CAO1D"}
+{"version":3,"file":"nodesDb.d.ts","sourceRoot":"","sources":["../../../../../packages/core/trie/nodesDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,KAAK,QAAQ,EAAY,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvF,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC;CAC3D,CAAC;AAEF,mDAAmD;AACnD,qBAAa,OAAO;aAOoB,MAAM,EAAE,UAAU;IANxD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAwB;IAExF,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU;IAI7B,SAAS,aAA6B,MAAM,EAAE,UAAU;IAExD,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI;IAMxC,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,YAAY;IAIlC,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC;IAU9B;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,CAAC,GAAG,CAAC;CAS1F;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,OAAO;IAC3C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU;IAI7B,MAAM,CAAC,IAAI,EAAE,YAAY;IAMzB,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY;CAO1D"}

package/packages/core/trie/nodesDb.js

@@ -5,6 +5,9 @@ import { NodeType } from "./nodes.js";
 export class NodesDb {
     hasher;
     nodes = HashDictionary.new();
+    static new(hasher) {
+        return new NodesDb(hasher);
+    }
     constructor(hasher) {
         this.hasher = hasher;
     }
@@ -46,6 +49,9 @@ export class NodesDb {
  * A version of `NodesDb` augmented with mutating methods.
  */
 export class WriteableNodesDb extends NodesDb {
+    static new(hasher) {
+        return new WriteableNodesDb(hasher);
+    }
     remove(hash) {
         return NodesDb.withHashCompat(hash, (key) => {
             this.nodes.delete(key);

package/packages/core/trie/trie.js

@@ -11,7 +11,7 @@ export class InMemoryTrie {
     root;
     /** Create an empty in-memory trie. */
     static empty(hasher) {
-        return new InMemoryTrie(new WriteableNodesDb(hasher));
+        return new InMemoryTrie(WriteableNodesDb.new(hasher));
     }
     /** Given a collection of leaves, compute the state root. */
     static computeStateRoot(hasher, leaves) {
@@ -99,7 +99,7 @@ export class InMemoryTrie {
     static fromLeaves(hasher, leaves) {
         // TODO [ToDr] [opti] Pair up the leaves and build upper levels.
         let root = null;
-        const nodes = new WriteableNodesDb(hasher);
+        const nodes = WriteableNodesDb.new(hasher);
         for (const leaf of leaves) {
             root = trieInsert(root, nodes, leaf);
         }

package/packages/extensions/ipc/index.js

@@ -20,7 +20,7 @@ export var FuzzVersion;
 export function startFuzzTarget(version, socket, api) {
     const socketName = socket ?? "jam_target.sock";
     if (version === FuzzVersion.V1) {
-        return startIpcServer(socketName, (sender) => new v1.FuzzTarget(new FuzzHandler(api), sender, api.chainSpec));
+        return startIpcServer(socketName, (sender) => v1.FuzzTarget.new(FuzzHandler.new(api), sender, api.chainSpec));
     }
     assertNever(version);
 }
@@ -43,13 +43,16 @@ function startJamnpExtension(api) {
     };
     const getKeyValuePairs = (_hash, startKey) => {
         const value = BytesBlob.blobFromNumbers([255, 255, 0, 0]);
-        return [new ce129.KeyValuePair(startKey, value)];
+        return [ce129.KeyValuePair.new(startKey, value)];
     };
     return startJamnpIpcServer(api.nodeName, api.chainSpec, announcements, getHandshake, getBoundaryNodes, getKeyValuePairs);
 }
 const logger = Logger.new(import.meta.filename, "ext-ipc");
 class FuzzHandler {
     api;
+    static new(api) {
+        return new FuzzHandler(api);
+    }
     constructor(api) {
         this.api = api;
     }

package/packages/extensions/ipc/jamnp/handler.d.ts

@@ -14,7 +14,8 @@ export declare class JamnpIpcHandler implements IpcHandler {
     private readonly streamHandlers;
     /** termination promise + resolvers */
     private readonly onEnd;
-    constructor(sender: IpcSender);
+    static new(sender: IpcSender): JamnpIpcHandler;
+    private constructor();
     /** Register stream handlers. */
     registerStreamHandlers(...handlers: StreamHandler[]): void;
     /** Re-use an existing stream of given kind if present. */
@@ -34,7 +35,8 @@ declare class EnvelopeSender implements StreamMessageSender {
     private readonly ipcStreamId;
     private readonly sender;
     readonly streamId: StreamId;
-    constructor(ipcStreamId: IpcStreamId, sender: IpcSender);
+    static new(ipcStreamId: IpcStreamId, sender: IpcSender): EnvelopeSender;
+    private constructor();
     open(newStream: NewStream): void;
     bufferAndSend(msg: BytesBlob): boolean;
     close(): void;

package/packages/extensions/ipc/jamnp/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../../packages/extensions/ipc/jamnp/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,QAAQ,EAEb,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAsC,MAAM,aAAa,CAAC;AAS9F,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;AAWhF,qBAAa,eAAgB,YAAW,UAAU;IAUpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAED,MAAM,EAAE,SAAS;IAe9C,gCAAgC;IAChC,sBAAsB,CAAC,GAAG,QAAQ,EAAE,aAAa,EAAE;IAMnD,0DAA0D;IAC1D,gBAAgB,CAAC,QAAQ,SAAS,aAAa,EAC7C,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,EAClC,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,GACxD,IAAI;IAWP,uCAAuC;IACvC,aAAa,CAAC,QAAQ,SAAS,aAAa,EAC1C,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,GACxD,IAAI;IA2BP,8CAA8C;IACxC,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmErD,yDAAyD;IACzD,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;IAkBpC,qEAAqE;IACrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B;AAED,cAAM,cAAe,YAAW,mBAAmB;IAI/C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,SAAgB,QAAQ,EAAE,QAAQ,CAAC;gBAGhB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,SAAS;IAKpC,IAAI,CAAC,SAAS,EAAE,SAAS;IAUzB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAWtC,KAAK,IAAI,IAAI;CAYd"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../../packages/extensions/ipc/jamnp/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,QAAQ,EAEb,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAsC,MAAM,aAAa,CAAC;AAS9F,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;AAWhF,qBAAa,eAAgB,YAAW,UAAU;IAc5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAb3C,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS;IAI5B,OAAO;IAeP,gCAAgC;IAChC,sBAAsB,CAAC,GAAG,QAAQ,EAAE,aAAa,EAAE;IAMnD,0DAA0D;IAC1D,gBAAgB,CAAC,QAAQ,SAAS,aAAa,EAC7C,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,EAClC,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,GACxD,IAAI;IAWP,uCAAuC;IACvC,aAAa,CAAC,QAAQ,SAAS,aAAa,EAC1C,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,GACxD,IAAI;IA2BP,8CAA8C;IACxC,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmErD,yDAAyD;IACzD,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;IAkBpC,qEAAqE;IACrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B;AAED,cAAM,cAAe,YAAW,mBAAmB;IAQ/C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS;IAItD,OAAO;IAOP,IAAI,CAAC,SAAS,EAAE,SAAS;IAUzB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAWtC,KAAK,IAAI,IAAI;CAYd"}