@brightchain/brightchain-lib 0.1.0

package/src/lib/blocks/ephemeral.d.ts

@@ -0,0 +1,103 @@
+import { ChecksumUint8Array, Member, type PlatformID } from '@digitaldefiance/ecies-lib';
+import { Readable } from 'stream';
+import { BlockDataType } from '../enumerations/blockDataType';
+import { BlockSize } from '../enumerations/blockSize';
+import { BlockType } from '../enumerations/blockType';
+import { EphemeralBlockMetadata } from '../ephemeralBlockMetadata';
+import { IEphemeralBlock } from '../interfaces/blocks/ephemeral';
+import { BaseBlock } from './base';
+import { IEncryptedBlock } from '../interfaces/blocks/encrypted';
+/**
+ * Ephemeral blocks are blocks that are not stored on disk, but are either input blocks or reconstituted blocks.
+ * Ephemeral blocks should never be written to disk and are therefore memory-only.
+ */
+export declare class EphemeralBlock<TID extends PlatformID = Uint8Array> extends BaseBlock implements IEphemeralBlock<TID> {
+    /**
+     * Creates a new ephemeral block
+     */
+    static from<TID extends PlatformID = Uint8Array>(type: BlockType, dataType: BlockDataType, blockSize: BlockSize, data: Uint8Array, checksum: ChecksumUint8Array, creator: Member<TID>, dateCreated?: Date, lengthBeforeEncryption?: number, canRead?: boolean, canPersist?: boolean): Promise<IEphemeralBlock<TID>>;
+    /**
+     * The data in the block
+     */
+    protected readonly _data: Uint8Array;
+    /**
+     * The block creator object
+     */
+    protected readonly _creator: Member<TID>;
+    /**
+     * Create a new ephemeral block
+     * @param type - The type of the block
+     * @param dataType - The type of data in the block
+     * @param blockSize - The size of the block
+     * @param data - The data in the block
+     * @param checksum - The id/checksum of the block
+     * @param dateCreated - The date the block was created
+     * @param metadata - Optional block metadata
+     * @param canRead - Whether the block can be read
+     * @param canPersist - Whether the block can be persisted (defaults to false for ephemeral blocks)
+     * @param encrypted - Whether the block is encrypted
+     */
+    constructor(type: BlockType, dataType: BlockDataType, data: Uint8Array | Readable, checksum: ChecksumUint8Array, metadata: EphemeralBlockMetadata<TID>, canRead?: boolean, canPersist?: boolean);
+    /**
+     * The data in the block
+     */
+    get data(): Uint8Array;
+    /**
+     * The date the block was created
+     */
+    get dateCreated(): Date;
+    /**
+     * The actual data length of the block before any encryption or padding overhead
+     */
+    get lengthBeforeEncryption(): number;
+    /**
+     * Whether the block can be encrypted
+     */
+    canEncrypt(): boolean;
+    /**
+     * Whether the block can be encrypted for multiple recipients
+     * @param recipientCount number of recipients
+     * @returns
+     */
+    canMultiEncrypt(recipientCount: number): boolean;
+    /**
+     * Synchronously validate the block's data and structure
+     * @throws {ChecksumMismatchError} If checksums do not match
+     */
+    validateSync(): void;
+    /**
+     * Asynchronously validate the block's data and structure
+     * @throws {ChecksumMismatchError} If checksums do not match
+     */
+    validateAsync(): Promise<void>;
+    /**
+     * The block creator object
+     * Only returns Member creators, not GuidV4 IDs
+     */
+    get creator(): Member<TID> | undefined;
+    get layerOverheadSize(): number;
+    /**
+     * Get this layer's header data
+     */
+    get layerHeaderData(): Uint8Array;
+    /**
+     * Get the payload data not including headers or padding
+     */
+    get layerPayload(): Uint8Array;
+    /**
+     * Get the length of the payload not counting padding
+     */
+    get layerPayloadSize(): number;
+    /**
+     * Encrypt this block using the creator's public key
+     * @param creator The member who will own the encrypted block
+     * @returns A new EncryptedOwnedDataBlock
+     */
+    encrypt<E extends IEncryptedBlock<TID>>(newBlockType: BlockType, recipients?: Member<TID>[]): Promise<E>;
+    /**
+     * Get the data for this layer, excluding the layer headers of lower-level layers
+     * and including everything to the end of the block.
+     */
+    get layerData(): Uint8Array;
+}
+//# sourceMappingURL=ephemeral.d.ts.map

