@brightchain/brightchain-lib 0.30.1 → 0.31.0

package/README.md

@@ -8,21 +8,30 @@
 ## 🌟 Key Features
 
 ### 🔐 Unified Cryptographic Architecture
+
 - **ECIES Integration**: Elliptic Curve Integrated Encryption Scheme for secure messaging and file storage
 - **Homomorphic Encryption**: Paillier keys derived from ECDH keypairs for secure voting and computation
 - **Brokered Anonymity**: Forward Error Correction with BrightTrust-based identity recovery
 
 ### 📦 Owner-Free File System (OFFS)
+
 - **TUPLE Storage**: All data stored as 3-block TUPLEs (data + 2 randomizers) for complete plausible deniability
 - **Block-based Storage**: Files broken into encrypted blocks with XOR randomization
 - **Deduplication**: SHA-512 based block identification prevents duplicate storage
 - **Distributed Architecture**: Decentralized storage with no single point of failure
 - **Legal Protection**: True owner-free storage ensures no single party can be compelled to produce meaningful data
 
-### ⚡ Energy-Efficient Design
-- **Joule Currency**: All operations measured in actual energy consumption
-- **Proof of Work Throttling**: Bad actors face increased computational requirements
-- **Sustainable Operations**: Optimized for minimal energy consumption
+### ⚡ Asset Accounts & Metering
+
+- **Generic `AssetAccount` / `AssetAccountStore`**: A single parameterized shape tracks any fungible asset (joules, tokens, credits). Each account is keyed by `memberId + assetId`; balances are stored as `bigint` microunits for lossless precision.
+- **`EnergyAccount` / `EnergyAccountStore`**: Specialization for the `'joule'` asset. Balances are expressed in microjoules (1 J = 1 000 000 µJ). Legacy numeric-joule DTOs are automatically migrated on read.
+- **Backward-compatible hydration**: `AssetAccount.fromDto()` handles missing `assetId` (defaults to `'joule'`) and numeric balances (multiplied by `JOULE_MICROUNITS_PER_UNIT = 1_000_000n`), so existing persisted data is transparently upgraded.
+- **`ITypedCollection<TStored, TTyped>`**: Storage abstraction in `brightchain-lib` that `brightchain-db` satisfies. `EnergyAccountStore` depends only on this interface, keeping the library free of database imports.
+- **Joule Currency**: All operations are measured and throttled using actual energy-unit accounting.
+- **Proof of Work Throttling**: Bad actors face increased computational requirements.
+- **Sustainable Operations**: Optimized for minimal energy consumption.
+
+> See specs: [`asset-account-store-generalization`](.kiro/specs/asset-account-store-generalization/), [`programmable-asset-ledger`](.kiro/specs/programmable-asset-ledger/), [`metering-log`](.kiro/specs/metering-log/).
 
 ## 🚀 Quick Start
 
