@typeberry/lib 0.8.4 → 0.9.0-3f2c45b

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/package.json +6 -4
  2. package/packages/configs/index.d.ts +30 -1
  3. package/packages/configs/index.d.ts.map +1 -1
  4. package/packages/configs/index.js +4 -2
  5. package/packages/configs/typeberry-dev-full.json +29 -0
  6. package/packages/core/bytes/bytes.d.ts +1 -0
  7. package/packages/core/bytes/bytes.d.ts.map +1 -1
  8. package/packages/core/bytes/bytes.js +8 -0
  9. package/packages/core/utils/debug.d.ts +4 -2
  10. package/packages/core/utils/debug.d.ts.map +1 -1
  11. package/packages/core/utils/debug.js +18 -13
  12. package/packages/core/utils/debug.test.js +12 -6
  13. package/packages/jam/config-node/node-config.d.ts +2 -1
  14. package/packages/jam/config-node/node-config.d.ts.map +1 -1
  15. package/packages/jam/config-node/node-config.js +8 -3
  16. package/packages/jam/config-node/node-config.test.js +3 -3
  17. package/packages/jam/database-fjall/hybrid-states.d.ts +82 -0
  18. package/packages/jam/database-fjall/hybrid-states.d.ts.map +1 -0
  19. package/packages/jam/database-fjall/hybrid-states.js +169 -0
  20. package/packages/jam/database-fjall/hybrid-states.test.d.ts +2 -0
  21. package/packages/jam/database-fjall/hybrid-states.test.d.ts.map +1 -0
  22. package/packages/jam/database-fjall/hybrid-states.test.js +113 -0
  23. package/packages/jam/database-fjall/index.d.ts +3 -0
  24. package/packages/jam/database-fjall/index.d.ts.map +1 -0
  25. package/packages/jam/database-fjall/index.js +2 -0
  26. package/packages/jam/database-fjall/root.d.ts +58 -0
  27. package/packages/jam/database-fjall/root.d.ts.map +1 -0
  28. package/packages/jam/database-fjall/root.js +89 -0
  29. package/packages/jam/jamnp-s/tasks/ticket-distribution.d.ts +18 -10
  30. package/packages/jam/jamnp-s/tasks/ticket-distribution.d.ts.map +1 -1
  31. package/packages/jam/jamnp-s/tasks/ticket-distribution.js +44 -68
  32. package/packages/jam/jamnp-s/tasks/ticket-distribution.test.js +30 -8
  33. package/packages/jam/node/main-fuzz.d.ts.map +1 -1
  34. package/packages/jam/node/main-fuzz.js +69 -11
  35. package/packages/jam/node/main-importer.d.ts +13 -3
  36. package/packages/jam/node/main-importer.d.ts.map +1 -1
  37. package/packages/jam/node/main-importer.js +5 -3
  38. package/packages/jam/safrole/bandersnatch-vrf.d.ts +24 -4
  39. package/packages/jam/safrole/bandersnatch-vrf.d.ts.map +1 -1
  40. package/packages/jam/safrole/bandersnatch-vrf.js +63 -26
  41. package/packages/jam/safrole/bandersnatch-vrf.test.js +12 -9
  42. package/packages/jam/safrole/bandersnatch-wasm.d.ts +10 -0
  43. package/packages/jam/safrole/bandersnatch-wasm.d.ts.map +1 -1
  44. package/packages/jam/safrole/bandersnatch-wasm.js +12 -0
  45. package/packages/jam/safrole/safrole.js +5 -5
  46. package/packages/jam/safrole/safrole.test.js +13 -13
  47. package/packages/jam/ticket-pool/index.d.ts +4 -0
  48. package/packages/jam/ticket-pool/index.d.ts.map +1 -0
  49. package/packages/jam/ticket-pool/index.js +3 -0
  50. package/packages/jam/ticket-pool/pending-ticket-pool.d.ts +30 -0
  51. package/packages/jam/ticket-pool/pending-ticket-pool.d.ts.map +1 -0
  52. package/packages/jam/ticket-pool/pending-ticket-pool.js +56 -0
  53. package/packages/jam/ticket-pool/pending-ticket-pool.test.d.ts +2 -0
  54. package/packages/jam/ticket-pool/pending-ticket-pool.test.d.ts.map +1 -0
  55. package/packages/jam/ticket-pool/pending-ticket-pool.test.js +67 -0
  56. package/packages/jam/ticket-pool/ticket-validator.d.ts +47 -0
  57. package/packages/jam/ticket-pool/ticket-validator.d.ts.map +1 -0
  58. package/packages/jam/ticket-pool/ticket-validator.js +34 -0
  59. package/packages/jam/ticket-pool/ticket-validator.test.d.ts +2 -0
  60. package/packages/jam/ticket-pool/ticket-validator.test.d.ts.map +1 -0
  61. package/packages/jam/ticket-pool/ticket-validator.test.js +35 -0
  62. package/packages/jam/ticket-pool/verified-ticket-pool.d.ts +26 -0
  63. package/packages/jam/ticket-pool/verified-ticket-pool.d.ts.map +1 -0
  64. package/packages/jam/ticket-pool/verified-ticket-pool.js +41 -0
  65. package/packages/jam/ticket-pool/verified-ticket-pool.test.d.ts +2 -0
  66. package/packages/jam/ticket-pool/verified-ticket-pool.test.d.ts.map +1 -0
  67. package/packages/jam/ticket-pool/verified-ticket-pool.test.js +54 -0
  68. package/packages/workers/api-node/config.d.ts +21 -6
  69. package/packages/workers/api-node/config.d.ts.map +1 -1
  70. package/packages/workers/api-node/config.js +26 -19
  71. package/packages/workers/api-node/config.test.js +38 -1
  72. package/packages/workers/block-authorship/{generator.d.ts → block-generator.d.ts} +5 -5
  73. package/packages/workers/block-authorship/block-generator.d.ts.map +1 -0
  74. package/packages/workers/block-authorship/{generator.js → block-generator.js} +3 -3
  75. package/packages/workers/block-authorship/block-generator.test.d.ts +2 -0
  76. package/packages/workers/block-authorship/block-generator.test.d.ts.map +1 -0
  77. package/packages/workers/block-authorship/{generator.test.js → block-generator.test.js} +8 -8
  78. package/packages/workers/block-authorship/epoch-authoring-slots.d.ts +35 -0
  79. package/packages/workers/block-authorship/epoch-authoring-slots.d.ts.map +1 -0
  80. package/packages/workers/block-authorship/epoch-authoring-slots.js +86 -0
  81. package/packages/workers/block-authorship/epoch-tracker.d.ts +29 -0
  82. package/packages/workers/block-authorship/epoch-tracker.d.ts.map +1 -0
  83. package/packages/workers/block-authorship/epoch-tracker.js +80 -0
  84. package/packages/workers/block-authorship/index.d.ts.map +1 -1
  85. package/packages/workers/block-authorship/index.js +1 -1
  86. package/packages/workers/block-authorship/main.d.ts +3 -0
  87. package/packages/workers/block-authorship/main.d.ts.map +1 -1
  88. package/packages/workers/block-authorship/main.js +197 -315
  89. package/packages/workers/block-authorship/ticket-generator/bootstrap-main.d.ts +2 -0
  90. package/packages/workers/block-authorship/ticket-generator/bootstrap-main.d.ts.map +1 -0
  91. package/packages/workers/block-authorship/ticket-generator/bootstrap-main.js +23 -0
  92. package/packages/workers/block-authorship/ticket-generator/index.d.ts +16 -0
  93. package/packages/workers/block-authorship/ticket-generator/index.d.ts.map +1 -0
  94. package/packages/workers/block-authorship/ticket-generator/index.js +62 -0
  95. package/packages/workers/block-authorship/ticket-generator/protocol.d.ts +50 -0
  96. package/packages/workers/block-authorship/ticket-generator/protocol.d.ts.map +1 -0
  97. package/packages/workers/block-authorship/ticket-generator/protocol.js +54 -0
  98. package/packages/workers/block-authorship/{ticket-generator.d.ts → ticket-generator/ticket-generator.d.ts} +4 -0
  99. package/packages/workers/block-authorship/ticket-generator/ticket-generator.d.ts.map +1 -0
  100. package/packages/workers/block-authorship/{ticket-generator.js → ticket-generator/ticket-generator.js} +19 -9
  101. package/packages/workers/block-authorship/ticket-generator/ticket-generator.test.d.ts.map +1 -0
  102. package/packages/workers/block-authorship/{ticket-generator.test.js → ticket-generator/ticket-generator.test.js} +13 -9
  103. package/packages/workers/block-authorship/ticket-generator/worker-pool.d.ts +36 -0
  104. package/packages/workers/block-authorship/ticket-generator/worker-pool.d.ts.map +1 -0
  105. package/packages/workers/block-authorship/ticket-generator/worker-pool.js +111 -0
  106. package/packages/workers/block-authorship/ticket-validator.d.ts +31 -0
  107. package/packages/workers/block-authorship/ticket-validator.d.ts.map +1 -0
  108. package/packages/workers/block-authorship/ticket-validator.js +59 -0
  109. package/packages/workers/comms-authorship-network/protocol.d.ts +14 -4
  110. package/packages/workers/comms-authorship-network/protocol.d.ts.map +1 -1
  111. package/packages/workers/comms-authorship-network/protocol.js +12 -6
  112. package/packages/workers/comms-authorship-network/tickets-message.d.ts +0 -14
  113. package/packages/workers/comms-authorship-network/tickets-message.d.ts.map +1 -1
  114. package/packages/workers/comms-authorship-network/tickets-message.js +0 -17
  115. package/packages/workers/importer/importer.d.ts +2 -2
  116. package/packages/workers/importer/importer.d.ts.map +1 -1
  117. package/packages/workers/importer/importer.js +5 -5
  118. package/packages/workers/importer/stats.d.ts +1 -3
  119. package/packages/workers/importer/stats.d.ts.map +1 -1
  120. package/packages/workers/importer/stats.js +12 -12
  121. package/packages/workers/jam-network/main.d.ts.map +1 -1
  122. package/packages/workers/jam-network/main.js +25 -4
  123. package/packages/workers/block-authorship/generator.d.ts.map +0 -1
  124. package/packages/workers/block-authorship/generator.test.d.ts +0 -2
  125. package/packages/workers/block-authorship/generator.test.d.ts.map +0 -1
  126. package/packages/workers/block-authorship/ticket-generator.d.ts.map +0 -1
  127. package/packages/workers/block-authorship/ticket-generator.test.d.ts.map +0 -1
  128. /package/packages/configs/{typeberry-dev.json → typeberry-dev-tiny.json} +0 -0
  129. /package/packages/workers/block-authorship/{ticket-generator.test.d.ts → ticket-generator/ticket-generator.test.d.ts} +0 -0
