@brightchain/brightchain-lib 0.29.8 → 0.29.17

package/src/lib/ledger/ledger.js

@@ -0,0 +1,383 @@
+"use strict";
+/**
+ * @fileoverview Ledger — append-only blockchain ledger persisted as
+ * RawDataBlock instances within any IBlockStore implementation.
+ *
+ * Each entry is serialized, padded to BlockSize, and stored as a RawDataBlock.
+ * A metadata block tracks the chain head, length, ledger ID, and the full
+ * sequenceNumber → blockChecksum index for cold-start reconstruction.
+ *
+ * The metadata block is stored at a deterministic Checksum derived from the
+ * ledgerId so that `Ledger.load()` can locate it without external state.
+ * Because the metadata content changes on each append while the storage key
+ * stays fixed, the metadata block uses a validation-exempt RawDataBlock
+ * subclass that allows a caller-specified checksum to differ from the
+ * content hash.
+ *
+ * @see Design: Block Chain Ledger — Ledger
+ * @see Requirements 5.1–5.6, 6.1–6.6, 7.1–7.5, 10.1–10.4, 11.2–11.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ledger = void 0;
+const rawData_1 = require("../blocks/rawData");
+const blockDataType_1 = require("../enumerations/blockDataType");
+const blockType_1 = require("../enumerations/blockType");
+const ledgerError_1 = require("../errors/ledgerError");
+const checksum_service_1 = require("../services/checksum.service");
+const checksum_1 = require("../types/checksum");
+const xorUtils_1 = require("../utils/xorUtils");
+/** Magic bytes identifying a ledger metadata block: "LMET" in ASCII. */
+const METADATA_MAGIC = 0x4c4d4554;
+/** Current metadata format version. */
+const METADATA_VERSION = 0x0001;
+/** SHA3-512 hash length in bytes. */
+const HASH_LENGTH = 64;
+/**
+ * A RawDataBlock subclass that skips checksum validation.
+ *
+ * Used exclusively for the ledger metadata block, which is stored at a
+ * deterministic checksum (derived from the ledgerId) that intentionally
+ * differs from the SHA3-512 of its content. The MemoryBlockStore calls
+ * `block.validate()` during `setData()`; this subclass makes that a no-op
+ * so the block can be stored under the deterministic key.
+ *
+ * @internal
+ */
+class LedgerMetadataBlock extends rawData_1.RawDataBlock {
+    constructor(blockSize, data, checksum) {
+        super(blockSize, data, undefined, checksum, blockType_1.BlockType.RawData, blockDataType_1.BlockDataType.RawData, true, true);
+    }
+    validateSync() {
+        // No-op: metadata block uses a deterministic key, not a content hash.
+    }
+    async validateAsync() {
+        // No-op
+    }
+    validate() {
+        // No-op
+    }
+}
+/**
+ * Append-only blockchain ledger backed by an IBlockStore.
+ *
+ * Maintains an in-memory index (sequenceNumber → block Checksum) for O(1)
+ * lookups and persists a metadata block after each append for cold-start
+ * reconstruction via `Ledger.load()`.
+ */
+class Ledger {
+    store;
+    blockSize;
+    serializer;
+    ledgerId;
+    index = new Map();
+    checksumService = new checksum_service_1.ChecksumService();
+    _length = 0;
+    _head = null;
+    _headEntryHash = null;
+    constructor(store, blockSize, serializer, ledgerId) {
+        this.store = store;
+        this.blockSize = blockSize;
+        this.serializer = serializer;
+        this.ledgerId = ledgerId;
+    }
+    // ── Public getters ────────────────────────────────────────────────
+    /** Current chain length. */
+    get length() {
+        return this._length;
+    }
+    /** Head block Checksum (block storage key), or null if empty. */
+    get head() {
+        return this._head;
+    }
+    // ── Append ────────────────────────────────────────────────────────
+    /**
+     * Append a new entry to the ledger.
+     * Returns the Checksum of the stored block.
+     */
+    async append(payload, signer) {
+        const sequenceNumber = this._length;
+        const previousEntryHash = this._headEntryHash;
+        const timestamp = new Date();
+        // 1. Compute entryHash
+        const partial = {
+            sequenceNumber,
+            timestamp,
+            previousEntryHash,
+            signerPublicKey: signer.publicKey,
+            payload,
+        };
+        const entryHash = this.serializer.computeEntryHash(partial);
+        // 2. Sign the entryHash
+        const signature = signer.sign(entryHash.toUint8Array());
+        // 3. Build full entry
+        const entry = { ...partial, entryHash, signature };
+        // 4. Serialize and pad
+        const serialized = this.serializer.serialize(entry);
+        const padded = (0, xorUtils_1.padToBlockSize)(serialized, this.blockSize);
+        // 5. Create RawDataBlock and store
+        const block = new rawData_1.RawDataBlock(this.blockSize, padded, undefined, undefined, undefined, undefined, true, true, this.checksumService);
+        const blockChecksum = block.idChecksum;
+        // Req 5.5: On BlockStore failure, do not update chain head or index.
+        // If setData throws, we propagate the error before updating state.
+        await this.store.setData(block);
+        // 6. Update in-memory state (only after successful store)
+        this.index.set(sequenceNumber, blockChecksum);
+        this._length = sequenceNumber + 1;
+        this._head = blockChecksum;
+        this._headEntryHash = entryHash;
+        // 7. Persist metadata block
+        try {
+            await this.persistMetadata();
+        }
+        catch {
+            // Metadata persistence failure is non-fatal for the append itself;
+            // the entry is already stored.
+        }
+        return blockChecksum;
+    }
+    // ── Read operations ───────────────────────────────────────────────
+    /**
+     * Get entry by sequence number.
+     * @throws LedgerError if not found
+     */
+    async getEntry(sequenceNumber) {
+        const blockChecksum = this.index.get(sequenceNumber);
+        if (blockChecksum === undefined) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.EntryNotFound, `Entry with sequenceNumber ${sequenceNumber} not found`);
+        }
+        const block = await this.store.getData(blockChecksum);
+        const unpadded = (0, xorUtils_1.unpadCblData)(block.data);
+        return this.serializer.deserialize(unpadded);
+    }
+    /**
+     * Get entries in range [start, end] inclusive.
+     * @throws LedgerError for invalid range
+     */
+    async getEntries(start, end) {
+        if (start > end) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.InvalidRange, `Invalid range: start (${start}) > end (${end})`);
+        }
+        if (start < 0 || end >= this._length) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.InvalidRange, `Range [${start}, ${end}] out of bounds for ledger of length ${this._length}`);
+        }
+        const entries = [];
+        for (let i = start; i <= end; i++) {
+            entries.push(await this.getEntry(i));
+        }
+        return entries;
+    }
+    /**
+     * Get the most recent entry, or null if empty.
+     */
+    async getLatestEntry() {
+        if (this._length === 0) {
+            return null;
+        }
+        return this.getEntry(this._length - 1);
+    }
+    // ── Metadata persistence ──────────────────────────────────────────
+    /**
+     * Compute the deterministic storage key for this ledger's metadata block.
+     * The key is SHA3-512("ledger-meta:" + ledgerId).
+     */
+    computeMetadataKey() {
+        return this.checksumService.calculateChecksumForString(`ledger-meta:${this.ledgerId}`);
+    }
+    /**
+     * Serialize the current metadata into binary.
+     *
+     * Format:
+     *   magic           4 bytes  0x4C4D4554 ("LMET")
+     *   version         2 bytes  0x0001
+     *   ledgerIdLength  4 bytes  uint32 BE
+     *   ledgerId        var      UTF-8
+     *   length          4 bytes  uint32 BE
+     *   hasHead         1 byte   0x00 or 0x01
+     *   headChecksum    0|64     SHA3-512 bytes (block checksum of head)
+     *   index entries   var      seqNum (uint32 BE) + blockChecksum (64 bytes)
+     */
+    serializeMetadata() {
+        const encoder = new TextEncoder();
+        const ledgerIdBytes = encoder.encode(this.ledgerId);
+        const headBytes = this._head ? this._head.toUint8Array() : null;
+        const indexEntrySize = 4 + HASH_LENGTH;
+        const indexSize = this._length * indexEntrySize;
+        const size = 4 +
+            2 +
+            4 +
+            ledgerIdBytes.length +
+            4 +
+            1 +
+            (headBytes ? HASH_LENGTH : 0) +
+            indexSize;
+        const buf = new Uint8Array(size);
+        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+        let offset = 0;
+        view.setUint32(offset, METADATA_MAGIC, false);
+        offset += 4;
+        view.setUint16(offset, METADATA_VERSION, false);
+        offset += 2;
+        view.setUint32(offset, ledgerIdBytes.length, false);
+        offset += 4;
+        buf.set(ledgerIdBytes, offset);
+        offset += ledgerIdBytes.length;
+        view.setUint32(offset, this._length, false);
+        offset += 4;
+        if (headBytes) {
+            buf[offset] = 0x01;
+            offset += 1;
+            buf.set(headBytes, offset);
+            offset += HASH_LENGTH;
+        }
+        else {
+            buf[offset] = 0x00;
+            offset += 1;
+        }
+        for (let i = 0; i < this._length; i++) {
+            const checksum = this.index.get(i);
+            if (checksum) {
+                view.setUint32(offset, i, false);
+                offset += 4;
+                buf.set(checksum.toUint8Array(), offset);
+                offset += HASH_LENGTH;
+            }
+        }
+        return buf;
+    }
+    /**
+     * Persist the metadata block to the store under a deterministic key.
+     *
+     * Uses a LedgerMetadataBlock (validation-exempt RawDataBlock subclass)
+     * so the block can be stored at the deterministic checksum derived from
+     * the ledgerId, even though the content hash differs.
+     */
+    async persistMetadata() {
+        const metadataBytes = this.serializeMetadata();
+        const padded = (0, xorUtils_1.padToBlockSize)(metadataBytes, this.blockSize);
+        const metadataKey = this.computeMetadataKey();
+        // Delete old metadata block first (same key, different content)
+        try {
+            await this.store.deleteData(metadataKey);
+        }
+        catch {
+            // May not exist yet — that's fine
+        }
+        const block = new LedgerMetadataBlock(this.blockSize, padded, metadataKey);
+        await this.store.setData(block);
+    }
+    // ── Static load ───────────────────────────────────────────────────
+    /**
+     * Load ledger state from the block store.
+     *
+     * 1. Compute metadata block key from ledgerId
+     * 2. Try to retrieve metadata block from store
+     * 3. If not found, return empty ledger
+     * 4. Parse metadata to get head checksum, length, and index
+     * 5. Restore headEntryHash by reading the head entry
+     * 6. Return populated ledger
+     */
+    static async load(store, blockSize, serializer, ledgerId) {
+        const ledger = new Ledger(store, blockSize, serializer, ledgerId);
+        const metadataKey = ledger.computeMetadataKey();
+        const hasMetadata = await store.has(metadataKey);
+        if (!hasMetadata) {
+            return ledger; // Empty ledger (Req 7.5)
+        }
+        let metadataBlock;
+        try {
+            metadataBlock = await store.getData(metadataKey);
+        }
+        catch {
+            return ledger; // Treat as empty if unreadable
+        }
+        const metadataBytes = (0, xorUtils_1.unpadCblData)(metadataBlock.data);
+        const parsed = Ledger.parseMetadata(metadataBytes);
+        if (parsed.length === 0 || parsed.headChecksum === null) {
+            return ledger;
+        }
+        // Populate ledger state
+        ledger._length = parsed.length;
+        ledger._head = parsed.headChecksum;
+        for (const [seqNum, blockChecksum] of parsed.index) {
+            ledger.index.set(seqNum, blockChecksum);
+        }
+        // Restore headEntryHash by reading the head entry
+        try {
+            const headBlock = await store.getData(parsed.headChecksum);
+            const unpadded = (0, xorUtils_1.unpadCblData)(headBlock.data);
+            const headEntry = serializer.deserialize(unpadded);
+            ledger._headEntryHash = headEntry.entryHash;
+        }
+        catch {
+            // Degraded state — reads still work via index
+        }
+        return ledger;
+    }
+    /**
+     * Parse a metadata block's binary content.
+     */
+    static parseMetadata(data) {
+        if (data.length < 11) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, 'Metadata block too short');
+        }
+        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        let offset = 0;
+        // magic
+        const magic = view.getUint32(offset, false);
+        offset += 4;
+        if (magic !== METADATA_MAGIC) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, `Invalid metadata magic: expected 0x${METADATA_MAGIC.toString(16)}, got 0x${magic.toString(16)}`);
+        }
+        // version
+        const version = view.getUint16(offset, false);
+        offset += 2;
+        if (version !== METADATA_VERSION) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, `Unsupported metadata version: ${version}`);
+        }
+        // ledgerIdLength + ledgerId
+        if (offset + 4 > data.length) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, 'Metadata ledgerIdLength overflows');
+        }
+        const ledgerIdLength = view.getUint32(offset, false);
+        offset += 4;
+        if (offset + ledgerIdLength > data.length) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, 'Metadata ledgerId overflows');
+        }
+        const decoder = new TextDecoder();
+        const ledgerId = decoder.decode(data.slice(offset, offset + ledgerIdLength));
+        offset += ledgerIdLength;
+        // length
+        if (offset + 4 > data.length) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, 'Metadata length field overflows');
+        }
+        const length = view.getUint32(offset, false);
+        offset += 4;
+        // hasHead
+        if (offset + 1 > data.length) {
+            throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, 'Metadata hasHead field overflows');
+        }
+        const hasHead = data[offset];
+        offset += 1;
+        let headChecksum = null;
+        if (hasHead === 0x01) {
+            if (offset + HASH_LENGTH > data.length) {
+                throw new ledgerError_1.LedgerError(ledgerError_1.LedgerErrorType.MetadataCorrupted, 'Metadata headChecksum overflows');
+            }
+            headChecksum = checksum_1.Checksum.fromUint8Array(data.slice(offset, offset + HASH_LENGTH));
+            offset += HASH_LENGTH;
+        }
+        // Parse index entries: each is seqNum (4) + checksum (64) = 68 bytes
+        const index = new Map();
+        const indexEntrySize = 4 + HASH_LENGTH;
+        while (offset + indexEntrySize <= data.length) {
+            const seqNum = view.getUint32(offset, false);
+            offset += 4;
+            const blockChecksum = checksum_1.Checksum.fromUint8Array(data.slice(offset, offset + HASH_LENGTH));
+            offset += HASH_LENGTH;
+            index.set(seqNum, blockChecksum);
+        }
+        return { ledgerId, length, headChecksum, index };
+    }
+}
+exports.Ledger = Ledger;
+//# sourceMappingURL=ledger.js.map

