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

package/packages/workers/importer/importer.js

@@ -12,11 +12,6 @@ export var ImporterErrorKind;
 })(ImporterErrorKind || (ImporterErrorKind = {}));
 const importerError = (kind, nested) => Result.taggedError(ImporterErrorKind, kind, nested);
 export class Importer {
-    hasher;
-    logger;
-    blocks;
-    states;
-    options;
     verifier;
     stf;
     // TODO [ToDr] we cannot assume state reference does not change.
@@ -24,24 +19,44 @@ export class Importer {
     // Hash of the block that we have the posterior state for in `state`.
     currentHash;
     metrics;
-    constructor(spec, pvm, hasher, logger, blocks, states, options = {}) {
-        this.hasher = hasher;
-        this.logger = logger;
-        this.blocks = blocks;
-        this.states = states;
-        this.options = options;
-        this.metrics = metrics.createMetrics();
-        const currentBestHeaderHash = this.blocks.getBestHeaderHash();
-        const state = states.getState(currentBestHeaderHash);
+    hasher;
+    logger;
+    blocks;
+    states;
+    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) {
+        const currentBestHeaderHash = args.blocks.getBestHeaderHash();
+        const state = args.states.getState(currentBestHeaderHash);
         if (state === null) {
             throw new Error(`Unable to load best state from header hash: ${currentBestHeaderHash}.`);
         }
-        this.verifier = new BlockVerifier(hasher, blocks);
-        this.stf = new OnChain(spec, state, hasher, { pvm, accumulateSequentially: false }, DbHeaderChain.new(blocks));
+        return new Importer(args, state, currentBestHeaderHash);
+    }
+    constructor(args, state, currentBestHeaderHash) {
+        this.hasher = args.hasher;
+        this.logger = args.logger;
+        this.blocks = args.blocks;
+        this.states = args.states;
+        this.options = args.options ?? {};
+        this.metrics = metrics.createMetrics();
+        this.verifier = BlockVerifier.new(args.hasher, args.blocks);
+        this.stf = OnChain.assemble({
+            chainSpec: args.spec,
+            state,
+            hasher: args.hasher,
+            options: { pvm: args.pvm, accumulateSequentially: false },
+            headerChain: DbHeaderChain.new(args.blocks),
+        });
         this.state = state;
         this.currentHash = currentBestHeaderHash;
         this.prepareForNextEpoch();
-        logger.info `😎 Best time slot: ${state.timeslot} (header hash: ${currentBestHeaderHash})`;
+        args.logger.info `😎 Best time slot: ${state.timeslot} (header hash: ${currentBestHeaderHash})`;
     }
     /** Do some extra work for preparation for the next epoch. */
     async prepareForNextEpoch() {
@@ -134,7 +149,7 @@ export class Importer {
         logger.log `${timerState()}`;
         // insert new state and the block to DB.
         const timerDb = measure("import:db");
-        const writeBlocks = this.blocks.insertBlock(new WithHash(headerHash, block));
+        const writeBlocks = this.blocks.insertBlock(WithHash.new(headerHash, block));
         // Computation of the state root may happen asynchronously,
         // but we still need to wait for it before next block can be imported
         const stateRoot = await this.states.getStateRoot(this.state);
@@ -157,7 +172,7 @@ export class Importer {
                 }
             }
         }
-        return Result.ok(new WithHash(headerHash, block.header.view()));
+        return Result.ok(WithHash.new(headerHash, block.header.view()));
     }
     getBestStateRootHash() {
         const bestHeaderHash = this.blocks.getBestHeaderHash();

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/importer/main.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMtE,MAAM,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAE/F,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC;IACnB,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;CACxC,CAAC,CAsBD;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,iBAwCjE"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/importer/main.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMtE,MAAM,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAE/F,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC;IACnB,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;CACxC,CAAC,CA8BD;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,iBAwCjE"}

package/packages/workers/importer/main.js

@@ -17,11 +17,19 @@ export async function createImporter(config, options = {}) {
     const dummyFinalityDepth = config.workerParams.dummyFinalityDepth ?? 0;
     const finalizer = dummyFinalityDepth > 0 ? DummyFinalizer.create(blocks, dummyFinalityDepth) : undefined;
     const pruneBlocks = config.workerParams.pruneBlocks ?? false;
-    const hasher = new TransitionHasher(await keccakHasher, await blake2b);
-    const importer = new Importer(chainSpec, pvm, hasher, logger, blocks, states, {
-        ...options,
-        finalizer,
-        pruneBlocks,
+    const hasher = TransitionHasher.new(await keccakHasher, await blake2b);
+    const importer = Importer.open({
+        spec: chainSpec,
+        pvm,
+        hasher,
+        logger,
+        blocks,
+        states,
+        options: {
+            ...options,
+            finalizer,
+            pruneBlocks,
+        },
     });
     return {
         importer,

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

@@ -1 +0,0 @@
-{"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

@@ -1,41 +0,0 @@
-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,23 +0,0 @@
-import type { EntropyHash } from "#@typeberry/block";
-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);
-    constants(): BytesBlob;
-    entropy(): EntropyHash;
-    authorizerTrace(): BytesBlob;
-    workItemExtrinsic(_workItem: U64 | null, _index: U64): BytesBlob | null;
-    workItemImport(_workItem: U64 | null, _index: U64): BytesBlob | null;
-    workPackage(): BytesBlob;
-    authConfiguration(): BytesBlob;
-    authToken(): BytesBlob;
-    refineContext(): BytesBlob;
-    allWorkItems(): BytesBlob;
-    oneWorkItem(_workItem: U64): BytesBlob | null;
-    workItemPayload(_workItem: U64): BytesBlob | null;
-}
-//# sourceMappingURL=refine-fetch-externalities.d.ts.map

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

@@ -1 +0,0 @@
-{"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;IAGvD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,QAAQ,CAAC,OAAO,+BAA+B;gBAElB,SAAS,EAAE,SAAS;IAEjD,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,56 +0,0 @@
-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;
-    constructor(chainSpec) {
-        this.chainSpec = chainSpec;
-    }
-    constants() {
-        return getEncodedConstants(this.chainSpec);
-    }
-    // Returns H₀ (zero hash)
-    entropy() {
-        return Bytes.zero(HASH_SIZE).asOpaque();
-    }
-    // TODO [ToDr] implement
-    authorizerTrace() {
-        return BytesBlob.empty();
-    }
-    // TODO [ToDr] implement
-    workItemExtrinsic(_workItem, _index) {
-        return null;
-    }
-    // TODO [ToDr] implement
-    workItemImport(_workItem, _index) {
-        return null;
-    }
-    // TODO [ToDr] implement
-    workPackage() {
-        return BytesBlob.empty();
-    }
-    // TODO [ToDr] implement
-    authConfiguration() {
-        return BytesBlob.empty();
-    }
-    // TODO [ToDr] implement
-    authToken() {
-        return BytesBlob.empty();
-    }
-    // TODO [ToDr] implement
-    refineContext() {
-        return BytesBlob.empty();
-    }
-    // TODO [ToDr] implement
-    allWorkItems() {
-        return BytesBlob.empty();
-    }
-    oneWorkItem(_workItem) {
-        return null;
-    }
-    workItemPayload(_workItem) {
-        return null;
-    }
-}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"refine-fetch-externalities.test.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/refine-fetch-externalities.test.ts"],"names":[],"mappings":""}

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

@@ -1,32 +0,0 @@
-import assert from "node:assert";
-import { describe, it } from "node:test";
-import { fullChainSpec, tinyChainSpec } from "#@typeberry/config";
-import { RefineFetchExternalities } from "./refine-fetch-externalities.js";
-describe("RefineFetchExternalities", () => {
-    const prepareRefineData = ({ chainSpec } = {}) => {
-        const defaultChainSpec = tinyChainSpec;
-        return new RefineFetchExternalities(chainSpec ?? defaultChainSpec);
-    };
-    it("should return different constants for different chain specs", () => {
-        const tinyFetchExternalities = prepareRefineData({ chainSpec: tinyChainSpec });
-        const fullFetchExternalities = prepareRefineData({ chainSpec: fullChainSpec });
-        const tinyConstants = tinyFetchExternalities.constants();
-        const fullConstants = fullFetchExternalities.constants();
-        assert.notStrictEqual(tinyConstants.length, 0);
-        assert.notStrictEqual(fullConstants.length, 0);
-        assert.notDeepStrictEqual(tinyConstants, fullConstants);
-    });
-    // Pending implementation — these should assert against real fixture values once
-    // RefineFetchExternalities accepts and exposes the required refine inputs.
-    it.todo("should return entropy (H₀ header hash of anchor block)");
-    it.todo("should return authorizer trace");
-    it.todo("should return work item extrinsic");
-    it.todo("should return work item import");
-    it.todo("should return work package");
-    it.todo("should return authorizer");
-    it.todo("should return authorization token");
-    it.todo("should return refine context");
-    it.todo("should return all work items");
-    it.todo("should return one work item");
-    it.todo("should return work item payload");
-});