@brightchain/brightchain-lib 0.1.0

package/README.md

@@ -0,0 +1,144 @@
+# brightchain-lib
+
+This library was generated with [Nx](https://nx.dev).
+
+## Overview
+
+`brightchain-lib` is the core library for BrightChain, providing blockchain and cryptographic functionality. It extends base cryptographic constants from `@digitaldefiance/ecies-lib` and adds BrightChain-specific constants for blockchain operations.
+
+## Constants Architecture
+
+### Base Constants (from @digitaldefiance/ecies-lib)
+
+The library extends base constants from `@digitaldefiance/ecies-lib`, which provides:
+
+- **PBKDF2**: Password-based key derivation configuration
+- **ECIES**: Elliptic Curve Integrated Encryption Scheme settings
+- **CHECKSUM**: SHA3 checksum configuration
+- **ENCRYPTION**: Base encryption settings
+- **KEYRING**: Keyring algorithm configuration
+- **UINT sizes**: Standard unsigned integer sizes and max values
+- **VOTING**: Paillier homomorphic encryption for voting
+
+### BrightChain-Specific Constants
+
+The library defines the following BrightChain-specific constants:
+
+#### CBL (Constituent Block List)
+Constants for managing constituent block lists:
+```typescript
+import { CBL } from 'brightchain-lib';
+
+// File validation
+CBL.MAX_FILE_NAME_LENGTH  // 255
+CBL.MAX_MIME_TYPE_LENGTH  // 127
+CBL.FILE_NAME_PATTERN     // Regex for valid file names
+CBL.MIME_TYPE_PATTERN     // Regex for valid MIME types
+```
+
+#### FEC (Forward Error Correction)
+Constants for forward error correction:
+```typescript
+import { FEC } from 'brightchain-lib';
+
+FEC.MAX_SHARD_SIZE  // 1048576 (1MB)
+```
+
+#### TUPLE
+Constants for tuple operations:
+```typescript
+import { TUPLE } from 'brightchain-lib';
+
+TUPLE.SIZE                    // 3
+TUPLE.MIN_SIZE                // 2
+TUPLE.MAX_SIZE                // 10
+TUPLE.RANDOM_BLOCKS_PER_TUPLE // 2
+```
+
+#### SEALING
+Constants for sealing operations:
+```typescript
+import { SEALING } from 'brightchain-lib';
+
+SEALING.MIN_SHARES  // 2
+SEALING.MAX_SHARES  // 1048575
+```
+
+#### SITE
+Site-specific configuration:
+```typescript
+import { SITE } from 'brightchain-lib';
+
+SITE.EMAIL_FROM      // 'noreply@brightchain.io'
+SITE.DOMAIN          // 'localhost:3000'
+SITE.CSP_NONCE_SIZE  // 32
+```
+
+#### JWT
+JWT configuration:
+```typescript
+import { JWT } from 'brightchain-lib';
+
+JWT.ALGORITHM       // 'HS256'
+JWT.EXPIRATION_SEC  // 86400 (24 hours)
+```
+
+### Usage Examples
+
+#### Importing All Constants
+```typescript
+import CONSTANTS from 'brightchain-lib';
+
+// Access base constants (from @digitaldefiance/ecies-lib)
+const pbkdf2Iterations = CONSTANTS.PBKDF2.ITERATIONS;
+const eciesCurve = CONSTANTS.ECIES.CURVE_NAME;
+
+// Access BrightChain-specific constants
+const maxFileSize = CONSTANTS.CBL.MAX_INPUT_FILE_SIZE;
+const tupleSize = CONSTANTS.TUPLE.SIZE;
+```
+
+#### Importing Specific Constant Groups
+```typescript
+import { CBL, FEC, TUPLE, SEALING } from 'brightchain-lib';
+
+// Use specific constant groups
+const isValidFileName = CBL.FILE_NAME_PATTERN.test(fileName);
+const maxShardSize = FEC.MAX_SHARD_SIZE;
+```
+
+#### Using ECIES Configuration
+```typescript
+import { EciesConfig } from 'brightchain-lib';
+
+// EciesConfig provides a ready-to-use ECIES configuration object
+const config = EciesConfig;
+console.log(config.curveName);  // 'secp256k1'
+console.log(config.symmetricAlgorithm);  // 'aes-256-gcm'
+```
+
+### Backward Compatibility
+
+The refactored constants maintain full backward compatibility. All previously exported constant names remain accessible:
+
+```typescript
+// These all work as before
+import CONSTANTS from 'brightchain-lib';
+
+CONSTANTS.PBKDF2.ITERATIONS
+CONSTANTS.ECIES.CURVE_NAME
+CONSTANTS.CHECKSUM.ALGORITHM
+CONSTANTS.CBL.MAX_FILE_NAME_LENGTH
+```
+
+## Building
+
+Run `nx build brightchain-lib` to build the library.
+
+## Running unit tests
+
+Run `nx test brightchain-lib` to execute the unit tests via [Jest](https://jestjs.io).
+
+## Migration Guide
+
+If you're updating from a previous version of brightchain-lib, see [MIGRATION.md](./.kiro/specs/constants-refactoring/MIGRATION.md) for detailed migration instructions.

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@brightchain/brightchain-lib",
+  "version": "0.1.0",
+  "description": "BrightChain core library - browser-compatible blockchain storage",
+  "main": "src/browser.js",
+  "types": "src/browser.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Digital-Defiance/BrightChain.git",
+    "directory": "brightchain-lib"
+  },
+  "homepage": "https://github.com/Digital-Defiance/BrightChain#readme",
+  "bugs": {
+    "url": "https://github.com/Digital-Defiance/BrightChain/issues"
+  },
+  "keywords": [
+    "blockchain",
+    "encryption",
+    "storage",
+    "decentralized",
+    "brightchain"
+  ],
+  "author": "Digital Defiance",
+  "license": "MIT",
+  "dependencies": {
+    "@digitaldefiance/ecies-lib": "^4.12.8",
+    "@digitaldefiance/i18n-lib": "^3.8.16",
+    "tslib": "^2.3.0"
+  },
+  "scripts": {
+    "build:dev": "npx nx build brightchain-lib --configuration=development",
+    "lint": "npx eslint '**/*.{ts,tsx}'",
+    "lint:fix": "npx eslint '**/*.{ts,tsx}' --fix",
+    "test:dev:16": "NODE_ENV=development npx nx test brightchain-lib --maxWorkers=16 --parallel=16 --configuration=development --outputStyle=stream 2>&1",
+    "test:dev:16:logged": "NODE_ENV=development npx nx test brightchain-lib --maxWorkers=16 --parallel=16 --configuration=development --outputStyle=stream 2>&1 | ansifilter -o test.log"
+  },
+  "type": "commonjs"
+}