@@ -71,6 +71,7 @@ export declare class Bytes<T extends number> extends BytesBlob {
71
71
  isEqualTo(other: Bytes<T>): boolean;
72
72
  /** Converts current type into some opaque extension. */
73
73
  asOpaque<R>(): Opaque<Bytes<T>, TokenOf<R, Bytes<T>>>;
74
+ toStringTruncated(): string;
74
75
  }
75
76
  export declare const bytesBlobComparator: Comparator<BytesBlob>;
76
77
  //# sourceMappingURL=bytes.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../../../packages/core/bytes/bytes.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../../../packages/core/bytes/bytes.ts"],"names":[],"mappings":"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"}
@@ -197,6 +197,14 @@ export class Bytes extends BytesBlob {
197
197
  asOpaque() {
198
198
  return asOpaqueType(this);
199
199
  }
200
+ toStringTruncated() {
201
+ if (this.raw.length > 8) {
202
+ const start = bytesToHexString(this.raw.subarray(0, 2));
203
+ const end = bytesToHexString(this.raw.subarray(this.raw.length - 2));
204
+ return `${start}...${end.substring(2)}`;
205
+ }
206
+ return `${this.toString()}`;
207
+ }
200
208
  }
201
209
  function byteFromString(s) {
202
210
  check `${s.length === 2} Two-character string expected`;
@@ -59,9 +59,11 @@ export declare function measure(id: string): () => {
59
59
  * `arrayBuffers` should allow tracking WASM memory, since every instance backs its
60
60
  * memory with `ArrayBuffer`.
61
61
  */
62
- export declare function memoryUsage(): string;
62
+ export declare function memoryUsage(withDetails: boolean): string;
63
63
  /** Create a stateful memory usage reporter. */
64
- export declare function memoryTracker(): () => string;
64
+ export declare function memoryTracker(withDetails: boolean): {
65
+ toString(): string;
66
+ };
65
67
  /** A class that adds `toString` method that prints all properties of an object. */
66
68
  export declare abstract class WithDebug {
67
69
  toString(): string;
@@ -1 +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"}
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,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"}
@@ -148,26 +148,31 @@ function rawMemoryUsage() {
148
148
  * `arrayBuffers` should allow tracking WASM memory, since every instance backs its
149
149
  * memory with `ArrayBuffer`.
150
150
  */
151
- export function memoryUsage() {
151
+ export function memoryUsage(withDetails) {
152
152
  const m = rawMemoryUsage();
153
153
  if (m === null) {
154
154
  return "";
155
155
  }
156
- return `rss=${toMb(m.rss)}MB heap=${toMb(m.heapUsed)}/${toMb(m.heapTotal)}MB external=${toMb(m.external)}MB arrayBuffers=${toMb(m.arrayBuffers)}MB`;
156
+ if (withDetails) {
157
+ return `rss=${toMb(m.rss)}MB heap=${toMb(m.heapUsed)}/${toMb(m.heapTotal)}MB external=${toMb(m.external)}MB arrayBuffers=${toMb(m.arrayBuffers)}MB`;
158
+ }
159
+ return `rss=${toMb(m.rss)}MB heap=${toMb(m.heapUsed)}/${toMb(m.heapTotal)}MB`;
157
160
  }
158
161
  /** Create a stateful memory usage reporter. */
159
- export function memoryTracker() {
162
+ export function memoryTracker(withDetails) {
160
163
  let prev = null;
161
- return () => {
162
- const m = rawMemoryUsage();
163
- if (m === null) {
164
- return "";
165
- }
166
- const delta = prev === null
167
- ? ""
168
- : ` (Δrss=${signedMb(m.rss - prev.rss)}MB ΔarrayBuffers=${signedMb(m.arrayBuffers - prev.arrayBuffers)}MB)`;
169
- prev = m;
170
- return `${memoryUsage()}${delta}`;
164
+ return {
165
+ toString() {
166
+ const m = rawMemoryUsage();
167
+ if (m === null) {
168
+ return "";
169
+ }
170
+ const delta = prev === null || withDetails === false
171
+ ? ""
172
+ : ` (Δrss=${signedMb(m.rss - prev.rss)}MB ΔarrayBuffers=${signedMb(m.arrayBuffers - prev.arrayBuffers)}MB)`;
173
+ prev = m;
174
+ return `${memoryUsage(withDetails)}${delta}`;
175
+ },
171
176
  };
172
177
  }
173
178
  /** A class that adds `toString` method that prints all properties of an object. */
@@ -25,21 +25,27 @@ describe("utils::lazyInspect", () => {
25
25
  });
26
26
  describe("utils::memoryUsage", () => {
27
27
  it("should report all memory fields", () => {
28
- const usage = memoryUsage();
28
+ const usage = memoryUsage(true);
29
29
  for (const field of ["rss=", "heap=", "external=", "arrayBuffers="]) {
30
30
  assert.ok(usage.includes(field), `expected "${field}" in "${usage}"`);
31
31
  }
32
32
  });
33
+ it("should report all memory fields without details", () => {
34
+ const usage = memoryUsage(false);
35
+ for (const field of ["rss=", "heap="]) {
36
+ assert.ok(usage.includes(field), `expected "${field}" in "${usage}"`);
37
+ }
38
+ });
33
39
  });
34
40
  describe("utils::memoryTracker", () => {
35
41
  it("should not include a delta on the first call", () => {
36
- const tracker = memoryTracker();
37
- assert.ok(!tracker().includes("Δrss"));
42
+ const tracker = memoryTracker(true);
43
+ assert.ok(!tracker.toString().includes("Δrss"));
38
44
  });
39
45
  it("should include a delta on subsequent calls", () => {
40
- const tracker = memoryTracker();
41
- tracker();
42
- const second = tracker();
46
+ const tracker = memoryTracker(true);
47
+ tracker.toString();
48
+ const second = tracker.toString();
43
49
  assert.ok(second.includes("Δrss="), `expected delta in "${second}"`);
44
50
  assert.ok(second.includes("ΔarrayBuffers="), `expected delta in "${second}"`);
45
51
  });
@@ -4,7 +4,8 @@ import { type FromJson } from "#@typeberry/json-parser";
4
4
  import { AuthorshipOptions } from "./authorship.js";
5
5
  import { JipChainSpec } from "./jip-chain-spec.js";
6
6
  /** Development config. Will accept unsealed blocks for now. */
7
- export declare const DEV_CONFIG = "dev";
7
+ export declare const DEV_TINY_CONFIG = "dev";
8
+ export declare const DEV_FULL_CONFIG = "dev-full";
8
9
  /** Default config file. */
9
10
  export declare const DEFAULT_CONFIG = "default";
10
11
  export declare const NODE_DEFAULTS: {
@@ -1 +1 @@
1
- {"version":3,"file":"node-config.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/node-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,wBAAwB,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,+DAA+D;AAC/D,eAAO,MAAM,UAAU,QAAQ,CAAC;AAChC,2BAA2B;AAC3B,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,aAAa;;;;CAIzB,CAAC;AAEF,0BAA0B;AAC1B,oBAAY,cAAc;IACxB,uBAAuB;IACvB,IAAI,SAAS;IACb,uBAAuB;IACvB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,sBAAsB,EAS7B,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE/B,qBAAa,iBAAiB;aAqBV,OAAO,EAAE,MAAM;aACf,OAAO,EAAE,MAAM;aACf,MAAM,EAAE,cAAc;aACtB,SAAS,EAAE,YAAY;IACvC,iEAAiE;aACjD,gBAAgB,EAAE,MAAM,GAAG,SAAS;aACpC,UAAU,EAAE,iBAAiB;IA1B/C,MAAM,CAAC,QAAQ,kFAUb;IAEF,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,iBAAiB,CAAC;IAOlH,OAAO;CASR;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,iBAAiB,CAkDlG"}
1
+ {"version":3,"file":"node-config.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/node-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,wBAAwB,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,+DAA+D;AAC/D,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,2BAA2B;AAC3B,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,aAAa;;;;CAIzB,CAAC;AAEF,0BAA0B;AAC1B,oBAAY,cAAc;IACxB,uBAAuB;IACvB,IAAI,SAAS;IACb,uBAAuB;IACvB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,sBAAsB,EAS7B,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE/B,qBAAa,iBAAiB;aAqBV,OAAO,EAAE,MAAM;aACf,OAAO,EAAE,MAAM;aACf,MAAM,EAAE,cAAc;aACtB,SAAS,EAAE,YAAY;IACvC,iEAAiE;aACjD,gBAAgB,EAAE,MAAM,GAAG,SAAS;aACpC,UAAU,EAAE,iBAAiB;IA1B/C,MAAM,CAAC,QAAQ,kFAUb;IAEF,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,iBAAiB,CAAC;IAOlH,OAAO;CASR;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,iBAAiB,CAuDlG"}
@@ -9,7 +9,8 @@ import { AuthorshipOptions } from "./authorship.js";
9
9
  import { JipChainSpec } from "./jip-chain-spec.js";
10
10
  const logger = Logger.new(import.meta.filename, "config");
11
11
  /** Development config. Will accept unsealed blocks for now. */
12
- export const DEV_CONFIG = "dev";
12
+ export const DEV_TINY_CONFIG = "dev";
13
+ export const DEV_FULL_CONFIG = "dev-full";
13
14
  /** Default config file. */
14
15
  export const DEFAULT_CONFIG = "default";
15
16
  export const NODE_DEFAULTS = {
@@ -72,8 +73,12 @@ export function loadConfig(config, withRelPath) {
72
73
  let mergedJson = {};
73
74
  for (const entry of config) {
74
75
  logger.log `🔧 Applying '${entry}'`;
75
- if (entry === DEV_CONFIG) {
76
- mergedJson = structuredClone(configs.dev); // clone to avoid mutating the original config. not doing a merge since dev and default should theoretically replace all properties.
76
+ if (entry === DEV_TINY_CONFIG) {
77
+ mergedJson = structuredClone(configs.devTiny); // clone to avoid mutating the original config. not doing a merge since dev and default should theoretically replace all properties.
78
+ continue;
79
+ }
80
+ if (entry === DEV_FULL_CONFIG) {
81
+ mergedJson = structuredClone(configs.devFull); // clone to avoid mutating the original config. not doing a merge since dev and default should theoretically replace all properties.
77
82
  continue;
78
83
  }
79
84
  if (entry === DEFAULT_CONFIG) {
@@ -70,7 +70,7 @@ describe("loadConfig", () => {
70
70
  });
71
71
  it("should load dev config", () => {
72
72
  const config = loadConfig(["dev"], withRelPath);
73
- assert.deepStrictEqual(config, parseFromJson(configs.dev, NodeConfiguration.fromJson));
73
+ assert.deepStrictEqual(config, parseFromJson(configs.devTiny, NodeConfiguration.fromJson));
74
74
  });
75
75
  it("should parse inline json config and deep merge onto previous entries", () => {
76
76
  const config = loadConfig(["default", JSON.stringify({ database_base_path: "/test/path", chain_spec: { bootnodes: [] } })], withRelPath);
@@ -138,9 +138,9 @@ describe("loadConfig", () => {
138
138
  `.database_base_path="/test/path-1"`,
139
139
  ], withRelPath);
140
140
  assert.deepStrictEqual(config, parseFromJson({
141
- ...configs.dev,
141
+ ...configs.devTiny,
142
142
  database_base_path: "/test/path-1",
143
- chain_spec: { ...configs.dev.chain_spec, bootnodes: [] },
143
+ chain_spec: { ...configs.devTiny.chain_spec, bootnodes: [] },
144
144
  }, NodeConfiguration.fromJson));
145
145
  });
146
146
  it("should throw an error if an invalid json file is provided", () => {
@@ -0,0 +1,82 @@
1
+ import type { HeaderHash, StateRootHash } from "#@typeberry/block";
2
+ import type { ChainSpec } from "#@typeberry/config";
3
+ import { type InitStatesDb, LeafDb, type StatesDb, StateUpdateError } from "#@typeberry/database";
4
+ import type { Blake2b } from "#@typeberry/hash";
5
+ import type { ServicesUpdate, State } from "#@typeberry/state";
6
+ import { SerializedState, type StateEntries } from "#@typeberry/state-merkleization";
7
+ import { OK, Result } from "#@typeberry/utils";
8
+ import { type FjallRootOptions, type Partition } from "./root.js";
9
+ /**
10
+ * One open fjall keyspace together with its content-addressed `values`
11
+ * partition.
12
+ *
13
+ * Opening the keyspace is the slow part, so the fuzz target opens one session
14
+ * per run and reuses it for every reset (see `HybridSerializedStates.fromSession`).
15
+ * The values partition is immutable - the key is the hash of the value - so it
16
+ * is fine that values pile up across resets, the unreferenced ones just sit
17
+ * there unused.
18
+ */
19
+ export declare class FjallValuesSession {
20
+ private readonly root;
21
+ /** Shared content-addressed values partition, reused across resets. */
22
+ readonly values: Partition;
23
+ private constructor();
24
+ /** Open (or create) the keyspace at `dbPath` and its `values` partition. */
25
+ static open(dbPath: string, options?: FjallRootOptions): Promise<FjallValuesSession>;
26
+ /** Flush the journal to disk (a no-op for ephemeral keyspaces). */
27
+ persist(): Promise<void>;
28
+ /** Size of the keyspace directory on disk, in bytes. */
29
+ sizeInBytes(): number | null;
30
+ /** Release the keyspace handle (skips the sync-all fsync when ephemeral). */
31
+ close(): Promise<void>;
32
+ }
33
+ /**
34
+ * Hybrid serialized-states db (fjall variant).
35
+ *
36
+ * States (leafs) are kept in memory, only the large values go to fjall on disk.
37
+ * Reads hit fjall directly, which keeps its own bounded block cache. Meant for
38
+ * long fuzzing, used together with pruning so the heap stays bounded.
39
+ *
40
+ * Construction is async, and value writes are flushed explicitly, because fjall
41
+ * has no transaction primitive.
42
+ */
43
+ export declare class HybridSerializedStates implements StatesDb<SerializedState<LeafDb>>, InitStatesDb<StateEntries> {
44
+ private readonly spec;
45
+ private readonly blake2b;
46
+ private readonly session;
47
+ /** Whether `close()` should close the underlying session. */
48
+ private readonly ownsSession;
49
+ static new({ spec, blake2b, dbPath, ephemeral, cacheSizeBytes, }: {
50
+ spec: ChainSpec;
51
+ blake2b: Blake2b;
52
+ dbPath: string;
53
+ ephemeral?: boolean;
54
+ cacheSizeBytes?: number;
55
+ }): Promise<HybridSerializedStates>;
56
+ /**
57
+ * Wrap an already-open `FjallValuesSession` and reuse its keyspace.
58
+ *
59
+ * The new instance starts with its own empty in-memory leaf sets but shares
60
+ * the values partition on disk. Its `close()` does not close the session, the
61
+ * session owner closes it once. The fuzz target uses this to keep one keyspace
62
+ * across resets and only rebuild the in-memory state for each vector.
63
+ */
64
+ static fromSession(spec: ChainSpec, blake2b: Blake2b, session: FjallValuesSession): HybridSerializedStates;
65
+ private readonly inMemStates;
66
+ private readonly valuesDb;
67
+ /** Shared content-addressed values partition (owned by `session`). */
68
+ private readonly values;
69
+ private constructor();
70
+ insertInitialState(headerHash: HeaderHash, entries: StateEntries): Promise<Result<OK, StateUpdateError>>;
71
+ updateAndSetState(header: HeaderHash, state: SerializedState<LeafDb>, update: Partial<State & ServicesUpdate>): Promise<Result<OK, StateUpdateError>>;
72
+ getStateRoot(state: SerializedState<LeafDb>): Promise<StateRootHash>;
73
+ getState(header: HeaderHash): SerializedState<LeafDb> | null;
74
+ markUnused(header: HeaderHash): void;
75
+ diskSizeInBytes(): number | null;
76
+ close(): Promise<void>;
77
+ /** Write new large values to fjall in a single batch, then flush. */
78
+ private writeValues;
79
+ /** Read a value from fjall. */
80
+ private readValue;
81
+ }
82
+ //# sourceMappingURL=hybrid-states.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hybrid-states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/hybrid-states.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,169 @@
1
+ import { HashDictionary, SortedSet } from "#@typeberry/collections";
2
+ import { LeafDb, StateUpdateError, updateLeafs, } from "#@typeberry/database";
3
+ import { Logger } from "#@typeberry/logger";
4
+ import { SerializedState, StateEntryUpdateAction, serializeStateUpdate, } from "#@typeberry/state-merkleization";
5
+ import { leafComparator } from "#@typeberry/trie";
6
+ import { OK, Result } from "#@typeberry/utils";
7
+ import { FjallRoot, toUint8Array } from "./root.js";
8
+ const logger = Logger.new(import.meta.filename, "db");
9
+ /**
10
+ * One open fjall keyspace together with its content-addressed `values`
11
+ * partition.
12
+ *
13
+ * Opening the keyspace is the slow part, so the fuzz target opens one session
14
+ * per run and reuses it for every reset (see `HybridSerializedStates.fromSession`).
15
+ * The values partition is immutable - the key is the hash of the value - so it
16
+ * is fine that values pile up across resets, the unreferenced ones just sit
17
+ * there unused.
18
+ */
19
+ export class FjallValuesSession {
20
+ root;
21
+ values;
22
+ constructor(root,
23
+ /** Shared content-addressed values partition, reused across resets. */
24
+ values) {
25
+ this.root = root;
26
+ this.values = values;
27
+ }
28
+ /** Open (or create) the keyspace at `dbPath` and its `values` partition. */
29
+ static async open(dbPath, options = {}) {
30
+ const root = await FjallRoot.open(dbPath, options);
31
+ const values = await root.partition("values");
32
+ return new FjallValuesSession(root, values);
33
+ }
34
+ /** Flush the journal to disk (a no-op for ephemeral keyspaces). */
35
+ async persist() {
36
+ await this.root.persist();
37
+ }
38
+ /** Size of the keyspace directory on disk, in bytes. */
39
+ sizeInBytes() {
40
+ return this.root.sizeInBytes();
41
+ }
42
+ /** Release the keyspace handle (skips the sync-all fsync when ephemeral). */
43
+ async close() {
44
+ await this.root.close();
45
+ }
46
+ }
47
+ /**
48
+ * Hybrid serialized-states db (fjall variant).
49
+ *
50
+ * States (leafs) are kept in memory, only the large values go to fjall on disk.
51
+ * Reads hit fjall directly, which keeps its own bounded block cache. Meant for
52
+ * long fuzzing, used together with pruning so the heap stays bounded.
53
+ *
54
+ * Construction is async, and value writes are flushed explicitly, because fjall
55
+ * has no transaction primitive.
56
+ */
57
+ export class HybridSerializedStates {
58
+ spec;
59
+ blake2b;
60
+ session;
61
+ ownsSession;
62
+ static async new({ spec, blake2b, dbPath, ephemeral, cacheSizeBytes, }) {
63
+ const session = await FjallValuesSession.open(dbPath, { ephemeral, cacheSizeBytes });
64
+ // This instance owns the session it just opened, so its `close()` closes it.
65
+ return new HybridSerializedStates(spec, blake2b, session, true);
66
+ }
67
+ /**
68
+ * Wrap an already-open `FjallValuesSession` and reuse its keyspace.
69
+ *
70
+ * The new instance starts with its own empty in-memory leaf sets but shares
71
+ * the values partition on disk. Its `close()` does not close the session, the
72
+ * session owner closes it once. The fuzz target uses this to keep one keyspace
73
+ * across resets and only rebuild the in-memory state for each vector.
74
+ */
75
+ static fromSession(spec, blake2b, session) {
76
+ return new HybridSerializedStates(spec, blake2b, session, false);
77
+ }
78
+ inMemStates = HashDictionary.new();
79
+ // A single shared values accessor reused by every `LeafDb` we hand out.
80
+ valuesDb;
81
+ /** Shared content-addressed values partition (owned by `session`). */
82
+ values;
83
+ constructor(spec, blake2b, session,
84
+ /** Whether `close()` should close the underlying session. */
85
+ ownsSession) {
86
+ this.spec = spec;
87
+ this.blake2b = blake2b;
88
+ this.session = session;
89
+ this.ownsSession = ownsSession;
90
+ this.values = session.values;
91
+ this.valuesDb = { get: (key) => this.readValue(key) };
92
+ }
93
+ async insertInitialState(headerHash, entries) {
94
+ const { values, leafs } = updateLeafs(SortedSet.fromArray(leafComparator, []), this.blake2b, Array.from(entries, (x) => [StateEntryUpdateAction.Insert, x[0], x[1]]));
95
+ const res = await this.writeValues(values);
96
+ if (res.isError) {
97
+ return res;
98
+ }
99
+ this.inMemStates.set(headerHash, leafs);
100
+ return Result.ok(OK);
101
+ }
102
+ async updateAndSetState(header, state, update) {
103
+ const updatedValues = serializeStateUpdate(this.spec, this.blake2b, update);
104
+ // Clone the leaf set before mutating: the previous state keeps using its own.
105
+ const newLeafs = SortedSet.fromSortedArray(leafComparator, state.backend.leafs.array);
106
+ const { values, leafs } = updateLeafs(newLeafs, this.blake2b, updatedValues);
107
+ const res = await this.writeValues(values);
108
+ if (res.isError) {
109
+ // Leave the caller's state untouched: its new leaves would reference
110
+ // values that never reached disk.
111
+ return res;
112
+ }
113
+ // Re-create the lookup with the shared values accessor only once the new
114
+ // values are durably written.
115
+ state.updateBackend(LeafDb.fromLeaves(leafs, this.valuesDb));
116
+ this.inMemStates.set(header, leafs);
117
+ return Result.ok(OK);
118
+ }
119
+ async getStateRoot(state) {
120
+ return state.backend.getStateRoot(this.blake2b);
121
+ }
122
+ getState(header) {
123
+ const leafs = this.inMemStates.get(header);
124
+ if (leafs === undefined) {
125
+ return null;
126
+ }
127
+ const leafDb = LeafDb.fromLeaves(leafs, this.valuesDb);
128
+ return SerializedState.new(this.spec, this.blake2b, leafDb);
129
+ }
130
+ markUnused(header) {
131
+ // We only remove the state from memory - values are not pruned at all,
132
+ // but since they are stored on disk we should be safe.
133
+ this.inMemStates.delete(header);
134
+ }
135
+ diskSizeInBytes() {
136
+ return this.session.sizeInBytes();
137
+ }
138
+ async close() {
139
+ // Instances backed by a shared session (fuzz reset reuse) keep the keyspace
140
+ // open for the next reset. The session owner closes it once.
141
+ if (this.ownsSession) {
142
+ await this.session.close();
143
+ }
144
+ }
145
+ /** Write new large values to fjall in a single batch, then flush. */
146
+ async writeValues(values) {
147
+ if (values.length === 0) {
148
+ return Result.ok(OK);
149
+ }
150
+ try {
151
+ const entries = values.map(([hash, val]) => ({ key: hash.raw, value: val.raw }));
152
+ await this.values.insertBatch(entries);
153
+ await this.session.persist();
154
+ }
155
+ catch (e) {
156
+ logger.error `${e}`;
157
+ return Result.error(StateUpdateError.Commit, () => `Failed to commit values: ${e}`);
158
+ }
159
+ return Result.ok(OK);
160
+ }
161
+ /** Read a value from fjall. */
162
+ readValue(key) {
163
+ const val = toUint8Array(this.values.get(key.raw));
164
+ if (val === null) {
165
+ throw new Error(`Missing value at key: ${key}`);
166
+ }
167
+ return val;
168
+ }
169
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=hybrid-states.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hybrid-states.test.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/hybrid-states.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,113 @@
1
+ import assert from "node:assert";
2
+ import * as fs from "node:fs";
3
+ import { afterEach, before, beforeEach, describe, it } from "node:test";
4
+ import { Bytes, BytesBlob } from "#@typeberry/bytes";
5
+ import { tinyChainSpec } from "#@typeberry/config";
6
+ import { Blake2b, HASH_SIZE } from "#@typeberry/hash";
7
+ import { InMemoryState } from "#@typeberry/state";
8
+ import { StateEntries } from "#@typeberry/state-merkleization";
9
+ import { deepEqual, OK, Result } from "#@typeberry/utils";
10
+ import { FjallValuesSession, HybridSerializedStates } from "./hybrid-states.js";
11
+ let blake2b;
12
+ before(async () => {
13
+ blake2b = await Blake2b.createHasher();
14
+ });
15
+ function createTempDir(suffix = "fjall-hybrid") {
16
+ return fs.mkdtempSync(`typeberry-${suffix}`);
17
+ }
18
+ describe("Fjall hybrid serialized states", () => {
19
+ const spec = tinyChainSpec;
20
+ const headerHash = Bytes.zero(HASH_SIZE).asOpaque();
21
+ let dbPath = "";
22
+ beforeEach(() => {
23
+ dbPath = createTempDir();
24
+ });
25
+ afterEach(() => {
26
+ fs.rmSync(dbPath, { recursive: true });
27
+ });
28
+ it("round-trips an initial state through the on-disk values store", async () => {
29
+ const states = await HybridSerializedStates.new({ spec, blake2b, dbPath });
30
+ try {
31
+ const empty = InMemoryState.empty(spec);
32
+ const serialized = StateEntries.serializeInMemory(spec, blake2b, empty);
33
+ const expectedRoot = serialized.getRootHash(blake2b);
34
+ const res = await states.insertInitialState(headerHash, serialized);
35
+ deepEqual(res, Result.ok(OK));
36
+ const state = states.getState(headerHash);
37
+ assert.ok(state !== null);
38
+ const stateRoot = await states.getStateRoot(state);
39
+ assert.strictEqual(`${stateRoot}`, `${expectedRoot}`);
40
+ deepEqual(InMemoryState.copyFrom(spec, state, new Map()), empty);
41
+ }
42
+ finally {
43
+ await states.close();
44
+ }
45
+ });
46
+ it("reads large values back from disk", async () => {
47
+ const states = await HybridSerializedStates.new({ spec, blake2b, dbPath });
48
+ try {
49
+ // > 32 bytes => stored in the values db (not embedded in the leaf).
50
+ const big1 = BytesBlob.blobFromString("x".repeat(100));
51
+ const big2 = BytesBlob.blobFromString("y".repeat(100));
52
+ const key1 = Bytes.fill(HASH_SIZE, 1).asOpaque();
53
+ const key2 = Bytes.fill(HASH_SIZE, 2).asOpaque();
54
+ const entries = StateEntries.fromEntriesUnsafe([
55
+ [key1, big1],
56
+ [key2, big2],
57
+ ]);
58
+ const res = await states.insertInitialState(headerHash, entries);
59
+ deepEqual(res, Result.ok(OK));
60
+ const state = states.getState(headerHash);
61
+ assert.ok(state !== null);
62
+ assert.strictEqual(`${state.backend.get(key2)}`, `${big2}`);
63
+ assert.strictEqual(`${state.backend.get(key1)}`, `${big1}`);
64
+ }
65
+ finally {
66
+ await states.close();
67
+ }
68
+ });
69
+ it("shares an open values session across resets without closing it", async () => {
70
+ // The fuzz reset path opens the values keyspace once per session and reuses
71
+ // it: each "reset" builds a fresh states instance sharing that session, and
72
+ // closing a session-backed states must NOT close the shared keyspace.
73
+ const session = await FjallValuesSession.open(dbPath);
74
+ try {
75
+ const big = BytesBlob.blobFromString("z".repeat(100));
76
+ const key = Bytes.fill(HASH_SIZE, 7).asOpaque();
77
+ const entries = StateEntries.fromEntriesUnsafe([[key, big]]);
78
+ // First "reset": write values through a states instance, then close it.
79
+ const first = HybridSerializedStates.fromSession(spec, blake2b, session);
80
+ const res = await first.insertInitialState(headerHash, entries);
81
+ deepEqual(res, Result.ok(OK));
82
+ await first.close();
83
+ // Second "reset": a fresh states sharing the same session. Its in-memory
84
+ // leaf set is independent (empty until it inserts)...
85
+ const second = HybridSerializedStates.fromSession(spec, blake2b, session);
86
+ assert.strictEqual(second.getState(headerHash), null);
87
+ // ...but the on-disk values store is the same one, still open and usable
88
+ // (a closed keyspace would throw here).
89
+ await second.insertInitialState(headerHash, entries);
90
+ const state = second.getState(headerHash);
91
+ assert.ok(state !== null);
92
+ assert.strictEqual(`${state.backend.get(key)}`, `${big}`);
93
+ await second.close();
94
+ }
95
+ finally {
96
+ await session.close();
97
+ }
98
+ });
99
+ it("drops the leaf set on markUnused while values stay on disk", async () => {
100
+ const states = await HybridSerializedStates.new({ spec, blake2b, dbPath });
101
+ try {
102
+ const empty = InMemoryState.empty(spec);
103
+ const serialized = StateEntries.serializeInMemory(spec, blake2b, empty);
104
+ await states.insertInitialState(headerHash, serialized);
105
+ assert.ok(states.getState(headerHash) !== null);
106
+ states.markUnused(headerHash);
107
+ assert.strictEqual(states.getState(headerHash), null);
108
+ }
109
+ finally {
110
+ await states.close();
111
+ }
112
+ });
113
+ });
@@ -0,0 +1,3 @@
1
+ export * from "./hybrid-states.js";
2
+ export * from "./root.js";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}
@@ -0,0 +1,2 @@
1
+ export * from "./hybrid-states.js";
2
+ export * from "./root.js";