@brightchain/brightchain-api-lib 0.0.1

package/src/lib/availability/blockRegistry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Block Registry Implementation
+ *
+ * Provides a fast local index of blocks stored on the node.
+ * Supports O(1) lookups, Bloom filter export, and manifest generation.
+ *
+ * @see Requirements 3.1, 3.2, 3.3, 3.4, 3.5, 4.1, 4.7
+ */
+import { BlockManifest, BloomFilter, IBlockRegistry } from '@brightchain/brightchain-lib';
+/**
+ * Default configuration for the Bloom filter.
+ */
+export interface BloomFilterConfig {
+    /**
+     * Target false positive rate (default: 0.01 = 1%)
+     */
+    falsePositiveRate: number;
+    /**
+     * Expected number of items (used for initial sizing)
+     */
+    expectedItems: number;
+}
+/**
+ * Default Bloom filter configuration.
+ */
+export declare const DEFAULT_BLOOM_FILTER_CONFIG: BloomFilterConfig;
+/**
+ * Block Registry Implementation
+ *
+ * Maintains a fast in-memory Set-based index of all locally stored block IDs.
+ * Provides O(1) lookups, Bloom filter export for efficient network queries,
+ * and manifest export for full synchronization.
+ *
+ * @see Requirements 3.1, 3.2, 3.3, 3.4, 3.5, 4.1, 4.7
+ */
+export declare class BlockRegistry implements IBlockRegistry {
+    /**
+     * In-memory Set of local block IDs for O(1) lookups.
+     */
+    private readonly localBlocks;
+    /**
+     * Cached Bloom filter (regenerated when blocks change).
+     */
+    private cachedBloomFilter;
+    /**
+     * Flag indicating if the Bloom filter needs regeneration.
+     */
+    private bloomFilterDirty;
+    /**
+     * Node ID for manifest generation.
+     */
+    private readonly nodeId;
+    /**
+     * Store path for rebuilding from disk.
+     */
+    private readonly storePath;
+    /**
+     * Block size string for directory structure.
+     */
+    private readonly blockSizeString;
+    /**
+     * Bloom filter configuration.
+     */
+    private readonly bloomConfig;
+    /**
+     * Create a new BlockRegistry.
+     *
+     * @param nodeId - The unique identifier of the local node
+     * @param storePath - The base path for block storage
+     * @param blockSizeString - The block size string (e.g., 'small', 'medium')
+     * @param bloomConfig - Optional Bloom filter configuration
+     */
+    constructor(nodeId: string, storePath: string, blockSizeString: string, bloomConfig?: BloomFilterConfig);
+    /**
+     * Check if a block exists locally (O(1) lookup).
+     *
+     * @param blockId - The block ID to check
+     * @returns true if the block exists locally
+     */
+    hasLocal(blockId: string): boolean;
+    /**
+     * Add a block to the local registry.
+     *
+     * @param blockId - The block ID to add
+     */
+    addLocal(blockId: string): void;
+    /**
+     * Remove a block from the local registry.
+     *
+     * @param blockId - The block ID to remove
+     */
+    removeLocal(blockId: string): void;
+    /**
+     * Get count of local blocks.
+     *
+     * @returns The number of blocks in the local registry
+     */
+    getLocalCount(): number;
+    /**
+     * Get all local block IDs (for full sync).
+     *
+     * @returns Array of all block IDs in the local registry
+     */
+    getLocalBlockIds(): string[];
+    /**
+     * Export a Bloom filter representation of the registry.
+     *
+     * @returns A Bloom filter representing all local block IDs
+     */
+    exportBloomFilter(): BloomFilter;
+    /**
+     * Regenerate the Bloom filter from the current block set.
+     */
+    private regenerateBloomFilter;
+    /**
+     * Export a complete manifest of all local blocks.
+     *
+     * @returns A manifest containing all local block IDs
+     */
+    exportManifest(): BlockManifest;
+    /**
+     * Compute a checksum for the manifest.
+     * The checksum changes if and only if the block set changes.
+     *
+     * @param blockIds - Sorted array of block IDs
+     * @returns SHA-256 checksum of the block IDs
+     */
+    private computeManifestChecksum;
+    /**
+     * Rebuild the registry from disk storage.
+     * Scans the block storage directory to find all stored blocks.
+     *
+     * @returns Promise that resolves when rebuild is complete
+     */
+    rebuild(): Promise<void>;
+    /**
+     * Clear the registry (for testing purposes).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=blockRegistry.d.ts.map

package/src/lib/availability/blockRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockRegistry.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/availability/blockRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACf,MAAM,8BAA8B,CAAC;AAOtC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAGzC,CAAC;AAgDF;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IAEtD;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAmC;IAE5D;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAAQ;IAEhC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAEhD;;;;;;;OAOG;gBAED,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,WAAW,GAAE,iBAA+C;IAQ9D;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO/B;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlC;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;OAIG;IACH,iBAAiB,IAAI,WAAW;IAOhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;OAIG;IACH,cAAc,IAAI,aAAa;IAY/B;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/src/lib/availability/blockRegistry.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * @fileoverview Block Registry Implementation
+ *
+ * Provides a fast local index of blocks stored on the node.
+ * Supports O(1) lookups, Bloom filter export, and manifest generation.
+ *
+ * @see Requirements 3.1, 3.2, 3.3, 3.4, 3.5, 4.1, 4.7
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockRegistry = exports.DEFAULT_BLOOM_FILTER_CONFIG = void 0;
+const bloom_filters_1 = require("bloom-filters");
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+/**
+ * Default Bloom filter configuration.
+ */
+exports.DEFAULT_BLOOM_FILTER_CONFIG = {
+    falsePositiveRate: 0.01,
+    expectedItems: 10000,
+};
+/**
+ * Wrapper class that implements the BloomFilter interface.
+ * Wraps the bloom-filters library implementation.
+ */
+class BloomFilterWrapper {
+    constructor(filter, itemCount) {
+        this.filter = filter;
+        this.hashCount = filter['_nbHashes'];
+        this.bitCount = filter.size;
+        this.itemCount = itemCount;
+        // Serialize the filter data to base64
+        this.data = this.serializeFilter();
+    }
+    /**
+     * Serialize the Bloom filter to a base64 string.
+     */
+    serializeFilter() {
+        // Export the filter to JSON and encode as base64
+        const exported = this.filter.saveAsJSON();
+        return Buffer.from(JSON.stringify(exported)).toString('base64');
+    }
+    /**
+     * Check if an item might exist in the filter.
+     */
+    mightContain(blockId) {
+        return this.filter.has(blockId);
+    }
+    /**
+     * Create a BloomFilterWrapper from serialized data.
+     */
+    static fromSerialized(data) {
+        const json = JSON.parse(Buffer.from(data, 'base64').toString('utf-8'));
+        const filter = bloom_filters_1.BloomFilter.fromJSON(json);
+        return new BloomFilterWrapper(filter, json._itemCount || 0);
+    }
+}
+/**
+ * Block Registry Implementation
+ *
+ * Maintains a fast in-memory Set-based index of all locally stored block IDs.
+ * Provides O(1) lookups, Bloom filter export for efficient network queries,
+ * and manifest export for full synchronization.
+ *
+ * @see Requirements 3.1, 3.2, 3.3, 3.4, 3.5, 4.1, 4.7
+ */
+class BlockRegistry {
+    /**
+     * Create a new BlockRegistry.
+     *
+     * @param nodeId - The unique identifier of the local node
+     * @param storePath - The base path for block storage
+     * @param blockSizeString - The block size string (e.g., 'small', 'medium')
+     * @param bloomConfig - Optional Bloom filter configuration
+     */
+    constructor(nodeId, storePath, blockSizeString, bloomConfig = exports.DEFAULT_BLOOM_FILTER_CONFIG) {
+        /**
+         * In-memory Set of local block IDs for O(1) lookups.
+         */
+        this.localBlocks = new Set();
+        /**
+         * Cached Bloom filter (regenerated when blocks change).
+         */
+        this.cachedBloomFilter = null;
+        /**
+         * Flag indicating if the Bloom filter needs regeneration.
+         */
+        this.bloomFilterDirty = true;
+        this.nodeId = nodeId;
+        this.storePath = storePath;
+        this.blockSizeString = blockSizeString;
+        this.bloomConfig = bloomConfig;
+    }
+    /**
+     * Check if a block exists locally (O(1) lookup).
+     *
+     * @param blockId - The block ID to check
+     * @returns true if the block exists locally
+     */
+    hasLocal(blockId) {
+        return this.localBlocks.has(blockId);
+    }
+    /**
+     * Add a block to the local registry.
+     *
+     * @param blockId - The block ID to add
+     */
+    addLocal(blockId) {
+        if (!this.localBlocks.has(blockId)) {
+            this.localBlocks.add(blockId);
+            this.bloomFilterDirty = true;
+        }
+    }
+    /**
+     * Remove a block from the local registry.
+     *
+     * @param blockId - The block ID to remove
+     */
+    removeLocal(blockId) {
+        if (this.localBlocks.has(blockId)) {
+            this.localBlocks.delete(blockId);
+            this.bloomFilterDirty = true;
+        }
+    }
+    /**
+     * Get count of local blocks.
+     *
+     * @returns The number of blocks in the local registry
+     */
+    getLocalCount() {
+        return this.localBlocks.size;
+    }
+    /**
+     * Get all local block IDs (for full sync).
+     *
+     * @returns Array of all block IDs in the local registry
+     */
+    getLocalBlockIds() {
+        return Array.from(this.localBlocks);
+    }
+    /**
+     * Export a Bloom filter representation of the registry.
+     *
+     * @returns A Bloom filter representing all local block IDs
+     */
+    exportBloomFilter() {
+        if (this.bloomFilterDirty || !this.cachedBloomFilter) {
+            this.regenerateBloomFilter();
+        }
+        return this.cachedBloomFilter;
+    }
+    /**
+     * Regenerate the Bloom filter from the current block set.
+     */
+    regenerateBloomFilter() {
+        const itemCount = Math.max(this.localBlocks.size, this.bloomConfig.expectedItems);
+        const filter = bloom_filters_1.BloomFilter.create(itemCount, this.bloomConfig.falsePositiveRate);
+        for (const blockId of this.localBlocks) {
+            filter.add(blockId);
+        }
+        this.cachedBloomFilter = new BloomFilterWrapper(filter, this.localBlocks.size);
+        this.bloomFilterDirty = false;
+    }
+    /**
+     * Export a complete manifest of all local blocks.
+     *
+     * @returns A manifest containing all local block IDs
+     */
+    exportManifest() {
+        const blockIds = this.getLocalBlockIds().sort();
+        const checksum = this.computeManifestChecksum(blockIds);
+        return {
+            nodeId: this.nodeId,
+            blockIds,
+            generatedAt: new Date(),
+            checksum,
+        };
+    }
+    /**
+     * Compute a checksum for the manifest.
+     * The checksum changes if and only if the block set changes.
+     *
+     * @param blockIds - Sorted array of block IDs
+     * @returns SHA-256 checksum of the block IDs
+     */
+    computeManifestChecksum(blockIds) {
+        const hash = (0, crypto_1.createHash)('sha256');
+        // Include the count to detect additions/removals
+        hash.update(blockIds.length.toString());
+        // Hash all block IDs in sorted order
+        for (const blockId of blockIds) {
+            hash.update(blockId);
+        }
+        return hash.digest('hex');
+    }
+    /**
+     * Rebuild the registry from disk storage.
+     * Scans the block storage directory to find all stored blocks.
+     *
+     * @returns Promise that resolves when rebuild is complete
+     */
+    async rebuild() {
+        // Clear existing registry
+        this.localBlocks.clear();
+        this.bloomFilterDirty = true;
+        const basePath = (0, path_1.join)(this.storePath, this.blockSizeString);
+        if (!(0, fs_1.existsSync)(basePath)) {
+            return;
+        }
+        try {
+            // Scan first level directories (first character of checksum)
+            const firstLevelDirs = await (0, promises_1.readdir)(basePath);
+            for (const firstDir of firstLevelDirs) {
+                const firstLevelPath = (0, path_1.join)(basePath, firstDir);
+                const firstStats = await (0, promises_1.stat)(firstLevelPath);
+                if (!firstStats.isDirectory()) {
+                    continue;
+                }
+                // Scan second level directories (second character of checksum)
+                const secondLevelDirs = await (0, promises_1.readdir)(firstLevelPath);
+                for (const secondDir of secondLevelDirs) {
+                    const secondLevelPath = (0, path_1.join)(firstLevelPath, secondDir);
+                    const secondStats = await (0, promises_1.stat)(secondLevelPath);
+                    if (!secondStats.isDirectory()) {
+                        continue;
+                    }
+                    // Scan block files (exclude metadata and parity files)
+                    const files = await (0, promises_1.readdir)(secondLevelPath);
+                    for (const file of files) {
+                        // Skip metadata files (.m.json) and parity files (.p0, .p1, etc.)
+                        if (file.endsWith('.m.json') || file.includes('.p')) {
+                            continue;
+                        }
+                        // The filename is the block ID (hex string)
+                        this.localBlocks.add(file);
+                    }
+                }
+            }
+        }
+        catch {
+            // If we can't read the directory structure, just return with empty registry
+            // This handles cases where the store is empty or corrupted
+        }
+    }
+    /**
+     * Clear the registry (for testing purposes).
+     */
+    clear() {
+        this.localBlocks.clear();
+        this.cachedBloomFilter = null;
+        this.bloomFilterDirty = true;
+    }
+}
+exports.BlockRegistry = BlockRegistry;
+//# sourceMappingURL=blockRegistry.js.map

package/src/lib/availability/blockRegistry.js.map

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

package/src/lib/availability/configValidation.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview Configuration Validation
+ *
+ * Provides validation functions for availability system configurations.
+ * Ensures all configuration values are valid and returns descriptive error messages.
+ *
+ * @see Requirements 13.1, 13.2, 13.3, 13.4, 13.5, 13.6
+ */
+import { DiscoveryConfig, GossipConfig, HeartbeatConfig } from '@brightchain/brightchain-lib';
+/**
+ * Configuration validation error.
+ * Contains a descriptive error message about what is invalid.
+ */
+export declare class ConfigValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate DiscoveryConfig.
+ * Ensures all values are positive and within reasonable ranges.
+ *
+ * @param config - The discovery configuration to validate
+ * @throws {ConfigValidationError} If configuration is invalid
+ * @see Requirements 13.1, 13.2, 13.3, 13.6
+ */
+export declare function validateDiscoveryConfig(config: Partial<DiscoveryConfig>): void;
+/**
+ * Validate GossipConfig.
+ * Ensures all values are positive and within reasonable ranges.
+ *
+ * @param config - The gossip configuration to validate
+ * @throws {ConfigValidationError} If configuration is invalid
+ * @see Requirements 13.4, 13.6
+ */
+export declare function validateGossipConfig(config: Partial<GossipConfig>): void;
+/**
+ * Validate HeartbeatConfig.
+ * Ensures all values are positive and within reasonable ranges.
+ * Also validates that timeoutMs < intervalMs for proper operation.
+ *
+ * @param config - The heartbeat configuration to validate
+ * @throws {ConfigValidationError} If configuration is invalid
+ * @see Requirements 13.5, 13.6
+ */
+export declare function validateHeartbeatConfig(config: Partial<HeartbeatConfig>): void;
+/**
+ * Create a validated DiscoveryConfig by merging partial config with defaults.
+ * Validates the merged configuration before returning.
+ *
+ * @param config - Partial configuration to merge with defaults
+ * @returns Complete validated configuration
+ * @throws {ConfigValidationError} If configuration is invalid
+ */
+export declare function createValidatedDiscoveryConfig(config?: Partial<DiscoveryConfig>): DiscoveryConfig;
+/**
+ * Create a validated GossipConfig by merging partial config with defaults.
+ * Validates the merged configuration before returning.
+ *
+ * @param config - Partial configuration to merge with defaults
+ * @returns Complete validated configuration
+ * @throws {ConfigValidationError} If configuration is invalid
+ */
+export declare function createValidatedGossipConfig(config?: Partial<GossipConfig>): GossipConfig;
+/**
+ * Create a validated HeartbeatConfig by merging partial config with defaults.
+ * Validates the merged configuration before returning.
+ *
+ * @param config - Partial configuration to merge with defaults
+ * @returns Complete validated configuration
+ * @throws {ConfigValidationError} If configuration is invalid
+ */
+export declare function createValidatedHeartbeatConfig(config?: Partial<HeartbeatConfig>): HeartbeatConfig;
+//# sourceMappingURL=configValidation.d.ts.map

package/src/lib/availability/configValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configValidation.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/availability/configValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,eAAe,EACf,YAAY,EACZ,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAEtC;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,IAAI,CAuFN;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAyDxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,IAAI,CAwDN;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GACpC,eAAe,CAMjB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GACjC,YAAY,CAMd;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GACpC,eAAe,CAQjB"}