package/src/browser.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/brightChain';
+export * from './lib/enumerations/blockSize';
+export * from './lib/types';
+//# sourceMappingURL=browser.d.ts.map

package/src/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,aAAa,CAAC"}

package/src/browser.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// Browser-only exports - no Node.js dependencies
+tslib_1.__exportStar(require("./lib/brightChain"), exports);
+tslib_1.__exportStar(require("./lib/enumerations/blockSize"), exports);
+tslib_1.__exportStar(require("./lib/types"), exports);
+//# sourceMappingURL=browser.js.map

package/src/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,4DAAkC;AAClC,uEAA6C;AAC7C,sDAA4B"}

package/src/index.d.ts

@@ -0,0 +1,10 @@
+export * from './lib/blocks/rawData';
+export * from './lib/brightChain';
+export * from './lib/enumerations/blockSize';
+export * from './lib/factories/blockStoreFactory';
+export * from './lib/interfaces/storage/blockStore';
+export * from './lib/stores/memoryBlockStore';
+export * from './lib/types';
+export { default as CONSTANTS, CBL, FEC, TUPLE, SEALING, JWT, SITE } from './lib/constants';
+export { EciesConfig } from './lib/ecies-config';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../brightchain-lib/src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/src/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EciesConfig = exports.SITE = exports.JWT = exports.SEALING = exports.TUPLE = exports.FEC = exports.CBL = exports.CONSTANTS = void 0;
+const tslib_1 = require("tslib");
+// Browser-compatible exports only
+tslib_1.__exportStar(require("./lib/blocks/rawData"), exports);
+tslib_1.__exportStar(require("./lib/brightChain"), exports);
+tslib_1.__exportStar(require("./lib/enumerations/blockSize"), exports);
+tslib_1.__exportStar(require("./lib/factories/blockStoreFactory"), exports);
+tslib_1.__exportStar(require("./lib/interfaces/storage/blockStore"), exports);
+tslib_1.__exportStar(require("./lib/stores/memoryBlockStore"), exports);
+tslib_1.__exportStar(require("./lib/types"), exports);
+// Export constants
+var constants_1 = require("./lib/constants");
+Object.defineProperty(exports, "CONSTANTS", { enumerable: true, get: function () { return constants_1.default; } });
+Object.defineProperty(exports, "CBL", { enumerable: true, get: function () { return constants_1.CBL; } });
+Object.defineProperty(exports, "FEC", { enumerable: true, get: function () { return constants_1.FEC; } });
+Object.defineProperty(exports, "TUPLE", { enumerable: true, get: function () { return constants_1.TUPLE; } });
+Object.defineProperty(exports, "SEALING", { enumerable: true, get: function () { return constants_1.SEALING; } });
+Object.defineProperty(exports, "JWT", { enumerable: true, get: function () { return constants_1.JWT; } });
+Object.defineProperty(exports, "SITE", { enumerable: true, get: function () { return constants_1.SITE; } });
+var ecies_config_1 = require("./lib/ecies-config");
+Object.defineProperty(exports, "EciesConfig", { enumerable: true, get: function () { return ecies_config_1.EciesConfig; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../brightchain-lib/src/index.ts"],"names":[],"mappings":";;;;AAAA,kCAAkC;AAClC,+DAAqC;AACrC,4DAAkC;AAClC,uEAA6C;AAC7C,4EAAkD;AAClD,8EAAoD;AACpD,wEAA8C;AAC9C,sDAA4B;AAE5B,mBAAmB;AACnB,6CAA4F;AAAnF,sGAAA,OAAO,OAAa;AAAE,gGAAA,GAAG,OAAA;AAAE,gGAAA,GAAG,OAAA;AAAE,kGAAA,KAAK,OAAA;AAAE,oGAAA,OAAO,OAAA;AAAE,gGAAA,GAAG,OAAA;AAAE,iGAAA,IAAI,OAAA;AAClE,mDAAiD;AAAxC,2GAAA,WAAW,OAAA"}

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

@@ -0,0 +1,12 @@
+import { ChecksumUint8Array } from '@digitaldefiance/ecies-lib';
+/**
+ * Checksum service access for blocks to avoid circular dependencies
+ */
+export declare class BlockChecksum {
+    static get checksumBufferLength(): number;
+    static calculateChecksum(data: Buffer): ChecksumUint8Array;
+    static compareChecksums(checksum1: ChecksumUint8Array, checksum2: ChecksumUint8Array): boolean;
+    static validateChecksum(checksum: ChecksumUint8Array): boolean;
+    static validateDataChecksum(data: Buffer, checksum: ChecksumUint8Array): boolean;
+}
+//# sourceMappingURL=checksum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE;;GAEG;AACH,qBAAa,aAAa;IACxB,WAAkB,oBAAoB,IAAI,MAAM,CAE/C;WAEa,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB;WAMnD,gBAAgB,CAC5B,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,kBAAkB,GAC5B,OAAO;WAOI,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO;WAMvD,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kBAAkB,GAC3B,OAAO;CAIX"}

package/src/lib/access/checksum.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockChecksum = void 0;
+const service_provider_1 = require("../services/service.provider");
+/**
+ * Checksum service access for blocks to avoid circular dependencies
+ */
+class BlockChecksum {
+    static get checksumBufferLength() {
+        return service_provider_1.ServiceProvider.getInstance().checksumService.checksumBufferLength;
+    }
+    static calculateChecksum(data) {
+        return service_provider_1.ServiceProvider.getInstance().checksumService.calculateChecksum(new Uint8Array(data));
+    }
+    static compareChecksums(checksum1, checksum2) {
+        return service_provider_1.ServiceProvider.getInstance().checksumService.compareChecksums(checksum1, checksum2);
+    }
+    static validateChecksum(checksum) {
+        return service_provider_1.ServiceProvider.getInstance().checksumService.validateChecksum(checksum);
+    }
+    static validateDataChecksum(data, checksum) {
+        const calculatedChecksum = this.calculateChecksum(data);
+        return this.compareChecksums(calculatedChecksum, checksum);
+    }
+}
+exports.BlockChecksum = BlockChecksum;
+//# sourceMappingURL=checksum.js.map

package/src/lib/access/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/checksum.ts"],"names":[],"mappings":";;;AACA,mEAA+D;AAE/D;;GAEG;AACH,MAAa,aAAa;IACjB,MAAM,KAAK,oBAAoB;QACpC,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,oBAAoB,CAAC;IAC5E,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,IAAY;QAC1C,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,iBAAiB,CACpE,IAAI,UAAU,CAAC,IAAI,CAAC,CACrB,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAC5B,SAA6B,EAC7B,SAA6B;QAE7B,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,gBAAgB,CACnE,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAAC,QAA4B;QACzD,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,gBAAgB,CACnE,QAAQ,CACT,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,oBAAoB,CAChC,IAAY,EACZ,QAA4B;QAE5B,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACF;AAlCD,sCAkCC"}

package/src/lib/access/ecies.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ECIES service access for blocks to avoid circular dependencies
+ * Updated to use new @digitaldefiance/ecies-lib API
+ */
+export declare class BlockECIES {
+    static encrypt(receiverPublicKey: Uint8Array, message: Uint8Array): Promise<Uint8Array>;
+    static decrypt(privateKey: Uint8Array, encryptedData: Uint8Array): Promise<Uint8Array>;
+    static decryptWithComponents(privateKey: Uint8Array, ephemeralPublicKey: Uint8Array, iv: Uint8Array, authTag: Uint8Array, encrypted: Uint8Array): Promise<{
+        decrypted: Uint8Array;
+        ciphertextLength?: number;
+    }>;
+}
+//# sourceMappingURL=ecies.d.ts.map

package/src/lib/access/ecies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecies.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/ecies.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,UAAU;WACD,OAAO,CACzB,iBAAiB,EAAE,UAAU,EAC7B,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,UAAU,CAAC;WASF,OAAO,CACzB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,UAAU,GACxB,OAAO,CAAC,UAAU,CAAC;WASF,qBAAqB,CACvC,UAAU,EAAE,UAAU,EACtB,kBAAkB,EAAE,UAAU,EAC9B,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC;QACT,SAAS,EAAE,UAAU,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CAWH"}

package/src/lib/access/ecies.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockECIES = void 0;
+const service_provider_1 = require("../services/service.provider");
+/**
+ * ECIES service access for blocks to avoid circular dependencies
+ * Updated to use new @digitaldefiance/ecies-lib API
+ */
+class BlockECIES {
+    static async encrypt(receiverPublicKey, message) {
+        // Use encryptSimpleOrSingle (encryptSimple = true) from new ECIES service
+        return service_provider_1.ServiceProvider.getInstance().eciesService.encryptSimpleOrSingle(true, receiverPublicKey, message);
+    }
+    static async decrypt(privateKey, encryptedData) {
+        // Use decryptSimpleOrSingleWithHeader (decryptSimple = false) from new ECIES service
+        return service_provider_1.ServiceProvider.getInstance().eciesService.decryptSimpleOrSingleWithHeader(false, privateKey, encryptedData);
+    }
+    static async decryptWithComponents(privateKey, ephemeralPublicKey, iv, authTag, encrypted) {
+        const result = service_provider_1.ServiceProvider.getInstance().eciesService.decryptSingleWithComponents(privateKey, ephemeralPublicKey, iv, authTag, encrypted);
+        return result;
+    }
+}
+exports.BlockECIES = BlockECIES;
+//# sourceMappingURL=ecies.js.map

package/src/lib/access/ecies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecies.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/ecies.ts"],"names":[],"mappings":";;;AAAA,mEAA+D;AAE/D;;;GAGG;AACH,MAAa,UAAU;IACd,MAAM,CAAC,KAAK,CAAC,OAAO,CACzB,iBAA6B,EAC7B,OAAmB;QAEnB,0EAA0E;QAC1E,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,qBAAqB,CACrE,IAAI,EACJ,iBAAiB,EACjB,OAAO,CACR,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,OAAO,CACzB,UAAsB,EACtB,aAAyB;QAEzB,qFAAqF;QACrF,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAC/E,KAAK,EACL,UAAU,EACV,aAAa,CACd,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,qBAAqB,CACvC,UAAsB,EACtB,kBAA8B,EAC9B,EAAc,EACd,OAAmB,EACnB,SAAqB;QAKrB,MAAM,MAAM,GACV,kCAAe,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,2BAA2B,CACpE,UAAU,EACV,kBAAkB,EAClB,EAAE,EACF,OAAO,EACP,SAAS,CACV,CAAC;QACJ,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA7CD,gCA6CC"}

package/src/lib/access/index.d.ts

@@ -0,0 +1,4 @@
+export * from './checksum';
+export * from './ecies';
+export * from './tuple';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/access/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/src/lib/access/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./checksum"), exports);
+tslib_1.__exportStar(require("./ecies"), exports);
+tslib_1.__exportStar(require("./tuple"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/access/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,kDAAwB;AACxB,kDAAwB"}

package/src/lib/access/tuple.d.ts

@@ -0,0 +1,16 @@
+import { Member, PlatformID } from '@digitaldefiance/ecies-lib';
+import { EphemeralBlock } from '../blocks/ephemeral';
+import { RandomBlock } from '../blocks/random';
+import { WhitenedBlock } from '../blocks/whitened';
+import { IEphemeralBlock } from '../interfaces/blocks/ephemeral';
+import { ITuple } from '../interfaces/tuple';
+/**
+ * Tuple service access for blocks to avoid circular dependencies
+ */
+export declare class BlockTuple {
+    static getRandomBlockCount(dataLength: number): number;
+    static xorSourceToPrimeWhitened(sourceBlock: EphemeralBlock, whiteners: WhitenedBlock[], randomBlocks: RandomBlock[]): Promise<WhitenedBlock>;
+    static makeTupleFromSourceXor(sourceBlock: EphemeralBlock, whiteners: WhitenedBlock[], randomBlocks: RandomBlock[]): Promise<ITuple>;
+    static xorDestPrimeWhitenedToOwned<TID extends PlatformID = Uint8Array>(creator: Member<TID>, primeWhitened: WhitenedBlock, whiteners: WhitenedBlock[], randomBlocks: RandomBlock[]): Promise<IEphemeralBlock<TID>>;
+}
+//# sourceMappingURL=tuple.d.ts.map

package/src/lib/access/tuple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/tuple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C;;GAEG;AACH,qBAAa,UAAU;WACP,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;WAMzC,wBAAwB,CAC1C,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,aAAa,EAAE,EAC1B,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,aAAa,CAAC;WAQL,sBAAsB,CACxC,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,aAAa,EAAE,EAC1B,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,MAAM,CAAC;WAQE,2BAA2B,CAC7C,GAAG,SAAS,UAAU,GAAG,UAAU,EAEnC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EACpB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,aAAa,EAAE,EAC1B,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;CAQjC"}

package/src/lib/access/tuple.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockTuple = void 0;
+const service_provider_1 = require("../services/service.provider");
+/**
+ * Tuple service access for blocks to avoid circular dependencies
+ */
+class BlockTuple {
+    static getRandomBlockCount(dataLength) {
+        return service_provider_1.ServiceProvider.getInstance().tupleService.getRandomBlockCount(dataLength);
+    }
+    static async xorSourceToPrimeWhitened(sourceBlock, whiteners, randomBlocks) {
+        return service_provider_1.ServiceProvider.getInstance().tupleService.xorSourceToPrimeWhitened(sourceBlock, whiteners, randomBlocks);
+    }
+    static async makeTupleFromSourceXor(sourceBlock, whiteners, randomBlocks) {
+        return service_provider_1.ServiceProvider.getInstance().tupleService.makeTupleFromSourceXor(sourceBlock, whiteners, randomBlocks);
+    }
+    static async xorDestPrimeWhitenedToOwned(creator, primeWhitened, whiteners, randomBlocks) {
+        return service_provider_1.ServiceProvider.getInstance().tupleService.xorDestPrimeWhitenedToOwned(creator, primeWhitened, whiteners, randomBlocks);
+    }
+}
+exports.BlockTuple = BlockTuple;
+//# sourceMappingURL=tuple.js.map

package/src/lib/access/tuple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/access/tuple.ts"],"names":[],"mappings":";;;AAMA,mEAA+D;AAE/D;;GAEG;AACH,MAAa,UAAU;IACd,MAAM,CAAC,mBAAmB,CAAC,UAAkB;QAClD,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,mBAAmB,CACnE,UAAU,CACX,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAC1C,WAA2B,EAC3B,SAA0B,EAC1B,YAA2B;QAE3B,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,wBAAwB,CACxE,WAAW,EACX,SAAS,EACT,YAAY,CACb,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,sBAAsB,CACxC,WAA2B,EAC3B,SAA0B,EAC1B,YAA2B;QAE3B,OAAO,kCAAe,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,sBAAsB,CACtE,WAAW,EACX,SAAS,EACT,YAAY,CACb,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAG7C,OAAoB,EACpB,aAA4B,EAC5B,SAA0B,EAC1B,YAA2B;QAE3B,OAAO,kCAAe,CAAC,WAAW,EAAO,CAAC,YAAY,CAAC,2BAA2B,CAChF,OAAO,EACP,aAAa,EACb,SAAS,EACT,YAAY,CACoB,CAAC;IACrC,CAAC;CACF;AA9CD,gCA8CC"}

package/src/lib/blockMetadata.d.ts

@@ -0,0 +1,41 @@
+import BlockDataType from './enumerations/blockDataType';
+import { BlockSize } from './enumerations/blockSize';
+import BlockType from './enumerations/blockType';
+import { IBaseBlockMetadata } from './interfaces/blocks/metadata/blockMetadata';
+/**
+ * BlockMetadata provides utility functions for working with block metadata.
+ * These functions ensure consistent metadata handling across the system.
+ */
+export declare class BlockMetadata implements IBaseBlockMetadata {
+    private readonly _size;
+    private readonly _type;
+    private readonly _dataType;
+    private readonly _lengthWithoutPadding;
+    private readonly _dateCreated;
+    constructor(size: BlockSize, type: BlockType, dataType: BlockDataType, lengthWithoutPadding: number, dateCreated?: Date);
+    /**
+     * Convert metadata to JSON string
+     * @returns JSON representation of metadata
+     */
+    toJson(): string;
+    static fromJsonValidator(data: any): void;
+    static fromJsonAdditionalData<T extends Record<string, any>>(data: any): T;
+    /**
+     * Parse metadata from JSON representation.
+     * Handles:
+     * 1. Type conversion
+     * 2. Optional fields
+     * 3. Custom attributes
+     *
+     * @param json - JSON string containing metadata
+     * @returns Parsed metadata object
+     * @throws If JSON is invalid or required fields are missing
+     */
+    static fromJson<B extends BlockMetadata, T extends Record<string, any>>(json: string): B & T;
+    get size(): BlockSize;
+    get type(): BlockType;
+    get dataType(): BlockDataType;
+    get lengthWithoutPadding(): number;
+    get dateCreated(): Date;
+}
+//# sourceMappingURL=blockMetadata.d.ts.map

package/src/lib/blockMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockMetadata.d.ts","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/blockMetadata.ts"],"names":[],"mappings":"AACA,OAAO,aAAa,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,SAAS,MAAM,0BAA0B,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAEhF;;;GAGG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAO;gBAGlC,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,aAAa,EACvB,oBAAoB,EAAE,MAAM,EAC5B,WAAW,OAAa;IAS1B;;;OAGG;IACI,MAAM,IAAI,MAAM;WAUT,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;WASlC,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChE,IAAI,EAAE,GAAG,GACR,CAAC;IAIJ;;;;;;;;;;OAUG;WACW,QAAQ,CACpB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC;IAyBtB,IAAW,IAAI,IAAI,SAAS,CAE3B;IACD,IAAW,IAAI,IAAI,SAAS,CAE3B;IACD,IAAW,QAAQ,IAAI,aAAa,CAEnC;IACD,IAAW,oBAAoB,IAAI,MAAM,CAExC;IACD,IAAW,WAAW,IAAI,IAAI,CAE7B;CACF"}

package/src/lib/blockMetadata.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockMetadata = void 0;
+const blockMetadataErrorType_1 = require("./enumerations/blockMetadataErrorType");
+const block_1 = require("./errors/block");
+/**
+ * BlockMetadata provides utility functions for working with block metadata.
+ * These functions ensure consistent metadata handling across the system.
+ */
+class BlockMetadata {
+    constructor(size, type, dataType, lengthWithoutPadding, dateCreated = new Date()) {
+        this._size = size;
+        this._type = type;
+        this._dataType = dataType;
+        this._lengthWithoutPadding = lengthWithoutPadding;
+        this._dateCreated = dateCreated;
+    }
+    /**
+     * Convert metadata to JSON string
+     * @returns JSON representation of metadata
+     */
+    toJson() {
+        return JSON.stringify({
+            size: this.size,
+            type: this.type,
+            dataType: this.dataType,
+            lengthWithoutPadding: this.lengthWithoutPadding,
+            dateCreated: this.dateCreated,
+        });
+    }
+    static fromJsonValidator(data) {
+        // Validate required fields
+        if (!data.size || !data.type || !data.dataType || !data.dateCreated) {
+            throw new block_1.BlockMetadataError(blockMetadataErrorType_1.BlockMetadataErrorType.MissingRequiredMetadata);
+        }
+    }
+    static fromJsonAdditionalData(data) {
+        return {};
+    }
+    /**
+     * Parse metadata from JSON representation.
+     * Handles:
+     * 1. Type conversion
+     * 2. Optional fields
+     * 3. Custom attributes
+     *
+     * @param json - JSON string containing metadata
+     * @returns Parsed metadata object
+     * @throws If JSON is invalid or required fields are missing
+     */
+    static fromJson(json) {
+        try {
+            const data = JSON.parse(json);
+            // Validate required fields
+            this.fromJsonValidator(data);
+            // Convert types and maintain extensibility
+            return {
+                ...data,
+                ...this.fromJsonAdditionalData(data),
+                dateCreated: data.dateCreated, // Already a string
+                size: data.size,
+                type: data.type,
+                dataType: data.dataType,
+                lengthWithoutPadding: data.lengthWithoutPadding,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to parse metadata: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    get size() {
+        return this._size;
+    }
+    get type() {
+        return this._type;
+    }
+    get dataType() {
+        return this._dataType;
+    }
+    get lengthWithoutPadding() {
+        return this._lengthWithoutPadding;
+    }
+    get dateCreated() {
+        return this._dateCreated;
+    }
+}
+exports.BlockMetadata = BlockMetadata;
+//# sourceMappingURL=blockMetadata.js.map

package/src/lib/blockMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockMetadata.js","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/blockMetadata.ts"],"names":[],"mappings":";;;AAEA,kFAA+E;AAG/E,0CAAoD;AAGpD;;;GAGG;AACH,MAAa,aAAa;IAOxB,YACE,IAAe,EACf,IAAe,EACf,QAAuB,EACvB,oBAA4B,EAC5B,WAAW,GAAG,IAAI,IAAI,EAAE;QAExB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAED;;;OAGG;IACI,MAAM;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,IAAS;QACvC,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpE,MAAM,IAAI,0BAAkB,CAC1B,+CAAsB,CAAC,uBAAuB,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,sBAAsB,CAClC,IAAS;QAET,OAAO,EAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,QAAQ,CAGpB,IAAY;QACZ,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAE9B,2BAA2B;YAC3B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAE7B,2CAA2C;YAC3C,OAAO;gBACL,GAAG,IAAI;gBACP,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC;gBACpC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,mBAAmB;gBAClD,IAAI,EAAE,IAAI,CAAC,IAAiB;gBAC5B,IAAI,EAAE,IAAI,CAAC,IAAiB;gBAC5B,QAAQ,EAAE,IAAI,CAAC,QAAyB;gBACxC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;aACvC,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,6BACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAC3C,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IACD,IAAW,oBAAoB;QAC7B,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IACD,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF;AAxGD,sCAwGC"}

package/src/lib/blockPaddingTransform.d.ts

@@ -0,0 +1,11 @@
+import { Transform, TransformCallback } from 'stream';
+import { BlockSize } from './enumerations/blockSize';
+declare class BlockPaddingTransform extends Transform {
+    private readonly blockSize;
+    private buffer;
+    constructor(blockSize: BlockSize);
+    _transform(chunk: Buffer, encoding: string, callback: TransformCallback): void;
+    _flush(callback: TransformCallback): void;
+}
+export default BlockPaddingTransform;
+//# sourceMappingURL=blockPaddingTransform.d.ts.map

package/src/lib/blockPaddingTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockPaddingTransform.d.ts","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/blockPaddingTransform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,cAAM,qBAAsB,SAAQ,SAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,EAAE,SAAS;IAMvB,UAAU,CACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,iBAAiB,GAC1B,IAAI;IAYE,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;CAUnD;AAED,eAAe,qBAAqB,CAAC"}

package/src/lib/blockPaddingTransform.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const crypto_1 = require("crypto");
+const stream_1 = require("stream");
+class BlockPaddingTransform extends stream_1.Transform {
+    constructor(blockSize) {
+        super();
+        this.blockSize = blockSize;
+        this.buffer = Buffer.alloc(0);
+    }
+    _transform(chunk, encoding, callback) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        while (this.buffer.length >= this.blockSize) {
+            const block = this.buffer.subarray(0, this.blockSize);
+            this.buffer = this.buffer.subarray(this.blockSize);
+            this.push(block);
+        }
+        callback();
+    }
+    _flush(callback) {
+        if (this.buffer.length > 0) {
+            const paddingSize = this.blockSize - (this.buffer.length % this.blockSize);
+            const padding = (0, crypto_1.randomBytes)(paddingSize);
+            const paddedBlock = Buffer.concat([this.buffer, padding]);
+            this.push(paddedBlock);
+        }
+        callback();
+    }
+}
+exports.default = BlockPaddingTransform;
+//# sourceMappingURL=blockPaddingTransform.js.map

package/src/lib/blockPaddingTransform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockPaddingTransform.js","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/blockPaddingTransform.ts"],"names":[],"mappings":";;AAAA,mCAAqC;AACrC,mCAAsD;AAGtD,MAAM,qBAAsB,SAAQ,kBAAS;IAI3C,YAAY,SAAoB;QAC9B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,SAAmB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAEQ,UAAU,CACjB,KAAa,EACb,QAAgB,EAChB,QAA2B;QAE3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAElD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QAED,QAAQ,EAAE,CAAC;IACb,CAAC;IAEQ,MAAM,CAAC,QAA2B;QACzC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,WAAW,GACf,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,IAAA,oBAAW,EAAC,WAAW,CAAC,CAAC;YACzC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzB,CAAC;QACD,QAAQ,EAAE,CAAC;IACb,CAAC;CACF;AAED,kBAAe,qBAAqB,CAAC"}