@typeberry/lib 0.8.4 → 0.9.0-1c3f157

package/packages/core/bytes/bytes.d.ts

@@ -71,6 +71,7 @@ export declare class Bytes<T extends number> extends BytesBlob {
     isEqualTo(other: Bytes<T>): boolean;
     /** Converts current type into some opaque extension. */
     asOpaque<R>(): Opaque<Bytes<T>, TokenOf<R, Bytes<T>>>;
+    toStringTruncated(): string;
 }
 export declare const bytesBlobComparator: Comparator<BytesBlob>;
 //# sourceMappingURL=bytes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../../../packages/core/bytes/bytes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../../../packages/core/bytes/bytes.ts"],"names":[],"mappings":"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"}

package/packages/core/bytes/bytes.js

@@ -197,6 +197,14 @@ export class Bytes extends BytesBlob {
     asOpaque() {
         return asOpaqueType(this);
     }
+    toStringTruncated() {
+        if (this.raw.length > 8) {
+            const start = bytesToHexString(this.raw.subarray(0, 2));
+            const end = bytesToHexString(this.raw.subarray(this.raw.length - 2));
+            return `${start}...${end.substring(2)}`;
+        }
+        return `${this.toString()}`;
+    }
 }
 function byteFromString(s) {
     check `${s.length === 2} Two-character string expected`;

package/packages/core/collections/sorted-array.d.ts

@@ -56,7 +56,7 @@ export declare class SortedArray<V> implements ImmutableSortedArray<V> {
     findIndex(v: V): number;
     findExact(v: V): V | undefined;
     /** Remove one matching element from the collection. */
-    removeOne(v: V): void;
+    removeOne(v: V): V | undefined;
     has(v: V): boolean;
     get length(): number;
     /** Return a regular array that's a copy of this one. */

package/packages/core/collections/sorted-array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sorted-array.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/sorted-array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAC1D,wBAAwB;IACxB,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAAC;IAC1B,6BAA6B;IAC7B,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAEhC;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IAExB;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAE/B,qDAAqD;IACrD,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,IAAI,MAAM,IAAI,MAAM,CAAC;IAErB,wDAAwD;IACxD,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,oBAAoB,CAAC,CAAC,CAAC;aAgC1C,KAAK,EAAE,CAAC,EAAE;aACV,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAhC3C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAMvE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAkB7E,SAAS,aACS,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAG3C,4CAA4C;IACrC,MAAM,CAAC,CAAC,EAAE,CAAC;IAKlB;;;;OAIG;IACI,GAAG,IAAI,CAAC,GAAG,SAAS;IAIpB,SAAS,CAAC,CAAC,EAAE,CAAC;IASd,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IASrC,uDAAuD;IAChD,SAAS,CAAC,CAAC,EAAE,CAAC;IAQd,GAAG,CAAC,CAAC,EAAE,CAAC;IAIf,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,wDAAwD;IACjD,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;IAI/C,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;;;;IA8B3B,4DAA4D;IAC5D,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAqClG,kDAAkD;IACjD,CAAC,MAAM,CAAC,QAAQ,CAAC;CAKnB"}
+{"version":3,"file":"sorted-array.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/sorted-array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAC1D,wBAAwB;IACxB,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAAC;IAC1B,6BAA6B;IAC7B,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAEhC;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IAExB;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAE/B,qDAAqD;IACrD,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,IAAI,MAAM,IAAI,MAAM,CAAC;IAErB,wDAAwD;IACxD,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,oBAAoB,CAAC,CAAC,CAAC;aAgC1C,KAAK,EAAE,CAAC,EAAE;aACV,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAhC3C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAMvE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAkB7E,SAAS,aACS,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAG3C,4CAA4C;IACrC,MAAM,CAAC,CAAC,EAAE,CAAC;IAKlB;;;;OAIG;IACI,GAAG,IAAI,CAAC,GAAG,SAAS;IAIpB,SAAS,CAAC,CAAC,EAAE,CAAC;IASd,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IASrC,uDAAuD;IAChD,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAU9B,GAAG,CAAC,CAAC,EAAE,CAAC;IAIf,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,wDAAwD;IACjD,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;IAI/C,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;;;;IA8B3B,4DAA4D;IAC5D,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAqClG,kDAAkD;IACjD,CAAC,MAAM,CAAC,QAAQ,CAAC;CAKnB"}

package/packages/core/collections/sorted-array.js

@@ -69,9 +69,11 @@ export class SortedArray {
     removeOne(v) {
         const findIdx = this.binarySearch(v);
         if (findIdx.isEqual) {
-            // remove the element
-            this.array.splice(findIdx.idx, 1);
+            // remove the element and return the stored one
+            const [removed] = this.array.splice(findIdx.idx, 1);
+            return removed;
         }
+        return undefined;
     }
     has(v) {
         return this.binarySearch(v).isEqual;

package/packages/core/collections/sorted-array.test.js

@@ -59,6 +59,16 @@ describe("SortedArray", { timeout: 10 }, () => {
         data.removeOne(2);
         assert.deepStrictEqual(data.slice(), [3]);
     });
+    it("should return the stored element that was removed", () => {
+        const byKey = (self, other) => cmp(self[0], other[0]);
+        const data = SortedArray.fromArray(byKey, [
+            [1, "a"],
+            [2, "b"],
+        ]);
+        const removed = data.removeOne([1, "x"]);
+        assert.deepStrictEqual(removed, [1, "a"]);
+        assert.strictEqual(data.removeOne([5, "z"]), undefined);
+    });
     it("should throw when using fromSortedArray and array is not sorted", () => {
         const data = [1, 3, 2];
         const tryToCreate = () => SortedArray.fromSortedArray(cmp, data);

package/packages/core/collections/sorted-set.d.ts

@@ -34,7 +34,7 @@ export declare class SortedSet<V> extends SortedArray<V> implements ImmutableSor
      *
      * Putting another value that's equal via comparator will replace the current one.
      */
-    replace(v: V): void;
+    replace(v: V): V | undefined;
     /** Create a new SortedSet from two sorted collections. */
     static fromTwoSortedCollections<V>(first: ImmutableSortedArray<V>, second: ImmutableSortedArray<V>): SortedSet<V>;
 }

package/packages/core/collections/sorted-set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sorted-set.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/sorted-set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,KAAK,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3E,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAC;CAAG;AAEzE;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAE,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAC/E;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAkBvE;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE;IAaxE;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAiB7E,wEAAwE;IACjE,MAAM,CAAC,CAAC,EAAE,CAAC;IAOlB;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,CAAC;IAMnB,0DAA0D;IAC1D,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;CA0BnG"}
+{"version":3,"file":"sorted-set.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/sorted-set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,KAAK,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3E,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAC;CAAG;AAEzE;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAE,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAC/E;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAkBvE;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE;IAaxE;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,SAAS,CAAC,EAAO;IAiB7E,wEAAwE;IACjE,MAAM,CAAC,CAAC,EAAE,CAAC;IAOlB;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAUnC,0DAA0D;IAC1D,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;CA0BnG"}

package/packages/core/collections/sorted-set.js

@@ -73,8 +73,12 @@ export class SortedSet extends SortedArray {
      */
     replace(v) {
         const findIdx = this.binarySearch(v);
-        const toRemove = findIdx.isEqual ? 1 : 0;
-        this.array.splice(findIdx.idx, toRemove, v);
+        if (findIdx.isEqual) {
+            const [displaced] = this.array.splice(findIdx.idx, 1, v);
+            return displaced;
+        }
+        this.array.splice(findIdx.idx, 0, v);
+        return undefined;
     }
     /** Create a new SortedSet from two sorted collections. */
     static fromTwoSortedCollections(first, second) {

package/packages/core/collections/sorted-set.test.js

@@ -65,6 +65,30 @@ describe("SortedSet", () => {
             assert.deepStrictEqual(data.length, 3);
         });
     });
+    describe("replace", () => {
+        const byKey = (self, other) => cmp(self[0], other[0]);
+        it("should return the displaced element when replacing an equal one", () => {
+            const data = SortedSet.fromArrayUnique(byKey, [
+                [1, "a"],
+                [2, "b"],
+            ]);
+            const displaced = data.replace([1, "c"]);
+            assert.deepStrictEqual(displaced, [1, "a"]);
+            assert.deepStrictEqual(data.slice(), [
+                [1, "c"],
+                [2, "b"],
+            ]);
+        });
+        it("should return undefined when inserting a fresh element", () => {
+            const data = SortedSet.fromArrayUnique(byKey, [[1, "a"]]);
+            const displaced = data.replace([2, "b"]);
+            assert.strictEqual(displaced, undefined);
+            assert.deepStrictEqual(data.slice(), [
+                [1, "a"],
+                [2, "b"],
+            ]);
+        });
+    });
     describe("fromTwoSortedCollections", () => {
         it("should merge two sorted sets without duplicates", () => {
             const arr1 = [1, 2, 3];

package/packages/core/utils/debug.d.ts

@@ -59,9 +59,11 @@ export declare function measure(id: string): () => {
  * `arrayBuffers` should allow tracking WASM memory, since every instance backs its
  * memory with `ArrayBuffer`.
  */
-export declare function memoryUsage(): string;
+export declare function memoryUsage(withDetails: boolean): string;
 /** Create a stateful memory usage reporter. */
-export declare function memoryTracker(): () => string;
+export declare function memoryTracker(withDetails: boolean): {
+    toString(): string;
+};
 /** A class that adds `toString` method that prints all properties of an object. */
 export declare abstract class WithDebug {
     toString(): string;

package/packages/core/utils/debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../../../packages/core/utils/debug.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,YAExB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,cAA6F,CAAC;AAE9G;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,OAAO,EAClB,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,SAAS,IAAI,IAAI,CAO3B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,QAKpE;AAED,6BAA6B;AAC7B,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAEzC;AAkED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;EAgBjC;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,IAAI,MAAM,MAAM,CAc5C;AAED,mFAAmF;AACnF,8BAAsB,SAAS;IAC7B,QAAQ;CAGT;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;;EAMpC"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../../../packages/core/utils/debug.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,YAExB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,cAA6F,CAAC;AAE9G;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,OAAO,EAClB,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,SAAS,IAAI,IAAI,CAO3B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,QAKpE;AAED,6BAA6B;AAC7B,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAEzC;AAkED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;EAgBjC;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAUxD;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,WAAW,EAAE,OAAO,GAAG;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,CAgB1E;AAED,mFAAmF;AACnF,8BAAsB,SAAS;IAC7B,QAAQ;CAGT;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;;EAMpC"}

package/packages/core/utils/debug.js

@@ -148,26 +148,31 @@ function rawMemoryUsage() {
  * `arrayBuffers` should allow tracking WASM memory, since every instance backs its
  * memory with `ArrayBuffer`.
  */
-export function memoryUsage() {
+export function memoryUsage(withDetails) {
     const m = rawMemoryUsage();
     if (m === null) {
         return "";
     }
-    return `rss=${toMb(m.rss)}MB heap=${toMb(m.heapUsed)}/${toMb(m.heapTotal)}MB external=${toMb(m.external)}MB arrayBuffers=${toMb(m.arrayBuffers)}MB`;
+    if (withDetails) {
+        return `rss=${toMb(m.rss)}MB heap=${toMb(m.heapUsed)}/${toMb(m.heapTotal)}MB external=${toMb(m.external)}MB arrayBuffers=${toMb(m.arrayBuffers)}MB`;
+    }
+    return `rss=${toMb(m.rss)}MB heap=${toMb(m.heapUsed)}/${toMb(m.heapTotal)}MB`;
 }
 /** Create a stateful memory usage reporter. */
-export function memoryTracker() {
+export function memoryTracker(withDetails) {
     let prev = null;
-    return () => {
-        const m = rawMemoryUsage();
-        if (m === null) {
-            return "";
-        }
-        const delta = prev === null
-            ? ""
-            : ` (Δrss=${signedMb(m.rss - prev.rss)}MB ΔarrayBuffers=${signedMb(m.arrayBuffers - prev.arrayBuffers)}MB)`;
-        prev = m;
-        return `${memoryUsage()}${delta}`;
+    return {
+        toString() {
+            const m = rawMemoryUsage();
+            if (m === null) {
+                return "";
+            }
+            const delta = prev === null || withDetails === false
+                ? ""
+                : ` (Δrss=${signedMb(m.rss - prev.rss)}MB ΔarrayBuffers=${signedMb(m.arrayBuffers - prev.arrayBuffers)}MB)`;
+            prev = m;
+            return `${memoryUsage(withDetails)}${delta}`;
+        },
     };
 }
 /** A class that adds `toString` method that prints all properties of an object. */

package/packages/core/utils/debug.test.js

@@ -25,21 +25,27 @@ describe("utils::lazyInspect", () => {
 });
 describe("utils::memoryUsage", () => {
     it("should report all memory fields", () => {
-        const usage = memoryUsage();
+        const usage = memoryUsage(true);
         for (const field of ["rss=", "heap=", "external=", "arrayBuffers="]) {
             assert.ok(usage.includes(field), `expected "${field}" in "${usage}"`);
         }
     });
+    it("should report all memory fields without details", () => {
+        const usage = memoryUsage(false);
+        for (const field of ["rss=", "heap="]) {
+            assert.ok(usage.includes(field), `expected "${field}" in "${usage}"`);
+        }
+    });
 });
 describe("utils::memoryTracker", () => {
     it("should not include a delta on the first call", () => {
-        const tracker = memoryTracker();
-        assert.ok(!tracker().includes("Δrss"));
+        const tracker = memoryTracker(true);
+        assert.ok(!tracker.toString().includes("Δrss"));
     });
     it("should include a delta on subsequent calls", () => {
-        const tracker = memoryTracker();
-        tracker();
-        const second = tracker();
+        const tracker = memoryTracker(true);
+        tracker.toString();
+        const second = tracker.toString();
         assert.ok(second.includes("Δrss="), `expected delta in "${second}"`);
         assert.ok(second.includes("ΔarrayBuffers="), `expected delta in "${second}"`);
     });

package/packages/core/utils/index.d.ts

@@ -18,5 +18,6 @@ export * from "./opaque.js";
 export { name, version } from "./package.js";
 export * from "./result.js";
 export * from "./safe-alloc-uint8array.js";
+export * from "./shutdown.js";
 export * from "./test.js";
 //# sourceMappingURL=index.d.ts.map

package/packages/core/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/packages/core/utils/index.js

@@ -18,4 +18,5 @@ export * from "./opaque.js";
 export { name, version } from "./package.js";
 export * from "./result.js";
 export * from "./safe-alloc-uint8array.js";
+export * from "./shutdown.js";
 export * from "./test.js";

package/packages/core/utils/shutdown.d.ts

@@ -0,0 +1,18 @@
+export type Closer = () => Promise<void>;
+export type ShutdownSignal = string;
+export interface ShutdownLogger {
+    info: (msg: string) => void;
+    error: (msg: string) => void;
+}
+export interface ShutdownOptions {
+    /** Max ms allowed for `close` before forced exit(1). Default 10_000. */
+    timeoutMs?: number;
+    /** Signals to listen for. Default ["SIGTERM", "SIGINT"]. */
+    signals?: readonly ShutdownSignal[];
+    /** Logger; defaults to a no-op logger. */
+    log?: ShutdownLogger;
+    /** Test hook used instead of process.exit. */
+    exit?: (code: number) => never;
+}
+export declare function installShutdownHandlers(_close: Closer, _options?: ShutdownOptions): () => void;
+//# sourceMappingURL=shutdown.d.ts.map

package/packages/core/utils/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../../../../packages/core/utils/shutdown.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,MAAM,IAAI,CAElG"}

package/packages/core/utils/shutdown.js

@@ -0,0 +1,3 @@
+export function installShutdownHandlers(_close, _options = {}) {
+    return () => { };
+}

package/packages/core/utils/shutdown.node.d.ts

@@ -0,0 +1,5 @@
+import type { Closer, ShutdownOptions } from "./shutdown.js";
+export type { Closer, ShutdownLogger, ShutdownOptions, ShutdownSignal } from "./shutdown.js";
+/** Returns an uninstall function (used by tests). */
+export declare function installShutdownHandlers(close: Closer, options?: ShutdownOptions): () => void;
+//# sourceMappingURL=shutdown.node.d.ts.map

package/packages/core/utils/shutdown.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.node.d.ts","sourceRoot":"","sources":["../../../../../packages/core/utils/shutdown.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE7D,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAK7F,qDAAqD;AACrD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,IAAI,CA+EhG"}

package/packages/core/utils/shutdown.node.js

@@ -0,0 +1,76 @@
+const DEFAULT_SIGNALS = ["SIGTERM", "SIGINT"];
+const DEFAULT_TIMEOUT_MS = 10_000;
+/** Returns an uninstall function (used by tests). */
+export function installShutdownHandlers(close, options = {}) {
+    const signals = (options.signals ?? DEFAULT_SIGNALS);
+    const exit = (options.exit ?? process.exit);
+    const log = options.log;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    let state = "idle";
+    const forceExit = (signal) => {
+        log?.error(`Received ${signal} during shutdown, forcing exit.`);
+        try {
+            exit(1);
+        }
+        catch {
+            // test-time exit throws; swallow.
+        }
+    };
+    const handler = (signal) => {
+        if (state === "closing" || state === "done") {
+            forceExit(signal);
+            return;
+        }
+        state = "closing";
+        log?.info(`Received ${signal}, draining...`);
+        void (async () => {
+            const TIMED_OUT = Symbol("timed-out");
+            let timeoutHandle;
+            const timeoutPromise = new Promise((resolve) => {
+                timeoutHandle = setTimeout(() => resolve(TIMED_OUT), timeoutMs);
+            });
+            timeoutHandle?.unref?.();
+            let code = 0;
+            try {
+                const outcome = await Promise.race([
+                    Promise.resolve()
+                        .then(close)
+                        .then(() => "ok", (e) => ({ err: e })),
+                    timeoutPromise,
+                ]);
+                if (outcome === TIMED_OUT) {
+                    code = 1;
+                    log?.error(`Shutdown cleanup exceeded ${timeoutMs}ms timeout, forcing exit.`);
+                }
+                else if (typeof outcome === "object" && "err" in outcome) {
+                    code = 1;
+                    const e = outcome.err;
+                    log?.error(`Shutdown close threw: ${e instanceof Error ? (e.stack ?? e.message) : String(e)}`);
+                }
+                else {
+                    log?.info("Shutdown complete.");
+                }
+            }
+            finally {
+                clearTimeout(timeoutHandle);
+                state = "done";
+            }
+            try {
+                exit(code);
+            }
+            catch {
+                // test-time exit throws; swallow.
+            }
+        })();
+    };
+    // Node passes the signal name to the listener, so a single handler works
+    // for every signal.
+    for (const sig of signals) {
+        process.on(sig, handler);
+    }
+    return () => {
+        for (const sig of signals) {
+            process.off(sig, handler);
+        }
+    };
+}

package/packages/core/utils/shutdown.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shutdown.test.d.ts.map

package/packages/core/utils/shutdown.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.test.d.ts","sourceRoot":"","sources":["../../../../../packages/core/utils/shutdown.test.ts"],"names":[],"mappings":""}

package/packages/core/utils/shutdown.test.js

@@ -0,0 +1,164 @@
+import assert from "node:assert";
+import { afterEach, describe, it } from "node:test";
+import { installShutdownHandlers as installGenericShutdownHandlers } from "./shutdown.js";
+import { installShutdownHandlers } from "./shutdown.node.js";
+function makeExitRecorder() {
+    let resolveExited;
+    const exited = new Promise((resolve) => {
+        resolveExited = resolve;
+    });
+    const recorder = {
+        exitCode: null,
+        exited,
+        exit: ((code) => {
+            recorder.exitCode = code;
+            resolveExited();
+            // Satisfy `never` and abort the calling promise chain.
+            throw new Error(`__test_exit_${code}`);
+        }),
+    };
+    return recorder;
+}
+const silentLog = { info: () => { }, error: () => { } };
+describe("utils::installShutdownHandlers", () => {
+    const uninstallers = [];
+    afterEach(() => {
+        while (uninstallers.length > 0) {
+            uninstallers.pop()?.();
+        }
+    });
+    it("calls close and exits 0 on first SIGTERM", async () => {
+        const exitRec = makeExitRecorder();
+        let closeCalled = false;
+        uninstallers.push(installShutdownHandlers(async () => {
+            closeCalled = true;
+        }, { exit: exitRec.exit, log: silentLog }));
+        process.emit("SIGTERM", "SIGTERM");
+        await exitRec.exited;
+        assert.strictEqual(closeCalled, true);
+        assert.strictEqual(exitRec.exitCode, 0);
+    });
+    it("exits with code 1 when cleanup exceeds timeoutMs", async () => {
+        const exitRec = makeExitRecorder();
+        let closeStarted = false;
+        let errorLogged = null;
+        let releaseClose;
+        const closeReleased = new Promise((resolve) => {
+            releaseClose = resolve;
+        });
+        uninstallers.push(installShutdownHandlers(async () => {
+            closeStarted = true;
+            await closeReleased;
+        }, {
+            exit: exitRec.exit,
+            timeoutMs: 5,
+            log: {
+                info: () => { },
+                error: (msg) => {
+                    errorLogged = msg;
+                },
+            },
+        }));
+        process.emit("SIGTERM", "SIGTERM");
+        await exitRec.exited;
+        assert.strictEqual(closeStarted, true, "close should have been invoked");
+        assert.strictEqual(exitRec.exitCode, 1);
+        assert.ok(errorLogged !== null, "expected timeout to be logged");
+        assert.match(errorLogged, /timeout|exceed/i);
+        // Allow the in-flight close promise to settle so the test doesn't leak.
+        releaseClose();
+    });
+    it("forces exit 1 when a second signal arrives during cleanup", async () => {
+        const exitRec = makeExitRecorder();
+        let releaseClose;
+        const closeReleased = new Promise((resolve) => {
+            releaseClose = resolve;
+        });
+        let errorLogged = null;
+        uninstallers.push(installShutdownHandlers(async () => {
+            await closeReleased;
+        }, {
+            // Large timeout so this test can't pass via the timeout path.
+            timeoutMs: 60_000,
+            exit: exitRec.exit,
+            log: {
+                info: () => { },
+                error: (msg) => {
+                    errorLogged = msg;
+                },
+            },
+        }));
+        process.emit("SIGTERM", "SIGTERM");
+        await new Promise((resolve) => setImmediate(resolve));
+        process.emit("SIGINT", "SIGINT");
+        await exitRec.exited;
+        assert.strictEqual(exitRec.exitCode, 1);
+        assert.ok(errorLogged !== null, "expected force-exit message to be logged");
+        assert.match(errorLogged, /SIGINT/);
+        releaseClose();
+    });
+    it("does nothing after uninstall", async () => {
+        const exitRec = makeExitRecorder();
+        let closeCalled = false;
+        const uninstall = installShutdownHandlers(async () => {
+            closeCalled = true;
+        }, { exit: exitRec.exit, log: silentLog });
+        uninstall();
+        process.emit("SIGTERM", "SIGTERM");
+        // Give any (incorrectly registered) handler a tick to fire.
+        await new Promise((resolve) => setImmediate(resolve));
+        assert.strictEqual(closeCalled, false);
+        assert.strictEqual(exitRec.exitCode, null);
+    });
+    it("is a no-op from the generic shutdown module", async () => {
+        const exitRec = makeExitRecorder();
+        let closeCalled = false;
+        const uninstall = installGenericShutdownHandlers(async () => {
+            closeCalled = true;
+        }, { exit: exitRec.exit, log: silentLog });
+        uninstall();
+        assert.strictEqual(typeof uninstall, "function");
+        assert.strictEqual(closeCalled, false);
+        assert.strictEqual(exitRec.exitCode, null);
+    });
+    it("exits with code 1 when close rejects", async () => {
+        const exitRec = makeExitRecorder();
+        let errorLogged = null;
+        uninstallers.push(installShutdownHandlers(async () => {
+            throw new Error("boom");
+        }, {
+            exit: exitRec.exit,
+            log: {
+                info: () => { },
+                error: (msg) => {
+                    errorLogged = msg;
+                },
+            },
+        }));
+        process.emit("SIGTERM", "SIGTERM");
+        await exitRec.exited;
+        assert.strictEqual(exitRec.exitCode, 1);
+        assert.ok(errorLogged !== null, "expected error to be logged");
+        assert.match(errorLogged, /boom/);
+    });
+    it("exits with code 1 when close throws synchronously", async () => {
+        const exitRec = makeExitRecorder();
+        let errorLogged = null;
+        uninstallers.push(installShutdownHandlers(() => {
+            throw new Error("sync boom");
+        }, {
+            exit: exitRec.exit,
+            log: {
+                info: () => { },
+                error: (msg) => {
+                    errorLogged = msg;
+                },
+            },
+        }));
+        process.emit("SIGTERM", "SIGTERM");
+        await exitRec.exited;
+        assert.strictEqual(exitRec.exitCode, 1);
+        assert.ok(errorLogged !== null, "expected error to be logged");
+        assert.match(errorLogged, /sync boom/);
+    });
+});

package/packages/extensions/ipc/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../packages/extensions/ipc/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAIrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,4CAA4C;AAC5C,qBAAa,SAAS;IAKA,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM;IAIzB,OAAO;IAEP,+CAA+C;IAC/C,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI3B,wBAAwB;IACxB,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,UAAU,cAiFhG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../packages/extensions/ipc/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAIrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,4CAA4C;AAC5C,qBAAa,SAAS;IAKA,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM;IAIzB,OAAO;IAEP,+CAA+C;IAC/C,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI3B,wBAAwB;IACxB,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,UAAU,cAuFhG"}

package/packages/extensions/ipc/server.js

@@ -87,6 +87,13 @@ export function startIpcServer(name, newMessageHandler) {
         controller.abort();
         // unrefing
         server.unref();
+        // Windows named pipes are cleaned up by the OS; Unix sockets are not.
+        if (!isWindows) {
+            try {
+                fs.unlinkSync(socketPath);
+            }
+            catch { }
+        }
     };
 }
 /**

package/packages/jam/config-node/node-config.d.ts

@@ -1,10 +1,10 @@
-import type { JsonObject } from "#@typeberry/block-json";
 import { PvmBackend } from "#@typeberry/config";
 import { type FromJson } from "#@typeberry/json-parser";
 import { AuthorshipOptions } from "./authorship.js";
 import { JipChainSpec } from "./jip-chain-spec.js";
 /** Development config. Will accept unsealed blocks for now. */
-export declare const DEV_CONFIG = "dev";
+export declare const DEV_TINY_CONFIG = "dev";
+export declare const DEV_FULL_CONFIG = "dev-full";
 /** Default config file. */
 export declare const DEFAULT_CONFIG = "default";
 export declare const NODE_DEFAULTS: {
@@ -19,7 +19,23 @@ export declare enum KnownChainSpec {
     /** Full chain spec. */
     Full = "full"
 }
+/** Persistent regular-node database backend. */
+export declare enum RegularStateBackend {
+    /** @deprecated lmdb remains available as an explicit fallback, but fjall is the default backend. */
+    Lmdb = "lmdb",
+    Fjall = "fjall"
+}
 export declare const knownChainSpecFromJson: FromJson<KnownChainSpec>;
+export declare const regularStateBackendFromJson: FromJson<RegularStateBackend>;
+type NodeConfigurationJson = {
+    $schema: string;
+    version: number;
+    flavor: KnownChainSpec;
+    chain_spec: JipChainSpec;
+    database_base_path?: string;
+    state_backend?: RegularStateBackend;
+    authorship: AuthorshipOptions;
+};
 export declare class NodeConfiguration {
     readonly $schema: string;
     readonly version: number;
@@ -27,10 +43,13 @@ export declare class NodeConfiguration {
     readonly chainSpec: JipChainSpec;
     /** If database path is not provided, we load an in-memory db. */
     readonly databaseBasePath: string | undefined;
+    /** Persistent database backend used when `databaseBasePath` is set. */
+    readonly stateBackend: RegularStateBackend;
     readonly authorship: AuthorshipOptions;
     static fromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, NodeConfiguration>;
-    static new({ $schema, version, flavor, chain_spec, database_base_path, authorship }: JsonObject<NodeConfiguration>): NodeConfiguration;
+    static new({ $schema, version, flavor, chain_spec, database_base_path, state_backend, authorship, }: NodeConfigurationJson): NodeConfiguration;
     private constructor();
 }
 export declare function loadConfig(config: string[], withRelPath: (p: string) => string): NodeConfiguration;
+export {};
 //# sourceMappingURL=node-config.d.ts.map