@typeberry/lib 0.5.10-9567cee → 0.5.10-9ffd7ac

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

@@ -1,5 +1,6 @@
 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,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;AACzC,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC"}

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

@@ -1,4 +1,5 @@
 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/externalities/is-authorized-fetch-externalities.d.ts

@@ -0,0 +1,22 @@
+import { BytesBlob } from "#@typeberry/bytes";
+import type { ChainSpec } from "#@typeberry/config";
+import { general } from "#@typeberry/jam-host-calls";
+import type { U64 } from "#@typeberry/numbers";
+export declare class IsAuthorizedFetchExternalities implements general.IIsAuthorizedFetch {
+    private readonly chainSpec;
+    private readonly params;
+    readonly context = general.FetchContext.IsAuthorized;
+    constructor(chainSpec: ChainSpec, params: {
+        authToken: BytesBlob;
+        authConfiguration: BytesBlob;
+    });
+    constants(): BytesBlob;
+    workPackage(): BytesBlob;
+    authConfiguration(): BytesBlob;
+    authToken(): BytesBlob;
+    refineContext(): BytesBlob;
+    allWorkItems(): BytesBlob;
+    oneWorkItem(_workItem: U64): BytesBlob | null;
+    workItemPayload(_workItem: U64): BytesBlob | null;
+}
+//# sourceMappingURL=is-authorized-fetch-externalities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is-authorized-fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/is-authorized-fetch-externalities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C,qBAAa,8BAA+B,YAAW,OAAO,CAAC,kBAAkB;IAI7E,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,QAAQ,CAAC,OAAO,qCAAqC;gBAGlC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE;QACvB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,SAAS,CAAC;KAC9B;IAGH,SAAS,IAAI,SAAS;IAKtB,WAAW,IAAI,SAAS;IAIxB,iBAAiB,IAAI,SAAS;IAI9B,SAAS,IAAI,SAAS;IAKtB,aAAa,IAAI,SAAS;IAK1B,YAAY,IAAI,SAAS;IAKzB,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAK7C,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAGlD"}

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

@@ -0,0 +1,41 @@
+import { BytesBlob } from "#@typeberry/bytes";
+import { general } from "#@typeberry/jam-host-calls";
+import { getEncodedConstants } from "./fetch-externalities.js";
+export class IsAuthorizedFetchExternalities {
+    chainSpec;
+    params;
+    context = general.FetchContext.IsAuthorized;
+    constructor(chainSpec, params) {
+        this.chainSpec = chainSpec;
+        this.params = params;
+    }
+    constants() {
+        return getEncodedConstants(this.chainSpec);
+    }
+    // TODO [ToDr] Return encoded work package E(p)
+    workPackage() {
+        return BytesBlob.empty();
+    }
+    authConfiguration() {
+        return this.params.authConfiguration;
+    }
+    authToken() {
+        return this.params.authToken;
+    }
+    // TODO [ToDr] Return encoded refinement context
+    refineContext() {
+        return BytesBlob.empty();
+    }
+    // TODO [ToDr] Return encoded work items
+    allWorkItems() {
+        return BytesBlob.empty();
+    }
+    // TODO [ToDr] Return single work item summary
+    oneWorkItem(_workItem) {
+        return null;
+    }
+    // TODO [ToDr] Return work item payload
+    workItemPayload(_workItem) {
+        return null;
+    }
+}

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

@@ -1,22 +1,23 @@
 import type { EntropyHash } from "#@typeberry/block";
