@typeberry/lib 0.5.10-ec38e0b → 0.5.11-019e542

package/packages/jam/transition/externalities/fetch-externalities.d.ts

@@ -1,6 +1,10 @@
-import type { BytesBlob } from "#@typeberry/bytes";
+import type { WorkItem } from "#@typeberry/block/work-item.js";
+import { WorkPackage, type WorkPackageView } from "#@typeberry/block/work-package.js";
+import { BytesBlob } from "#@typeberry/bytes";
+import { type DescribedBy, SequenceView } from "#@typeberry/codec";
 import type { ChainSpec } from "#@typeberry/config";
 import { PendingTransfer } from "#@typeberry/jam-host-calls";
+import { type U64 } from "#@typeberry/numbers";
 import { Operand } from "../accumulate/operand.js";
 export declare enum TransferOperandKind {
     OPERAND = 0,
@@ -14,6 +18,55 @@ export type TransferOrOperand = {
     value: PendingTransfer;
 };
 export declare const TRANSFER_OR_OPERAND: import("@typeberry/codec").Descriptor<TransferOrOperand, TransferOrOperand>;
-export declare const TRANSFERS_AND_OPERANDS: import("@typeberry/codec").Descriptor<TransferOrOperand[], import("@typeberry/codec").SequenceView<TransferOrOperand, TransferOrOperand>>;
+export declare const TRANSFERS_AND_OPERANDS: import("@typeberry/codec").Descriptor<TransferOrOperand[], SequenceView<TransferOrOperand, TransferOrOperand>>;
 export declare function getEncodedConstants(chainSpec: ChainSpec): BytesBlob;
+/**
+ * `S(w)` — work-item summary used by fetch in both the IsAuthorized
+ * and Refine contexts.
+ *
+ * https://graypaper.fluffylabs.dev/#/ab2cdbd/31fc0231fc02?v=0.7.2
+ */
+declare const WORK_ITEM_SUMMARY_CODEC: import("@typeberry/codec").Descriptor<{
+    service: number & import("@typeberry/numbers").WithBytesRepresentation<4> & import("@typeberry/utils").WithOpaque<"ServiceId[u32]">;
+    codeHash: import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"CodeHash">;
+    refineGasLimit: bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">;
+    accumulateGasLimit: bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">;
+    exportCount: import("@typeberry/numbers").U16;
+    importSegmentsCount: import("@typeberry/numbers").U16;
+    extrinsicCount: import("@typeberry/numbers").U16;
+    payloadLength: import("@typeberry/numbers").U32;
+}, import("@typeberry/codec").ViewOf<{
+    service: number & import("@typeberry/numbers").WithBytesRepresentation<4> & import("@typeberry/utils").WithOpaque<"ServiceId[u32]">;
+    codeHash: import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"CodeHash">;
+    refineGasLimit: bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">;
+    accumulateGasLimit: bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">;
+    exportCount: import("@typeberry/numbers").U16;
+    importSegmentsCount: import("@typeberry/numbers").U16;
+    extrinsicCount: import("@typeberry/numbers").U16;
+    payloadLength: import("@typeberry/numbers").U32;
+}, import("@typeberry/codec").SimpleDescriptorRecord<{
+    service: number & import("@typeberry/numbers").WithBytesRepresentation<4> & import("@typeberry/utils").WithOpaque<"ServiceId[u32]">;
+    codeHash: import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"CodeHash">;
+    refineGasLimit: bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">;
+    accumulateGasLimit: bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">;
+    exportCount: import("@typeberry/numbers").U16;
+    importSegmentsCount: import("@typeberry/numbers").U16;
+    extrinsicCount: import("@typeberry/numbers").U16;
+    payloadLength: import("@typeberry/numbers").U32;
+}>>>;
+type WorkItemSummary = DescribedBy<typeof WORK_ITEM_SUMMARY_CODEC>;
+type WorkItemSummaryView = DescribedBy<typeof WORK_ITEM_SUMMARY_CODEC.View>;
+export declare function encodeWorkItemSummary(item: WorkItem): BytesBlob;
+/** Encoded work package data for fetch, shared between `IsAuthorized` and `Refine` fetchers. */
+export type WorkPackageFetchData = {
+    /** Lazy view over the encoded work package. */
+    packageView: WorkPackageView;
+    /** SequenceView over the concatenated S(w) summaries. */
+    workItemSummaries: SequenceView<WorkItemSummary, WorkItemSummaryView>;
+};
+/** Eagerly build the per-package fetch views. */
+export declare function buildWorkPackageFetchData(chainSpec: ChainSpec, workPackage: WorkPackage): WorkPackageFetchData;
+/** Converts u64 value taken from a register into valid index of array of given `length`. */
+export declare function u64ToArrayIndex(v: U64, len: number): number | null;
+export {};
 //# sourceMappingURL=fetch-externalities.d.ts.map

package/packages/jam/transition/externalities/fetch-externalities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/fetch-externalities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAS5D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAInD,oBAAY,mBAAmB;IAC7B,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC;IACnC,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AAEN,eAAO,MAAM,mBAAmB,6EAG9B,CAAC;AAEH,eAAO,MAAM,sBAAsB,2IAA4C,CAAC;AA0ChF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,aA6CvD"}
+{"version":3,"file":"fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/fetch-externalities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAA4B,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAkB,KAAK,WAAW,EAAW,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAQ5E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAInD,oBAAY,mBAAmB;IAC7B,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC;IACnC,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AAEN,eAAO,MAAM,mBAAmB,6EAG9B,CAAC;AAEH,eAAO,MAAM,sBAAsB,gHAA4C,CAAC;AA0ChF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,aA6CvD;AAED;;;;;GAKG;AACH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;IAS3B,CAAC;AACH,KAAK,eAAe,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACnE,KAAK,mBAAmB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAE5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAW/D;AAED,gGAAgG;AAChG,MAAM,MAAM,oBAAoB,GAAG;IACjC,+CAA+C;IAC/C,WAAW,EAAE,eAAe,CAAC;IAC7B,yDAAyD;IACzD,iBAAiB,EAAE,YAAY,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;CACvE,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAY9G;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAElE"}

package/packages/jam/transition/externalities/fetch-externalities.js

@@ -1,6 +1,9 @@
+import { reencodeAsView } from "#@typeberry/block";
 import { G_I, MAX_REPORT_DEPENDENCIES, O, Q, T, W_A, W_B, W_C, W_M, W_T, W_X } from "#@typeberry/block/gp-constants.js";
-import { MAX_NUMBER_OF_WORK_ITEMS } from "#@typeberry/block/work-package.js";
-import { codec, Encoder } from "#@typeberry/codec";
+import { MAX_NUMBER_OF_WORK_ITEMS, WorkPackage } from "#@typeberry/block/work-package.js";
+import { BytesBlob } from "#@typeberry/bytes";
+import { codec, Decoder, Encoder, SequenceView } from "#@typeberry/codec";
+import { HASH_SIZE } from "#@typeberry/hash";
 import { PendingTransfer } from "#@typeberry/jam-host-calls";
 import { tryAsU16, tryAsU32, tryAsU64 } from "#@typeberry/numbers";
 import { BASE_SERVICE_BALANCE, ELECTIVE_BYTE_BALANCE, ELECTIVE_ITEM_BALANCE, MAX_RECENT_HISTORY, } from "#@typeberry/state";
@@ -99,3 +102,42 @@ export function getEncodedConstants(chainSpec) {
     encodedConstantsCache.set(chainSpec, encodedConsts);
     return encodedConsts;
 }
+/**
+ * `S(w)` — work-item summary used by fetch in both the IsAuthorized
+ * and Refine contexts.
+ *
+ * https://graypaper.fluffylabs.dev/#/ab2cdbd/31fc0231fc02?v=0.7.2
+ */
+const WORK_ITEM_SUMMARY_CODEC = codec.object({
+    service: codec.u32.asOpaque(),
+    codeHash: codec.bytes(HASH_SIZE).asOpaque(),
+    refineGasLimit: codec.u64.asOpaque(),
+    accumulateGasLimit: codec.u64.asOpaque(),
+    exportCount: codec.u16,
+    importSegmentsCount: codec.u16,
+    extrinsicCount: codec.u16,
+    payloadLength: codec.u32,
+});
+export function encodeWorkItemSummary(item) {
+    return Encoder.encodeObject(WORK_ITEM_SUMMARY_CODEC, {
+        service: item.service,
+        codeHash: item.codeHash,
+        refineGasLimit: item.refineGasLimit,
+        accumulateGasLimit: item.accumulateGasLimit,
+        exportCount: item.exportCount,
+        importSegmentsCount: tryAsU16(item.importSegments.length),
+        extrinsicCount: tryAsU16(item.extrinsic.length),
+        payloadLength: tryAsU32(item.payload.length),
+    });
+}
+/** Eagerly build the per-package fetch views. */
+export function buildWorkPackageFetchData(chainSpec, workPackage) {
+    const packageView = reencodeAsView(WorkPackage.Codec, workPackage, chainSpec);
+    const summariesBlob = BytesBlob.blobFromParts(workPackage.items.map((i) => encodeWorkItemSummary(i).raw));
+    const workItemSummaries = new SequenceView(Decoder.fromBytesBlob(summariesBlob), WORK_ITEM_SUMMARY_CODEC, workPackage.items.length);
+    return { packageView, workItemSummaries };
+}
+/** Converts u64 value taken from a register into valid index of array of given `length`. */
+export function u64ToArrayIndex(v, len) {
+    return v < BigInt(len) ? Number(v) : null;
+}

package/packages/jam/transition/externalities/index.d.ts

@@ -1,6 +1,4 @@
 export * from "./accumulate-externalities.js";
 export * from "./accumulate-fetch-externalities.js";
 export * from "./fetch-externalities.js";
-export * from "./is-authorized-fetch-externalities.js";
-export * from "./refine-fetch-externalities.js";
 //# sourceMappingURL=index.d.ts.map

package/packages/jam/transition/externalities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC"}

package/packages/jam/transition/externalities/index.js

@@ -1,5 +1,3 @@
 export * from "./accumulate-externalities.js";
 export * from "./accumulate-fetch-externalities.js";
 export * from "./fetch-externalities.js";
-export * from "./is-authorized-fetch-externalities.js";
-export * from "./refine-fetch-externalities.js";

package/packages/jam/transition/hasher.d.ts

@@ -7,7 +7,8 @@ export declare class TransitionHasher implements MmrHasher<KeccakHash> {
     private readonly keccakHasher;
     readonly blake2b: Blake2b;
     static create(): Promise<TransitionHasher>;
-    constructor(keccakHasher: keccak.KeccakHasher, blake2b: Blake2b);
+    static new(keccakHasher: keccak.KeccakHasher, blake2b: Blake2b): TransitionHasher;
+    private constructor();
     /** Concatenates two hashes and hash this concatenation */
     hashConcat(a: KeccakHash, b: KeccakHash): KeccakHash;
     hashConcatPrepend(id: BytesBlob, a: KeccakHash, b: KeccakHash): KeccakHash;

package/packages/jam/transition/hasher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/transition/hasher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAC7G,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,8DAA8D;AAC9D,qBAAa,gBAAiB,YAAW,SAAS,CAAC,UAAU,CAAC;IAM1D,OAAO,CAAC,QAAQ,CAAC,YAAY;aACb,OAAO,EAAE,OAAO;WANrB,MAAM;gBAKA,YAAY,EAAE,MAAM,CAAC,YAAY,EAClC,OAAO,EAAE,OAAO;IAGlC,0DAA0D;IAC1D,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU;IAIpD,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU;IAI1E,8CAA8C;IAC9C,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAI5D;;;;OAIG;IACH,SAAS,CAAC,aAAa,EAAE,aAAa,GAAG,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC;CA4BxF"}
+{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/transition/hasher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAC7G,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,8DAA8D;AAC9D,qBAAa,gBAAiB,YAAW,SAAS,CAAC,UAAU,CAAC;IAU1D,OAAO,CAAC,QAAQ,CAAC,YAAY;aACb,OAAO,EAAE,OAAO;WAVrB,MAAM;IAInB,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO;IAI9D,OAAO;IAKP,0DAA0D;IAC1D,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU;IAIpD,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU;IAI1E,8CAA8C;IAC9C,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAI5D;;;;OAIG;IACH,SAAS,CAAC,aAAa,EAAE,aAAa,GAAG,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC;CA4BxF"}

package/packages/jam/transition/hasher.js

@@ -9,6 +9,9 @@ export class TransitionHasher {
     static async create() {
         return new TransitionHasher(await keccak.KeccakHasher.create(), await Blake2b.createHasher());
     }
+    static new(keccakHasher, blake2b) {
+        return new TransitionHasher(keccakHasher, blake2b);
+    }
     constructor(keccakHasher, blake2b) {
         this.keccakHasher = keccakHasher;
         this.blake2b = blake2b;
@@ -22,7 +25,7 @@ export class TransitionHasher {
     }
     /** Creates hash from the block header view */
     header(header) {
-        return new WithHash(this.blake2b.hashBytes(header.encoded()).asOpaque(), header);
+        return WithHash.new(this.blake2b.hashBytes(header.encoded()).asOpaque(), header);
     }
     /**
      * Merkle commitment of the extrinsic data
@@ -49,6 +52,6 @@ export class TransitionHasher {
         const ea = this.blake2b.hashBytes(extrinsicView.assurances.encoded()).asOpaque();
         const ed = this.blake2b.hashBytes(extrinsicView.disputes.encoded()).asOpaque();
         const encoded = BytesBlob.blobFromParts([et.raw, ep.raw, eg.raw, ea.raw, ed.raw]);
-        return new WithHashAndBytes(this.blake2b.hashBytes(encoded).asOpaque(), extrinsicView, encoded);
+        return WithHashAndBytes.create(this.blake2b.hashBytes(encoded).asOpaque(), extrinsicView, encoded);
     }
 }

package/packages/jam/transition/hasher.test.js

@@ -20,7 +20,7 @@ describe("TransitionHasher", () => {
         async function prepareHasher() {
             const keccakHasher = await keccak.KeccakHasher.create();
             const blake2b = await Blake2b.createHasher();
-            return new TransitionHasher(keccakHasher, blake2b);
+            return TransitionHasher.new(keccakHasher, blake2b);
         }
         function prepareExtrinsicView(partialExtrinsic) {
             const spec = tinyChainSpec;

package/packages/jam/transition/preimages.test.js

@@ -18,7 +18,7 @@ function createInput(preimages, slot) {
 function createAccount(id, preimagesEntries = [], lookupHistoryEntries = []) {
     const preimages = HashDictionary.fromEntries(preimagesEntries.map((x) => [x.hash, x]));
     const lookupHistory = HashDictionary.fromEntries(lookupHistoryEntries.map((x) => [x.hash, [x]]));
-    return new InMemoryService(id, {
+    return InMemoryService.new(id, {
         info: ServiceAccountInfo.create({
             codeHash: Bytes.zero(HASH_SIZE).asOpaque(),
             balance: tryAsU64(0),
@@ -107,7 +107,7 @@ describe("Preimages", async () => {
         const hash = blake2b.hashBytes(blob).asOpaque();
         const preimages = [PreimageItem.create({ hash, blob })];
         const lookupHistory = [
-            new LookupHistoryItem(hash, tryAsU32(blob.length), tryAsLookupHistorySlots([tryAsTimeSlot(5)])),
+            LookupHistoryItem.new(hash, tryAsU32(blob.length), tryAsLookupHistorySlots([tryAsTimeSlot(5)])),
         ];
         const state = InMemoryState.partial(tinyChainSpec, {
             services: new Map([[tryAsServiceId(0), createAccount(tryAsServiceId(0), preimages, lookupHistory)]]),
@@ -123,8 +123,8 @@ describe("Preimages", async () => {
         const hash1 = blake2b.hashBytes(blob1).asOpaque();
         const hash2 = blake2b.hashBytes(blob2).asOpaque();
         const lookupHistory = [
-            new LookupHistoryItem(hash1, tryAsU32(blob1.length), tryAsLookupHistorySlots([])),
-            new LookupHistoryItem(hash2, tryAsU32(blob2.length), tryAsLookupHistorySlots([])),
+            LookupHistoryItem.new(hash1, tryAsU32(blob1.length), tryAsLookupHistorySlots([])),
+            LookupHistoryItem.new(hash2, tryAsU32(blob2.length), tryAsLookupHistorySlots([])),
         ];
         const state = InMemoryState.partial(tinyChainSpec, {
             services: new Map([

package/packages/jam/transition/reports/test.utils.js

@@ -189,7 +189,7 @@ export const initialValidators = () => [
 export const initialServices = ({ withDummyCodeHash = false } = {}) => {
     const m = new Map();
     const id = tryAsServiceId(129);
-    m.set(id, new InMemoryService(tryAsServiceId(129), {
+    m.set(id, InMemoryService.new(tryAsServiceId(129), {
         preimages: HashDictionary.new(),
         storage: new Map(),
         lookupHistory: HashDictionary.new(),

package/packages/workers/api-node/config.js

@@ -18,7 +18,7 @@ export class LmdbWorkerConfig {
     /** Restore node config from a transferable config object. */
     static async fromTransferable(decodeParams, config) {
         const blake2b = await Blake2b.createHasher();
-        const chainSpec = new ChainSpec(config.chainSpec);
+        const chainSpec = ChainSpec.new(config.chainSpec);
         const workerParams = Decoder.decodeObject(decodeParams, config.workerParams, chainSpec);
         const ports = new Map(config.workerPorts.map(([name, port]) => [name, ThreadPort.fromTransferable(chainSpec, port)]));
         return LmdbWorkerConfig.new({
@@ -39,10 +39,10 @@ export class LmdbWorkerConfig {
         this.ports = ports;
     }
     openDatabase(options = { readonly: true }) {
-        const lmdb = new LmdbRoot(this.dbPath, options.readonly);
+        const lmdb = LmdbRoot.new(this.dbPath, options.readonly);
         return {
-            getBlocksDb: () => new LmdbBlocks(this.chainSpec, lmdb),
-            getStatesDb: () => new LmdbStates(this.chainSpec, this.blake2b, lmdb),
+            getBlocksDb: () => LmdbBlocks.new(this.chainSpec, lmdb),
+            getStatesDb: () => LmdbStates.new(this.chainSpec, this.blake2b, lmdb),
             close: async () => await lmdb.close(),
         };
     }

package/packages/workers/api-node/port.d.ts

@@ -18,7 +18,8 @@ export declare class ThreadPort implements Port {
     static pair(spec: ChainSpec): [ThreadPort, ThreadPort];
     readonly threadId: number;
     private readonly events;
-    constructor(spec: ChainSpec, port: MessagePort);
+    static new(spec: ChainSpec, port: MessagePort): ThreadPort;
+    private constructor();
     static fromTransferable(spec: ChainSpec, { port }: TransferablePort): ThreadPort;
     intoTransferable(): TransferablePort;
     close(): void;

package/packages/workers/api-node/port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/api-node/port.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAA+B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,KAAK,KAAK,EAAoB,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAIF,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AACF,qBAAa,UAAW,YAAW,IAAI;IAWnC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXvB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC;IAMtD,SAAgB,QAAQ,SAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAG1B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,WAAW;IAcpC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,gBAAgB;IAInE,gBAAgB,IAAI,gBAAgB;IAIpC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI3C,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IASvF,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IASzF,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;CAWvE"}
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/api-node/port.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAA+B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,KAAK,KAAK,EAAoB,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAIF,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AACF,qBAAa,UAAW,YAAW,IAAI;IAenC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfvB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC;IAMtD,SAAgB,QAAQ,SAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW;IAI7C,OAAO;IAgBP,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,gBAAgB;IAInE,gBAAgB,IAAI,gBAAgB;IAIpC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI3C,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IASvF,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IASzF,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;CAWvE"}

package/packages/workers/api-node/port.js

@@ -10,10 +10,13 @@ export class ThreadPort {
     port;
     static pair(spec) {
         const { port1, port2 } = new MessageChannel();
-        return [new ThreadPort(spec, port1), new ThreadPort(spec, port2)];
+        return [ThreadPort.new(spec, port1), ThreadPort.new(spec, port2)];
     }
     threadId = threadId;
     events = new EventEmitter();
+    static new(spec, port) {
+        return new ThreadPort(spec, port);
+    }
     constructor(spec, port) {
         this.spec = spec;
         this.port = port;

package/packages/workers/api-node/port.test.js

@@ -17,8 +17,8 @@ describe("ThreadPort", () => {
         channel.port2.close();
     });
     it("should successfuly send messages", async () => {
-        const tx = new ThreadPort(spec, channel.port1);
-        const rx = new ThreadPort(spec, channel.port2);
+        const tx = ThreadPort.new(spec, channel.port1);
+        const rx = ThreadPort.new(spec, channel.port2);
         let received = null;
         // attach listener
         rx.on("hello", codec.varU32, (msg) => {

package/packages/workers/api-node/protocol.js

@@ -51,7 +51,7 @@ export function spawnWorker(protocol, bootstrapPath, config, paramsEncoder) {
         });
     });
     // now return communication channel with that worker
-    const txPort = new ThreadPort(config.chainSpec, channel.port1);
+    const txPort = ThreadPort.new(config.chainSpec, channel.port1);
     return {
         api: Channel.tx(protocol, txPort),
         worker,
@@ -90,7 +90,7 @@ export async function initWorker(protocol, paramsDecoder) {
                 logger.trace `--> (${protocol.name}) received configuration.`;
                 isResolved = true;
                 const config = await LmdbWorkerConfig.fromTransferable(paramsDecoder, msg.config);
-                const rxPort = new ThreadPort(config.chainSpec, msg.parentPort);
+                const rxPort = ThreadPort.new(config.chainSpec, msg.parentPort);
                 const comms = Channel.rx(protocol, rxPort);
                 resolve({
                     config,

package/packages/workers/block-authorship/generator.d.ts

@@ -17,15 +17,26 @@ import { type Opaque } from "#@typeberry/utils";
  *
  */
 export type BlockSealInput = Opaque<BytesBlob, "Seal">;
+/** Construction arguments for {@link Generator}. */
+export type GeneratorArgs = {
+    chainSpec: ChainSpec;
+    bandersnatch: BandernsatchWasm;
+    keccakHasher: keccak.KeccakHasher;
+    blake2b: Blake2b;
+    blocks: BlocksDb;
+    states: StatesDb;
+};
 export declare class Generator {
+    private readonly metrics;
     readonly chainSpec: ChainSpec;
     readonly bandersnatch: BandernsatchWasm;
     readonly keccakHasher: keccak.KeccakHasher;
     readonly blake2b: Blake2b;
     private readonly blocks;
     private readonly states;
-    private readonly metrics;
-    constructor(chainSpec: ChainSpec, bandersnatch: BandernsatchWasm, keccakHasher: keccak.KeccakHasher, blake2b: Blake2b, blocks: BlocksDb, states: StatesDb);
+    /** Build a {@link Generator} from its collaborators. */
+    static new(args: GeneratorArgs): Generator;
+    private constructor();
     private getLastHeaderAndState;
     nextBlockView(validatorIndex: ValidatorIndex, bandersnatchSecret: BandersnatchSecretSeed, sealPayload: BlockSealInput, timeSlot: TimeSlot): Promise<BlockView>;
     /**

package/packages/workers/block-authorship/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAIL,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAS,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAoC,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAIvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAGhF,OAAO,EAAqB,KAAK,MAAM,EAAU,MAAM,kBAAkB,CAAC;AAM1E;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAEvD,qBAAa,SAAS;aAIF,SAAS,EAAE,SAAS;aACpB,YAAY,EAAE,gBAAgB;aAC9B,YAAY,EAAE,MAAM,CAAC,YAAY;aACjC,OAAO,EAAE,OAAO;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;gBAGjD,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,gBAAgB,EAC9B,YAAY,EAAE,MAAM,CAAC,YAAY,EACjC,OAAO,EAAE,OAAO,EACf,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ;IAKnC,OAAO,CAAC,qBAAqB;IAYvB,aAAa,CACjB,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,sBAAsB,EAC1C,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,SAAS,CAAC;IAKrB;;;;;;;;;OASG;YACW,cAAc;IAiBtB,SAAS,CACb,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,sBAAsB,EAC1C,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,QAAQ;CAgGrB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAIL,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAS,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAoC,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAIvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAGhF,OAAO,EAAqB,KAAK,MAAM,EAAU,MAAM,kBAAkB,CAAC;AAM1E;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAEvD,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IAEnE,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,YAAY,EAAE,gBAAgB,CAAC;IAC/C,SAAgB,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC;IAClD,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAElC,wDAAwD;IACxD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa;IAI9B,OAAO;IAUP,OAAO,CAAC,qBAAqB;IAYvB,aAAa,CACjB,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,sBAAsB,EAC1C,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,SAAS,CAAC;IAKrB;;;;;;;;;OASG;YACW,cAAc;IAiBtB,SAAS,CACb,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,sBAAsB,EAC1C,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,QAAQ;CAgGrB"}

package/packages/workers/block-authorship/generator.js

@@ -13,20 +13,24 @@ import * as metrics from "./metrics.js";
 const EMPTY_AUX_DATA = BytesBlob.empty();
 const logger = Logger.new(import.meta.filename, "author");
 export class Generator {
+    metrics;
     chainSpec;
     bandersnatch;
     keccakHasher;
     blake2b;
     blocks;
     states;
-    metrics;
-    constructor(chainSpec, bandersnatch, keccakHasher, blake2b, blocks, states) {
-        this.chainSpec = chainSpec;
-        this.bandersnatch = bandersnatch;
-        this.keccakHasher = keccakHasher;
-        this.blake2b = blake2b;
-        this.blocks = blocks;
-        this.states = states;
+    /** Build a {@link Generator} from its collaborators. */
+    static new(args) {
+        return new Generator(args);
+    }
+    constructor(args) {
+        this.chainSpec = args.chainSpec;
+        this.bandersnatch = args.bandersnatch;
+        this.keccakHasher = args.keccakHasher;
+        this.blake2b = args.blake2b;
+        this.blocks = args.blocks;
+        this.states = args.states;
         this.metrics = metrics.createMetrics();
     }
     getLastHeaderAndState() {
@@ -79,7 +83,7 @@ export class Generator {
             throw new Error(`Entropy source generation failed: ${entropySource.error}`);
         }
         // retrieve data from previous block
-        const hasher = new TransitionHasher(this.keccakHasher, this.blake2b);
+        const hasher = TransitionHasher.new(this.keccakHasher, this.blake2b);
         const stateRoot = this.states.getStateRoot(lastState);
         // TODO create extrinsic
         const extrinsic = Extrinsic.create({

package/packages/workers/block-authorship/generator.test.js

@@ -156,7 +156,14 @@ describe("Generator", () => {
             const state = createMockState(0);
             const blocksDb = createMockBlocksDb(MOCK_PARENT_HASH);
             const statesDb = createMockStatesDb(state);
-            const generator = new Generator(tinyChainSpec, bandersnatch, keccakHasher, blake2b, blocksDb, statesDb);
+            const generator = Generator.new({
+                chainSpec: tinyChainSpec,
+                bandersnatch,
+                keccakHasher,
+                blake2b,
+                blocks: blocksDb,
+                states: statesDb,
+            });
             const validatorIndex = tryAsValidatorIndex(0);
             const timeSlot = tryAsTimeSlot(1);
             const block = await generator.nextBlock(validatorIndex, MOCK_BANDERSNATCH_SECRET, MOCK_SEAL_PAYLOAD, timeSlot);
@@ -176,7 +183,14 @@ describe("Generator", () => {
             const state = createMockState(lastSlotOfEpoch0);
             const blocksDb = createMockBlocksDb(MOCK_PARENT_HASH);
             const statesDb = createMockStatesDb(state);
-            const generator = new Generator(tinyChainSpec, bandersnatch, keccakHasher, blake2b, blocksDb, statesDb);
+            const generator = Generator.new({
+                chainSpec: tinyChainSpec,
+                bandersnatch,
+                keccakHasher,
+                blake2b,
+                blocks: blocksDb,
+                states: statesDb,
+            });
             const validatorIndex = tryAsValidatorIndex(0);
             const timeSlot = tryAsTimeSlot(firstSlotOfEpoch1);
             const block = await generator.nextBlock(validatorIndex, MOCK_BANDERSNATCH_SECRET, MOCK_SEAL_PAYLOAD, timeSlot);

package/packages/workers/block-authorship/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/main.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAgB3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK9E,KAAK,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAkBlD,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,iBA+OpG"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/main.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAgB3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK9E,KAAK,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAkBlD,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,iBAsPpG"}

package/packages/workers/block-authorship/main.js

@@ -34,7 +34,14 @@ export async function main(config, comms, networkingComms) {
     const hash = blocks.getBestHeaderHash();
     const startTime = tryAsU64(process.hrtime.bigint() / 1000000n);
     const startTimeSlot = states.getState(hash)?.timeslot ?? tryAsTimeSlot(0);
-    const generator = new Generator(chainSpec, bandersnatch, keccakHasher, blake2bHasher, blocks, states);
+    const generator = Generator.new({
+        chainSpec,
+        bandersnatch,
+        keccakHasher,
+        blake2b: blake2bHasher,
+        blocks,
+        states,
+    });
     const keys = await Promise.all(config.workerParams.keys.map(async (secrets) => ({
         bandersnatchSecret: secrets.bandersnatch,
         bandersnatchPublic: deriveBandersnatchPublicKey(secrets.bandersnatch),

package/packages/workers/importer/finality.test.js

@@ -36,7 +36,7 @@ async function createBlock(db, parent, slot = 0) {
     });
     const blockView = reencodeAsView(Block.Codec, block, tinyChainSpec);
     const headerHash = blake2b.hashBytes(blockView.header.view().encoded()).asOpaque();
-    await db.insertBlock(new WithHash(headerHash, blockView));
+    await db.insertBlock(WithHash.new(headerHash, blockView));
     return headerHash;
 }
 /** Build a linear chain of `length` blocks starting from `parentHash`. */

package/packages/workers/importer/importer.d.ts

@@ -20,18 +20,35 @@ export type ImporterOptions = {
     finalizer?: Finalizer;
     pruneBlocks?: boolean;
 };
+/** Construction arguments for {@link Importer}. */
+export type ImporterArgs = {
+    spec: ChainSpec;
+    pvm: PvmBackend;
+    hasher: TransitionHasher;
+    logger: Logger;
+    blocks: BlocksDb;
+    states: StatesDb<SerializedState<LeafDb>>;
+    options?: ImporterOptions;
+};
 export declare class Importer {
-    private readonly hasher;
-    private readonly logger;
-    private readonly blocks;
-    private readonly states;
-    private readonly options;
     private readonly verifier;
     private readonly stf;
     private readonly state;
     private currentHash;
     private readonly metrics;
-    constructor(spec: ChainSpec, pvm: PvmBackend, hasher: TransitionHasher, logger: Logger, blocks: BlocksDb, states: StatesDb<SerializedState<LeafDb>>, options?: ImporterOptions);
+    private readonly hasher;
+    private readonly logger;
+    private readonly blocks;
+    private readonly states;
+    private readonly options;
+    /**
+     * Build an {@link Importer} connected to the best state loaded from `states`.
+     *
+     * Throws if the best state cannot be loaded — callers are expected to treat that
+     * as a programmer error (the DB should be initialized before reaching here).
+     */
+    static open(args: ImporterArgs): Importer;
+    private constructor();
     /** Do some extra work for preparation for the next epoch. */
     prepareForNextEpoch(): Promise<void>;
     importBlockWithStateRoot(block: BlockView): Promise<Result<StateRootHash, ImporterError>>;

package/packages/workers/importer/importer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/importer/importer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AACvH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAiB,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAkC,MAAM,EAAkB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,oBAAY,iBAAiB;IAC3B,QAAQ,IAAI;IACZ,GAAG,IAAI;IACP,MAAM,IAAI;CACX;AAED,MAAM,MAAM,aAAa,GACrB,WAAW,CAAC,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAC3D,WAAW,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,GAC5C,WAAW,CAAC,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAO5D,MAAM,MAAM,eAAe,GAAG;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,qBAAa,QAAQ;IAajB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhB1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAG9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAEhD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;gBAGjE,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,UAAU,EACE,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EACzC,OAAO,GAAE,eAAoB;IAkBhD,6DAA6D;IAChD,mBAAmB;IAQnB,wBAAwB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAQzF,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;YAwB9F,mBAAmB;IAgGjC,oBAAoB;IAMpB,gBAAgB;IAIhB,eAAe,CAAC,UAAU,EAAE,UAAU;IAKhC,KAAK;CAIZ"}
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/importer/importer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AACvH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAiB,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAkC,MAAM,EAAkB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,oBAAY,iBAAiB;IAC3B,QAAQ,IAAI;IACZ,GAAG,IAAI;IACP,MAAM,IAAI;CACX;AAED,MAAM,MAAM,aAAa,GACrB,WAAW,CAAC,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAC3D,WAAW,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,GAC5C,WAAW,CAAC,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAO5D,MAAM,MAAM,eAAe,GAAG;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAG9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAEhD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IAEnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAE1C;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ;IASzC,OAAO;IAwBP,6DAA6D;IAChD,mBAAmB;IAQnB,wBAAwB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAQzF,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;YAwB9F,mBAAmB;IAgGjC,oBAAoB;IAMpB,gBAAgB;IAIhB,eAAe,CAAC,UAAU,EAAE,UAAU;IAKhC,KAAK;CAIZ"}