@lodestar/era 1.36.0

package/lib/era/reader.js

@@ -0,0 +1,160 @@
+import { open } from "node:fs/promises";
+import { basename } from "node:path";
+import { PublicKey, Signature, verify } from "@chainsafe/blst";
+import { createCachedGenesis } from "@lodestar/config";
+import { DOMAIN_BEACON_PROPOSER, SLOTS_PER_HISTORICAL_ROOT } from "@lodestar/params";
+import { ssz } from "@lodestar/types";
+import { E2STORE_HEADER_SIZE, EntryType, readEntry, readVersion } from "../e2s.js";
+import { snappyUncompress } from "../util.js";
+import { computeEraNumberFromBlockSlot, parseEraName, readAllEraIndices, readSlotFromBeaconStateBytes, } from "./util.js";
+/**
+ * EraReader is responsible for reading and validating ERA files.
+ *
+ * See https://github.com/eth-clients/e2store-format-specs/blob/main/formats/era.md
+ */
+export class EraReader {
+    config;
+    /** The underlying file handle */
+    fh;
+    /** The era number retrieved from the file name */
+    eraNumber;
+    /** The short historical root retrieved from the file name */
+    shortHistoricalRoot;
+    /** An array of state and block indices, one per group */
+    groups;
+    constructor(config, fh, eraNumber, shortHistoricalRoot, indices) {
+        this.config = config;
+        this.fh = fh;
+        this.eraNumber = eraNumber;
+        this.shortHistoricalRoot = shortHistoricalRoot;
+        this.groups = indices;
+    }
+    static async open(config, path) {
+        const fh = await open(path, "r");
+        const name = basename(path);
+        const { configName, eraNumber, shortHistoricalRoot } = parseEraName(name);
+        if (config.CONFIG_NAME !== configName) {
+            throw new Error(`Config name mismatch: expected ${config.CONFIG_NAME}, got ${configName}`);
+        }
+        const indices = await readAllEraIndices(fh);
+        return new EraReader(config, fh, eraNumber, shortHistoricalRoot, indices);
+    }
+    /**
+     * Close the underlying file descriptor
+     *
+     * No further actions can be taken after this operation
+     */
+    async close() {
+        await this.fh.close();
+    }
+    async readCompressedState(eraNumber) {
+        eraNumber = eraNumber ?? this.eraNumber;
+        const index = this.groups.at(eraNumber - this.eraNumber);
+        if (!index) {
+            throw new Error(`No index found for era number ${eraNumber}`);
+        }
+        const entry = await readEntry(this.fh, index.stateIndex.recordStart + index.stateIndex.offsets[0]);
+        if (entry.type !== EntryType.CompressedBeaconState) {
+            throw new Error(`Expected CompressedBeaconState, got ${entry.type}`);
+        }
+        return entry.data;
+    }
+    async readSerializedState(eraNumber) {
+        const compressed = await this.readCompressedState(eraNumber);
+        return snappyUncompress(compressed);
+    }
+    async readState(eraNumber) {
+        const serialized = await this.readSerializedState(eraNumber);
+        const stateSlot = readSlotFromBeaconStateBytes(serialized);
+        return this.config.getForkTypes(stateSlot).BeaconState.deserialize(serialized);
+    }
+    async readCompressedBlock(slot) {
+        const slotEra = computeEraNumberFromBlockSlot(slot);
+        const index = this.groups.at(slotEra - this.eraNumber);
+        if (!index) {
+            throw new Error(`Slot ${slot} is out of range`);
+        }
+        if (!index.blocksIndex) {
+            throw new Error(`No block index found for era number ${slotEra}`);
+        }
+        // Calculate offset within the index
+        const indexOffset = slot - index.blocksIndex.startSlot;
+        const offset = index.blocksIndex.recordStart + index.blocksIndex.offsets[indexOffset];
+        if (offset === 0) {
+            return null; // Empty slot
+        }
+        const entry = await readEntry(this.fh, offset);
+        if (entry.type !== EntryType.CompressedSignedBeaconBlock) {
+            throw new Error(`Expected CompressedSignedBeaconBlock, got ${EntryType[entry.type] ?? "unknown"}`);
+        }
+        return entry.data;
+    }
+    async readSerializedBlock(slot) {
+        const compressed = await this.readCompressedBlock(slot);
+        if (compressed === null)
+            return null;
+        return snappyUncompress(compressed);
+    }
+    async readBlock(slot) {
+        const serialized = await this.readSerializedBlock(slot);
+        if (serialized === null)
+            return null;
+        return this.config.getForkTypes(slot).SignedBeaconBlock.deserialize(serialized);
+    }
+    /**
+     * Validate the era file.
+     * - e2s format correctness
+     * - era range correctness
+     * - network correctness for state and blocks
+     * - block root and signature matches
+     */
+    async validate() {
+        for (let groupIndex = 0; groupIndex < this.groups.length; groupIndex++) {
+            const eraNumber = this.eraNumber + groupIndex;
+            const index = this.groups[groupIndex];
+            // validate version entry
+            const start = index.blocksIndex
+                ? index.blocksIndex.recordStart + index.blocksIndex.offsets[0] - E2STORE_HEADER_SIZE
+                : index.stateIndex.recordStart + index.stateIndex.offsets[0] - E2STORE_HEADER_SIZE;
+            await readVersion(this.fh, start);
+            // validate state
+            // the state is loadable and consistent with the given runtime configuration
+            const state = await this.readState(eraNumber);
+            const cachedGenesis = createCachedGenesis(this.config, state.genesisValidatorsRoot);
+            if (eraNumber === 0 && index.blocksIndex) {
+                throw new Error("Genesis era (era 0) should not have blocks index");
+            }
+            if (eraNumber !== 0) {
+                if (!index.blocksIndex) {
+                    throw new Error(`Era ${eraNumber} is missing blocks index`);
+                }
+                // validate blocks
+                for (let slot = index.blocksIndex.startSlot; slot < index.blocksIndex.startSlot + index.blocksIndex.offsets.length; slot++) {
+                    const block = await this.readBlock(slot);
+                    if (block === null) {
+                        if (slot === index.blocksIndex.startSlot)
+                            continue; // first slot in the era can't be easily validated
+                        if (Buffer.compare(state.blockRoots[(slot - 1) % SLOTS_PER_HISTORICAL_ROOT], state.blockRoots[slot % SLOTS_PER_HISTORICAL_ROOT]) !== 0) {
+                            throw new Error(`Block root mismatch at slot ${slot} for empty slot`);
+                        }
+                        continue;
+                    }
+                    const blockRoot = this.config.getForkTypes(slot).BeaconBlock.hashTreeRoot(block.message);
+                    if (Buffer.compare(blockRoot, state.blockRoots[slot % SLOTS_PER_HISTORICAL_ROOT]) !== 0) {
+                        throw new Error(`Block root mismatch at slot ${slot}`);
+                    }
+                    const msg = ssz.phase0.SigningData.hashTreeRoot({
+                        objectRoot: blockRoot,
+                        domain: cachedGenesis.getDomain(slot, DOMAIN_BEACON_PROPOSER),
+                    });
+                    const pk = PublicKey.fromBytes(state.validators[block.message.proposerIndex].pubkey);
+                    const sig = Signature.fromBytes(block.signature);
+                    if (!verify(msg, pk, sig, true, true)) {
+                        throw new Error(`Block signature verification failed at slot ${slot}`);
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=reader.js.map

package/lib/era/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/era/reader.ts"],"names":[],"mappings":"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"}

package/lib/era/util.d.ts

@@ -0,0 +1,46 @@
+import type { FileHandle } from "node:fs/promises";
+import { ChainForkConfig } from "@lodestar/config";
+import { BeaconState, Slot } from "@lodestar/types";
+import { SlotIndex } from "../e2s.ts";
+/**
+ * Parsed components of an .era file name.
+ * Format: <config-name>-<era-number>-<short-historical-root>.era
+ */
+export interface EraFileName {
+    /** CONFIG_NAME field of runtime config (mainnet, sepolia, holesky, etc.) */
+    configName: string;
+    /** Number of the first era stored in file, 5-digit zero-padded (00000, 00001, etc.) */
+    eraNumber: number;
+    /** First 4 bytes of last historical root, lower-case hex-encoded (8 chars) */
+    shortHistoricalRoot: string;
+}
+export interface EraIndices {
+    stateIndex: SlotIndex;
+    blocksIndex?: SlotIndex;
+}
+/** Return true if `slot` is within the era range */
+export declare function isSlotInRange(slot: Slot, eraNumber: number): boolean;
+export declare function isValidEraStateSlot(slot: Slot, eraNumber: number): boolean;
+export declare function computeEraNumberFromBlockSlot(slot: Slot): number;
+export declare function computeStartBlockSlotFromEraNumber(eraNumber: number): Slot;
+/**
+ * Parse era filename.
+ *
+ * Format: `<config-name>-<era-number>-<short-historical-root>.era`
+ */
+export declare function parseEraName(filename: string): {
+    configName: string;
+    eraNumber: number;
+    shortHistoricalRoot: string;
+};
+/**
+ * Read all indices from an era file.
+ */
+export declare function readAllEraIndices(fh: FileHandle): Promise<EraIndices[]>;
+/**
+ * Read state and block SlotIndex entries from an era file and validate alignment.
+ */
+export declare function readEraIndexes(fh: FileHandle, end: number): Promise<EraIndices>;
+export declare function readSlotFromBeaconStateBytes(beaconStateBytes: Uint8Array): Slot;
+export declare function getShortHistoricalRoot(config: ChainForkConfig, state: BeaconState): string;
+//# sourceMappingURL=util.d.ts.map

package/lib/era/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/era/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAC,WAAW,EAAE,IAAI,EAAe,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAsB,SAAS,EAAgB,MAAM,WAAW,CAAC;AAGxE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhE;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAC,CAUnH;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAY7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BrF;AAED,wBAAgB,4BAA4B,CAAC,gBAAgB,EAAE,UAAU,GAAG,IAAI,CAO/E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAa1F"}

package/lib/era/util.js

@@ -0,0 +1,92 @@
+import { SLOTS_PER_HISTORICAL_ROOT, isForkPostCapella } from "@lodestar/params";
+import { ssz } from "@lodestar/types";
+import { E2STORE_HEADER_SIZE, readSlotIndex } from "../e2s.js";
+import { readUint48 } from "../util.js";
+/** Return true if `slot` is within the era range */
+export function isSlotInRange(slot, eraNumber) {
+    return computeEraNumberFromBlockSlot(slot) === eraNumber;
+}
+export function isValidEraStateSlot(slot, eraNumber) {
+    return slot % SLOTS_PER_HISTORICAL_ROOT === 0 && slot / SLOTS_PER_HISTORICAL_ROOT === eraNumber;
+}
+export function computeEraNumberFromBlockSlot(slot) {
+    return Math.floor(slot / SLOTS_PER_HISTORICAL_ROOT) + 1;
+}
+export function computeStartBlockSlotFromEraNumber(eraNumber) {
+    if (eraNumber === 0) {
+        throw new Error("Genesis era (era 0) does not contain blocks");
+    }
+    return (eraNumber - 1) * SLOTS_PER_HISTORICAL_ROOT;
+}
+/**
+ * Parse era filename.
+ *
+ * Format: `<config-name>-<era-number>-<short-historical-root>.era`
+ */
+export function parseEraName(filename) {
+    const match = filename.match(/^(.*)-(\d{5})-([0-9a-f]{8})\.era$/);
+    if (!match) {
+        throw new Error(`Invalid era filename format: ${filename}`);
+    }
+    return {
+        configName: match[1],
+        eraNumber: parseInt(match[2], 10),
+        shortHistoricalRoot: match[3],
+    };
+}
+/**
+ * Read all indices from an era file.
+ */
+export async function readAllEraIndices(fh) {
+    let end = (await fh.stat()).size;
+    const indices = [];
+    while (end > E2STORE_HEADER_SIZE) {
+        const index = await readEraIndexes(fh, end);
+        indices.push(index);
+        end = index.blocksIndex
+            ? index.blocksIndex.recordStart + index.blocksIndex.offsets[0] - E2STORE_HEADER_SIZE
+            : index.stateIndex.recordStart + index.stateIndex.offsets[0] - E2STORE_HEADER_SIZE;
+    }
+    return indices;
+}
+/**
+ * Read state and block SlotIndex entries from an era file and validate alignment.
+ */
+export async function readEraIndexes(fh, end) {
+    const stateIndex = await readSlotIndex(fh, end);
+    if (stateIndex.offsets.length !== 1) {
+        throw new Error(`State SlotIndex must have exactly one offset, got ${stateIndex.offsets.length}`);
+    }
+    // Read block index if not genesis era (era 0)
+    let blocksIndex;
+    if (stateIndex.startSlot > 0) {
+        blocksIndex = await readSlotIndex(fh, stateIndex.recordStart);
+        if (blocksIndex.offsets.length !== SLOTS_PER_HISTORICAL_ROOT) {
+            throw new Error(`Block SlotIndex must have exactly ${SLOTS_PER_HISTORICAL_ROOT} offsets, got ${blocksIndex.offsets.length}`);
+        }
+        // Validate block and state indices are properly aligned
+        const expectedBlockStartSlot = stateIndex.startSlot - SLOTS_PER_HISTORICAL_ROOT;
+        if (blocksIndex.startSlot !== expectedBlockStartSlot) {
+            throw new Error(`Block index alignment error: expected startSlot=${expectedBlockStartSlot}, ` +
+                `got startSlot=${blocksIndex.startSlot} (should be exactly one era before state)`);
+        }
+    }
+    return { stateIndex, blocksIndex };
+}
+export function readSlotFromBeaconStateBytes(beaconStateBytes) {
+    // not technically a Uint48, but for practical purposes fits within 6 bytes
+    return readUint48(beaconStateBytes, 
+    // slot is at offset 40: 8 (genesisTime) + 32 (genesisValidatorsRoot)
+    40);
+}
+export function getShortHistoricalRoot(config, state) {
+    return Buffer.from(state.slot === 0
+        ? state.genesisValidatorsRoot
+        : // Post-Capella, historical_roots is replaced by historical_summaries
+            isForkPostCapella(config.getForkName(state.slot))
+                ? ssz.capella.HistoricalSummary.hashTreeRoot(state.historicalSummaries.at(-1))
+                : state.historicalRoots.at(-1))
+        .subarray(0, 4)
+        .toString("hex");
+}
+//# sourceMappingURL=util.js.map

package/lib/era/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/era/util.ts"],"names":[],"mappings":"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"}

package/lib/era/writer.d.ts

@@ -0,0 +1,48 @@
+import { type FileHandle } from "node:fs/promises";
+import { ChainForkConfig } from "@lodestar/config";
+import { BeaconState, SignedBeaconBlock, Slot } from "@lodestar/types";
+declare enum WriterStateType {
+    InitGroup = 0,
+    WriteGroup = 1,
+    FinishedGroup = 2
+}
+type WriterState = {
+    type: WriterStateType.InitGroup;
+    eraNumber: number;
+    currentOffset: number;
+} | {
+    type: WriterStateType.WriteGroup;
+    eraNumber: number;
+    currentOffset: number;
+    blockOffsets: number[];
+    lastSlot: Slot;
+} | {
+    type: WriterStateType.FinishedGroup;
+    eraNumber: number;
+    currentOffset: number;
+    shortHistoricalRoot: string;
+};
+/**
+ * EraWriter is responsible for writing ERA files.
+ *
+ * See https://github.com/eth-clients/e2store-format-specs/blob/main/formats/era.md
+ */
+export declare class EraWriter {
+    config: ChainForkConfig;
+    path: string;
+    fh: FileHandle;
+    eraNumber: number;
+    state: WriterState;
+    constructor(config: ChainForkConfig, path: string, fh: FileHandle, eraNumber: number);
+    static create(config: ChainForkConfig, path: string, eraNumber: number): Promise<EraWriter>;
+    finish(): Promise<string>;
+    writeVersion(): Promise<void>;
+    writeCompressedState(slot: Slot, shortHistoricalRoot: string, data: Uint8Array): Promise<void>;
+    writeSerializedState(slot: Slot, shortHistoricalRoot: string, data: Uint8Array): Promise<void>;
+    writeState(state: BeaconState): Promise<void>;
+    writeCompressedBlock(slot: Slot, data: Uint8Array): Promise<void>;
+    writeSerializedBlock(slot: Slot, data: Uint8Array): Promise<void>;
+    writeBlock(block: SignedBeaconBlock): Promise<void>;
+}
+export {};
+//# sourceMappingURL=writer.d.ts.map

package/lib/era/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/era/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,UAAU,EAAe,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAE,IAAI,EAAC,MAAM,iBAAiB,CAAC;AAUrE,aAAK,eAAe;IAClB,SAAS,IAAA;IACT,UAAU,IAAA;IACV,aAAa,IAAA;CACd;AAED,KAAK,WAAW,GACZ;IACE,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,GACD;IACE,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,IAAI,CAAC;CAChB,GACD;IACE,IAAI,EAAE,eAAe,CAAC,aAAa,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEN;;;;GAIG;AACH,qBAAa,SAAS;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;gBAEP,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM;WAYvE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAK3F,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBzB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB7B,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C9F,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9F,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjE,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjE,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAM1D"}

package/lib/era/writer.js

@@ -0,0 +1,163 @@
+import { open, rename } from "node:fs/promises";
+import { format, parse } from "node:path";
+import { SLOTS_PER_HISTORICAL_ROOT } from "@lodestar/params";
+import { E2STORE_HEADER_SIZE, EntryType, serializeSlotIndex, writeEntry } from "../e2s.js";
+import { snappyCompress } from "../util.js";
+import { computeStartBlockSlotFromEraNumber, getShortHistoricalRoot, isSlotInRange, isValidEraStateSlot, } from "./util.js";
+var WriterStateType;
+(function (WriterStateType) {
+    WriterStateType[WriterStateType["InitGroup"] = 0] = "InitGroup";
+    WriterStateType[WriterStateType["WriteGroup"] = 1] = "WriteGroup";
+    WriterStateType[WriterStateType["FinishedGroup"] = 2] = "FinishedGroup";
+})(WriterStateType || (WriterStateType = {}));
+/**
+ * EraWriter is responsible for writing ERA files.
+ *
+ * See https://github.com/eth-clients/e2store-format-specs/blob/main/formats/era.md
+ */
+export class EraWriter {
+    config;
+    path;
+    fh;
+    eraNumber;
+    state;
+    constructor(config, path, fh, eraNumber) {
+        this.config = config;
+        this.path = path;
+        this.fh = fh;
+        this.eraNumber = eraNumber;
+        this.state = {
+            type: WriterStateType.InitGroup,
+            eraNumber,
+            currentOffset: 0,
+        };
+    }
+    static async create(config, path, eraNumber) {
+        const fh = await open(path, "w");
+        return new EraWriter(config, path, fh, eraNumber);
+    }
+    async finish() {
+        if (this.state.type !== WriterStateType.FinishedGroup) {
+            throw new Error("Writer has not been finished");
+        }
+        await this.fh.close();
+        const pathParts = parse(this.path);
+        const newPath = format({
+            ...pathParts,
+            base: `${this.config.CONFIG_NAME}-${String(this.eraNumber).padStart(5, "0")}-${this.state.shortHistoricalRoot}.era`,
+        });
+        await rename(this.path, newPath);
+        return newPath;
+    }
+    async writeVersion() {
+        if (this.state.type === WriterStateType.FinishedGroup) {
+            this.state = {
+                type: WriterStateType.InitGroup,
+                eraNumber: this.state.eraNumber + 1,
+                currentOffset: this.state.currentOffset,
+            };
+        }
+        if (this.state.type !== WriterStateType.InitGroup) {
+            throw new Error("Writer has already been initialized");
+        }
+        await writeEntry(this.fh, this.state.currentOffset, EntryType.Version, new Uint8Array(0));
+        // Move to writing blocks/state
+        this.state = {
+            type: WriterStateType.WriteGroup,
+            eraNumber: this.state.eraNumber,
+            currentOffset: this.state.currentOffset + E2STORE_HEADER_SIZE,
+            blockOffsets: [],
+            lastSlot: computeStartBlockSlotFromEraNumber(this.state.eraNumber) - 1,
+        };
+    }
+    async writeCompressedState(slot, shortHistoricalRoot, data) {
+        if (this.state.type === WriterStateType.InitGroup) {
+            await this.writeVersion();
+        }
+        if (this.state.type !== WriterStateType.WriteGroup) {
+            throw new Error("unreachable");
+        }
+        const expectedSlot = this.state.eraNumber * SLOTS_PER_HISTORICAL_ROOT;
+        if (!isValidEraStateSlot(slot, this.state.eraNumber)) {
+            throw new Error(`State slot must be ${expectedSlot} for era ${this.eraNumber}, got ${slot}`);
+        }
+        for (let s = this.state.lastSlot + 1; s < slot; s++) {
+            this.state.blockOffsets.push(0); // Empty slot
+        }
+        const stateOffset = this.state.currentOffset;
+        await writeEntry(this.fh, this.state.currentOffset, EntryType.CompressedBeaconState, data);
+        this.state.currentOffset += E2STORE_HEADER_SIZE + data.length;
+        if (this.state.eraNumber !== 0) {
+            const blocksIndex = {
+                type: EntryType.SlotIndex,
+                startSlot: computeStartBlockSlotFromEraNumber(this.state.eraNumber),
+                offsets: this.state.blockOffsets.map((o) => o - this.state.currentOffset),
+                recordStart: this.state.currentOffset,
+            };
+            const blocksIndexPayload = serializeSlotIndex(blocksIndex);
+            await writeEntry(this.fh, this.state.currentOffset, EntryType.SlotIndex, blocksIndexPayload);
+            this.state.currentOffset += E2STORE_HEADER_SIZE + blocksIndexPayload.length;
+        }
+        const stateIndex = {
+            type: EntryType.SlotIndex,
+            startSlot: slot,
+            offsets: [stateOffset - this.state.currentOffset],
+            recordStart: this.state.currentOffset,
+        };
+        const stateIndexPayload = serializeSlotIndex(stateIndex);
+        await writeEntry(this.fh, this.state.currentOffset, EntryType.SlotIndex, stateIndexPayload);
+        this.state.currentOffset += E2STORE_HEADER_SIZE + stateIndexPayload.length;
+        this.state = {
+            type: WriterStateType.FinishedGroup,
+            eraNumber: this.state.eraNumber,
+            currentOffset: this.state.currentOffset,
+            shortHistoricalRoot,
+        };
+    }
+    async writeSerializedState(slot, shortHistoricalRoot, data) {
+        const compressed = await snappyCompress(data);
+        await this.writeCompressedState(slot, shortHistoricalRoot, compressed);
+    }
+    async writeState(state) {
+        const slot = state.slot;
+        const shortHistoricalRoot = getShortHistoricalRoot(this.config, state);
+        const ssz = this.config.getForkTypes(slot).BeaconState.serialize(state);
+        await this.writeSerializedState(slot, shortHistoricalRoot, ssz);
+    }
+    async writeCompressedBlock(slot, data) {
+        if (this.state.type === WriterStateType.InitGroup) {
+            await this.writeVersion();
+        }
+        if (this.state.type !== WriterStateType.WriteGroup) {
+            throw new Error("Cannot write blocks after writing canonical state");
+        }
+        if (this.eraNumber === 0) {
+            throw new Error("Genesis era (era 0) does not contain blocks");
+        }
+        const blockEra = this.state.eraNumber;
+        if (!isSlotInRange(slot, blockEra)) {
+            throw new Error(`Slot ${slot} is not in valid block range for era ${blockEra}`);
+        }
+        if (slot <= this.state.lastSlot) {
+            throw new Error(`Slots must be written in ascending order. Last slot: ${this.state.lastSlot}, got: ${slot}`);
+        }
+        for (let s = this.state.lastSlot + 1; s < slot; s++) {
+            this.state.blockOffsets.push(0); // Empty slot
+        }
+        await writeEntry(this.fh, this.state.currentOffset, EntryType.CompressedSignedBeaconBlock, data);
+        this.state.blockOffsets.push(this.state.currentOffset);
+        this.state.currentOffset += E2STORE_HEADER_SIZE + data.length;
+        this.state.lastSlot = slot;
+    }
+    async writeSerializedBlock(slot, data) {
+        const compressed = await snappyCompress(data);
+        await this.writeCompressedBlock(slot, compressed);
+    }
+    async writeBlock(block) {
+        const slot = block.message.slot;
+        const types = this.config.getForkTypes(slot);
+        const ssz = types.SignedBeaconBlock.serialize(block);
+        await this.writeSerializedBlock(slot, ssz);
+    }
+}
+//# sourceMappingURL=writer.js.map

package/lib/era/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/era/writer.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * as e2s from "./e2s.js";
+export * as era from "./era/index.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/lib/index.js

@@ -0,0 +1,3 @@
+export * as e2s from "./e2s.js";
+export * as era from "./era/index.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/lib/util.d.ts

@@ -0,0 +1,19 @@
+/** Read 48-bit signed integer (little-endian) at offset. */
+export declare function readInt48(bytes: Uint8Array, offset: number): number;
+/** Read 48-bit unsigned integer (little-endian) at offset. */
+export declare function readUint48(bytes: Uint8Array, offset: number): number;
+/** Read 16-bit unsigned integer (little-endian) at offset. */
+export declare function readUint16(bytes: Uint8Array, offset: number): number;
+/** Read 32-bit unsigned integer (little-endian) at offset. */
+export declare function readUint32(bytes: Uint8Array, offset: number): number;
+/** Write 48-bit signed integer (little-endian) into target at offset. */
+export declare function writeInt48(target: Uint8Array, offset: number, v: number): void;
+/** Write 16-bit unsigned integer (little-endian) into target at offset. */
+export declare function writeUint16(target: Uint8Array, offset: number, v: number): void;
+/** Write 32-bit unsigned integer (little-endian) into target at offset. */
+export declare function writeUint32(target: Uint8Array, offset: number, v: number): void;
+/** Decompress snappy-framed data  */
+export declare function snappyUncompress(compressedData: Uint8Array): Uint8Array;
+/** Compress data using snappy framing */
+export declare function snappyCompress(data: Uint8Array): Promise<Uint8Array>;
+//# sourceMappingURL=util.d.ts.map

package/lib/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAGA,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAE9E;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAE/E;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAE/E;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,UAAU,GAAG,UAAU,CAWvE;AAED,yCAAyC;AACzC,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAM1E"}

package/lib/util.js

@@ -0,0 +1,49 @@
+import { Uint8ArrayList } from "uint8arraylist";
+import { SnappyFramesUncompress, encodeSnappy } from "@lodestar/reqresp/utils";
+/** Read 48-bit signed integer (little-endian) at offset. */
+export function readInt48(bytes, offset) {
+    return Buffer.prototype.readIntLE.call(bytes, offset, 6);
+}
+/** Read 48-bit unsigned integer (little-endian) at offset. */
+export function readUint48(bytes, offset) {
+    return Buffer.prototype.readUintLE.call(bytes, offset, 6);
+}
+/** Read 16-bit unsigned integer (little-endian) at offset. */
+export function readUint16(bytes, offset) {
+    return Buffer.prototype.readUint16LE.call(bytes, offset);
+}
+/** Read 32-bit unsigned integer (little-endian) at offset. */
+export function readUint32(bytes, offset) {
+    return Buffer.prototype.readUint32LE.call(bytes, offset);
+}
+/** Write 48-bit signed integer (little-endian) into target at offset. */
+export function writeInt48(target, offset, v) {
+    Buffer.prototype.writeIntLE.call(target, v, offset, 6);
+}
+/** Write 16-bit unsigned integer (little-endian) into target at offset. */
+export function writeUint16(target, offset, v) {
+    Buffer.prototype.writeUint16LE.call(target, v, offset);
+}
+/** Write 32-bit unsigned integer (little-endian) into target at offset. */
+export function writeUint32(target, offset, v) {
+    Buffer.prototype.writeUint32LE.call(target, v, offset);
+}
+/** Decompress snappy-framed data  */
+export function snappyUncompress(compressedData) {
+    const decompressor = new SnappyFramesUncompress();
+    const input = new Uint8ArrayList(compressedData);
+    const result = decompressor.uncompress(input);
+    if (result === null) {
+        throw new Error("Snappy decompression failed - no data returned");
+    }
+    return result.subarray();
+}
+/** Compress data using snappy framing */
+export async function snappyCompress(data) {
+    const buffers = [];
+    for await (const chunk of encodeSnappy(Buffer.from(data.buffer, data.byteOffset, data.byteLength))) {
+        buffers.push(chunk);
+    }
+    return Buffer.concat(buffers);
+}
+//# sourceMappingURL=util.js.map