@typeberry/lib 0.8.4 → 0.9.0-959889e

package/packages/workers/block-authorship/epoch-tracker.js

@@ -0,0 +1,80 @@
+import { tryAsEpoch } from "#@typeberry/block";
+import { Safrole } from "#@typeberry/safrole";
+import { SafroleSealingKeysKind } from "#@typeberry/state";
+import { Result } from "#@typeberry/utils";
+import { EpochAuthoringSlots } from "./epoch-authoring-slots.js";
+export class EpochTracker {
+    chainSpec;
+    blake2bHasher;
+    authoring;
+    static async new(chainSpec, bandersnatch, blake2bHasher, keys) {
+        const epochSlots = await EpochAuthoringSlots.new(chainSpec, bandersnatch, keys);
+        return new EpochTracker(chainSpec, blake2bHasher, epochSlots);
+    }
+    constructor(chainSpec, blake2bHasher, authoring) {
+        this.chainSpec = chainSpec;
+        this.blake2bHasher = blake2bHasher;
+        this.authoring = authoring;
+    }
+    isEpochChanged(stateTimeSlot, newTimeSlot) {
+        const epochLength = this.chainSpec.epochLength;
+        const stateEpoch = Math.floor(stateTimeSlot / epochLength);
+        const newEpoch = Math.floor(newTimeSlot / epochLength);
+        return newEpoch > stateEpoch;
+    }
+    async getEpochData(logger, state, newTimeSlot) {
+        const sealingKeySeriesResult = await this.getSealingKeySeries(state, newTimeSlot);
+        // Propagate the typed failure instead of crashing — `main` decides whether to
+        // retry, skip or terminate, and keeps the real error details.
+        if (sealingKeySeriesResult.isError) {
+            return Result.error(`${sealingKeySeriesResult.error}`, sealingKeySeriesResult.details);
+        }
+        const epochLength = this.chainSpec.epochLength;
+        const sealingKeySeries = sealingKeySeriesResult.ok;
+        // On a new epoch, `state.entropy[2]` is the epoch-E entropy (pre-transition);
+        // mid-epoch, it has already shifted to `entropy[3]`. Use the same predicate
+        // as `getSealingKeySeries` so the entropy and the key series stay consistent
+        // even when the first authored block of an epoch isn't exactly at slot E·L.
+        const isNewEpoch = this.isEpochChanged(state.timeslot, newTimeSlot);
+        const entropy = isNewEpoch ? state.entropy[2] : state.entropy[3];
+        const epoch = tryAsEpoch(Math.floor(newTimeSlot / epochLength));
+        logger.log `[E${epoch}] is using ${SafroleSealingKeysKind[sealingKeySeries.kind]}`;
+        logger.trace `[E${epoch}] ${sealingKeySeries}`;
+        const slots = await this.authoring.getOurSlotsInKeySeries(sealingKeySeries, entropy);
+        this.logEpochAuthorshipInfo(logger, epoch, slots);
+        return Result.ok({
+            epoch,
+            epochLength,
+            sealingKeySeries,
+            entropy,
+            slots,
+        });
+    }
+    async getSealingKeySeries(state, newTimeSlot) {
+        // in case we are not changing epoch, just use the state data
+        if (!this.isEpochChanged(state.timeslot, newTimeSlot)) {
+            return Result.ok(state.sealingKeySeries);
+        }
+        // otherwise, pick the new sealing key series already
+        const safrole = new Safrole(this.chainSpec, this.blake2bHasher, state);
+        return await safrole.getSealingKeySeries({
+            entropy: state.entropy[1],
+            slot: newTimeSlot,
+            punishSet: state.disputesRecords.punishSet,
+        });
+    }
+    logEpochAuthorshipInfo(logger, epoch, slots) {
+        let isCreating = false;
+        let slot = epoch * this.chainSpec.epochLength;
+        for (const sealData of slots) {
+            if (sealData !== null) {
+                isCreating = true;
+                logger.info `[E${epoch}#${slot}] Validator ${sealData.key.bandersnatchPublic.toStringTruncated()} will author using ${sealData.logId}`;
+            }
+            slot += 1;
+        }
+        if (isCreating === false) {
+            logger.info `[E${epoch}] No blocks to author for this epoch.`;
+        }
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,eAAO,MAAM,MAAM,mBAAwD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,eAAO,MAAM,MAAM,mBAAyD,CAAC"}

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

@@ -1,4 +1,4 @@
 export * from "./main.js";
 export * from "./metrics.js";
 export * from "./protocol.js";
-export const WORKER = new URL("./bootstrap-generator.mjs", import.meta.url);
+export const WORKER = new URL("./bootstrap-authorship.mjs", import.meta.url);

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

@@ -2,6 +2,9 @@ import type { NetworkingComms } from "#@typeberry/comms-authorship-network";
 import type { WorkerConfig } from "#@typeberry/workers-api";
 import type { BlockAuthorshipConfig, GeneratorInternal } from "./protocol.js";
 type Config = WorkerConfig<BlockAuthorshipConfig>;
+/**
+ * The `BlockAuthorship` should create new blocks and send them as signals to the main thread.
+ */
 export declare function main(config: Config, comms: GeneratorInternal, networkingComms: NetworkingComms): Promise<void>;
 export {};
 //# sourceMappingURL=main.d.ts.map

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":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAiB3E,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;AAwBlD,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,iBAiapG"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/main.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAS3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAM9E,KAAK,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAElD;;GAEG;AAEH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,iBAkKpG"}