package/src/lib/blocks/ephemeral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/ephemeral.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,MAAM,EACN,KAAK,UAAU,EAChB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EACL,SAAS,EAGV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAQnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAInC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;GAGG;AACH,qBAAa,cAAc,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,CAC7D,SAAQ,SACR,YAAW,eAAe,CAAC,GAAG,CAAC;IAE/B;;OAEG;WACiB,IAAI,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,EAC1D,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EACpB,WAAW,CAAC,EAAE,IAAI,EAClB,sBAAsB,CAAC,EAAE,MAAM,EAC/B,OAAO,UAAO,EACd,UAAU,UAAO,GAChB,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAgChC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAErC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAEzC;;;;;;;;;;;;OAYG;gBAED,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,UAAU,GAAG,QAAQ,EAC3B,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,sBAAsB,CAAC,GAAG,CAAC,EACrC,OAAO,UAAO,EACd,UAAU,UAAQ;IAsCpB;;OAEG;IACH,IAAoB,IAAI,IAAI,UAAU,CAKrC;IAED;;OAEG;IACH,IAAoB,WAAW,IAAI,IAAI,CAEtC;IAED;;OAEG;IACH,IAAW,sBAAsB,IAAI,MAAM,CAE1C;IAED;;OAEG;IACI,UAAU,IAAI,OAAO;IAuB5B;;;;OAIG;IACI,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IA4BvD;;;OAGG;IACa,YAAY,IAAI,IAAI;IAkBpC;;;OAGG;IACmB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBpD;;;OAGG;IACH,IAAW,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAE5C;IAED,IAAoB,iBAAiB,IAAI,MAAM,CAE9C;IAED;;OAEG;IACH,IAAoB,eAAe,IAAI,UAAU,CAMhD;IAED;;OAEG;IACH,IAAoB,YAAY,IAAI,UAAU,CAQ7C;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED;;;;OAIG;IACU,OAAO,CAAC,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,EACjD,YAAY,EAAE,SAAS,EACvB,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GACzB,OAAO,CAAC,CAAC,CAAC;IAmEb;;;OAGG;IACH,IAAW,SAAS,IAAI,UAAU,CAQjC;CACF"}