@@ -136,6 +145,7 @@ try {
 ```
 
 **Error Types:**
+
 - `BrightChainError`: Base class for all BrightChain errors
 - `ValidationError`: Input validation failures
 - `ChecksumError`: Checksum calculation or validation errors
@@ -145,6 +155,7 @@ try {
 
 **Error Context:**
 All BrightChain errors include:
+
 - `type`: Error type identifier
 - `message`: Human-readable error message
 - `context`: Additional context (parameters, state, etc.)
@@ -228,11 +239,13 @@ try {
 ```
 
 **Classes with Factory Patterns:**
+
 - `MemberDocument`: Use `MemberDocument.create()`
 - `BaseBlock` subclasses: Use `BlockType.from()` or specific factory methods
 - `Checksum`: Use `Checksum.fromBuffer()`, `Checksum.fromUint8Array()`, or `Checksum.fromHex()`
 
 **Why Factory Patterns?**
+
 - Ensures proper validation during object creation
 - Prevents invalid object states
 - Provides clear, documented creation APIs
@@ -249,6 +262,7 @@ If you're upgrading from BrightChain v1.x, see our comprehensive [Migration Guid
 - Breaking changes documentation
 
 **Quick Migration Checklist:**
+
 - [ ] Replace `ChecksumBuffer`/`ChecksumUint8Array` with `Checksum` class
 - [ ] Update direct constructor calls to use factory methods
 - [ ] Add type parameters to `BlockHandle` declarations
@@ -288,6 +302,7 @@ const originalData = await tupleService.retrieveTuple(
 ```
 
 **Why TUPLEs?**
+
 - **Plausible Deniability**: No single block contains identifiable data
 - **Legal Protection**: Node operators cannot be compelled to produce meaningful data
 - **Complete OFF Compliance**: All data stored as 3 blocks (not just 2)
@@ -449,6 +464,7 @@ All blocks follow a layered structure:
 ```
 
 **Base Header includes:**
+
 - Block Type
 - Block Size  
 - Data Type
@@ -456,6 +472,7 @@ All blocks follow a layered structure:
 - Date Created
 
 **Encrypted Block Header adds:**
+
 - Encryption Type (1 byte)
 - Recipient GUID (16 bytes)
 - Ephemeral Public Key (65 bytes)
@@ -589,49 +606,61 @@ For detailed naming conventions and terminology, see [NAMING_CONVENTIONS.md](./N
 ### Core Classes
 
 #### BrightChain
+
 Main interface for file storage and retrieval.
 
 **Methods:**
+
 - `storeFile(data: Uint8Array, fileName?: string): Promise<FileReceipt>`
 - `retrieveFile(receipt: FileReceipt): Promise<Uint8Array>`
 
 #### BaseBlock
+
 Abstract base class for all block types.
 
 **Properties:**
+
 - `blockSize: BlockSize` - Size category of the block
 - `blockType: BlockType` - Type of block (raw, encrypted, CBL, etc)
 - `idChecksum: ChecksumUint8Array` - Unique identifier
 - `dateCreated: Date` - Creation timestamp
 
 **Methods:**
+
 - `validateAsync(): Promise<void>` - Async validation
 - `validateSync(): void` - Sync validation
 
 #### EncryptedBlock
+
 Encrypted block implementation with ECIES.
 
 **Properties:**
+
 - `encryptionType: BlockEncryptionType` - Single or multi-recipient
 - `recipients: Array<TID>` - List of recipient IDs
 - `recipientWithKey: Member<TID>` - Member with decryption key
 
 **Methods:**
+
 - `decrypt<D>(newBlockType: BlockType): Promise<D>` - Decrypt block
 
 ### Services
 
 #### ChecksumService
+
 Handles SHA-512 checksum operations.
 
 **Methods:**
+
 - `calculateChecksum(data: Uint8Array): ChecksumUint8Array`
 - `checksumToHexString(checksum: ChecksumUint8Array): ChecksumString`
 
 #### ECIESService  
+
 Provides ECIES encryption/decryption.
 
 **Methods:**
+
 - `encryptSimpleOrSingle(simple: boolean, publicKey: Uint8Array, data: Uint8Array): Promise<Uint8Array>`
 - `decryptSimpleOrSingle(simple: boolean, privateKey: Uint8Array, data: Uint8Array): Promise<Uint8Array>`
 
@@ -674,4 +703,4 @@ BrightChain is actively developed with ambitious goals:
 
 ---
 
-**BrightChain** - *Illuminating the future of decentralized digital governance*
+**BrightChain** - *Illuminating the future of decentralized digital governance*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightchain/brightchain-lib",
-  "version": "0.30.1",
+  "version": "0.31.0",
   "description": "BrightChain core library - browser-compatible blockchain storage",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -68,11 +68,11 @@
   "dependencies": {
     "@digitaldefiance/branded-interface": "0.0.5",
     "@digitaldefiance/bzip2-wasm": "^1.1.1",
-    "@digitaldefiance/ecies-lib": "5.1.4",
-    "@digitaldefiance/i18n-lib": "4.7.3",
+    "@digitaldefiance/ecies-lib": "5.1.6",
+    "@digitaldefiance/i18n-lib": "4.7.4",
     "@digitaldefiance/reed-solomon-erasure.wasm": "^1.0.2",
     "@digitaldefiance/secrets": "^2.0.7",
-    "@digitaldefiance/suite-core-lib": "4.26.8",
+    "@digitaldefiance/suite-core-lib": "4.27.2",
     "@ethereumjs/wallet": "^10.0.0",
     "@noble/hashes": "^1.8.0",
     "@peculiar/asn1-pfx": "^2.6.1",

package/src/browser.d.ts

@@ -11,6 +11,7 @@ export { RawDataBlock } from './lib/blocks/rawData';
 export { ServiceLocator } from './lib/services/serviceLocator';
 export { uint8ArrayToHex } from './lib/utils/checksumUtils';
 export { XorLengthMismatchError, constantTimeXor, constantTimeXorMultiple, } from './lib/utils/constantTimeXor';
+export { BlockECIES } from './lib/access/ecies';
 export { ServiceProvider } from './lib/services/service.provider';
 export { initializeBrightChain } from './lib/init';
 export { Checksum } from './lib/types/checksum';
@@ -19,6 +20,9 @@ export type { BlockId } from './lib/interfaces/branded/primitives/blockId';
 export { CBLService } from './lib/services/cblService';
 export { ChecksumService } from './lib/services/checksum.service';
 export { MessageCBLService } from './lib/services/messaging/messageCBLService';
+export { joulesToMicrojoules, microjoulesToJoules, } from './lib/asset/microunits';
+export { formatJoule } from './lib/joule/formatJoule';
+export { DefaultDurabilityLevel, DurabilityLevel, DurabilityMap, getParityCountForDurability, } from './lib/enumerations/durabilityLevel';
 export { BrightChainStrings } from './lib/enumerations/brightChainStrings';
 export { DeliveryStatus } from './lib/enumerations/messaging/deliveryStatus';
 export { MessageEncryptionScheme } from './lib/enumerations/messaging/messageEncryptionScheme';
@@ -27,6 +31,9 @@ export type { IMessageMetadata } from './lib/interfaces/messaging/messageMetadat
 export type { IMessageCBLOptions } from './lib/services/messaging/messageCBLService';
 export type { BlockInfo, FileReceipt } from './lib/brightChain';
 export type { CBLMagnetComponents, CBLStorageResult, CBLWhiteningOptions, } from './lib/interfaces/storage/cblWhitening';
+export { InMemoryHeadRegistry } from './lib/db/inMemoryHeadRegistry';
+export type { IHeadRegistry } from './lib/interfaces/storage/headRegistry';
+export * from './lib/joule';
 export type { ILedgerEntry } from './lib/interfaces/ledger/ledgerEntry';
 export type { ILedgerMetadata } from './lib/interfaces/ledger/ledgerMetadata';
 export type { ILedgerSignatureVerifier } from './lib/interfaces/ledger/ledgerSignatureVerifier';

package/src/browser.d.ts.map

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

package/src/browser.js

@@ -2,7 +2,7 @@
 // Minimal browser-compatible exports
 // Only exports core functionality that works without Node.js modules
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GovernancePayloadSerializer = exports.AuthorizedSignerSet = exports.SignerStatus = exports.SignerRole = exports.GovernanceActionType = exports.QuorumType = exports.MemberSignerAdapter = exports.LedgerEntrySerializer = exports.LedgerChainValidator = exports.Ledger = exports.EciesSignatureVerifier = exports.BrowserSignatureVerifier = exports.MessagePriority = exports.MessageEncryptionScheme = exports.DeliveryStatus = exports.BrightChainStrings = exports.MessageCBLService = exports.ChecksumService = exports.CBLService = exports.asBlockId = exports.Checksum = exports.initializeBrightChain = exports.ServiceProvider = exports.constantTimeXorMultiple = exports.constantTimeXor = exports.XorLengthMismatchError = exports.uint8ArrayToHex = exports.ServiceLocator = exports.RawDataBlock = exports.RandomBlock = exports.isBlockHandle = exports.createBlockHandle = exports.BaseBlock = exports.VALIDATION = exports.TUPLE = exports.THEME_COLORS = exports.CONSTANTS = void 0;
+exports.GovernancePayloadSerializer = exports.AuthorizedSignerSet = exports.SignerStatus = exports.SignerRole = exports.GovernanceActionType = exports.QuorumType = exports.MemberSignerAdapter = exports.LedgerEntrySerializer = exports.LedgerChainValidator = exports.Ledger = exports.EciesSignatureVerifier = exports.BrowserSignatureVerifier = exports.InMemoryHeadRegistry = exports.MessagePriority = exports.MessageEncryptionScheme = exports.DeliveryStatus = exports.BrightChainStrings = exports.getParityCountForDurability = exports.DurabilityMap = exports.DurabilityLevel = exports.DefaultDurabilityLevel = exports.formatJoule = exports.microjoulesToJoules = exports.joulesToMicrojoules = exports.MessageCBLService = exports.ChecksumService = exports.CBLService = exports.asBlockId = exports.Checksum = exports.initializeBrightChain = exports.ServiceProvider = exports.BlockECIES = exports.constantTimeXorMultiple = exports.constantTimeXor = exports.XorLengthMismatchError = exports.uint8ArrayToHex = exports.ServiceLocator = exports.RawDataBlock = exports.RandomBlock = exports.isBlockHandle = exports.createBlockHandle = exports.BaseBlock = exports.VALIDATION = exports.TUPLE = exports.THEME_COLORS = exports.CONSTANTS = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/brightChain"), exports);
 tslib_1.__exportStar(require("./lib/enumerations/blockSize"), exports);
@@ -36,6 +36,9 @@ var constantTimeXor_1 = require("./lib/utils/constantTimeXor");
 Object.defineProperty(exports, "XorLengthMismatchError", { enumerable: true, get: function () { return constantTimeXor_1.XorLengthMismatchError; } });
 Object.defineProperty(exports, "constantTimeXor", { enumerable: true, get: function () { return constantTimeXor_1.constantTimeXor; } });
 Object.defineProperty(exports, "constantTimeXorMultiple", { enumerable: true, get: function () { return constantTimeXor_1.constantTimeXorMultiple; } });
+// Export ECIES block encryption utility (browser-compatible)
+var ecies_1 = require("./lib/access/ecies");
+Object.defineProperty(exports, "BlockECIES", { enumerable: true, get: function () { return ecies_1.BlockECIES; } });
 // Export ServiceProvider for advanced usage
 var service_provider_1 = require("./lib/services/service.provider");
 Object.defineProperty(exports, "ServiceProvider", { enumerable: true, get: function () { return service_provider_1.ServiceProvider; } });
@@ -55,6 +58,18 @@ var checksum_service_1 = require("./lib/services/checksum.service");
 Object.defineProperty(exports, "ChecksumService", { enumerable: true, get: function () { return checksum_service_1.ChecksumService; } });
 var messageCBLService_1 = require("./lib/services/messaging/messageCBLService");
 Object.defineProperty(exports, "MessageCBLService", { enumerable: true, get: function () { return messageCBLService_1.MessageCBLService; } });
+// Export asset / joule unit conversion helpers (pure math, browser-safe)
+var microunits_1 = require("./lib/asset/microunits");
+Object.defineProperty(exports, "joulesToMicrojoules", { enumerable: true, get: function () { return microunits_1.joulesToMicrojoules; } });
+Object.defineProperty(exports, "microjoulesToJoules", { enumerable: true, get: function () { return microunits_1.microjoulesToJoules; } });
+var formatJoule_1 = require("./lib/joule/formatJoule");
+Object.defineProperty(exports, "formatJoule", { enumerable: true, get: function () { return formatJoule_1.formatJoule; } });
+// Export durability level enum and helpers (browser-safe)
+var durabilityLevel_1 = require("./lib/enumerations/durabilityLevel");
+Object.defineProperty(exports, "DefaultDurabilityLevel", { enumerable: true, get: function () { return durabilityLevel_1.DefaultDurabilityLevel; } });
+Object.defineProperty(exports, "DurabilityLevel", { enumerable: true, get: function () { return durabilityLevel_1.DurabilityLevel; } });
+Object.defineProperty(exports, "DurabilityMap", { enumerable: true, get: function () { return durabilityLevel_1.DurabilityMap; } });
+Object.defineProperty(exports, "getParityCountForDurability", { enumerable: true, get: function () { return durabilityLevel_1.getParityCountForDurability; } });
 // Export messaging enums and interfaces
 var brightChainStrings_1 = require("./lib/enumerations/brightChainStrings");
 Object.defineProperty(exports, "BrightChainStrings", { enumerable: true, get: function () { return brightChainStrings_1.BrightChainStrings; } });
@@ -64,6 +79,11 @@ var messageEncryptionScheme_1 = require("./lib/enumerations/messaging/messageEnc
 Object.defineProperty(exports, "MessageEncryptionScheme", { enumerable: true, get: function () { return messageEncryptionScheme_1.MessageEncryptionScheme; } });
 var messagePriority_1 = require("./lib/enumerations/messaging/messagePriority");
 Object.defineProperty(exports, "MessagePriority", { enumerable: true, get: function () { return messagePriority_1.MessagePriority; } });
+// Head registry (browser-compatible in-memory implementation)
+var inMemoryHeadRegistry_1 = require("./lib/db/inMemoryHeadRegistry");
+Object.defineProperty(exports, "InMemoryHeadRegistry", { enumerable: true, get: function () { return inMemoryHeadRegistry_1.InMemoryHeadRegistry; } });
+// Joule resource-credit primitives (browser-safe)
+tslib_1.__exportStar(require("./lib/joule"), exports);
 var browserSignatureVerifier_1 = require("./lib/ledger/browserSignatureVerifier");
 Object.defineProperty(exports, "BrowserSignatureVerifier", { enumerable: true, get: function () { return browserSignatureVerifier_1.BrowserSignatureVerifier; } });
 var eciesSignatureVerifier_1 = require("./lib/ledger/eciesSignatureVerifier");

package/src/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":";AAAA,qCAAqC;AACrC,qEAAqE;;;;AAErE,4DAAkC;AAClC,uEAA6C;AAC7C,4EAAkD;AAClD,8EAAoD;AACpD,wEAA8C;AAE9C,mBAAmB;AACnB,6CAA6E;AAApE,sGAAA,SAAS,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,kGAAA,KAAK,OAAA;AAAE,uGAAA,UAAU,OAAA;AAEnD,qCAAqC;AACrC,0CAA8C;AAArC,iGAAA,SAAS,OAAA;AAClB,8CAI6B;AAH3B,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AAGf,8CAAkD;AAAzC,qGAAA,WAAW,OAAA;AACpB,gDAAoD;AAA3C,uGAAA,YAAY,OAAA;AAErB,wBAAwB;AACxB,gEAA+D;AAAtD,gHAAA,cAAc,OAAA;AAEvB,2BAA2B;AAC3B,2DAA4D;AAAnD,gHAAA,eAAe,OAAA;AAExB,0DAA0D;AAC1D,+DAIqC;AAHnC,yHAAA,sBAAsB,OAAA;AACtB,kHAAA,eAAe,OAAA;AACf,0HAAA,uBAAuB,OAAA;AAGzB,4CAA4C;AAC5C,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AAExB,4CAA4C;AAC5C,mCAAmD;AAA1C,6GAAA,qBAAqB,OAAA;AAE9B,kDAAkD;AAClD,iDAAgD;AAAvC,oGAAA,QAAQ,OAAA;AAEjB,0CAA0C;AAC1C,uEAAwE;AAA/D,oGAAA,SAAS,OAAA;AAGlB,kBAAkB;AAClB,wDAAuD;AAA9C,wGAAA,UAAU,OAAA;AACnB,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AACxB,gFAA+E;AAAtE,sHAAA,iBAAiB,OAAA;AAE1B,wCAAwC;AACxC,4EAA2E;AAAlE,wHAAA,kBAAkB,OAAA;AAC3B,8EAA6E;AAApE,gHAAA,cAAc,OAAA;AACvB,gGAA+F;AAAtF,kIAAA,uBAAuB,OAAA;AAChC,gFAA+E;AAAtE,kHAAA,eAAe,OAAA;AAsBxB,kFAAiF;AAAxE,oIAAA,wBAAwB,OAAA;AACjC,8EAA6E;AAApE,gIAAA,sBAAsB,OAAA;AAC/B,8CAA6C;AAApC,gGAAA,MAAM,OAAA;AACf,0EAAyE;AAAhE,4HAAA,oBAAoB,OAAA;AAC7B,4EAA2E;AAAlE,8HAAA,qBAAqB,OAAA;AAC9B,wEAAuE;AAA9D,0HAAA,mBAAmB,OAAA;AAI5B,+EAAuE;AAA9D,+GAAA,UAAU,OAAA;AAEnB,6EAAgF;AAAvE,wHAAA,oBAAoB,OAAA;AAG7B,iEAAgE;AAAvD,wGAAA,UAAU,OAAA;AACnB,qEAAoE;AAA3D,4GAAA,YAAY,OAAA;AACrB,wEAAuE;AAA9D,0HAAA,mBAAmB,OAAA;AAC5B,wFAAuF;AAA9E,0IAAA,2BAA2B,OAAA"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":";AAAA,qCAAqC;AACrC,qEAAqE;;;;AAErE,4DAAkC;AAClC,uEAA6C;AAC7C,4EAAkD;AAClD,8EAAoD;AACpD,wEAA8C;AAE9C,mBAAmB;AACnB,6CAA6E;AAApE,sGAAA,SAAS,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,kGAAA,KAAK,OAAA;AAAE,uGAAA,UAAU,OAAA;AAEnD,qCAAqC;AACrC,0CAA8C;AAArC,iGAAA,SAAS,OAAA;AAClB,8CAI6B;AAH3B,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AAGf,8CAAkD;AAAzC,qGAAA,WAAW,OAAA;AACpB,gDAAoD;AAA3C,uGAAA,YAAY,OAAA;AAErB,wBAAwB;AACxB,gEAA+D;AAAtD,gHAAA,cAAc,OAAA;AAEvB,2BAA2B;AAC3B,2DAA4D;AAAnD,gHAAA,eAAe,OAAA;AAExB,0DAA0D;AAC1D,+DAIqC;AAHnC,yHAAA,sBAAsB,OAAA;AACtB,kHAAA,eAAe,OAAA;AACf,0HAAA,uBAAuB,OAAA;AAGzB,6DAA6D;AAC7D,4CAAgD;AAAvC,mGAAA,UAAU,OAAA;AAEnB,4CAA4C;AAC5C,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AAExB,4CAA4C;AAC5C,mCAAmD;AAA1C,6GAAA,qBAAqB,OAAA;AAE9B,kDAAkD;AAClD,iDAAgD;AAAvC,oGAAA,QAAQ,OAAA;AAEjB,0CAA0C;AAC1C,uEAAwE;AAA/D,oGAAA,SAAS,OAAA;AAGlB,kBAAkB;AAClB,wDAAuD;AAA9C,wGAAA,UAAU,OAAA;AACnB,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AACxB,gFAA+E;AAAtE,sHAAA,iBAAiB,OAAA;AAE1B,yEAAyE;AACzE,qDAGgC;AAF9B,iHAAA,mBAAmB,OAAA;AACnB,iHAAA,mBAAmB,OAAA;AAErB,uDAAsD;AAA7C,0GAAA,WAAW,OAAA;AAEpB,0DAA0D;AAC1D,sEAK4C;AAJ1C,yHAAA,sBAAsB,OAAA;AACtB,kHAAA,eAAe,OAAA;AACf,gHAAA,aAAa,OAAA;AACb,8HAAA,2BAA2B,OAAA;AAG7B,wCAAwC;AACxC,4EAA2E;AAAlE,wHAAA,kBAAkB,OAAA;AAC3B,8EAA6E;AAApE,gHAAA,cAAc,OAAA;AACvB,gGAA+F;AAAtF,kIAAA,uBAAuB,OAAA;AAChC,gFAA+E;AAAtE,kHAAA,eAAe,OAAA;AAYxB,8DAA8D;AAC9D,sEAAqE;AAA5D,4HAAA,oBAAoB,OAAA;AAG7B,kDAAkD;AAClD,sDAA4B;AAY5B,kFAAiF;AAAxE,oIAAA,wBAAwB,OAAA;AACjC,8EAA6E;AAApE,gIAAA,sBAAsB,OAAA;AAC/B,8CAA6C;AAApC,gGAAA,MAAM,OAAA;AACf,0EAAyE;AAAhE,4HAAA,oBAAoB,OAAA;AAC7B,4EAA2E;AAAlE,8HAAA,qBAAqB,OAAA;AAC9B,wEAAuE;AAA9D,0HAAA,mBAAmB,OAAA;AAI5B,+EAAuE;AAA9D,+GAAA,UAAU,OAAA;AAEnB,6EAAgF;AAAvE,wHAAA,oBAAoB,OAAA;AAG7B,iEAAgE;AAAvD,wGAAA,UAAU,OAAA;AACnB,qEAAoE;AAA3D,4GAAA,YAAY,OAAA;AACrB,wEAAuE;AAA9D,0HAAA,mBAAmB,OAAA;AAC5B,wFAAuF;AAA9E,0IAAA,2BAA2B,OAAA"}

package/src/lib/asset/assetAccount.d.ts

@@ -0,0 +1,66 @@
+import { IAssetAccount, IAssetAccountDto } from '../interfaces/assetAccount';
+import { Checksum } from '../types/checksum';
+declare const BIGINT_FIELDS: readonly ["balance", "earned", "spent", "reserved"];
+type BigIntField = (typeof BIGINT_FIELDS)[number];
+/**
+ * Hydrate a raw DTO record into a canonical {@link IAssetAccountDto}.
+ *
+ * Handles two legacy markers introduced before the
+ * `asset-account-store-generalization` refactor:
+ *
+ *  - **missing `assetId`** → defaults to `'joule'`.
+ *  - **`number` balance fields** → multiplied by
+ *    {@link JOULE_MICROUNITS_PER_UNIT} (rounded) and stored as decimal-
+ *    string `bigint` microunits.
+ *
+ * Already-upgraded DTOs round-trip unchanged. The function never throws —
+ * unrecognized field shapes coerce to `'0'` so the caller gets a fully
+ * populated DTO it can persist on next write.
+ *
+ * @see asset-account-store-generalization spec, Requirements 1.4, 2.5, 2.6.
+ */
+export declare function hydrateAssetAccountDto(raw: Record<string, unknown>): IAssetAccountDto;
+/**
+ * Generalized per-(member, asset) account.
+ *
+ * `bigint` microunit balances eliminate floating-point drift from
+ * charge / credit paths. The legacy {@link EnergyAccount} class is
+ * preserved untouched during this additive phase; a future phase will
+ * fold it onto this base via re-export alias.
+ *
+ * @see asset-account-store-generalization spec, Phase 3.
+ */
+export declare class AssetAccount implements IAssetAccount {
+    readonly memberId: Checksum;
+    readonly assetId: string;
+    readonly createdAt: Date;
+    balance: bigint;
+    earned: bigint;
+    spent: bigint;
+    reserved: bigint;
+    reputation: number;
+    lastUpdated: Date;
+    constructor(memberId: Checksum, assetId?: string, createdAt?: Date, balance?: bigint, earned?: bigint, spent?: bigint, reserved?: bigint, reputation?: number, lastUpdated?: Date);
+    /** Available = balance - reserved, floored at 0. */
+    get availableBalance(): bigint;
+    /** Net = earned - spent. May be negative. */
+    get netAsset(): bigint;
+    canAfford(amount: bigint): boolean;
+    reserve(amount: bigint): void;
+    release(amount: bigint): void;
+    charge(amount: bigint): void;
+    credit(amount: bigint): void;
+    updateReputation(newReputation: number): void;
+    toDto(): IAssetAccountDto;
+    /**
+     * Build an {@link AssetAccount} from a DTO. Accepts both fully-upgraded
+     * {@link IAssetAccountDto} and legacy `IEnergyAccountDto`-shaped records:
+     * the input is run through {@link hydrateAssetAccountDto} first.
+     */
+    static fromDto(dto: Record<string, unknown>): AssetAccount;
+    toJson(): string;
+    static fromJson(json: string): AssetAccount;
+}
+export declare const ASSET_ACCOUNT_BIGINT_FIELDS: readonly BigIntField[];
+export {};
+//# sourceMappingURL=assetAccount.d.ts.map

package/src/lib/asset/assetAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetAccount.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/assetAccount.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,QAAA,MAAM,aAAa,qDAAsD,CAAC;AAC1E,KAAK,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAWlD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,gBAAgB,CAsClB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAa,YAAW,aAAa;aAS9B,QAAQ,EAAE,QAAQ;aAClB,OAAO,EAAE,MAAM;aACf,SAAS,EAAE,IAAI;IAV1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC;gBAGP,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,MAAuB,EAChC,SAAS,GAAE,IAAiB,EAC5C,OAAO,GAAE,MAAW,EACpB,MAAM,GAAE,MAAW,EACnB,KAAK,GAAE,MAAW,EAClB,QAAQ,GAAE,MAAW,EACrB,UAAU,SAAM,EAChB,WAAW,CAAC,EAAE,IAAI;IAoBpB,oDAAoD;IACpD,IAAI,gBAAgB,IAAI,MAAM,CAG7B;IAED,6CAA6C;IAC7C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKlC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa7B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM7B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAc5B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5B,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAW7C,KAAK,IAAI,gBAAgB;IAczB;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAe1D,MAAM,IAAI,MAAM;IAIhB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;CAG5C;AAID,eAAO,MAAM,2BAA2B,EAAE,SAAS,WAAW,EAC/C,CAAC"}

package/src/lib/asset/assetAccount.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASSET_ACCOUNT_BIGINT_FIELDS = exports.AssetAccount = void 0;
+exports.hydrateAssetAccountDto = hydrateAssetAccountDto;
+const insufficientAvailableBalanceError_1 = require("../errors/asset/insufficientAvailableBalanceError");
+const invalidAmountError_1 = require("../errors/asset/invalidAmountError");
+const checksum_1 = require("../types/checksum");
+const jouleConstants_1 = require("./jouleConstants");
+const BIGINT_FIELDS = ['balance', 'earned', 'spent', 'reserved'];
+function assertNonNegativeBigInt(value, field) {
+    if (typeof value !== 'bigint') {
+        throw new invalidAmountError_1.InvalidAmountError(`${field} must be bigint`, value);
+    }
+    if (value < 0n) {
+        throw new invalidAmountError_1.InvalidAmountError(`${field} must be non-negative`, value);
+    }
+}
+/**
+ * Hydrate a raw DTO record into a canonical {@link IAssetAccountDto}.
+ *
+ * Handles two legacy markers introduced before the
+ * `asset-account-store-generalization` refactor:
+ *
+ *  - **missing `assetId`** → defaults to `'joule'`.
+ *  - **`number` balance fields** → multiplied by
+ *    {@link JOULE_MICROUNITS_PER_UNIT} (rounded) and stored as decimal-
+ *    string `bigint` microunits.
+ *
+ * Already-upgraded DTOs round-trip unchanged. The function never throws —
+ * unrecognized field shapes coerce to `'0'` so the caller gets a fully
+ * populated DTO it can persist on next write.
+ *
+ * @see asset-account-store-generalization spec, Requirements 1.4, 2.5, 2.6.
+ */
+function hydrateAssetAccountDto(raw) {
+    const assetIdRaw = raw['assetId'];
+    const assetId = typeof assetIdRaw === 'string' && assetIdRaw.length > 0
+        ? assetIdRaw
+        : jouleConstants_1.JOULE_ASSET_ID;
+    const out = { ...raw, assetId };
+    for (const field of BIGINT_FIELDS) {
+        const v = raw[field];
+        if (typeof v === 'bigint') {
+            out[field] = v.toString();
+        }
+        else if (typeof v === 'number' && Number.isFinite(v)) {
+            // Legacy joule DTO: number Joules → bigint microjoules.
+            const micro = BigInt(Math.round(v * Number(jouleConstants_1.JOULE_MICROUNITS_PER_UNIT)));
+            out[field] = micro.toString();
+        }
+        else if (typeof v === 'string' && /^-?\d+$/.test(v)) {
+            out[field] = v;
+        }
+        else {
+            out[field] = '0';
+        }
+    }
+    if (typeof out['reputation'] !== 'number') {
+        out['reputation'] = 0;
+    }
+    if (typeof out['memberId'] !== 'string') {
+        out['memberId'] = '';
+    }
+    if (typeof out['createdAt'] !== 'string') {
+        out['createdAt'] = new Date(0).toISOString();
+    }
+    if (typeof out['lastUpdated'] !== 'string') {
+        out['lastUpdated'] = out['createdAt'];
+    }
+    return out;
+}
+/**
+ * Generalized per-(member, asset) account.
+ *
+ * `bigint` microunit balances eliminate floating-point drift from
+ * charge / credit paths. The legacy {@link EnergyAccount} class is
+ * preserved untouched during this additive phase; a future phase will
+ * fold it onto this base via re-export alias.
+ *
+ * @see asset-account-store-generalization spec, Phase 3.
+ */
+class AssetAccount {
+    memberId;
+    assetId;
+    createdAt;
+    balance;
+    earned;
+    spent;
+    reserved;
+    reputation;
+    lastUpdated;
+    constructor(memberId, assetId = jouleConstants_1.JOULE_ASSET_ID, createdAt = new Date(), balance = 0n, earned = 0n, spent = 0n, reserved = 0n, reputation = 0.5, lastUpdated) {
+        this.memberId = memberId;
+        this.assetId = assetId;
+        this.createdAt = createdAt;
+        if (typeof assetId !== 'string' || assetId.length === 0) {
+            throw new invalidAmountError_1.InvalidAmountError('assetId must be a non-empty string', assetId);
+        }
+        assertNonNegativeBigInt(balance, 'balance');
+        assertNonNegativeBigInt(earned, 'earned');
+        assertNonNegativeBigInt(spent, 'spent');
+        assertNonNegativeBigInt(reserved, 'reserved');
+        this.balance = balance;
+        this.earned = earned;
+        this.spent = spent;
+        this.reserved = reserved;
+        this.reputation = Math.max(0, Math.min(1, reputation));
+        this.lastUpdated = lastUpdated ?? createdAt;
+    }
+    /** Available = balance - reserved, floored at 0. */
+    get availableBalance() {
+        const a = this.balance - this.reserved;
+        return a > 0n ? a : 0n;
+    }
+    /** Net = earned - spent. May be negative. */
+    get netAsset() {
+        return this.earned - this.spent;
+    }
+    canAfford(amount) {
+        if (typeof amount !== 'bigint' || amount < 0n)
+            return false;
+        return this.availableBalance >= amount;
+    }
+    reserve(amount) {
+        assertNonNegativeBigInt(amount, 'amount');
+        if (!this.canAfford(amount)) {
+            throw new insufficientAvailableBalanceError_1.InsufficientAvailableBalanceError(this.assetId, amount, this.availableBalance);
+        }
+        this.reserved += amount;
+        this.lastUpdated = new Date();
+    }
+    release(amount) {
+        assertNonNegativeBigInt(amount, 'amount');
+        this.reserved = this.reserved > amount ? this.reserved - amount : 0n;
+        this.lastUpdated = new Date();
+    }
+    charge(amount) {
+        assertNonNegativeBigInt(amount, 'amount');
+        if (amount > this.balance) {
+            throw new insufficientAvailableBalanceError_1.InsufficientAvailableBalanceError(this.assetId, amount, this.balance);
+        }
+        this.balance -= amount;
+        this.spent += amount;
+        this.lastUpdated = new Date();
+    }
+    credit(amount) {
+        assertNonNegativeBigInt(amount, 'amount');
+        this.balance += amount;
+        this.earned += amount;
+        this.lastUpdated = new Date();
+    }
+    updateReputation(newReputation) {
+        if (typeof newReputation !== 'number' || !Number.isFinite(newReputation)) {
+            throw new invalidAmountError_1.InvalidAmountError('reputation must be finite number', newReputation);
+        }
+        this.reputation = Math.max(0, Math.min(1, newReputation));
+        this.lastUpdated = new Date();
+    }
+    toDto() {
+        return {
+            memberId: this.memberId.toHex(),
+            assetId: this.assetId,
+            balance: this.balance.toString(),
+            earned: this.earned.toString(),
+            spent: this.spent.toString(),
+            reserved: this.reserved.toString(),
+            reputation: this.reputation,
+            createdAt: this.createdAt.toISOString(),
+            lastUpdated: this.lastUpdated.toISOString(),
+        };
+    }
+    /**
+     * Build an {@link AssetAccount} from a DTO. Accepts both fully-upgraded
+     * {@link IAssetAccountDto} and legacy `IEnergyAccountDto`-shaped records:
+     * the input is run through {@link hydrateAssetAccountDto} first.
+     */
+    static fromDto(dto) {
+        const h = hydrateAssetAccountDto(dto);
+        return new AssetAccount(checksum_1.Checksum.fromHex(h.memberId), h.assetId, new Date(h.createdAt), BigInt(h.balance), BigInt(h.earned), BigInt(h.spent), BigInt(h.reserved), h.reputation, new Date(h.lastUpdated));
+    }
+    toJson() {
+        return JSON.stringify(this.toDto());
+    }
+    static fromJson(json) {
+        return AssetAccount.fromDto(JSON.parse(json));
+    }
+}
+exports.AssetAccount = AssetAccount;
+// Re-export field list for tests / store internals that need to walk
+// every bigint-microunit field.
+exports.ASSET_ACCOUNT_BIGINT_FIELDS = BIGINT_FIELDS;
+//# sourceMappingURL=assetAccount.js.map

package/src/lib/asset/assetAccount.js.map

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

package/src/lib/asset/formatAssetAmount.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Options controlling {@link formatAssetAmount} output.
+ */
+export interface IFormatAssetAmountOptions {
+    /**
+     * Number of fractional digits to render. Defaults to the asset's natural
+     * precision (6 for joule).
+     */
+    precision?: number;
+    /**
+     * BCP-47 locale tag for digit grouping / decimal separator. When omitted,
+     * a plain non-localized representation is produced (no thousands grouping,
+     * `.` decimal separator).
+     */
+    locale?: string;
+}
+/**
+ * Format an asset microunit amount as a human-readable string.
+ *
+ * - For `assetId === 'joule'` the default format is `'1.234567 J'`.
+ * - For unknown assetIds the function falls back to `'<microunits> <assetId>'`
+ *   raw and never throws.
+ *
+ * No business logic SHALL parse formatted strings back into amounts; parsing
+ * occurs only on validated DTO inputs.
+ *
+ * @see asset-account-store-generalization spec, Requirements 8.1–8.4.
+ */
+export declare function formatAssetAmount(amount: bigint, assetId: string, opts?: IFormatAssetAmountOptions): string;
+//# sourceMappingURL=formatAssetAmount.d.ts.map

package/src/lib/asset/formatAssetAmount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatAssetAmount.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/formatAssetAmount.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,yBAAyB,GAC/B,MAAM,CAwCR"}