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

package/README.md

@@ -243,7 +243,7 @@ const programHex = "0x0000213308013309012803009577ff51070c648ac8980864a928f36487
 const program = BytesBlob.parseBlob(programHex);
 
 // Create interpreter and initialize with program
-const pvm = new Interpreter();
+const pvm = Interpreter.new();
 pvm.resetGeneric(program.raw, 0, tryAsGas(1000));
 
 // dump the program data
@@ -269,7 +269,7 @@ import { BytesBlob } from "@typeberry/lib/bytes";
 const programHex = "0x0000210408010409010503000277ff07070c528a08980852a905f3528704080409111300499352d500";
 const program = BytesBlob.parseBlob(programHex);
 
-const pvm = new Interpreter();
+const pvm = Interpreter.new();
 pvm.resetGeneric(program.raw, 0, tryAsGas(1000));
 pvm.runProgram();
 

package/bin/lib/examples/pvm-usage.test.js

@@ -11,7 +11,7 @@ describe("PVM Examples", () => {
         const programHex = "0x0000213308013309012803009577ff51070c648ac8980864a928f3648733083309013200499352d500";
         const program = BytesBlob.parseBlob(programHex);
         // Create interpreter and initialize with program
-        const pvm = new Interpreter();
+        const pvm = Interpreter.new();
         pvm.resetGeneric(program.raw, 0, tryAsGas(1000));
         // dump the program data
         console.table(pvm.dumpProgram());
@@ -29,7 +29,7 @@ describe("PVM Examples", () => {
         const { BytesBlob } = await import("@typeberry/lib/bytes");
         const programHex = "0x0000210408010409010503000277ff07070c528a08980852a905f3528704080409111300499352d500";
         const program = BytesBlob.parseBlob(programHex);
-        const pvm = new Interpreter();
+        const pvm = Interpreter.new();
         pvm.resetGeneric(program.raw, 0, tryAsGas(1000));
         pvm.runProgram();
         // Access register values after execution

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeberry/lib",
-  "version": "0.5.10-7338c21",
+  "version": "0.5.10-9ffd7ac",
   "description": "Typeberry Library",
   "main": "./bin/lib/index.js",
   "types": "./bin/lib/index.d.ts",

package/packages/core/codec/descriptor.js

@@ -54,7 +54,7 @@ export class Descriptor {
      */
     skipEncoded(decoder) {
         const initBytes = decoder.bytesRead();
-        this.skip(new Skipper(decoder));
+        this.skip(Skipper.new(decoder));
         const endBytes = decoder.bytesRead();
         return BytesBlob.blobFrom(decoder.source.subarray(initBytes, endBytes));
     }

package/packages/core/codec/descriptors.js

@@ -311,6 +311,9 @@ function hasUniqueView(a) {
 function objectView(Class, descriptors, sizeHint, skipper) {
     // Create a View, based on the `AbstractView`.
     class ClassView extends ObjectView {
+        static new(d) {
+            return new ClassView(d);
+        }
         constructor(d) {
             super(d, Class, descriptors);
         }
@@ -330,8 +333,8 @@ function objectView(Class, descriptors, sizeHint, skipper) {
         const encoded = t.encoded();
         e.bytes(Bytes.fromBlob(encoded.raw, encoded.length));
     }, (d) => {
-        const view = new ClassView(d.clone());
-        skipper(new Skipper(d));
+        const view = ClassView.new(d.clone());
+        skipper(Skipper.new(d));
         return view;
     }, skipper);
 }
@@ -351,7 +354,7 @@ function sequenceViewVarLen(type, options) {
         e.bytes(Bytes.fromBlob(encoded.raw, encoded.length));
     }, (d) => {
         const view = new SequenceView(d.clone(), type);
-        skipper(new Skipper(d));
+        skipper(Skipper.new(d));
         return view;
     }, skipper);
 }
@@ -366,7 +369,7 @@ function sequenceViewFixLen(type, { fixedLength }) {
         e.bytes(Bytes.fromBlob(encoded.raw, encoded.length));
     }, (d) => {
         const view = new SequenceView(d.clone(), type, fixedLength);
-        skipper(new Skipper(d));
+        skipper(Skipper.new(d));
         return view;
     }, skipper);
 }

package/packages/core/codec/index.test.js

@@ -67,7 +67,7 @@ describe("JAM encoder / decoder", () => {
                 const encoded = encoder.viewResult();
                 const decoder = Decoder.fromBytesBlob(encoded);
                 // skipping
-                const skip = new Skipper(decoder.clone());
+                const skip = Skipper.new(decoder.clone());
                 g.descriptor.skip(skip);
                 skip.decoder.finish();
                 // decoding

package/packages/core/codec/skip.d.ts

@@ -7,7 +7,8 @@ export type Skip = {
 /** Wrapper for `Decoder` that can skip bytes of fields in the data buffer instead of decoding them. */
 export declare class Skipper {
     readonly decoder: Decoder;
-    constructor(decoder: Decoder);
+    static new(decoder: Decoder): Skipper;
+    private constructor();
     /** Skip U64/I64. */
     u64: () => void;
     /** Skip U32/I32. */

package/packages/core/codec/skip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skip.d.ts","sourceRoot":"","sources":["../../../../../packages/core/codec/skip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAkC,MAAM,cAAc,CAAC;AAE5E,yDAAyD;AACzD,MAAM,MAAM,IAAI,GAAG;IACjB,4CAA4C;IAC5C,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5B,CAAC;AAEF,uGAAuG;AACvG,qBAAa,OAAO;aACU,OAAO,EAAE,OAAO;gBAAhB,OAAO,EAAE,OAAO;IAC5C,oBAAoB;IACpB,GAAG,aAA8B;IACjC,oBAAoB;IACpB,GAAG,aAA8B;IACjC,oBAAoB;IACpB,GAAG,aAA8B;IACjC,oBAAoB;IACpB,GAAG,aAA8B;IACjC,kBAAkB;IAClB,EAAE,aAA8B;IAChC,oBAAoB;IACpB,IAAI,aAA8B;IAClC,gCAAgC;IAChC,MAAM,aAAuB;IAC7B,gCAAgC;IAChC,MAAM;IAKN,+BAA+B;IAC/B,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC;IAG9B,uCAAuC;IACvC,SAAS;IAIT,oCAAoC;IACpC,YAAY,CAAC,SAAS,EAAE,MAAM;IAG9B,uCAAuC;IACvC,YAAY;IAIZ,+BAA+B;IAC/B,MAAM,CAAC,MAAM,EAAE,IAAI;IAGnB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,IAAI;IAMrB,kCAAkC;IAClC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM;IAKxC,qCAAqC;IACrC,cAAc,CAAC,MAAM,EAAE,IAAI;CAI5B"}
+{"version":3,"file":"skip.d.ts","sourceRoot":"","sources":["../../../../../packages/core/codec/skip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAkC,MAAM,cAAc,CAAC;AAE5E,yDAAyD;AACzD,MAAM,MAAM,IAAI,GAAG;IACjB,4CAA4C;IAC5C,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5B,CAAC;AAEF,uGAAuG;AACvG,qBAAa,OAAO;aAKkB,OAAO,EAAE,OAAO;IAJpD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO;IAI3B,OAAO;IACP,oBAAoB;IACpB,GAAG,aAA8B;IACjC,oBAAoB;IACpB,GAAG,aAA8B;IACjC,oBAAoB;IACpB,GAAG,aAA8B;IACjC,oBAAoB;IACpB,GAAG,aAA8B;IACjC,kBAAkB;IAClB,EAAE,aAA8B;IAChC,oBAAoB;IACpB,IAAI,aAA8B;IAClC,gCAAgC;IAChC,MAAM,aAAuB;IAC7B,gCAAgC;IAChC,MAAM;IAKN,+BAA+B;IAC/B,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC;IAG9B,uCAAuC;IACvC,SAAS;IAIT,oCAAoC;IACpC,YAAY,CAAC,SAAS,EAAE,MAAM;IAG9B,uCAAuC;IACvC,YAAY;IAIZ,+BAA+B;IAC/B,MAAM,CAAC,MAAM,EAAE,IAAI;IAGnB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,IAAI;IAMrB,kCAAkC;IAClC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM;IAKxC,qCAAqC;IACrC,cAAc,CAAC,MAAM,EAAE,IAAI;CAI5B"}

package/packages/core/codec/skip.js

@@ -2,6 +2,9 @@ import { decodeVariableLengthExtraBytes } from "./decoder.js";
 /** Wrapper for `Decoder` that can skip bytes of fields in the data buffer instead of decoding them. */
 export class Skipper {
     decoder;
+    static new(decoder) {
+        return new Skipper(decoder);
+    }
     constructor(decoder) {
         this.decoder = decoder;
     }

package/packages/core/codec/view.js

@@ -107,7 +107,7 @@ export class ObjectView {
        is already decoded (${this.lastDecodedFieldIdx}, ${String(lastField)}).
     `;
         let lastItem = this.cache.get(lastField);
-        const skipper = new Skipper(this.decoder);
+        const skipper = Skipper.new(this.decoder);
         // now skip all of the fields and further populate the cache.
         for (let i = this.lastDecodedFieldIdx + 1; i <= index; i++) {
             // create new cached prop
@@ -214,7 +214,7 @@ export class SequenceView {
       Unjustified call to 'decodeUpTo' - the index (${index}) is already decoded (${this.lastDecodedIdx}).
     `;
         let lastItem = this.cache.get(this.lastDecodedIdx);
-        const skipper = new Skipper(this.decoder);
+        const skipper = Skipper.new(this.decoder);
         // now skip all of the fields and further populate the cache.
         for (let i = this.lastDecodedIdx + 1; i <= index; i++) {
             // create new cached prop

package/packages/core/collections/multi-map.d.ts

@@ -18,7 +18,8 @@ export declare class MultiMap<TKeys extends readonly unknown[], TValue> {
      * Pass the number of keys and optionally mappers from keys to primitive types
      * if needed.
      */
-    constructor(keysLength: TKeys["length"], keyMappers?: KeyMappers<TKeys>);
+    static new<TKeys extends readonly unknown[], TValue>(keysLength: TKeys["length"], keyMappers?: KeyMappers<TKeys>): MultiMap<TKeys, TValue>;
+    private constructor();
     /** Convert input keys into primitive types. */
     private primitiveKeys;
     /**

package/packages/core/collections/multi-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-map.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/multi-map.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,GACnG,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GACrC,MAAM,CAAC;AAEX,KAAK,UAAU,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,GAC3F,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,GAC/C,EAAE,CAAC;AAEP,sDAAsD;AACtD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzE;;;;;;;;GAQG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM;IAC5D,SAAgB,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;OAGG;gBACS,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC;IAOvE,+CAA+C;IAC/C,OAAO,CAAC,aAAa;IAOrB;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK;IAsBnC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO;IAKjC,kDAAkD;IAClD,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO;IAK9B,kEAAkE;IAClE,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAKzC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CA0B1B"}
+{"version":3,"file":"multi-map.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/multi-map.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,GACnG,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GACrC,MAAM,CAAC;AAEX,KAAK,UAAU,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,GAC3F,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,GAC/C,EAAE,CAAC;AAEP,sDAAsD;AACtD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzE;;;;;;;;GAQG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM;IAC5D,SAAgB,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC;IAIhH,OAAO;IAOP,+CAA+C;IAC/C,OAAO,CAAC,aAAa;IAOrB;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK;IAsBnC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO;IAKjC,kDAAkD;IAClD,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO;IAK9B,kEAAkE;IAClE,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAKzC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CA0B1B"}

package/packages/core/collections/multi-map.js

@@ -15,6 +15,9 @@ export class MultiMap {
      * Pass the number of keys and optionally mappers from keys to primitive types
      * if needed.
      */
+    static new(keysLength, keyMappers) {
+        return new MultiMap(keysLength, keyMappers);
+    }
     constructor(keysLength, keyMappers) {
         check `${keysLength > 0} Keys cannot be empty.`;
         check `${keyMappers === undefined || keyMappers.length === keysLength} Incorrect number of key mappers given!`;

package/packages/core/collections/multi-map.test.js

@@ -18,7 +18,7 @@ describe("Multi Map", () => {
             }
         }
         // given
-        const map = new MultiMap(3, [null, (obj) => obj.val, null]);
+        const map = MultiMap.new(3, [null, (obj) => obj.val, null]);
         map
             .set("hello", "a", new MyObject(5), 10)
             .set("world", "b", new MyObject(10), 10)
@@ -37,7 +37,7 @@ describe("Multi Map", () => {
     });
     it("should check existence and remove elements", () => {
         // given
-        const map = new MultiMap(2);
+        const map = MultiMap.new(2);
         map.set("hello", "a", 10).set("world", "b", 10).set("frens", "a", 11);
         // when
         const has_a = map.has("a", 10);

package/packages/core/concurrent/parent.js

@@ -113,11 +113,14 @@ async function initWorker(workerPath) {
     });
     // make sure the threads don't prevent the program from stopping.
     workerThread.unref();
-    return new WorkerChannel(workerThread, port2);
+    return WorkerChannel.new(workerThread, port2);
 }
 class WorkerChannel {
     worker;
     port;
+    static new(worker, port) {
+        return new WorkerChannel(worker, port);
+    }
     constructor(worker, port) {
         this.worker = worker;
         this.port = port;

package/packages/core/crypto/ed25519.d.ts

@@ -31,11 +31,8 @@ export declare class Ed25519Pair {
     readonly pubKey: Ed25519Key;
     /** Private key. NOTE: Avoid using directly. */
     readonly _privKey: Bytes<ED25519_PRIV_KEY_BYTES>;
-    constructor(
-    /** Public key */
-    pubKey: Ed25519Key, 
-    /** Private key. NOTE: Avoid using directly. */
-    _privKey: Bytes<ED25519_PRIV_KEY_BYTES>);
+    static new(pubKey: Ed25519Key, _privKey: Bytes<ED25519_PRIV_KEY_BYTES>): Ed25519Pair;
+    private constructor();
 }
 /** Create a private key from given raw bytes. */
 export declare function privateKey(privKey: Bytes<ED25519_PRIV_KEY_BYTES>): Promise<Ed25519Pair>;

package/packages/core/crypto/ed25519.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ed25519.d.ts","sourceRoot":"","sources":["../../../../../packages/core/crypto/ed25519.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAS,KAAK,MAAM,EAAuB,MAAM,kBAAkB,CAAC;AAE3E,gCAAgC;AAChC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,KAAK,sBAAsB,GAAG,OAAO,sBAAsB,CAAC;AAE5D,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AAEzD,8BAA8B;AAC9B,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,YAAY,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAE1F;;;;GAIG;AACH,qBAAa,WAAW;IAEpB,iBAAiB;aACD,MAAM,EAAE,UAAU;IAClC,+CAA+C;aAC/B,QAAQ,EAAE,KAAK,CAAC,sBAAsB,CAAC;;IAHvD,iBAAiB;IACD,MAAM,EAAE,UAAU;IAClC,+CAA+C;IAC/B,QAAQ,EAAE,KAAK,CAAC,sBAAsB,CAAC;CAE1D;AAED,iDAAiD;AACjD,wBAAsB,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAG7F;AAED,wDAAwD;AACxD,wBAAsB,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGvG;AAED,oCAAoC;AACpC,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI;IACnD,iBAAiB;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kBAAkB;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,yBAAyB;IACzB,OAAO,EAAE,CAAC,CAAC;CACZ,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA2BvF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAa1F"}
+{"version":3,"file":"ed25519.d.ts","sourceRoot":"","sources":["../../../../../packages/core/crypto/ed25519.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAS,KAAK,MAAM,EAAuB,MAAM,kBAAkB,CAAC;AAE3E,gCAAgC;AAChC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,KAAK,sBAAsB,GAAG,OAAO,sBAAsB,CAAC;AAE5D,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AAEzD,8BAA8B;AAC9B,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,YAAY,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAE1F;;;;GAIG;AACH,qBAAa,WAAW;IAMpB,iBAAiB;aACD,MAAM,EAAE,UAAU;IAClC,+CAA+C;aAC/B,QAAQ,EAAE,KAAK,CAAC,sBAAsB,CAAC;IARzD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,sBAAsB,CAAC;IAItE,OAAO;CAMR;AAED,iDAAiD;AACjD,wBAAsB,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAG7F;AAED,wDAAwD;AACxD,wBAAsB,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGvG;AAED,oCAAoC;AACpC,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI;IACnD,iBAAiB;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kBAAkB;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,yBAAyB;IACzB,OAAO,EAAE,CAAC,CAAC;CACZ,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA2BvF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAa1F"}

package/packages/core/crypto/ed25519.js

@@ -16,6 +16,9 @@ export const ED25519_SIGNATURE_BYTES = 64;
 export class Ed25519Pair {
     pubKey;
     _privKey;
+    static new(pubKey, _privKey) {
+        return new Ed25519Pair(pubKey, _privKey);
+    }
     constructor(
     /** Public key */
     pubKey, 
@@ -28,7 +31,7 @@ export class Ed25519Pair {
 /** Create a private key from given raw bytes. */
 export async function privateKey(privKey) {
     const pubKey = await ed.getPublicKeyAsync(privKey.raw);
-    return new Ed25519Pair(Bytes.fromBlob(pubKey, ED25519_KEY_BYTES).asOpaque(), privKey.asOpaque());
+    return Ed25519Pair.new(Bytes.fromBlob(pubKey, ED25519_KEY_BYTES).asOpaque(), privKey.asOpaque());
 }
 /** Sign given piece of data using provided key pair. */
 export async function sign(key, message) {

package/packages/core/hash/hash.d.ts

@@ -29,13 +29,15 @@ export declare const ZERO_HASH: Bytes<32>;
 export declare class WithHash<THash extends OpaqueHash, TData> extends WithDebug {
     readonly hash: THash;
     readonly data: TData;
-    constructor(hash: THash, data: TData);
+    static new<THash extends OpaqueHash, TData>(hash: THash, data: TData): WithHash<THash, TData>;
+    protected constructor(hash: THash, data: TData);
 }
 /**
  * Extension of [`WithHash`] additionally containing an encoded version of the object.
  */
 export declare class WithHashAndBytes<THash extends OpaqueHash, TData> extends WithHash<THash, TData> {
     readonly encoded: BytesBlob;
-    constructor(hash: THash, data: TData, encoded: BytesBlob);
+    static create<THash extends OpaqueHash, TData>(hash: THash, data: TData, encoded: BytesBlob): WithHashAndBytes<THash, TData>;
+    protected constructor(hash: THash, data: TData, encoded: BytesBlob);
 }
 //# sourceMappingURL=hash.d.ts.map

package/packages/core/hash/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../../packages/core/hash/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC;AAEzC,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAE1C,sBAAsB;AACtB,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAE3C,yBAAyB;AACzB,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAE1C,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAEvD,eAAO,MAAM,SAAS,WAAwB,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,UAAU,EAAE,KAAK,CAAE,SAAQ,SAAS;aAGpD,IAAI,EAAE,KAAK;aACX,IAAI,EAAE,KAAK;gBADX,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,KAAK;CAI9B;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,KAAK,SAAS,UAAU,EAAE,KAAK,CAAE,SAAQ,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;aAIzE,OAAO,EAAE,SAAS;gBAFlC,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,KAAK,EACK,OAAO,EAAE,SAAS;CAIrC"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../../packages/core/hash/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC;AAEzC,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAE1C,sBAAsB;AACtB,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAE3C,yBAAyB;AACzB,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAE1C,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAEvD,eAAO,MAAM,SAAS,WAAwB,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,UAAU,EAAE,KAAK,CAAE,SAAQ,SAAS;aAMpD,IAAI,EAAE,KAAK;aACX,IAAI,EAAE,KAAK;IAN7B,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK;IAIpE,SAAS,aACS,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,KAAK;CAI9B;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,KAAK,SAAS,UAAU,EAAE,KAAK,CAAE,SAAQ,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;aAQzE,OAAO,EAAE,SAAS;IAPpC,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS;IAI3F,SAAS,aACP,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,KAAK,EACK,OAAO,EAAE,SAAS;CAIrC"}

package/packages/core/hash/hash.js

@@ -19,7 +19,9 @@ export const ZERO_HASH = Bytes.zero(HASH_SIZE);
 export class WithHash extends WithDebug {
     hash;
     data;
-    // TODO [ToDr] use static method and make constructor private
+    static new(hash, data) {
+        return new WithHash(hash, data);
+    }
     constructor(hash, data) {
         super();
         this.hash = hash;
@@ -31,6 +33,9 @@ export class WithHash extends WithDebug {
  */
 export class WithHashAndBytes extends WithHash {
     encoded;
+    static create(hash, data, encoded) {
+        return new WithHashAndBytes(hash, data, encoded);
+    }
     constructor(hash, data, encoded) {
         super(hash, data);
         this.encoded = encoded;

package/packages/core/networking/quic-network.d.ts

@@ -9,10 +9,11 @@ export declare class QuicNetwork implements Network<QuicPeer> {
     private readonly _peers;
     private readonly listen;
     private started;
-    constructor(socket: QUICSocket, server: QUICServer, _dial: (peer: PeerAddress, options: DialOptions) => Promise<QuicPeer>, _peers: PeersManagement<QuicPeer>, listen: {
+    static new(socket: QUICSocket, server: QUICServer, _dial: (peer: PeerAddress, options: DialOptions) => Promise<QuicPeer>, _peers: PeersManagement<QuicPeer>, listen: {
         host: string;
         port: number;
-    });
+    }): QuicNetwork;
+    private constructor();
     get isRunning(): boolean;
     start(): Promise<void>;
     stop(): Promise<void>;

package/packages/core/networking/quic-network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quic-network.d.ts","sourceRoot":"","sources":["../../../../../packages/core/networking/quic-network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,qBAAa,WAAY,YAAW,OAAO,CAAC,QAAQ,CAAC;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,OAAO,CAAS;gBAGL,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,EACrE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAGzD,IAAI,SAAS,YAEZ;IAEK,KAAK;IAYL,IAAI;IAYV,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,CAE3B;IAEK,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAG5E"}
+{"version":3,"file":"quic-network.d.ts","sourceRoot":"","sources":["../../../../../packages/core/networking/quic-network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,qBAAa,WAAY,YAAW,OAAO,CAAC,QAAQ,CAAC;IAcjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAjBzB,OAAO,CAAC,OAAO,CAAS;IAExB,MAAM,CAAC,GAAG,CACR,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,EACrE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAKxC,OAAO;IAQP,IAAI,SAAS,YAEZ;IAEK,KAAK;IAYL,IAAI;IAYV,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,CAE3B;IAEK,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAG5E"}

package/packages/core/networking/quic-network.js

@@ -7,6 +7,9 @@ export class QuicNetwork {
     _peers;
     listen;
     started = false;
+    static new(socket, server, _dial, _peers, listen) {
+        return new QuicNetwork(socket, server, _dial, _peers, listen);
+    }
     constructor(socket, server, _dial, _peers, listen) {
         this.socket = socket;
         this.server = server;

package/packages/core/networking/quic-peer.d.ts

@@ -10,7 +10,8 @@ export declare class QuicPeer implements Peer {
     readonly id: PeerId;
     readonly key: Ed25519Key;
     private readonly streamEvents;
-    constructor(conn: QUICConnection, peerInfo: PeerInfo);
+    static new(conn: QUICConnection, peerInfo: PeerInfo): QuicPeer;
+    private constructor();
     addOnIncomingStream(streamCallback: StreamCallback<QuicStream>): void;
     openStream(): QuicStream;
     disconnect(): Promise<void>;

package/packages/core/networking/quic-peer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quic-peer.d.ts","sourceRoot":"","sources":["../../../../../packages/core/networking/quic-peer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK9C,qBAAa,QAAS,YAAW,IAAI;aAQjB,IAAI,EAAE,cAAc;IAPtC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,OAAO,EAAE,WAAW,CAAC;IACrC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,GAAG,EAAE,UAAU,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAGjC,IAAI,EAAE,cAAc,EACpC,QAAQ,EAAE,QAAQ;IAuBpB,mBAAmB,CAAC,cAAc,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI;IAIrE,UAAU,IAAI,UAAU;IAMlB,UAAU;CAIjB"}
+{"version":3,"file":"quic-peer.d.ts","sourceRoot":"","sources":["../../../../../packages/core/networking/quic-peer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK9C,qBAAa,QAAS,YAAW,IAAI;aAYjB,IAAI,EAAE,cAAc;IAXtC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,OAAO,EAAE,WAAW,CAAC;IACrC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,GAAG,EAAE,UAAU,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IAEnD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ;IAInD,OAAO;IAyBP,mBAAmB,CAAC,cAAc,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI;IAIrE,UAAU,IAAI,UAAU;IAMlB,UAAU;CAIjB"}

package/packages/core/networking/quic-peer.js

@@ -11,6 +11,9 @@ export class QuicPeer {
     id;
     key;
     streamEvents = new EventEmitter();
+    static new(conn, peerInfo) {
+        return new QuicPeer(conn, peerInfo);
+    }
     constructor(conn, peerInfo) {
         this.conn = conn;
         logger.log `👥 [${peerInfo.id}] peer connected ${conn.remoteHost}:${conn.remotePort}`;
@@ -24,7 +27,7 @@ export class QuicPeer {
         addEventListener(conn, events.EventQUICConnectionStream, (ev) => {
             const stream = ev.detail;
             logger.log `🚰  [${this.id}] new stream: [${stream.streamId}]`;
-            this.streamEvents.emit("stream", new QuicStream(stream));
+            this.streamEvents.emit("stream", QuicStream.new(stream));
         });
         addEventListener(conn, events.EventQUICConnectionError, (err) => {
             logger.error `❌ [${this.id}] connection failed: ${err.detail}`;
@@ -36,7 +39,7 @@ export class QuicPeer {
     openStream() {
         const stream = this.conn.newStream("bidi");
         logger.log `🚰 [${this.id}] opening stream: [${stream.streamId}]`;
-        return new QuicStream(stream);
+        return QuicStream.new(stream);
     }
     async disconnect() {
         logger.log `👋 [${this.id}] disconnecting`;

package/packages/core/networking/quic-stream.d.ts

@@ -3,7 +3,8 @@ import { type Stream, type StreamErrorCallback } from "./peers.js";
 /** `QUICStream` adapter for our `Stream` API. */
 export declare class QuicStream implements Stream {
     readonly stream: QUICStream;
-    constructor(stream: QUICStream);
+    static new(stream: QUICStream): QuicStream;
+    private constructor();
     get streamId(): import("@matrixai/quic").StreamId;
     get readable(): import("stream/web").ReadableStream<Uint8Array<ArrayBufferLike>>;
     get writable(): import("stream/web").WritableStream<Uint8Array<ArrayBufferLike>>;

package/packages/core/networking/quic-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quic-stream.d.ts","sourceRoot":"","sources":["../../../../../packages/core/networking/quic-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,mBAAmB,EAAmB,MAAM,YAAY,CAAC;AAGpF,iDAAiD;AACjD,qBAAa,UAAW,YAAW,MAAM;aACX,MAAM,EAAE,UAAU;gBAAlB,MAAM,EAAE,UAAU;IAE9C,IAAI,QAAQ,sCAEX;IAED,IAAI,QAAQ,qEAEX;IAED,IAAI,QAAQ,qEAEX;IAED,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAmB9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGzB"}
+{"version":3,"file":"quic-stream.d.ts","sourceRoot":"","sources":["../../../../../packages/core/networking/quic-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,mBAAmB,EAAmB,MAAM,YAAY,CAAC;AAGpF,iDAAiD;AACjD,qBAAa,UAAW,YAAW,MAAM;aAKH,MAAM,EAAE,UAAU;IAJtD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU;IAI7B,OAAO;IAEP,IAAI,QAAQ,sCAEX;IAED,IAAI,QAAQ,qEAEX;IAED,IAAI,QAAQ,qEAEX;IAED,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAmB9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGzB"}

package/packages/core/networking/quic-stream.js

@@ -4,6 +4,9 @@ import { addEventListener } from "./quic-utils.js";
 /** `QUICStream` adapter for our `Stream` API. */
 export class QuicStream {
     stream;
+    static new(stream) {
+        return new QuicStream(stream);
+    }
     constructor(stream) {
         this.stream = stream;
     }

package/packages/core/networking/setup.js

@@ -144,7 +144,7 @@ export class Quic {
             }
         }
         function newPeer(conn, peerInfo, side) {
-            const peer = new QuicPeer(conn, peerInfo);
+            const peer = QuicPeer.new(conn, peerInfo);
             const connectionStartTime = now();
             addEventListener(peer.conn, events.EventQUICConnectionClose, (ev) => {
                 const duration = now() - connectionStartTime;
@@ -155,6 +155,6 @@ export class Quic {
             peers.peerConnected(peer);
             return peer;
         }
-        return new QuicNetwork(socket, server, dial, peers, { host, port });
+        return QuicNetwork.new(socket, server, dial, peers, { host, port });
     }
 }

package/packages/core/pvm-host-calls/bin.js

@@ -3,9 +3,9 @@ import { tryAsGas } from "#@typeberry/pvm-interface";
 import { HostCalls, NoopMissing } from "./host-calls.js";
 import { HostCallsExecutor } from "./host-calls-executor.js";
 import { PvmInstanceManager } from "./pvm-instance-manager.js";
-const hostCalls = new HostCalls({ missing: new NoopMissing(), handlers: [] });
+const hostCalls = HostCalls.new({ missing: new NoopMissing(), handlers: [] });
 const pvmInstanceManager = await PvmInstanceManager.new(PvmBackend.BuiltIn);
-const pvmHostCallExtension = new HostCallsExecutor(pvmInstanceManager, hostCalls);
+const pvmHostCallExtension = HostCallsExecutor.new(pvmInstanceManager, hostCalls);
 const program = new Uint8Array([
     0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x10, 0x1, 0x0, 0x0, 0xf9, 0x0, 0x0, 0x0, 0x0, 0x0, 0x80, 0xd9, 0x5, 0x12,
     0x0, 0x0, 0x0, 0x5, 0x11, 0x0, 0x0, 0x0, 0x5, 0xa3, 0x0, 0x0, 0x0, 0x5, 0xc6, 0x0, 0x4, 0x7, 0x13, 0x0, 0x2, 0x11,

package/packages/core/pvm-host-calls/ecalli-trace-logger.test.js

@@ -12,7 +12,7 @@ function createRegisters(values) {
     for (const [idx, value] of values) {
         view.setBigUint64(idx * REGISTER_BYTE_SIZE, value, true);
     }
-    return new HostCallRegisters(bytes);
+    return HostCallRegisters.fromRaw(bytes);
 }
 describe("IoTraceLogger", () => {
     describe("logProgram", () => {

package/packages/core/pvm-host-calls/host-call-memory.d.ts

@@ -5,7 +5,8 @@ import type { IoTracker } from "./ecalli-io-tracker.js";
 export declare class HostCallMemory {
     private readonly memory;
     ioTracker: IoTracker | null;
-    constructor(memory: IMemory);
+    static new(memory: IMemory): HostCallMemory;
+    private constructor();
     /**
      * Save some bytes into memory under given address.
      *

package/packages/core/pvm-host-calls/host-call-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-call-memory.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF5B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAEb,MAAM,EAAE,OAAO;IAE5C;;;;;OAKG;IACH,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAgBpE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;CAerE"}
+{"version":3,"file":"host-call-memory.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,cAAc;IAQL,OAAO,CAAC,QAAQ,CAAC,MAAM;IANpC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE1C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;IAI1B,OAAO;IAEP;;;;;OAKG;IACH,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAgBpE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;CAerE"}

package/packages/core/pvm-host-calls/host-call-memory.js

@@ -4,6 +4,9 @@ export class HostCallMemory {
     memory;
     // Track successful memory reads and writes.
     ioTracker = null;
+    static new(memory) {
+        return new HostCallMemory(memory);
+    }
     constructor(memory) {
         this.memory = memory;
     }

package/packages/core/pvm-host-calls/host-call-memory.test.js

@@ -18,7 +18,7 @@ describe("HostCallMemory", () => {
     let hostCallMemory;
     beforeEach(() => {
         memory = new FakeMemory();
-        hostCallMemory = new HostCallMemory(memory);
+        hostCallMemory = HostCallMemory.new(memory);
     });
     describe("storeFrom", () => {
         it("should always allow 0-length bytes", () => {

package/packages/core/pvm-host-calls/host-call-registers.d.ts

@@ -5,7 +5,11 @@ export declare class HostCallRegisters {
     private readonly raw;
     private readonly registers;
     ioTracker: IoTracker | null;
-    constructor(bytes: Uint8Array);
+    /** Creates empty registers object. */
+    static empty(noOfRegisters?: number): HostCallRegisters;
+    /** Creates new `HostCallRegisters` by wrapping an already allocated byte array. */
+    static fromRaw(bytes: Uint8Array): HostCallRegisters;
+    private constructor();
     /** Get U64 register value. */
     get(registerIndex: number): U64;
     /** Set U64 register value. */

package/packages/core/pvm-host-calls/host-call-registers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-call-registers.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-registers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,iBAAiB;IAMhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IAE9B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAEb,KAAK,EAAE,UAAU;IAK9C,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG;IAI/B,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAOrC,0DAA0D;IAC1D,UAAU,IAAI,UAAU;IAIxB,sCAAsC;IACtC,UAAU,CAAC,KAAK,EAAE,UAAU;IAK5B,QAAQ;CAWT"}
+{"version":3,"file":"host-call-registers.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-registers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,iBAAiB;IAkBR,OAAO,CAAC,QAAQ,CAAC,KAAK;IAjB1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IAE9B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE1C,sCAAsC;IACtC,MAAM,CAAC,KAAK,CAAC,aAAa,SAAkB;IAI5C,mFAAmF;IACnF,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU;IAMhC,OAAO;IAKP,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG;IAI/B,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAOrC,0DAA0D;IAC1D,UAAU,IAAI,UAAU;IAIxB,sCAAsC;IACtC,UAAU,CAAC,KAAK,EAAE,UAAU;IAK5B,QAAQ;CAWT"}

package/packages/core/pvm-host-calls/host-call-registers.js

@@ -1,5 +1,5 @@
 import { tryAsU64 } from "#@typeberry/numbers";
-import { REGISTER_BYTE_SIZE } from "#@typeberry/pvm-interface";
+import { NO_OF_REGISTERS, REGISTER_BYTE_SIZE } from "#@typeberry/pvm-interface";
 import { check } from "#@typeberry/utils";
 export class HostCallRegisters {
     bytes;
@@ -7,6 +7,16 @@ export class HostCallRegisters {
     registers;
     // Track register modifications.
     ioTracker = null;
+    /** Creates empty registers object. */
+    static empty(noOfRegisters = NO_OF_REGISTERS) {
+        return HostCallRegisters.fromRaw(new Uint8Array(noOfRegisters * REGISTER_BYTE_SIZE));
+    }
+    /** Creates new `HostCallRegisters` by wrapping an already allocated byte array. */
+    static fromRaw(bytes) {
+        check `${bytes.length % REGISTER_BYTE_SIZE === 0} registers array must be a multiply of ${REGISTER_BYTE_SIZE},
+    got: ${bytes.length}`;
+        return new HostCallRegisters(bytes);
+    }
     constructor(bytes) {
         this.bytes = bytes;
         this.raw = bytes;

package/packages/core/pvm-host-calls/host-call-registers.test.js

@@ -7,14 +7,14 @@ describe("HostCallRegisters", () => {
         it("reads a u64 value from the underlying registers", () => {
             const regs = new BigUint64Array(13);
             regs[0] = 0xfffffffffffffffdn;
-            const hostCallRegisters = new HostCallRegisters(new Uint8Array(regs.buffer));
+            const hostCallRegisters = HostCallRegisters.fromRaw(new Uint8Array(regs.buffer));
             assert.strictEqual(hostCallRegisters.get(0), tryAsU64(0xfffffffffffffffdn));
         });
     });
     describe("setAllEncoded", () => {
         it("writes a u64 value to the underlying registers", () => {
             const regs = new BigUint64Array(13);
-            const hostCallRegisters = new HostCallRegisters(new Uint8Array(regs.buffer));
+            const hostCallRegisters = HostCallRegisters.fromRaw(new Uint8Array(regs.buffer));
             hostCallRegisters.set(0, tryAsU64(0xfffffffffffffffdn));
             const view = new DataView(hostCallRegisters.getEncoded().buffer);
             assert.strictEqual(view.getBigUint64(0, true), tryAsU64(0xfffffffffffffffdn));

package/packages/core/pvm-host-calls/host-calls-executor.d.ts

@@ -29,7 +29,8 @@ export declare class HostCallsExecutor {
     private pvmInstanceManager;
     private hostCalls;
     private ioTracer;
-    constructor(pvmInstanceManager: PvmInstanceManager, hostCalls: HostCalls, ioTracer?: EcalliTraceLogger | null);
+    static new(pvmInstanceManager: PvmInstanceManager, hostCalls: HostCalls, ioTracer?: EcalliTraceLogger | null): HostCallsExecutor;
+    private constructor();
     private getReturnValue;
     private execute;
     runProgram(program: Uint8Array, args: Uint8Array, initialPc: number, initialGas: Gas): Promise<ReturnValue>;

package/packages/core/pvm-host-calls/host-calls-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-calls-executor.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-calls-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAgC,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;GAMG;AACH,oBAAY,YAAY;IACtB,2BAA2B;IAC3B,EAAE,IAAI;IACN,iCAAiC;IACjC,GAAG,IAAI;IACP,qCAAqC;IACrC,KAAK,IAAI;CACV;AAED,MAAM,MAAM,WAAW,CAAC,IAAI,GAAG,GAAG,IAAI;IACpC,WAAW,EAAE,IAAI,CAAC;CACnB,GAAG,CACA;IACE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,CAAC;CACzB,GACD;IACE,MAAM,EAAE,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC;CAC/C,CACJ,CAAC;AAEF,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ;gBAFR,kBAAkB,EAAE,kBAAkB,EACtC,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,iBAAiB,GAAG,IAAiC;IAGzE,OAAO,CAAC,cAAc;YAqCR,OAAO;IAkFf,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;CAWlH"}
+{"version":3,"file":"host-calls-executor.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-calls-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAgC,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;GAMG;AACH,oBAAY,YAAY;IACtB,2BAA2B;IAC3B,EAAE,IAAI;IACN,iCAAiC;IACjC,GAAG,IAAI;IACP,qCAAqC;IACrC,KAAK,IAAI;CACV;AAED,MAAM,MAAM,WAAW,CAAC,IAAI,GAAG,GAAG,IAAI;IACpC,WAAW,EAAE,IAAI,CAAC;CACnB,GAAG,CACA;IACE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,CAAC;CACzB,GACD;IACE,MAAM,EAAE,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC;CAC/C,CACJ,CAAC;AAEF,qBAAa,iBAAiB;IAU1B,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ;IAXlB,MAAM,CAAC,GAAG,CACR,kBAAkB,EAAE,kBAAkB,EACtC,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,iBAAiB,GAAG,IAAiC;IAKjE,OAAO;IAMP,OAAO,CAAC,cAAc;YAqCR,OAAO;IAkFf,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;CAWlH"}

package/packages/core/pvm-host-calls/host-calls-executor.js

@@ -24,6 +24,9 @@ export class HostCallsExecutor {
     pvmInstanceManager;
     hostCalls;
     ioTracer;
+    static new(pvmInstanceManager, hostCalls, ioTracer = EcalliTraceLogger.create()) {
+        return new HostCallsExecutor(pvmInstanceManager, hostCalls, ioTracer);
+    }
     constructor(pvmInstanceManager, hostCalls, ioTracer = EcalliTraceLogger.create()) {
         this.pvmInstanceManager = pvmInstanceManager;
         this.hostCalls = hostCalls;
@@ -54,9 +57,9 @@ export class HostCallsExecutor {
     }
     async execute(pvmInstance, initialPc) {
         const ioTracker = this.ioTracer?.tracker() ?? null;
-        const registers = new HostCallRegisters(pvmInstance.registers.getAllEncoded());
+        const registers = HostCallRegisters.fromRaw(pvmInstance.registers.getAllEncoded());
         registers.ioTracker = ioTracker;
-        const memory = new HostCallMemory(pvmInstance.memory);
+        const memory = HostCallMemory.new(pvmInstance.memory);
         memory.ioTracker = ioTracker;
         const gas = pvmInstance.gas;
         // log start of execution (note the PVM initialisation should be logged already)