@digitaldefiance/ecies-lib 4.17.2 → 4.17.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/ecies-lib",
-  "version": "4.17.2",
+  "version": "4.17.4",
   "description": "Digital Defiance ECIES Library",
   "homepage": "https://github.com/Digital-Defiance/ecies-lib",
   "repository": {
@@ -62,7 +62,7 @@
   "license": "MIT",
   "packageManager": "yarn@4.11.0",
   "dependencies": {
-    "@digitaldefiance/i18n-lib": "4.3.2",
+    "@digitaldefiance/i18n-lib": "4.4.0",
     "@ethereumjs/wallet": "^2.0.4",
     "@noble/curves": "^1.4.2",
     "@noble/hashes": "^1.4.0",

package/src/i18n-setup.d.ts

@@ -2,7 +2,7 @@
  * ECIES i18n Setup - v2.0 Architecture
  * Uses i18n-lib 2.0 patterns with runtime validation
  */
-import type { BrandedPluralMasterStringsCollection, ComponentConfig, CoreLanguageCode, EngineConfig } from '@digitaldefiance/i18n-lib';
+import type { BrandedPluralMasterStringsCollection, ComponentConfig, CoreLanguageCode, EngineConfig, I18nComponentPackage } from '@digitaldefiance/i18n-lib';
 import { I18nEngine } from '@digitaldefiance/i18n-lib';
 import { EciesComponentId, EciesStringKey, type EciesStringKeyValue } from './enumerations/ecies-string-key';
 export declare const EciesI18nEngineKey: "DigitalDefiance.Ecies.I18nEngine";
@@ -18,6 +18,12 @@ export declare const EciesComponentStrings: BrandedPluralMasterStringsCollection
  * Note: Includes all 8 supported languages
  */
 export declare function createEciesComponentConfig(): ComponentConfig;
+/**
+ * Creates an I18nComponentPackage bundling the ECIES ComponentConfig
+ * with its branded string key enum. Use this with createI18nSetup's
+ * libraryComponents array.
+ */
+export declare function createEciesComponentPackage(): I18nComponentPackage;
 export declare function getEciesI18nEngine(config?: EngineConfig): I18nEngine;
 /**
  * Proxy for backward compatibility

package/src/i18n-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-setup.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/i18n-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,oCAAoC,EACpC,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,UAAU,EAIX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AASzC,eAAO,MAAM,kBAAkB,EAAG,kCAA2C,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,oCAAoC,CACtE,OAAO,cAAc,EACrB,gBAAgB,CAUjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,eAAe,CAK5D;AA+CD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,CAKpE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,YAI1B,CAAC;AAEH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAMR"}
+{"version":3,"file":"i18n-setup.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/i18n-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,oCAAoC,EACpC,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,UAAU,EAIX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AASzC,eAAO,MAAM,kBAAkB,EAAG,kCAA2C,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,oCAAoC,CACtE,OAAO,cAAc,EACrB,gBAAgB,CAUjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,eAAe,CAK5D;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,oBAAoB,CAKlE;AA+CD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,CAKpE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,YAI1B,CAAC;AAEH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAMR"}

package/src/i18n-setup.js

@@ -6,6 +6,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.eciesI18nEngine = exports.EciesComponentStrings = exports.EciesComponentId = exports.EciesI18nEngineKey = void 0;
 exports.createEciesComponentConfig = createEciesComponentConfig;
+exports.createEciesComponentPackage = createEciesComponentPackage;
 exports.getEciesI18nEngine = getEciesI18nEngine;
 exports.resetEciesI18nEngine = resetEciesI18nEngine;
 exports.getEciesTranslation = getEciesTranslation;
@@ -46,6 +47,17 @@ function createEciesComponentConfig() {
         strings: exports.EciesComponentStrings,
     };
 }
+/**
+ * Creates an I18nComponentPackage bundling the ECIES ComponentConfig
+ * with its branded string key enum. Use this with createI18nSetup's
+ * libraryComponents array.
+ */
+function createEciesComponentPackage() {
+    return {
+        config: createEciesComponentConfig(),
+        stringKeyEnum: ecies_string_key_1.EciesStringKey,
+    };
+}
 /**
  * Create ECIES i18n engine instance
  * Uses i18n 2.0 pattern with runtime validation

package/src/i18n-setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-setup.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/i18n-setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"i18n-setup.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/i18n-setup.ts"],"names":[],"mappings":"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"}

package/src/index.d.ts

@@ -12,7 +12,7 @@ import './lib/crypto-polyfill';
 export * from './builders/index';
 export * from './core/index';
 export * from './lib/index';
-export { createEciesComponentConfig, EciesComponentStrings, EciesI18nEngineKey, getEciesI18nEngine, getEciesTranslation, resetEciesI18nEngine, safeEciesTranslation, } from './i18n-setup';
+export { createEciesComponentConfig, createEciesComponentPackage, EciesComponentStrings, EciesI18nEngineKey, getEciesI18nEngine, getEciesTranslation, resetEciesI18nEngine, safeEciesTranslation, } from './i18n-setup';
 export { encryptionTypeEnumToType, encryptionTypeToString, ensureEciesEncryptionTypeEnum, validateEciesEncryptionTypeEnum, } from './utils/encryption-type-utils';
 export * from './constants';
 export * from './typed-configuration';

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,uBAAuB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAG5B,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AASvC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,YAAY,EACV,UAAU,EACV,SAAS,EACT,OAAO,IAAI,eAAe,GAC3B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,uBAAuB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAG5B,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AASvC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,YAAY,EACV,UAAU,EACV,SAAS,EACT,OAAO,IAAI,eAAe,GAC3B,MAAM,iBAAiB,CAAC"}

package/src/index.js

@@ -10,7 +10,7 @@
  * - i18n 2.0 integration
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENCRYPTION_STATE_VERSION = exports.validateEciesEncryptionTypeEnum = exports.ensureEciesEncryptionTypeEnum = exports.encryptionTypeToString = exports.encryptionTypeEnumToType = exports.safeEciesTranslation = exports.resetEciesI18nEngine = exports.getEciesTranslation = exports.getEciesI18nEngine = exports.EciesI18nEngineKey = exports.EciesComponentStrings = exports.createEciesComponentConfig = void 0;
+exports.ENCRYPTION_STATE_VERSION = exports.validateEciesEncryptionTypeEnum = exports.ensureEciesEncryptionTypeEnum = exports.encryptionTypeToString = exports.encryptionTypeEnumToType = exports.safeEciesTranslation = exports.resetEciesI18nEngine = exports.getEciesTranslation = exports.getEciesI18nEngine = exports.EciesI18nEngineKey = exports.EciesComponentStrings = exports.createEciesComponentPackage = exports.createEciesComponentConfig = void 0;
 const tslib_1 = require("tslib");
 // CRITICAL: Apply crypto polyfill BEFORE any @noble/curves imports
 // This ensures crypto.getRandomValues returns pure Uint8Array instances
@@ -22,6 +22,7 @@ tslib_1.__exportStar(require("./lib/index"), exports);
 // i18n v2
 var i18n_setup_1 = require("./i18n-setup");
 Object.defineProperty(exports, "createEciesComponentConfig", { enumerable: true, get: function () { return i18n_setup_1.createEciesComponentConfig; } });
+Object.defineProperty(exports, "createEciesComponentPackage", { enumerable: true, get: function () { return i18n_setup_1.createEciesComponentPackage; } });
 Object.defineProperty(exports, "EciesComponentStrings", { enumerable: true, get: function () { return i18n_setup_1.EciesComponentStrings; } });
 Object.defineProperty(exports, "EciesI18nEngineKey", { enumerable: true, get: function () { return i18n_setup_1.EciesI18nEngineKey; } });
 Object.defineProperty(exports, "getEciesI18nEngine", { enumerable: true, get: function () { return i18n_setup_1.getEciesI18nEngine; } });

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;AAEH,mEAAmE;AACnE,wEAAwE;AACxE,iCAA+B;AAE/B,kBAAkB;AAClB,2DAAiC;AACjC,uDAA6B;AAC7B,sDAA4B;AAE5B,UAAU;AACV,2CAQsB;AAPpB,wHAAA,0BAA0B,OAAA;AAC1B,mHAAA,qBAAqB,OAAA;AACrB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,iHAAA,mBAAmB,OAAA;AACnB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,mFAAmF;AACnF,mEAAmE;AACnE,uEAKuC;AAJrC,iIAAA,wBAAwB,OAAA;AACxB,+HAAA,sBAAsB,OAAA;AACtB,sIAAA,6BAA6B,OAAA;AAC7B,wIAAA,+BAA+B,OAAA;AAGjC,2DAA2D;AAC3D,oEAAoE;AACpE,8DAA8D;AAE9D,kEAAkE;AAClE,gEAAgE;AAEhE,sDAA4B;AAC5B,gEAAsC;AACtC,yDAA+B;AAC/B,yDAA+B;AAC/B,mDAAyB;AACzB,uDAA6B;AAC7B,uEAA6C;AAC7C,kEAAyE;AAAhE,4HAAA,wBAAwB,OAAA;AAEjC,qEAA2C;AAC3C,qEAA2C;AAC3C,uEAA6C;AAC7C,6DAAmC;AACnC,4DAAkC;AAClC,mDAAyB;AACzB,4DAAkC;AAClC,yDAA+B;AAC/B,0DAAgC;AAChC,0DAAgC;AAChC,qDAA2B;AAC3B,uDAA6B;AAC7B,wDAA8B;AAC9B,kDAAwB;AACxB,kDAAwB;AAExB,qEAAqE;AACrE,uDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;AAEH,mEAAmE;AACnE,wEAAwE;AACxE,iCAA+B;AAE/B,kBAAkB;AAClB,2DAAiC;AACjC,uDAA6B;AAC7B,sDAA4B;AAE5B,UAAU;AACV,2CASsB;AARpB,wHAAA,0BAA0B,OAAA;AAC1B,yHAAA,2BAA2B,OAAA;AAC3B,mHAAA,qBAAqB,OAAA;AACrB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,iHAAA,mBAAmB,OAAA;AACnB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,mFAAmF;AACnF,mEAAmE;AACnE,uEAKuC;AAJrC,iIAAA,wBAAwB,OAAA;AACxB,+HAAA,sBAAsB,OAAA;AACtB,sIAAA,6BAA6B,OAAA;AAC7B,wIAAA,+BAA+B,OAAA;AAGjC,2DAA2D;AAC3D,oEAAoE;AACpE,8DAA8D;AAE9D,kEAAkE;AAClE,gEAAgE;AAEhE,sDAA4B;AAC5B,gEAAsC;AACtC,yDAA+B;AAC/B,yDAA+B;AAC/B,mDAAyB;AACzB,uDAA6B;AAC7B,uEAA6C;AAC7C,kEAAyE;AAAhE,4HAAA,wBAAwB,OAAA;AAEjC,qEAA2C;AAC3C,qEAA2C;AAC3C,uEAA6C;AAC7C,6DAAmC;AACnC,4DAAkC;AAClC,mDAAyB;AACzB,4DAAkC;AAClC,yDAA+B;AAC/B,0DAAgC;AAChC,0DAAgC;AAChC,qDAA2B;AAC3B,uDAA6B;AAC7B,wDAA8B;AAC9B,kDAAwB;AACxB,kDAAwB;AAExB,qEAAqE;AACrE,uDAA6B"}

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

@@ -44,4 +44,5 @@ export { PrecinctAggregator, CountyAggregator, StateAggregator, NationalAggregat
 export { BatchVoteProcessor } from './persistent-state';
 export * from './enumerations';
 export type * from './interfaces';
+export * from './threshold';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,cAAc,gBAAgB,CAAC;AAG/B,mBAAmB,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,cAAc,gBAAgB,CAAC;AAG/B,mBAAmB,cAAc,CAAC;AAGlC,cAAc,aAAa,CAAC"}

package/src/lib/voting/index.js

@@ -62,4 +62,6 @@ var persistent_state_1 = require("./persistent-state");
 Object.defineProperty(exports, "BatchVoteProcessor", { enumerable: true, get: function () { return persistent_state_1.BatchVoteProcessor; } });
 // Re-export enumerations
 tslib_1.__exportStar(require("./enumerations"), exports);
+// Re-export threshold voting module
+tslib_1.__exportStar(require("./threshold"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;;AAEH,yCAAmC;AAA1B,iGAAA,IAAI,OAAA;AACb,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,uCAAsE;AAA7D,mHAAA,uBAAuB,OAAA;AAAE,2GAAA,eAAe,OAAA;AACjD,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAC1B,mDAAuD;AAA9C,qHAAA,mBAAmB,OAAA;AAC5B,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AACxB,qEAKmC;AAJjC,6HAAA,kBAAkB,OAAA;AAClB,2HAAA,gBAAgB,OAAA;AAChB,0HAAA,eAAe,OAAA;AACf,6HAAA,kBAAkB,OAAA;AAEpB,uDAAwD;AAA/C,sHAAA,kBAAkB,OAAA;AAE3B,yBAAyB;AACzB,yDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;;AAEH,yCAAmC;AAA1B,iGAAA,IAAI,OAAA;AACb,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,uCAAsE;AAA7D,mHAAA,uBAAuB,OAAA;AAAE,2GAAA,eAAe,OAAA;AACjD,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAC1B,mDAAuD;AAA9C,qHAAA,mBAAmB,OAAA;AAC5B,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AACxB,qEAKmC;AAJjC,6HAAA,kBAAkB,OAAA;AAClB,2HAAA,gBAAgB,OAAA;AAChB,0HAAA,eAAe,OAAA;AACf,6HAAA,kBAAkB,OAAA;AAEpB,uDAAwD;AAA/C,sHAAA,kBAAkB,OAAA;AAE3B,yBAAyB;AACzB,yDAA+B;AAK/B,oCAAoC;AACpC,sDAA4B"}

package/src/lib/voting/threshold/decryption-combiner.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Decryption Combiner
+ *
+ * Combines k partial decryptions using Lagrange interpolation to produce
+ * the final plaintext tally. Based on Damgård et al.'s threshold Paillier scheme.
+ *
+ * The combining process:
+ * 1. Verify each partial decryption's ZK proof
+ * 2. Compute Lagrange coefficients for the participating share indices
+ * 3. Combine partials: product of partial_i^(2·λ_i) mod n²
+ * 4. Apply the Paillier L-function: L(x) = (x - 1) / n
+ * 5. Multiply by the modular inverse of 4·Δ² to recover plaintext
+ *
+ * Where Δ = n! (factorial of total shares count).
+ */
+import type { PublicKey } from 'paillier-bigint';
+import type { CombinedDecryption, IDecryptionCombiner, PartialDecryption, ThresholdKeyConfig } from './interfaces';
+/**
+ * Error thrown when there are insufficient partial decryptions.
+ */
+export declare class InsufficientPartialsError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when a partial decryption's ZK proof is invalid during combining.
+ */
+export declare class InvalidPartialInCombineError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when decryption combining fails.
+ */
+export declare class CombineFailedError extends Error {
+    constructor(message: string);
+}
+/**
+ * Combines k partial decryptions into the final plaintext using
+ * Lagrange interpolation over the Paillier ciphertext space.
+ *
+ * @example
+ * ```typescript
+ * const combiner = new DecryptionCombiner(publicKey, verificationKeys);
+ *
+ * const result = combiner.combine(
+ *   partials,
+ *   encryptedTally,
+ *   publicKey,
+ *   { totalShares: 9, threshold: 5 }
+ * );
+ *
+ * console.log(result.tallies); // decrypted vote counts
+ * ```
+ */
+export declare class DecryptionCombiner implements IDecryptionCombiner {
+    private readonly verificationKeys;
+    private readonly partialService;
+    private readonly theta;
+    constructor(publicKey: PublicKey, verificationKeys: readonly Uint8Array[], theta: bigint);
+    /**
+     * Combine k partial decryptions into the final plaintext.
+     *
+     * @param partials - The partial decryptions from k Guardians
+     * @param encryptedTally - The encrypted tally ciphertexts
+     * @param publicKey - The Paillier public key
+     * @param config - The threshold configuration
+     * @returns The combined decryption with plaintext tallies and proof
+     * @throws InsufficientPartialsError if fewer than k partials provided
+     * @throws InvalidPartialInCombineError if any partial's ZK proof is invalid
+     * @throws CombineFailedError if the combining operation fails
+     */
+    combine(partials: readonly PartialDecryption[], encryptedTally: bigint[], publicKey: PublicKey, config: ThresholdKeyConfig): CombinedDecryption;
+    /**
+     * Verify a combined decryption result.
+     *
+     * Checks that:
+     * 1. All individual partial proofs are valid
+     * 2. The participating Guardians are authorized (have valid verification keys)
+     * 3. The aggregated commitment is consistent
+     */
+    verifyCombined(combined: CombinedDecryption, encryptedTally: bigint[], verificationKeys: readonly Uint8Array[], publicKey: PublicKey): boolean;
+    /**
+     * Combine partial decryptions for a single ciphertext.
+     *
+     * Each partial_i = c^(2·s_i) mod n² (computed by PartialDecryptionService).
+     *
+     * Using integer Lagrange coefficients λ_i' = Δ · Π_{j≠i} j/(j-i):
+     *   combined = Π partial_i^(2·λ_i') mod n²
+     *            = c^(4·Δ·λ) mod n²
+     *
+     * where λ is the original Paillier secret key.
+     *
+     * By the Paillier L-function property: L(c^(4·Δ·λ)) = 4·Δ·λ·m mod n
+     * So: plaintext = L(combined) · (4·Δ)^(-1) mod n
+     */
+    private combineSingleCiphertext;
+    /**
+     * Compute integer Lagrange coefficient scaled by delta.
+     *
+     * λ_i = Δ · Π_{j≠i} (j / (j - i))
+     *
+     * Since we scale by Δ = n!, the result is always an integer.
+     */
+    private lagrangeCoefficientInteger;
+    /**
+     * Build the combined ZK proof from individual partial proofs.
+     */
+    private buildCombinedProof;
+    /**
+     * Compute a hash of the encrypted tally inputs.
+     */
+    private computeInputHash;
+    /**
+     * Generate a ceremony ID from the partials' nonces.
+     */
+    private generateCeremonyId;
+    /**
+     * Compute n! (factorial).
+     */
+    private factorial;
+    /**
+     * Compute a mod m, handling negative numbers correctly.
+     */
+    private mod;
+    /**
+     * Compute base^exp mod m using square-and-multiply.
+     */
+    private modPow;
+    /**
+     * Compute modular inverse using extended Euclidean algorithm.
+     */
+    private modInverse;
+    /**
+     * Convert a bigint to Uint8Array.
+     */
+    private bigintToUint8Array;
+    /**
+     * Compare two Uint8Arrays for equality.
+     */
+    private uint8ArrayEquals;
+}
+//# sourceMappingURL=decryption-combiner.d.ts.map

package/src/lib/voting/threshold/decryption-combiner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decryption-combiner.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/threshold/decryption-combiner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,kBAAkB,EAElB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAG7B,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,SAAS,UAAU,EAAE,EACvC,KAAK,EAAE,MAAM;IAOf;;;;;;;;;;;OAWG;IACH,OAAO,CACL,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,GACzB,kBAAkB;IAmFrB;;;;;;;OAOG;IACH,cAAc,CACZ,QAAQ,EAAE,kBAAkB,EAC5B,cAAc,EAAE,MAAM,EAAE,EACxB,gBAAgB,EAAE,SAAS,UAAU,EAAE,EACvC,SAAS,EAAE,SAAS,GACnB,OAAO;IAoCV;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,uBAAuB;IAmD/B;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,GAAG;IAKX;;OAEG;IACH,OAAO,CAAC,MAAM;IAcd;;OAEG;IACH,OAAO,CAAC,UAAU;IAqBlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}

package/src/lib/voting/threshold/decryption-combiner.js

@@ -0,0 +1,343 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecryptionCombiner = exports.CombineFailedError = exports.InvalidPartialInCombineError = exports.InsufficientPartialsError = void 0;
+const partial_decryption_service_1 = require("./partial-decryption-service");
+/**
+ * Error thrown when there are insufficient partial decryptions.
+ */
+class InsufficientPartialsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InsufficientPartialsError';
+    }
+}
+exports.InsufficientPartialsError = InsufficientPartialsError;
+/**
+ * Error thrown when a partial decryption's ZK proof is invalid during combining.
+ */
+class InvalidPartialInCombineError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidPartialInCombineError';
+    }
+}
+exports.InvalidPartialInCombineError = InvalidPartialInCombineError;
+/**
+ * Error thrown when decryption combining fails.
+ */
+class CombineFailedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CombineFailedError';
+    }
+}
+exports.CombineFailedError = CombineFailedError;
+/**
+ * Combines k partial decryptions into the final plaintext using
+ * Lagrange interpolation over the Paillier ciphertext space.
+ *
+ * @example
+ * ```typescript
+ * const combiner = new DecryptionCombiner(publicKey, verificationKeys);
+ *
+ * const result = combiner.combine(
+ *   partials,
+ *   encryptedTally,
+ *   publicKey,
+ *   { totalShares: 9, threshold: 5 }
+ * );
+ *
+ * console.log(result.tallies); // decrypted vote counts
+ * ```
+ */
+class DecryptionCombiner {
+    verificationKeys;
+    partialService;
+    theta;
+    constructor(publicKey, verificationKeys, theta) {
+        this.verificationKeys = verificationKeys;
+        this.partialService = new partial_decryption_service_1.PartialDecryptionService(publicKey);
+        this.theta = theta;
+    }
+    /**
+     * Combine k partial decryptions into the final plaintext.
+     *
+     * @param partials - The partial decryptions from k Guardians
+     * @param encryptedTally - The encrypted tally ciphertexts
+     * @param publicKey - The Paillier public key
+     * @param config - The threshold configuration
+     * @returns The combined decryption with plaintext tallies and proof
+     * @throws InsufficientPartialsError if fewer than k partials provided
+     * @throws InvalidPartialInCombineError if any partial's ZK proof is invalid
+     * @throws CombineFailedError if the combining operation fails
+     */
+    combine(partials, encryptedTally, publicKey, config) {
+        const { threshold: k } = config;
+        // Enforce minimum k partials requirement
+        if (partials.length < k) {
+            throw new InsufficientPartialsError(`Need at least ${k} partial decryptions, got ${partials.length}`);
+        }
+        if (encryptedTally.length === 0) {
+            throw new CombineFailedError('Encrypted tally must not be empty');
+        }
+        // Verify each partial's ZK proof before combining
+        for (const partial of partials) {
+            const vkIndex = partial.guardianIndex - 1; // 1-indexed to 0-indexed
+            if (vkIndex < 0 || vkIndex >= this.verificationKeys.length) {
+                throw new InvalidPartialInCombineError(`Guardian index ${partial.guardianIndex} is out of range [1, ${this.verificationKeys.length}]`);
+            }
+            const isValid = this.partialService.verifyPartial(partial, encryptedTally, this.verificationKeys[vkIndex], publicKey);
+            if (!isValid) {
+                throw new InvalidPartialInCombineError(`ZK proof verification failed for Guardian ${partial.guardianIndex}`);
+            }
+        }
+        // Use only the first k partials (in case more than k were provided)
+        const usedPartials = partials.slice(0, k);
+        const participatingGuardians = usedPartials.map((p) => p.guardianIndex);
+        try {
+            const n = publicKey.n;
+            const n2 = n * n;
+            // Compute the tallies by combining partial decryptions for each ciphertext
+            const tallies = encryptedTally.map((ciphertext) => this.combineSingleCiphertext(ciphertext, usedPartials, n, n2, config));
+            // Build the combined ZK proof
+            const combinedProof = this.buildCombinedProof(usedPartials, encryptedTally, n2);
+            return {
+                tallies,
+                combinedProof,
+                participatingGuardians,
+                ceremonyId: this.generateCeremonyId(usedPartials),
+                timestamp: Date.now(),
+            };
+        }
+        catch (error) {
+            if (error instanceof InsufficientPartialsError ||
+                error instanceof InvalidPartialInCombineError) {
+                throw error;
+            }
+            throw new CombineFailedError(`Failed to combine partial decryptions: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Verify a combined decryption result.
+     *
+     * Checks that:
+     * 1. All individual partial proofs are valid
+     * 2. The participating Guardians are authorized (have valid verification keys)
+     * 3. The aggregated commitment is consistent
+     */
+    verifyCombined(combined, encryptedTally, verificationKeys, publicKey) {
+        if (encryptedTally.length === 0 || combined.tallies.length === 0) {
+            return false;
+        }
+        // Verify each participating Guardian's index is valid
+        for (const guardianIndex of combined.participatingGuardians) {
+            const vkIndex = guardianIndex - 1;
+            if (vkIndex < 0 || vkIndex >= verificationKeys.length) {
+                return false;
+            }
+        }
+        // Verify the input hash matches
+        const n2 = publicKey.n * publicKey.n;
+        const expectedInputHash = this.computeInputHash(encryptedTally, n2);
+        if (!this.uint8ArrayEquals(combined.combinedProof.inputHash, expectedInputHash)) {
+            return false;
+        }
+        // Verify the aggregated commitment is non-zero
+        if (combined.combinedProof.aggregatedCommitment === 0n) {
+            return false;
+        }
+        // Verify we have the right number of partial proofs
+        if (combined.combinedProof.partialProofs.length !==
+            combined.participatingGuardians.length) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Combine partial decryptions for a single ciphertext.
+     *
+     * Each partial_i = c^(2·s_i) mod n² (computed by PartialDecryptionService).
+     *
+     * Using integer Lagrange coefficients λ_i' = Δ · Π_{j≠i} j/(j-i):
+     *   combined = Π partial_i^(2·λ_i') mod n²
+     *            = c^(4·Δ·λ) mod n²
+     *
+     * where λ is the original Paillier secret key.
+     *
+     * By the Paillier L-function property: L(c^(4·Δ·λ)) = 4·Δ·λ·m mod n
+     * So: plaintext = L(combined) · (4·Δ)^(-1) mod n
+     */
+    combineSingleCiphertext(_ciphertext, partials, n, n2, config) {
+        const indices = partials.map((p) => p.guardianIndex);
+        const delta = this.factorial(BigInt(config.totalShares));
+        // Compute combined value using Lagrange interpolation in the exponent:
+        // combined = Π partial_i^(2·λ_i') mod n²
+        // where λ_i' = Δ · Π_{j≠i} j/(j-i) are integer Lagrange coefficients
+        let combined = 1n;
+        for (const partial of partials) {
+            const partialValue = partial.value;
+            const lambda = this.lagrangeCoefficientInteger(partial.guardianIndex, indices, delta);
+            // combined *= partial_i^(2·lambda) mod n²
+            // The exponent can be negative, so we handle that with modular inverse
+            if (lambda >= 0n) {
+                combined = this.mod(combined * this.modPow(partialValue, 2n * lambda, n2), n2);
+            }
+            else {
+                const posExp = -lambda;
+                const partialPow = this.modPow(partialValue, 2n * posExp, n2);
+                const partialInv = this.modInverse(partialPow, n2);
+                combined = this.mod(combined * partialInv, n2);
+            }
+        }
+        // Apply L-function: L(x) = (x - 1) / n
+        const lValue = (combined - 1n) / n;
+        // Divide by θ to get the plaintext.
+        // θ = L(g^(4·Δ·λ) mod n²) mod n was precomputed during key generation.
+        // m = L(combined) · θ⁻¹ mod n
+        const thetaInv = this.modInverse(this.mod(this.theta, n), n);
+        const plaintext = this.mod(lValue * thetaInv, n);
+        return plaintext;
+    }
+    /**
+     * Compute integer Lagrange coefficient scaled by delta.
+     *
+     * λ_i = Δ · Π_{j≠i} (j / (j - i))
+     *
+     * Since we scale by Δ = n!, the result is always an integer.
+     */
+    lagrangeCoefficientInteger(i, indices, delta) {
+        let numerator = delta;
+        let denominator = 1n;
+        for (const j of indices) {
+            if (j !== i) {
+                numerator = numerator * BigInt(j);
+                denominator = denominator * BigInt(j - i);
+            }
+        }
+        // Since delta = n!, the division is exact (integer result)
+        return numerator / denominator;
+    }
+    /**
+     * Build the combined ZK proof from individual partial proofs.
+     */
+    buildCombinedProof(partials, encryptedTally, n2) {
+        const partialProofs = partials.map((p) => p.proof);
+        // Aggregate commitments by multiplying them together mod n²
+        let aggregatedCommitment = 1n;
+        for (const proof of partialProofs) {
+            aggregatedCommitment = this.mod(aggregatedCommitment * proof.commitment, n2);
+        }
+        const inputHash = this.computeInputHash(encryptedTally, n2);
+        return {
+            partialProofs,
+            aggregatedCommitment,
+            inputHash,
+        };
+    }
+    /**
+     * Compute a hash of the encrypted tally inputs.
+     */
+    computeInputHash(encryptedTally, n2) {
+        let hash = 0n;
+        for (const ct of encryptedTally) {
+            const bytes = this.bigintToUint8Array(ct);
+            for (const byte of bytes) {
+                hash = (hash * 256n + BigInt(byte)) % n2;
+            }
+        }
+        return this.bigintToUint8Array(hash);
+    }
+    /**
+     * Generate a ceremony ID from the partials' nonces.
+     */
+    generateCeremonyId(partials) {
+        if (partials.length === 0)
+            return 'empty';
+        // Use the first partial's nonce as the ceremony identifier
+        const nonce = partials[0].ceremonyNonce;
+        return Array.from(nonce)
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    /**
+     * Compute n! (factorial).
+     */
+    factorial(n) {
+        let result = 1n;
+        for (let i = 2n; i <= n; i++) {
+            result *= i;
+        }
+        return result;
+    }
+    /**
+     * Compute a mod m, handling negative numbers correctly.
+     */
+    mod(a, m) {
+        const result = a % m;
+        return result >= 0n ? result : result + m;
+    }
+    /**
+     * Compute base^exp mod m using square-and-multiply.
+     */
+    modPow(base, exp, m) {
+        if (m === 1n)
+            return 0n;
+        let result = 1n;
+        base = this.mod(base, m);
+        while (exp > 0n) {
+            if (exp % 2n === 1n) {
+                result = this.mod(result * base, m);
+            }
+            exp = exp >> 1n;
+            base = this.mod(base * base, m);
+        }
+        return result;
+    }
+    /**
+     * Compute modular inverse using extended Euclidean algorithm.
+     */
+    modInverse(a, m) {
+        const originalM = m;
+        a = this.mod(a, m);
+        let [old_r, r] = [a, m];
+        let [old_s, s] = [1n, 0n];
+        while (r !== 0n) {
+            const quotient = old_r / r;
+            [old_r, r] = [r, old_r - quotient * r];
+            [old_s, s] = [s, old_s - quotient * s];
+        }
+        if (old_r !== 1n) {
+            throw new CombineFailedError(`Modular inverse does not exist for ${a} mod ${m}`);
+        }
+        return ((old_s % originalM) + originalM) % originalM;
+    }
+    /**
+     * Convert a bigint to Uint8Array.
+     */
+    bigintToUint8Array(value) {
+        if (value === 0n) {
+            return new Uint8Array([0]);
+        }
+        const hex = value.toString(16);
+        const paddedHex = hex.length % 2 === 0 ? hex : '0' + hex;
+        const bytes = new Uint8Array(paddedHex.length / 2);
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = parseInt(paddedHex.slice(i * 2, i * 2 + 2), 16);
+        }
+        return bytes;
+    }
+    /**
+     * Compare two Uint8Arrays for equality.
+     */
+    uint8ArrayEquals(a, b) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            if (a[i] !== b[i])
+                return false;
+        }
+        return true;
+    }
+}
+exports.DecryptionCombiner = DecryptionCombiner;
+//# sourceMappingURL=decryption-combiner.js.map