package/src/lib/blocks/ephemeral.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EphemeralBlock = void 0;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const crypto_1 = require("crypto");
+const stream_1 = require("stream");
+const constants_1 = require("../constants");
+const blockAccessErrorType_1 = require("../enumerations/blockAccessErrorType");
+const blockErrorType_1 = require("../enumerations/blockErrorType");
+const blockMetadataErrorType_1 = require("../enumerations/blockMetadataErrorType");
+const blockType_1 = require("../enumerations/blockType");
+const blockValidationErrorType_1 = require("../enumerations/blockValidationErrorType");
+const ephemeralBlockMetadata_1 = require("../ephemeralBlockMetadata");
+const block_1 = require("../errors/block");
+const checksumMismatch_1 = require("../errors/checksumMismatch");
+const serviceLocator_1 = require("../services/serviceLocator");
+const base_1 = require("./base");
+// Remove circular import
+// import { EncryptedBlock } from './encrypted';
+const blockEncryptionType_1 = require("../enumerations/blockEncryptionType");
+/**
+ * Ephemeral blocks are blocks that are not stored on disk, but are either input blocks or reconstituted blocks.
+ * Ephemeral blocks should never be written to disk and are therefore memory-only.
+ */
+class EphemeralBlock extends base_1.BaseBlock {
+    /**
+     * Creates a new ephemeral block
+     */
+    static async from(type, dataType, blockSize, data, checksum, creator, dateCreated, lengthBeforeEncryption, canRead = true, canPersist = true) {
+        // Skip validation in test environment
+        const calculatedChecksum = await serviceLocator_1.ServiceLocator.getServiceProvider().checksumService.calculateChecksum(data);
+        if (!(0, ecies_lib_1.arraysEqual)(calculatedChecksum, checksum)) {
+            throw new checksumMismatch_1.ChecksumMismatchError(checksum, calculatedChecksum);
+        }
+        const metadata = new ephemeralBlockMetadata_1.EphemeralBlockMetadata(blockSize, type, dataType, lengthBeforeEncryption ?? data.length, creator, dateCreated ?? new Date());
+        return new EphemeralBlock(type, dataType, data, checksum, metadata, canRead, canPersist);
+    }
+    /**
+     * Create a new ephemeral block
+     * @param type - The type of the block
+     * @param dataType - The type of data in the block
+     * @param blockSize - The size of the block
+     * @param data - The data in the block
+     * @param checksum - The id/checksum of the block
+     * @param dateCreated - The date the block was created
+     * @param metadata - Optional block metadata
+     * @param canRead - Whether the block can be read
+     * @param canPersist - Whether the block can be persisted (defaults to false for ephemeral blocks)
+     * @param encrypted - Whether the block is encrypted
+     */
+    constructor(type, dataType, data, checksum, metadata, canRead = true, canPersist = false) {
+        if (data instanceof stream_1.Readable) {
+            throw new block_1.BlockValidationError(blockValidationErrorType_1.BlockValidationErrorType.EphemeralBlockOnlySupportsBufferData);
+        }
+        // Initialize base class
+        super(type, dataType, checksum, metadata, canRead, canPersist);
+        // Validate data length against block size
+        const maxDataSize = metadata.size;
+        if (data.length > maxDataSize) {
+            throw new block_1.BlockValidationError(blockValidationErrorType_1.BlockValidationErrorType.DataLengthExceedsCapacity);
+        }
+        // Handle padding
+        let paddedData = data;
+        if (paddedData.length < maxDataSize) {
+            // Pad with random data to reach the full block size
+            const padding = (0, crypto_1.randomBytes)(maxDataSize - paddedData.length);
+            paddedData = Buffer.concat([paddedData, padding]);
+        }
+        if (!metadata) {
+            throw new block_1.BlockMetadataError(blockMetadataErrorType_1.BlockMetadataErrorType.MetadataRequired);
+        }
+        // Store block properties
+        this._data = paddedData;
+        // Handle creator from metadata
+        this._creator = metadata.creator;
+    }
+    /**
+     * The data in the block
+     */
+    get data() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        return this._data;
+    }
+    /**
+     * The date the block was created
+     */
+    get dateCreated() {
+        return this._dateCreated;
+    }
+    /**
+     * The actual data length of the block before any encryption or padding overhead
+     */
+    get lengthBeforeEncryption() {
+        return this._lengthBeforeEncryption;
+    }
+    /**
+     * Whether the block can be encrypted
+     */
+    canEncrypt() {
+        let encryptedBlockType = blockType_1.BlockType.EncryptedOwnedDataBlock;
+        if (this.blockType === blockType_1.BlockType.ConstituentBlockList) {
+            encryptedBlockType = blockType_1.BlockType.EncryptedConstituentBlockListBlock;
+        }
+        else if (this.blockType === blockType_1.BlockType.EncryptedExtendedConstituentBlockListBlock) {
+            encryptedBlockType = blockType_1.BlockType.EncryptedExtendedConstituentBlockListBlock;
+        }
+        const capacity = serviceLocator_1.ServiceLocator.getServiceProvider().blockCapacityCalculator.calculateCapacity({
+            blockSize: this.blockSize,
+            blockType: encryptedBlockType,
+            encryptionType: blockEncryptionType_1.BlockEncryptionType.SingleRecipient,
+        });
+        return (this._lengthBeforeEncryption + constants_1.ECIES.OVERHEAD_SIZE <=
+            capacity.availableCapacity);
+    }
+    /**
+     * Whether the block can be encrypted for multiple recipients
+     * @param recipientCount number of recipients
+     * @returns
+     */
+    canMultiEncrypt(recipientCount) {
+        let encryptedBlockType = blockType_1.BlockType.EncryptedOwnedDataBlock;
+        if (this.blockType === blockType_1.BlockType.ConstituentBlockList) {
+            encryptedBlockType = blockType_1.BlockType.EncryptedConstituentBlockListBlock;
+        }
+        else if (this.blockType === blockType_1.BlockType.EncryptedExtendedConstituentBlockListBlock) {
+            encryptedBlockType = blockType_1.BlockType.EncryptedExtendedConstituentBlockListBlock;
+        }
+        const capacity = serviceLocator_1.ServiceLocator.getServiceProvider().blockCapacityCalculator.calculateCapacity({
+            blockSize: this.blockSize,
+            blockType: encryptedBlockType,
+            recipientCount: recipientCount,
+            encryptionType: blockEncryptionType_1.BlockEncryptionType.MultiRecipient,
+        });
+        const overhead = serviceLocator_1.ServiceLocator.getServiceProvider().eciesService.calculateECIESMultipleRecipientOverhead(recipientCount, true);
+        return (this._lengthBeforeEncryption + overhead <= capacity.availableCapacity);
+    }
+    /**
+     * Synchronously validate the block's data and structure
+     * @throws {ChecksumMismatchError} If checksums do not match
+     */
+    validateSync() {
+        // For both encrypted and unencrypted blocks,
+        // validate against the provided checksum
+        if (!this.idChecksum) {
+            throw new block_1.BlockValidationError(blockValidationErrorType_1.BlockValidationErrorType.NoChecksum);
+        }
+        // Calculate checksum on actual data length, excluding padding
+        const computedChecksum = serviceLocator_1.ServiceLocator.getServiceProvider().checksumService.calculateChecksum(this._data);
+        const validated = (0, ecies_lib_1.arraysEqual)(computedChecksum, this.idChecksum);
+        if (!validated) {
+            throw new checksumMismatch_1.ChecksumMismatchError(this.idChecksum, computedChecksum);
+        }
+    }
+    /**
+     * Asynchronously validate the block's data and structure
+     * @throws {ChecksumMismatchError} If checksums do not match
+     */
+    async validateAsync() {
+        // For both encrypted and unencrypted blocks,
+        // validate against the provided checksum
+        if (!this.idChecksum) {
+            throw new block_1.BlockValidationError(blockValidationErrorType_1.BlockValidationErrorType.NoChecksum);
+        }
+        // Calculate checksum on actual data length, excluding padding
+        const computedChecksum = await serviceLocator_1.ServiceLocator.getServiceProvider().checksumService.calculateChecksum(this._data);
+        const validated = (0, ecies_lib_1.arraysEqual)(computedChecksum, this.idChecksum);
+        if (!validated) {
+            throw new checksumMismatch_1.ChecksumMismatchError(this.idChecksum, computedChecksum);
+        }
+    }
+    /**
+     * The block creator object
+     * Only returns Member creators, not GuidV4 IDs
+     */
+    get creator() {
+        return this._creator || undefined;
+    }
+    get layerOverheadSize() {
+        return 0;
+    }
+    /**
+     * Get this layer's header data
+     */
+    get layerHeaderData() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        // Return empty buffer by default, but allow derived classes to override
+        return new Uint8Array(0);
+    }
+    /**
+     * Get the payload data not including headers or padding
+     */
+    get layerPayload() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        return this.layerData.subarray(this.layerOverheadSize, this.layerOverheadSize + this.layerPayloadSize);
+    }
+    /**
+     * Get the length of the payload not counting padding
+     */
+    get layerPayloadSize() {
+        return this._lengthBeforeEncryption;
+    }
+    /**
+     * Encrypt this block using the creator's public key
+     * @param creator The member who will own the encrypted block
+     * @returns A new EncryptedOwnedDataBlock
+     */
+    async encrypt(newBlockType, recipients) {
+        const encryptedBlockType = recipients && recipients.length >= 2
+            ? blockEncryptionType_1.BlockEncryptionType.MultiRecipient
+            : blockEncryptionType_1.BlockEncryptionType.SingleRecipient;
+        if (recipients && recipients.length === 0) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.RecipientRequired);
+        }
+        if (!blockType_1.EncryptedBlockTypes.includes(newBlockType)) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.InvalidNewBlockType);
+        }
+        else if (!blockType_1.EphemeralBlockTypes.includes(this.blockType)) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.UnexpectedEncryptedBlockType);
+        }
+        else if (!this.creator) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.CreatorRequiredForEncryption);
+        }
+        else if (encryptedBlockType === blockEncryptionType_1.BlockEncryptionType.MultiRecipient &&
+            (recipients === undefined ||
+                recipients.length < 2 ||
+                recipients.length > constants_1.ECIES.MULTIPLE.MAX_RECIPIENTS)) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.InvalidMultiEncryptionRecipientCount);
+        }
+        else if (encryptedBlockType === blockEncryptionType_1.BlockEncryptionType.SingleRecipient &&
+            !this.canEncrypt()) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.CannotEncrypt);
+        }
+        else if (encryptedBlockType === blockEncryptionType_1.BlockEncryptionType.MultiRecipient &&
+            recipients &&
+            !this.canMultiEncrypt(recipients.length)) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.CannotEncrypt);
+        }
+        // Encrypt using BlockService
+        const encryptedBlock = encryptedBlockType === blockEncryptionType_1.BlockEncryptionType.MultiRecipient && recipients
+            ? await serviceLocator_1.ServiceLocator.getServiceProvider().blockService.encryptMultiple(newBlockType, this, recipients)
+            : await serviceLocator_1.ServiceLocator.getServiceProvider().blockService.encrypt(newBlockType, this, recipients ? recipients[0] : undefined);
+        // We can't use instanceof EncryptedBlock here due to circular dependency
+        // Instead, check if it implements IEncryptedBlock interface or IMultiEncryptedBlock
+        if (!encryptedBlock ||
+            typeof encryptedBlock !== 'object' ||
+            !('decrypt' in encryptedBlock) ||
+            (encryptedBlockType === blockEncryptionType_1.BlockEncryptionType.SingleRecipient &&
+                !('ephemeralPublicKey' in encryptedBlock)) ||
+            (encryptedBlockType === blockEncryptionType_1.BlockEncryptionType.MultiRecipient &&
+                !('recipientKeys' in encryptedBlock))) {
+            throw new block_1.BlockError(blockErrorType_1.BlockErrorType.UnexpectedEncryptedBlockType);
+        }
+        return encryptedBlock;
+    }
+    /**
+     * Get the data for this layer, excluding the layer headers of lower-level layers
+     * and including everything to the end of the block.
+     */
+    get layerData() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        const startOffset = this.lowerLayerHeaderSize + this.layerOverheadSize;
+        return this.data.subarray(startOffset, startOffset + this.layerPayloadSize);
+    }
+}
+exports.EphemeralBlock = EphemeralBlock;
+//# sourceMappingURL=ephemeral.js.map