package/src/lib/ledger/ledger.js.map

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

package/src/lib/ledger/ledgerChainValidator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview LedgerChainValidator — validates chain integrity by walking
+ * entries and checking hashes, signatures, and sequence links.
+ *
+ * Validation does not throw — it returns an IValidationResult with error
+ * descriptors. All errors are collected (validation does not stop at the
+ * first error).
+ *
+ * @see Design: Block Chain Ledger — LedgerChainValidator
+ * @see Requirements 3.2, 3.3, 4.3–4.6, 8.1–8.4
+ */
+import { ILedgerEntry } from '../interfaces/ledger/ledgerEntry';
+import { ILedgerSignatureVerifier } from '../interfaces/ledger/ledgerSignatureVerifier';
+import { IValidationResult } from '../interfaces/ledger/validationResult';
+import { LedgerEntrySerializer } from './ledgerEntrySerializer';
+/**
+ * Validates ledger chain integrity by walking entries and verifying:
+ * - Contiguous sequence numbers
+ * - Genesis entry correctness
+ * - Hash-chain links (previousEntryHash)
+ * - EntryHash recomputation
+ * - Signature verification
+ */
+export declare class LedgerChainValidator {
+    private readonly serializer;
+    private readonly signatureVerifier;
+    constructor(serializer: LedgerEntrySerializer, signatureVerifier: ILedgerSignatureVerifier);
+    /**
+     * Validate the entire chain from genesis to head.
+     *
+     * Expects entries ordered by sequenceNumber starting from 0.
+     * Returns { isValid: true, entriesChecked: 0, errors: [] } for an empty chain.
+     */
+    validateAll(entries: ILedgerEntry[]): IValidationResult;
+    /**
+     * Validate a sub-range of entries, including the link to the predecessor.
+     *
+     * @param entries - The sub-range of entries to validate (ordered by sequenceNumber).
+     * @param predecessor - The entry immediately before the sub-range, or null if
+     *   the sub-range starts at genesis.
+     */
+    validateRange(entries: ILedgerEntry[], predecessor: ILedgerEntry | null): IValidationResult;
+    /**
+     * Recompute the entryHash for the given entry and compare it to the
+     * stored entryHash. Pushes an error if they don't match.
+     */
+    private verifyEntryHash;
+    /**
+     * Verify the entry's signature against its signerPublicKey and entryHash.
+     * Pushes an error if verification fails.
+     */
+    private verifySignature;
+}
+//# sourceMappingURL=ledgerChainValidator.d.ts.map

