@brightchain/brightchain-lib 0.14.0 → 0.15.0

package/src/lib/stores/pooledMemoryBlockStore.js

@@ -0,0 +1,583 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PooledMemoryBlockStore = void 0;
+const sha3_1 = require("@noble/hashes/sha3");
+const handle_1 = require("../blocks/handle");
+const rawData_1 = require("../blocks/rawData");
+const constants_1 = require("../constants");
+const enumerations_1 = require("../enumerations");
+const storeErrorType_1 = require("../enumerations/storeErrorType");
+const poolDeletionError_1 = require("../errors/poolDeletionError");
+const storeError_1 = require("../errors/storeError");
+const i18n_1 = require("../i18n");
+const blockMetadata_1 = require("../interfaces/storage/blockMetadata");
+const pooledBlockStore_1 = require("../interfaces/storage/pooledBlockStore");
+const globalServiceProvider_1 = require("../services/globalServiceProvider");
+const xor_1 = require("../services/xor");
+const checksum_1 = require("../types/checksum");
+const xorUtils_1 = require("../utils/xorUtils");
+const memoryBlockStore_1 = require("./memoryBlockStore");
+/**
+ * In-memory implementation of IPooledBlockStore.
+ *
+ * Extends MemoryBlockStore with pool-based namespace isolation.
+ * Blocks are stored in a separate pool-scoped map keyed by storage keys
+ * (format: "${poolId}:${hash}"). Legacy IBlockStore methods delegate
+ * to the DEFAULT_POOL for backward compatibility.
+ *
+ * @see IPooledBlockStore for the interface definition
+ * @see MemoryBlockStore for the base implementation
+ */
+class PooledMemoryBlockStore extends memoryBlockStore_1.MemoryBlockStore {
+    constructor(blockSize, fecService, metadataStore) {
+        super(blockSize, fecService, metadataStore);
+        /** Pool-scoped block storage: storageKey -> block data */
+        this.poolBlocks = new Map();
+        /** Per-pool statistics */
+        this.poolStatsMap = new Map();
+    }
+    // =========================================================================
+    // Pool-Scoped Block Operations
+    // =========================================================================
+    /**
+     * Compute the SHA3-512 hash of data and return as hex string.
+     */
+    computeHash(data) {
+        const hashBytes = (0, sha3_1.sha3_512)(data);
+        return checksum_1.Checksum.fromUint8Array(hashBytes).toHex();
+    }
+    /**
+     * Update pool statistics after a block is added.
+     */
+    recordPut(poolId, dataLength) {
+        const now = new Date();
+        const existing = this.poolStatsMap.get(poolId);
+        if (existing) {
+            existing.blockCount += 1;
+            existing.totalBytes += dataLength;
+            existing.lastAccessedAt = now;
+        }
+        else {
+            this.poolStatsMap.set(poolId, {
+                poolId,
+                blockCount: 1,
+                totalBytes: dataLength,
+                createdAt: now,
+                lastAccessedAt: now,
+            });
+        }
+    }
+    /**
+     * Update pool statistics after a block is removed.
+     */
+    recordDelete(poolId, dataLength) {
+        const existing = this.poolStatsMap.get(poolId);
+        if (existing) {
+            existing.blockCount -= 1;
+            existing.totalBytes -= dataLength;
+            existing.lastAccessedAt = new Date();
+        }
+    }
+    /**
+     * Touch the lastAccessedAt timestamp for a pool.
+     */
+    touchPool(poolId) {
+        const existing = this.poolStatsMap.get(poolId);
+        if (existing) {
+            existing.lastAccessedAt = new Date();
+        }
+    }
+    async hasInPool(pool, hash) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const key = (0, pooledBlockStore_1.makeStorageKey)(pool, hash);
+        this.touchPool(pool);
+        return this.poolBlocks.has(key);
+    }
+    async getFromPool(pool, hash) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const key = (0, pooledBlockStore_1.makeStorageKey)(pool, hash);
+        const data = this.poolBlocks.get(key);
+        if (!data) {
+            throw new storeError_1.StoreError(storeErrorType_1.StoreErrorType.KeyNotFound, undefined, {
+                KEY: `${pool}:${hash}`,
+            });
+        }
+        this.touchPool(pool);
+        return data;
+    }
+    async putInPool(pool, data, options) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const hash = this.computeHash(data);
+        const key = (0, pooledBlockStore_1.makeStorageKey)(pool, hash);
+        if (this.poolBlocks.has(key)) {
+            // Idempotent — block already exists in this pool
+            this.touchPool(pool);
+            return hash;
+        }
+        // Store the block data
+        this.poolBlocks.set(key, new Uint8Array(data));
+        // Create metadata with poolId
+        const metadata = (0, blockMetadata_1.createDefaultBlockMetadata)(hash, data.length, hash, options, pool);
+        try {
+            await this.getMetadataStore().create(metadata);
+        }
+        catch {
+            // Metadata may already exist if the same hash was stored in another pool
+            // Update poolId on existing metadata
+            if (this.getMetadataStore().has(hash)) {
+                await this.getMetadataStore().update(hash, { poolId: pool });
+            }
+        }
+        // Update pool stats
+        this.recordPut(pool, data.length);
+        return hash;
+    }
+    async deleteFromPool(pool, hash) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const key = (0, pooledBlockStore_1.makeStorageKey)(pool, hash);
+        const data = this.poolBlocks.get(key);
+        if (data) {
+            this.poolBlocks.delete(key);
+            this.recordDelete(pool, data.length);
+        }
+    }
+    // =========================================================================
+    // Pool Management
+    // =========================================================================
+    async listPools() {
+        const pools = [];
+        for (const [poolId, stats] of this.poolStatsMap) {
+            if (stats.blockCount > 0) {
+                pools.push(poolId);
+            }
+        }
+        return pools;
+    }
+    async *listBlocksInPool(pool, options) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const prefix = pool + ':';
+        const limit = options?.limit;
+        const cursor = options?.cursor;
+        let pastCursor = cursor === undefined;
+        let yielded = 0;
+        for (const key of this.poolBlocks.keys()) {
+            if (!key.startsWith(prefix)) {
+                continue;
+            }
+            const { hash } = (0, pooledBlockStore_1.parseStorageKey)(key);
+            if (!pastCursor) {
+                if (hash === cursor) {
+                    pastCursor = true;
+                }
+                continue;
+            }
+            yield hash;
+            yielded++;
+            if (limit !== undefined && yielded >= limit) {
+                break;
+            }
+        }
+    }
+    async getPoolStats(pool) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const stats = this.poolStatsMap.get(pool);
+        if (!stats) {
+            throw new Error(`Pool "${pool}" not found: no blocks have been stored in this pool`);
+        }
+        return {
+            ...stats,
+            createdAt: new Date(stats.createdAt.getTime()),
+            lastAccessedAt: new Date(stats.lastAccessedAt.getTime()),
+        };
+    }
+    async deletePool(pool) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        // Pre-deletion validation
+        const validation = await this.validatePoolDeletion(pool);
+        if (!validation.safe) {
+            throw new poolDeletionError_1.PoolDeletionError(`Cannot delete pool "${pool}": ${validation.dependentPools.length} dependent pool(s) ` +
+                `reference ${validation.referencedBlocks.length} block(s). ` +
+                `Dependent pools: ${validation.dependentPools.join(', ')}. ` +
+                `Use forceDeletePool() to bypass this check.`, validation);
+        }
+        // Proceed with deletion
+        await this.performPoolDeletion(pool);
+    }
+    /**
+     * Internal deletion logic shared by deletePool (after validation) and forceDeletePool.
+     * Removes all blocks with the pool prefix and clears pool stats.
+     */
+    async performPoolDeletion(pool) {
+        const prefix = pool + ':';
+        const keysToDelete = [];
+        for (const key of this.poolBlocks.keys()) {
+            if (key.startsWith(prefix)) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.poolBlocks.delete(key);
+        }
+        this.poolStatsMap.delete(pool);
+    }
+    // =========================================================================
+    // Pool-Scoped Whitening Operations
+    // =========================================================================
+    /**
+     * Get random block checksums scoped to a specific pool.
+     * Iterates storage keys with the pool prefix and randomly selects blocks.
+     * @param pool - The pool to source random blocks from
+     * @param count - Number of random blocks requested
+     * @returns Array of checksums (may be fewer than count if pool has insufficient blocks)
+     */
+    async getRandomBlocksFromPool(pool, count) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const poolPrefix = `${pool}:`;
+        const poolKeys = [];
+        for (const key of this.poolBlocks.keys()) {
+            if (key.startsWith(poolPrefix)) {
+                poolKeys.push(key.substring(poolPrefix.length));
+            }
+        }
+        const actualCount = Math.min(count, poolKeys.length);
+        const shuffled = [...poolKeys].sort(() => Math.random() - 0.5);
+        return shuffled.slice(0, actualCount).map((hex) => checksum_1.Checksum.fromHex(hex));
+    }
+    /**
+     * Override getRandomBlocks to use Default_Pool for backward compatibility.
+     * Delegates to getRandomBlocksFromPool with DEFAULT_POOL.
+     */
+    async getRandomBlocks(count) {
+        return this.getRandomBlocksFromPool(pooledBlockStore_1.DEFAULT_POOL, count);
+    }
+    /**
+     * Seed a pool with cryptographically random blocks for whitening material.
+     * Stub — full implementation in task 5.1.
+     */
+    async bootstrapPool(pool, blockSize, count) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        if (count <= 0)
+            return;
+        for (let i = 0; i < count; i++) {
+            const data = new Uint8Array(blockSize);
+            crypto.getRandomValues(data);
+            await this.putInPool(pool, data);
+        }
+    }
+    /**
+     * Check whether a pool can be safely deleted (no cross-pool XOR dependencies).
+     * Scans all other pools' blocks looking for CBL-type blocks whose addresses
+     * reference checksums stored in the target pool.
+     *
+     * @param pool - The pool to validate for deletion
+     * @returns Validation result with dependency details if unsafe
+     */
+    async validatePoolDeletion(pool) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        // 1. Collect all block hashes in the target pool for O(1) lookup
+        const targetPoolPrefix = `${pool}:`;
+        const targetPoolHashes = new Set();
+        for (const key of this.poolBlocks.keys()) {
+            if (key.startsWith(targetPoolPrefix)) {
+                const { hash } = (0, pooledBlockStore_1.parseStorageKey)(key);
+                targetPoolHashes.add(hash);
+            }
+        }
+        // If the target pool is empty, it's trivially safe to delete
+        if (targetPoolHashes.size === 0) {
+            return { safe: true, dependentPools: [], referencedBlocks: [] };
+        }
+        // 2. Get a CBLService instance from the global service provider
+        let cblService = null;
+        try {
+            const provider = (0, globalServiceProvider_1.getGlobalServiceProvider)();
+            cblService = provider.cblService;
+        }
+        catch {
+            // Global service provider not initialized — cannot parse CBLs.
+            // Return safe=true since we can't determine dependencies without the service.
+            return { safe: true, dependentPools: [], referencedBlocks: [] };
+        }
+        // 3. Scan all blocks in OTHER pools for CBL-type blocks
+        const dependentPoolsSet = new Set();
+        const referencedBlocksSet = new Set();
+        for (const [key, data] of this.poolBlocks.entries()) {
+            // Skip blocks in the target pool itself
+            if (key.startsWith(targetPoolPrefix)) {
+                continue;
+            }
+            // Check if this block is a structured CBL block
+            if (!this.isCblBlock(data)) {
+                continue;
+            }
+            // Extract the pool this CBL belongs to
+            const { poolId: otherPool } = (0, pooledBlockStore_1.parseStorageKey)(key);
+            // Try to parse addresses from this CBL
+            const addresses = this.extractCblAddresses(data, cblService);
+            if (addresses === null) {
+                continue; // Encrypted or unparseable — skip
+            }
+            // Check if any addresses reference blocks in the target pool
+            for (const address of addresses) {
+                const addressHex = address.toHex();
+                if (targetPoolHashes.has(addressHex)) {
+                    dependentPoolsSet.add(otherPool);
+                    referencedBlocksSet.add(addressHex);
+                }
+            }
+        }
+        const dependentPools = Array.from(dependentPoolsSet);
+        const referencedBlocks = Array.from(referencedBlocksSet);
+        const safe = dependentPools.length === 0;
+        return { safe, dependentPools, referencedBlocks };
+    }
+    /**
+     * Check if raw block data represents a CBL-type block.
+     * CBL blocks have the BrightChain magic prefix (0xBC) followed by a CBL structured type.
+     */
+    isCblBlock(data) {
+        if (data.length < 4) {
+            return false;
+        }
+        if (data[0] !== constants_1.BLOCK_HEADER.MAGIC_PREFIX) {
+            return false;
+        }
+        const structuredType = data[1];
+        return (structuredType === constants_1.StructuredBlockType.CBL ||
+            structuredType === constants_1.StructuredBlockType.ExtendedCBL ||
+            structuredType === constants_1.StructuredBlockType.MessageCBL ||
+            structuredType === constants_1.StructuredBlockType.SuperCBL ||
+            structuredType === constants_1.StructuredBlockType.VaultCBL);
+    }
+    /**
+     * Extract addresses from a CBL block's raw data.
+     * Returns null if the block is encrypted or cannot be parsed.
+     */
+    extractCblAddresses(data, cblService) {
+        try {
+            // Skip encrypted CBLs — we can't parse their addresses
+            if (cblService.isEncrypted(data)) {
+                return null;
+            }
+            // SuperCBLs store sub-CBL checksums, not data block addresses
+            if (cblService.isSuperCbl(data)) {
+                return cblService.getSuperCblSubCblChecksums(data);
+            }
+            // Regular/Extended/Message/Vault CBLs use addressDataToAddresses
+            return cblService.addressDataToAddresses(data);
+        }
+        catch {
+            // If parsing fails for any reason, skip this block
+            return null;
+        }
+    }
+    /**
+     * Delete a pool without checking for cross-pool dependencies.
+     * For administrative use only — bypasses validatePoolDeletion.
+     */
+    async forceDeletePool(pool) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        await this.performPoolDeletion(pool);
+    }
+    // =========================================================================
+    // Pool-Scoped CBL Whitening Operations
+    // =========================================================================
+    /**
+     * Store a CBL with XOR whitening, scoped to a specific pool.
+     * Both XOR component blocks are stored within the specified pool namespace.
+     *
+     * @param pool - The pool to store the whitened CBL components in
+     * @param cblData - The original CBL data as Uint8Array
+     * @param options - Optional storage options (durability, expiration, encryption flag)
+     * @returns Result containing block IDs, parity IDs (if any), and magnet URL
+     */
+    async storeCBLWithWhiteningInPool(pool, cblData, options) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        // Validate input
+        if (!cblData || cblData.length === 0) {
+            throw new storeError_1.StoreError(storeErrorType_1.StoreErrorType.BlockValidationFailed, undefined, {
+                ERROR: (0, i18n_1.translate)(enumerations_1.BrightChainStrings.MemoryBlockStore_CBLDataCannotBeEmpty),
+            });
+        }
+        // 1. Pad CBL to block size (includes length prefix)
+        const paddedCbl = (0, xorUtils_1.padToBlockSize)(cblData, this.blockSize);
+        // Validate that padded CBL fits within block size
+        if (paddedCbl.length > this.blockSize) {
+            throw new storeError_1.StoreError(storeErrorType_1.StoreErrorType.BlockValidationFailed, undefined, {
+                ERROR: (0, i18n_1.translate)(enumerations_1.BrightChainStrings.MemoryBlockStore_CBLDataTooLargeTemplate, {
+                    LENGTH: paddedCbl.length,
+                    BLOCK_SIZE: this.blockSize,
+                }),
+            });
+        }
+        // 2. Select or generate a random block from the pool for whitening
+        const poolRandomBlocks = await this.getRandomBlocksFromPool(pool, 1);
+        let randomBlock;
+        if (poolRandomBlocks.length > 0) {
+            // Use an existing block from the pool as the randomizer
+            const existingData = await this.getFromPool(pool, poolRandomBlocks[0].toHex());
+            if (existingData.length >= paddedCbl.length) {
+                randomBlock = existingData.slice(0, paddedCbl.length);
+            }
+            else {
+                // Existing block too small, generate fresh random data
+                randomBlock = xor_1.XorService.generateKey(paddedCbl.length);
+            }
+        }
+        else {
+            // No blocks in pool yet, generate fresh random data
+            randomBlock = xor_1.XorService.generateKey(paddedCbl.length);
+        }
+        // 3. XOR to create second block (CBL XOR R)
+        const xorResult = (0, xorUtils_1.xorArrays)(paddedCbl, randomBlock);
+        // Track stored blocks for rollback on failure
+        let block1Stored = false;
+        let block1Id = '';
+        try {
+            // 4. Store first block (R - the randomizer) in the pool
+            block1Id = await this.putInPool(pool, randomBlock, options);
+            block1Stored = true;
+            // 5. Store second block (CBL XOR R) in the pool
+            const block2Id = await this.putInPool(pool, xorResult, options);
+            // 6. Get parity block IDs if FEC redundancy was applied
+            let block1ParityIds;
+            let block2ParityIds;
+            const block1Meta = await this.getMetadata(block1Id);
+            if (block1Meta?.parityBlockIds?.length) {
+                block1ParityIds = block1Meta.parityBlockIds;
+            }
+            const block2Meta = await this.getMetadata(block2Id);
+            if (block2Meta?.parityBlockIds?.length) {
+                block2ParityIds = block2Meta.parityBlockIds;
+            }
+            // 7. Generate magnet URL
+            const magnetUrl = this.generateCBLMagnetUrl(block1Id, block2Id, this.blockSize, block1ParityIds, block2ParityIds, options?.isEncrypted);
+            return {
+                blockId1: block1Id,
+                blockId2: block2Id,
+                blockSize: this.blockSize,
+                magnetUrl,
+                block1ParityIds,
+                block2ParityIds,
+                isEncrypted: options?.isEncrypted,
+            };
+        }
+        catch (error) {
+            // Rollback: delete block1 if it was stored by us
+            if (block1Stored && block1Id) {
+                try {
+                    await this.deleteFromPool(pool, block1Id);
+                }
+                catch {
+                    // Ignore rollback errors
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Retrieve and reconstruct a whitened CBL from a specific pool.
+     * Both XOR component blocks are retrieved from the specified pool namespace.
+     *
+     * @param pool - The pool to retrieve the whitened CBL components from
+     * @param blockId1 - First block ID (Checksum or hex string)
+     * @param blockId2 - Second block ID (Checksum or hex string)
+     * @param block1ParityIds - Optional parity block IDs for block 1 recovery
+     * @param block2ParityIds - Optional parity block IDs for block 2 recovery
+     * @returns The original CBL data as Uint8Array
+     */
+    async retrieveCBLFromPool(pool, blockId1, blockId2, _block1ParityIds, _block2ParityIds) {
+        (0, pooledBlockStore_1.validatePoolId)(pool);
+        const b1Hex = typeof blockId1 === 'string' ? blockId1 : blockId1.toHex();
+        const b2Hex = typeof blockId2 === 'string' ? blockId2 : blockId2.toHex();
+        // 1. Retrieve first block from the pool
+        const hasBlock1 = await this.hasInPool(pool, b1Hex);
+        if (!hasBlock1) {
+            throw new storeError_1.StoreError(storeErrorType_1.StoreErrorType.KeyNotFound, undefined, {
+                KEY: `Block 1 (${b1Hex}) not found in pool "${pool}"`,
+            });
+        }
+        const block1Data = await this.getFromPool(pool, b1Hex);
+        // 2. Retrieve second block from the pool
+        const hasBlock2 = await this.hasInPool(pool, b2Hex);
+        if (!hasBlock2) {
+            throw new storeError_1.StoreError(storeErrorType_1.StoreErrorType.KeyNotFound, undefined, {
+                KEY: `Block 2 (${b2Hex}) not found in pool "${pool}"`,
+            });
+        }
+        const block2Data = await this.getFromPool(pool, b2Hex);
+        // 3. XOR to reconstruct padded CBL (order doesn't matter due to commutativity)
+        const reconstructedPadded = (0, xorUtils_1.xorArrays)(block1Data, block2Data);
+        // 4. Remove padding to get original CBL
+        return (0, xorUtils_1.unpadCblData)(reconstructedPadded);
+    }
+    // =========================================================================
+    // Legacy IBlockStore method overrides — delegate to DEFAULT_POOL
+    // =========================================================================
+    async has(key) {
+        const hash = typeof key === 'string' ? key : key.toHex();
+        return this.hasInPool(pooledBlockStore_1.DEFAULT_POOL, hash);
+    }
+    async getData(key) {
+        const hash = key.toHex();
+        const data = await this.getFromPool(pooledBlockStore_1.DEFAULT_POOL, hash);
+        return new rawData_1.RawDataBlock(this.blockSize, data);
+    }
+    async setData(block, options) {
+        await this.putInPool(pooledBlockStore_1.DEFAULT_POOL, block.data, options);
+    }
+    async deleteData(key) {
+        const hash = key.toHex();
+        await this.deleteFromPool(pooledBlockStore_1.DEFAULT_POOL, hash);
+    }
+    async put(key, data, options) {
+        await this.putInPool(pooledBlockStore_1.DEFAULT_POOL, data, options);
+    }
+    async delete(key) {
+        const hash = typeof key === 'string' ? key : key.toHex();
+        await this.deleteFromPool(pooledBlockStore_1.DEFAULT_POOL, hash);
+    }
+    get(key) {
+        const hash = typeof key === 'string' ? key : key.toHex();
+        const storageKey = (0, pooledBlockStore_1.makeStorageKey)(pooledBlockStore_1.DEFAULT_POOL, hash);
+        const data = this.poolBlocks.get(storageKey);
+        if (!data) {
+            throw new storeError_1.StoreError(storeErrorType_1.StoreErrorType.KeyNotFound, undefined, {
+                KEY: hash,
+            });
+        }
+        const checksum = typeof key === 'string' ? checksum_1.Checksum.fromHex(key) : key;
+        return (0, handle_1.createBlockHandle)(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        rawData_1.RawDataBlock, this.blockSize, data, checksum, true, true);
+    }
+    // =========================================================================
+    // Metadata overrides for pool-scoped storage keys
+    // =========================================================================
+    async getMetadata(key) {
+        const hash = typeof key === 'string' ? key : key.toHex();
+        return this.getMetadataStore().get(hash);
+    }
+    async updateMetadata(key, updates) {
+        const hash = typeof key === 'string' ? key : key.toHex();
+        if (!this.getMetadataStore().has(hash)) {
+            throw new storeError_1.StoreError(storeErrorType_1.StoreErrorType.KeyNotFound, undefined, {
+                KEY: hash,
+            });
+        }
+        await this.getMetadataStore().update(hash, updates);
+    }
+    // =========================================================================
+    // Utility overrides
+    // =========================================================================
+    clear() {
+        super.clear();
+        this.poolBlocks.clear();
+        this.poolStatsMap.clear();
+    }
+    size() {
+        return this.poolBlocks.size;
+    }
+}
+exports.PooledMemoryBlockStore = PooledMemoryBlockStore;
+//# sourceMappingURL=pooledMemoryBlockStore.js.map

package/src/lib/stores/pooledMemoryBlockStore.js.map

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

package/src/lib/types/checksum.d.ts

@@ -65,6 +65,11 @@ export declare class Checksum {
      * @returns A new Checksum instance
      * @throws ChecksumError if buffer length is not equal to SHA3_BUFFER_LENGTH
      *
+     * @deprecated Use `Checksum.fromUint8Array()` instead for browser compatibility.
+     *   This method exists for backward compatibility with Node.js code that uses Buffer.
+     *   Buffer extends Uint8Array, so `fromUint8Array()` accepts Buffer values directly.
+     * @platform Node.js — accepts Node.js `Buffer` type
+     *
      * @example
      * ```typescript
      * const buffer = Buffer.from('a'.repeat(128), 'hex'); // 64 bytes
@@ -72,6 +77,7 @@ export declare class Checksum {
      * ```
      *
      * @see Requirement 1.2
+     * @see Requirement 18.4 — platform-specific convenience method
      */
     static fromBuffer(buffer: Buffer): Checksum;
     /**
@@ -132,6 +138,10 @@ export declare class Checksum {
      *
      * @returns A new Buffer containing the checksum data
      *
+     * @deprecated Use `toUint8Array()` instead for browser compatibility.
+     *   This method exists for backward compatibility with Node.js code that expects Buffer.
+     * @platform Node.js — returns Node.js `Buffer` type
+     *
      * @example
      * ```typescript
      * const checksum = Checksum.fromHex(hexString);
@@ -139,6 +149,7 @@ export declare class Checksum {
      * ```
      *
      * @see Requirement 1.5
+     * @see Requirement 18.4 — platform-specific convenience method
      */
     toBuffer(): Buffer;
     /**

package/src/lib/types/checksum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/types/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACnB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;;;;;;OAOG;IACH,OAAO;IAkBP;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAI3C;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ;IAIlD;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IA+BrC;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAYhC;;;;;;;;;;;;OAYG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,IAAI,UAAU;IAI1B;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,MAAM;IAIf;;;;;;;;;;;;;;OAcG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/types/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACnB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;;;;;;OAOG;IACH,OAAO;IAkBP;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAI3C;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ;IAIlD;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IA+BrC;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAYhC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,IAAI,UAAU;IAI1B;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,MAAM;IAIf;;;;;;;;;;;;;;OAcG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}