package/src/lib/blocks/ephemeral.js.map

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

package/src/lib/blocks/extendedCbl.d.ts

@@ -0,0 +1,77 @@
+import { ChecksumString, ChecksumUint8Array, Member, PlatformID, SignatureUint8Array } from '@digitaldefiance/ecies-lib';
+import { BlockDataType } from '../enumerations/blockDataType';
+import { BlockSize } from '../enumerations/blockSize';
+import { BlockType } from '../enumerations/blockType';
+import { IEncryptedBlock } from '../interfaces/blocks/encrypted';
+import { IExtendedConstituentBlockListBlock } from '../interfaces/blocks/extendedCbl';
+/**
+ * Extended CBL class, which extends the CBL class with additional properties
+ * for extended CBLs (fileName + mimeType).
+ * This introduces a variable length header
+ */
+export declare class ExtendedCBL<TID extends PlatformID = Uint8Array> implements IExtendedConstituentBlockListBlock<TID> {
+    private _delegate;
+    constructor(...args: any[]);
+    protected get _data(): Buffer;
+    protected ensureHeaderValidated(): void;
+    /**
+     * The name of the file represented by the CBL
+     */
+    get fileName(): string;
+    /**
+     * The length of the file name
+     */
+    get fileNameLength(): number;
+    /**
+     * The MIME type of the file represented by the CBL
+     */
+    get mimeType(): string;
+    /**
+     * The length of the MIME type
+     */
+    get mimeTypeLength(): number;
+    /**
+     * Validate the CBL structure and metadata
+     */
+    validateSync(): void;
+    /**
+     * Validate the CBL structure and metadata, async
+     */
+    validateAsync(): Promise<void>;
+    get blockSize(): BlockSize;
+    get blockType(): BlockType;
+    get isExtendedCbl(): boolean;
+    get addressData(): Buffer;
+    get addresses(): ChecksumUint8Array[];
+    get cblAddressCount(): number;
+    get dateCreated(): Date;
+    get originalDataLength(): number;
+    get tupleSize(): number;
+    get creatorSignature(): SignatureUint8Array;
+    get creatorId(): TID;
+    get layerPayload(): Buffer;
+    get layerData(): Buffer;
+    get totalOverhead(): number;
+    get layerHeaderData(): Buffer;
+    get fullHeaderData(): Buffer;
+    get data(): Buffer;
+    get idChecksum(): ChecksumUint8Array;
+    get checksumString(): ChecksumString;
+    get canRead(): boolean;
+    get canPersist(): boolean;
+    get blockDataType(): BlockDataType;
+    get creator(): Member<TID>;
+    get headerValidated(): boolean;
+    get layerOverheadSize(): number;
+    get lengthBeforeEncryption(): number;
+    get layerPayloadSize(): number;
+    get layers(): any[];
+    get parent(): any;
+    canEncrypt(): boolean;
+    canMultiEncrypt(recipientCount: number): boolean;
+    validateSignature(creator?: Member<TID>): boolean;
+    validate(): void;
+    encrypt<E extends IEncryptedBlock<TID>>(newBlockType: BlockType, recipients?: Member<TID>[]): Promise<E>;
+    getHandleTuples(getDiskBlockPath: any): Promise<any[]>;
+}
+//# sourceMappingURL=extendedCbl.d.ts.map