package/src/lib/ledger/ledgerChainValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledgerChainValidator.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/ledger/ledgerChainValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,EAEL,iBAAiB,EAClB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBADjB,UAAU,EAAE,qBAAqB,EACjC,iBAAiB,EAAE,wBAAwB;IAG9D;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,iBAAiB;IA2DvD;;;;;;OAMG;IACH,aAAa,CACX,OAAO,EAAE,YAAY,EAAE,EACvB,WAAW,EAAE,YAAY,GAAG,IAAI,GAC/B,iBAAiB;IA4EpB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAcvB;;;OAGG;IACH,OAAO,CAAC,eAAe;CAkBxB"}

package/src/lib/ledger/ledgerChainValidator.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * @fileoverview LedgerChainValidator — validates chain integrity by walking
+ * entries and checking hashes, signatures, and sequence links.
+ *
+ * Validation does not throw — it returns an IValidationResult with error
+ * descriptors. All errors are collected (validation does not stop at the
+ * first error).
+ *
+ * @see Design: Block Chain Ledger — LedgerChainValidator
+ * @see Requirements 3.2, 3.3, 4.3–4.6, 8.1–8.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerChainValidator = void 0;
+/**
+ * Validates ledger chain integrity by walking entries and verifying:
+ * - Contiguous sequence numbers
+ * - Genesis entry correctness
+ * - Hash-chain links (previousEntryHash)
+ * - EntryHash recomputation
+ * - Signature verification
+ */
+class LedgerChainValidator {
+    serializer;
+    signatureVerifier;
+    constructor(serializer, signatureVerifier) {
+        this.serializer = serializer;
+        this.signatureVerifier = signatureVerifier;
+    }
+    /**
+     * Validate the entire chain from genesis to head.
+     *
+     * Expects entries ordered by sequenceNumber starting from 0.
+     * Returns { isValid: true, entriesChecked: 0, errors: [] } for an empty chain.
+     */
+    validateAll(entries) {
+        if (entries.length === 0) {
+            return { isValid: true, entriesChecked: 0, errors: [] };
+        }
+        const errors = [];
+        for (let i = 0; i < entries.length; i++) {
+            const entry = entries[i];
+            const expectedSeq = i;
+            // Verify contiguous sequence numbers starting from 0
+            if (entry.sequenceNumber !== expectedSeq) {
+                errors.push({
+                    sequenceNumber: entry.sequenceNumber,
+                    errorType: 'sequence_gap',
+                    message: `Expected sequenceNumber ${expectedSeq}, got ${entry.sequenceNumber}`,
+                });
+            }
+            if (i === 0) {
+                // Genesis entry: previousEntryHash must be null
+                if (entry.previousEntryHash !== null) {
+                    errors.push({
+                        sequenceNumber: entry.sequenceNumber,
+                        errorType: 'genesis_invalid',
+                        message: 'Genesis entry (sequenceNumber 0) must have null previousEntryHash',
+                    });
+                }
+            }
+            else {
+                // Non-genesis: previousEntryHash must equal preceding entry's entryHash
+                const prev = entries[i - 1];
+                if (entry.previousEntryHash === null ||
+                    !entry.previousEntryHash.equals(prev.entryHash)) {
+                    errors.push({
+                        sequenceNumber: entry.sequenceNumber,
+                        errorType: 'previous_hash_mismatch',
+                        message: `previousEntryHash does not match preceding entry's entryHash at sequenceNumber ${entry.sequenceNumber}`,
+                    });
+                }
+            }
+            // Recompute entryHash and verify
+            this.verifyEntryHash(entry, errors);
+            // Verify signature
+            this.verifySignature(entry, errors);
+        }
+        return {
+            isValid: errors.length === 0,
+            entriesChecked: entries.length,
+            errors,
+        };
+    }
+    /**
+     * Validate a sub-range of entries, including the link to the predecessor.
+     *
+     * @param entries - The sub-range of entries to validate (ordered by sequenceNumber).
+     * @param predecessor - The entry immediately before the sub-range, or null if
+     *   the sub-range starts at genesis.
+     */
+    validateRange(entries, predecessor) {
+        if (entries.length === 0) {
+            return { isValid: true, entriesChecked: 0, errors: [] };
+        }
+        const errors = [];
+        const startSeq = predecessor !== null ? predecessor.sequenceNumber + 1 : 0;
+        for (let i = 0; i < entries.length; i++) {
+            const entry = entries[i];
+            const expectedSeq = startSeq + i;
+            // Verify contiguous sequence numbers
+            if (entry.sequenceNumber !== expectedSeq) {
+                errors.push({
+                    sequenceNumber: entry.sequenceNumber,
+                    errorType: 'sequence_gap',
+                    message: `Expected sequenceNumber ${expectedSeq}, got ${entry.sequenceNumber}`,
+                });
+            }
+            if (i === 0) {
+                if (predecessor !== null) {
+                    // First entry in range must link to predecessor
+                    if (entry.previousEntryHash === null ||
+                        !entry.previousEntryHash.equals(predecessor.entryHash)) {
+                        errors.push({
+                            sequenceNumber: entry.sequenceNumber,
+                            errorType: 'previous_hash_mismatch',
+                            message: `previousEntryHash does not match predecessor's entryHash at sequenceNumber ${entry.sequenceNumber}`,
+                        });
+                    }
+                }
+                else {
+                    // No predecessor means this should be genesis
+                    if (entry.previousEntryHash !== null) {
+                        errors.push({
+                            sequenceNumber: entry.sequenceNumber,
+                            errorType: 'genesis_invalid',
+                            message: 'Genesis entry (sequenceNumber 0) must have null previousEntryHash',
+                        });
+                    }
+                }
+            }
+            else {
+                // Subsequent entries link to the previous entry in the range
+                const prev = entries[i - 1];
+                if (entry.previousEntryHash === null ||
+                    !entry.previousEntryHash.equals(prev.entryHash)) {
+                    errors.push({
+                        sequenceNumber: entry.sequenceNumber,
+                        errorType: 'previous_hash_mismatch',
+                        message: `previousEntryHash does not match preceding entry's entryHash at sequenceNumber ${entry.sequenceNumber}`,
+                    });
+                }
+            }
+            // Recompute entryHash and verify
+            this.verifyEntryHash(entry, errors);
+            // Verify signature
+            this.verifySignature(entry, errors);
+        }
+        return {
+            isValid: errors.length === 0,
+            entriesChecked: entries.length,
+            errors,
+        };
+    }
+    // ── private helpers ──────────────────────────────────────────────────
+    /**
+     * Recompute the entryHash for the given entry and compare it to the
+     * stored entryHash. Pushes an error if they don't match.
+     */
+    verifyEntryHash(entry, errors) {
+        const recomputed = this.serializer.computeEntryHash(entry);
+        if (!recomputed.equals(entry.entryHash)) {
+            errors.push({
+                sequenceNumber: entry.sequenceNumber,
+                errorType: 'hash_mismatch',
+                message: `Recomputed entryHash does not match stored entryHash at sequenceNumber ${entry.sequenceNumber}`,
+            });
+        }
+    }
+    /**
+     * Verify the entry's signature against its signerPublicKey and entryHash.
+     * Pushes an error if verification fails.
+     */
+    verifySignature(entry, errors) {
+        const entryHashBytes = entry.entryHash.toUint8Array();
+        const isValid = this.signatureVerifier.verify(entry.signerPublicKey, entryHashBytes, entry.signature);
+        if (!isValid) {
+            errors.push({
+                sequenceNumber: entry.sequenceNumber,
+                errorType: 'signature_invalid',
+                message: `Signature verification failed at sequenceNumber ${entry.sequenceNumber}`,
+            });
+        }
+    }
+}
+exports.LedgerChainValidator = LedgerChainValidator;
+//# sourceMappingURL=ledgerChainValidator.js.map

package/src/lib/ledger/ledgerChainValidator.js.map

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