-import { type BytesBlob } from "#@typeberry/bytes";
+import { BytesBlob } from "#@typeberry/bytes";
 import type { ChainSpec } from "#@typeberry/config";
 import { general } from "#@typeberry/jam-host-calls";
 import type { U64 } from "#@typeberry/numbers";
 export declare class RefineFetchExternalities implements general.IRefineFetch {
     private readonly chainSpec;
     readonly context = general.FetchContext.Refine;
-    constructor(chainSpec: ChainSpec);
+    static new(chainSpec: ChainSpec): RefineFetchExternalities;
+    private constructor();
     constants(): BytesBlob;
     entropy(): EntropyHash;
-    authorizerTrace(): BytesBlob | null;
+    authorizerTrace(): BytesBlob;
     workItemExtrinsic(_workItem: U64 | null, _index: U64): BytesBlob | null;
     workItemImport(_workItem: U64 | null, _index: U64): BytesBlob | null;
-    workPackage(): BytesBlob | null;
-    authorizer(): BytesBlob | null;
-    authorizationToken(): BytesBlob | null;
-    refineContext(): BytesBlob | null;
-    allWorkItems(): BytesBlob | null;
+    workPackage(): BytesBlob;
+    authConfiguration(): BytesBlob;
+    authToken(): BytesBlob;
+    refineContext(): BytesBlob;
+    allWorkItems(): BytesBlob;
     oneWorkItem(_workItem: U64): BytesBlob | null;
     workItemPayload(_workItem: U64): BytesBlob | null;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"refine-fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/refine-fetch-externalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C,qBAAa,wBAAyB,YAAW,OAAO,CAAC,YAAY;IAGvD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,QAAQ,CAAC,OAAO,+BAA+B;gBAElB,SAAS,EAAE,SAAS;IAEjD,SAAS,IAAI,SAAS;IAKtB,OAAO,IAAI,WAAW;IAItB,eAAe,IAAI,SAAS,GAAG,IAAI;IAInC,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAIvE,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAIpE,WAAW,IAAI,SAAS,GAAG,IAAI;IAI/B,UAAU,IAAI,SAAS,GAAG,IAAI;IAI9B,kBAAkB,IAAI,SAAS,GAAG,IAAI;IAItC,aAAa,IAAI,SAAS,GAAG,IAAI;IAIjC,YAAY,IAAI,SAAS,GAAG,IAAI;IAIhC,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAI7C,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAGlD"}
+{"version":3,"file":"refine-fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/refine-fetch-externalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAS,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C,qBAAa,wBAAyB,YAAW,OAAO,CAAC,YAAY;IAO/C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN9C,QAAQ,CAAC,OAAO,+BAA+B;IAE/C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS;IAI/B,OAAO;IAEP,SAAS,IAAI,SAAS;IAKtB,OAAO,IAAI,WAAW;IAKtB,eAAe,IAAI,SAAS;IAK5B,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAKvE,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAKpE,WAAW,IAAI,SAAS;IAKxB,iBAAiB,IAAI,SAAS;IAK9B,SAAS,IAAI,SAAS;IAKtB,aAAa,IAAI,SAAS;IAK1B,YAAY,IAAI,SAAS;IAIzB,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAI7C,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAGlD"}

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

@@ -1,10 +1,13 @@
-import { Bytes } from "#@typeberry/bytes";
+import { Bytes, BytesBlob } from "#@typeberry/bytes";
 import { HASH_SIZE } from "#@typeberry/hash";
 import { general } from "#@typeberry/jam-host-calls";
 import { getEncodedConstants } from "./fetch-externalities.js";
 export class RefineFetchExternalities {
     chainSpec;
     context = general.FetchContext.Refine;
+    static new(chainSpec) {
+        return new RefineFetchExternalities(chainSpec);
+    }
     constructor(chainSpec) {
         this.chainSpec = chainSpec;
     }
@@ -15,29 +18,37 @@ export class RefineFetchExternalities {
     entropy() {
         return Bytes.zero(HASH_SIZE).asOpaque();
     }
+    // TODO [ToDr] implement
     authorizerTrace() {
-        return null;
+        return BytesBlob.empty();
     }
+    // TODO [ToDr] implement
     workItemExtrinsic(_workItem, _index) {
         return null;
     }
+    // TODO [ToDr] implement
     workItemImport(_workItem, _index) {
         return null;
     }
+    // TODO [ToDr] implement
     workPackage() {
-        return null;
+        return BytesBlob.empty();
     }
-    authorizer() {
-        return null;
+    // TODO [ToDr] implement
+    authConfiguration() {
+        return BytesBlob.empty();
     }
-    authorizationToken() {
-        return null;
+    // TODO [ToDr] implement
+    authToken() {
+        return BytesBlob.empty();
     }
+    // TODO [ToDr] implement
     refineContext() {
-        return null;
+        return BytesBlob.empty();
     }
+    // TODO [ToDr] implement
     allWorkItems() {
-        return null;
+        return BytesBlob.empty();
     }
     oneWorkItem(_workItem) {
         return null;

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

@@ -5,7 +5,7 @@ import { RefineFetchExternalities } from "./refine-fetch-externalities.js";
 describe("RefineFetchExternalities", () => {
     const prepareRefineData = ({ chainSpec } = {}) => {
         const defaultChainSpec = tinyChainSpec;
-        return new RefineFetchExternalities(chainSpec ?? defaultChainSpec);
+        return RefineFetchExternalities.new(chainSpec ?? defaultChainSpec);
     };
     it("should return different constants for different chain specs", () => {
         const tinyFetchExternalities = prepareRefineData({ chainSpec: tinyChainSpec });

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":"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"}