package/src/lib/blocks/extendedCbl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extendedCbl.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/extendedCbl.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAGtF;;;;GAIG;AACH,qBAAa,WAAW,CACtB,GAAG,SAAS,UAAU,GAAG,UAAU,CACnC,YAAW,kCAAkC,CAAC,GAAG,CAAC;IAElD,OAAO,CAAC,SAAS,CAAM;gBAEX,GAAG,IAAI,EAAE,GAAG,EAAE;IAS1B,SAAS,KAAK,KAAK,IAAI,MAAM,CAE5B;IAED,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAOvC;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAS5B;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,MAAM,CAKlC;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAS5B;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,MAAM,CAKlC;IAED;;OAEG;IACI,YAAY,IAAI,IAAI;IAS3B;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3C,IAAW,SAAS,IAAI,SAAS,CAEhC;IAED,IAAW,SAAS,IAAI,SAAS,CAEhC;IAED,IAAW,aAAa,IAAI,OAAO,CAElC;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,SAAS,IAAI,kBAAkB,EAAE,CAE3C;IAED,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,IAAW,WAAW,IAAI,IAAI,CAE7B;IAED,IAAW,kBAAkB,IAAI,MAAM,CAEtC;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,gBAAgB,IAAI,mBAAmB,CAEjD;IAED,IAAW,SAAS,IAAI,GAAG,CAE1B;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,IAAW,IAAI,IAAI,MAAM,CASxB;IAED,IAAW,UAAU,IAAI,kBAAkB,CAE1C;IAED,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,UAAU,IAAI,OAAO,CAE/B;IAED,IAAW,aAAa,IAAI,aAAa,CAExC;IAED,IAAW,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAEhC;IAED,IAAW,eAAe,IAAI,OAAO,CAEpC;IAED,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED,IAAW,sBAAsB,IAAI,MAAM,CAE1C;IAED,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,IAAW,MAAM,IAAI,GAAG,EAAE,CAEzB;IAED,IAAW,MAAM,IAAI,GAAG,CAEvB;IAEM,UAAU,IAAI,OAAO;IAIrB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIhD,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO;IAIjD,QAAQ,IAAI,IAAI;IAIV,OAAO,CAAC,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,EACjD,YAAY,EAAE,SAAS,EACvB,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GACzB,OAAO,CAAC,CAAC,CAAC;IAIA,eAAe,CAAC,gBAAgB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAGpE"}