@digitaldefiance/ecies-lib 4.8.7 → 4.9.1

package/src/lib/voting/hierarchical-aggregator.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JurisdictionLevel = exports.NationalAggregator = exports.StateAggregator = exports.CountyAggregator = exports.PrecinctAggregator = void 0;
+const jurisdictional_level_1 = require("./enumerations/jurisdictional-level");
+/**
+ * Precinct-level aggregator - handles ~900 votes in memory
+ * Optional persistence via injected logger/checkpoint manager
+ */
+class PrecinctAggregator {
+    poll;
+    config;
+    logger;
+    checkpointMgr;
+    checkpointInterval = 100;
+    constructor(poll, config, logger, checkpointMgr) {
+        if (config.level !== jurisdictional_level_1.JurisdictionLevel.Precinct) {
+            throw new Error('PrecinctAggregator requires precinct-level config');
+        }
+        this.poll = poll;
+        this.config = config;
+        this.logger = logger;
+        this.checkpointMgr = checkpointMgr;
+    }
+    async vote(voter, vote) {
+        this.poll.vote(voter, vote);
+        if (this.logger) {
+            await this.logger.appendVote(voter.id, vote.encrypted, Date.now());
+        }
+        if (this.checkpointMgr &&
+            this.poll.voterCount % this.checkpointInterval === 0) {
+            await this.checkpointMgr.saveCheckpoint(this.getTally());
+        }
+    }
+    getTally() {
+        const votes = this.poll.getEncryptedVotes();
+        const choiceCount = this.poll.choices.length;
+        const encryptedTallies = Array(choiceCount).fill(0n);
+        for (const encryptedVote of votes.values()) {
+            for (let i = 0; i < choiceCount; i++) {
+                encryptedTallies[i] = encryptedVote[i];
+            }
+        }
+        return {
+            jurisdictionId: this.config.id,
+            level: jurisdictional_level_1.JurisdictionLevel.Precinct,
+            encryptedTallies,
+            voterCount: this.poll.voterCount,
+            timestamp: Date.now(),
+        };
+    }
+    close() {
+        this.poll.close();
+    }
+}
+exports.PrecinctAggregator = PrecinctAggregator;
+/**
+ * County-level aggregator - combines precinct tallies
+ */
+class CountyAggregator {
+    config;
+    precinctTallies = new Map();
+    votingPublicKey;
+    constructor(config, votingPublicKey) {
+        if (config.level !== jurisdictional_level_1.JurisdictionLevel.County) {
+            throw new Error('CountyAggregator requires county-level config');
+        }
+        this.config = config;
+        this.votingPublicKey = votingPublicKey;
+    }
+    /**
+     * Add precinct tally to county aggregate
+     */
+    addPrecinctTally(tally) {
+        const key = this.toKey(tally.jurisdictionId);
+        this.precinctTallies.set(key, tally);
+    }
+    /**
+     * Get aggregated county tally
+     */
+    getTally() {
+        const tallies = Array.from(this.precinctTallies.values());
+        if (tallies.length === 0) {
+            throw new Error('No precinct tallies to aggregate');
+        }
+        const choiceCount = tallies[0].encryptedTallies.length;
+        const encryptedTallies = Array(choiceCount).fill(0n);
+        let totalVoters = 0;
+        for (const tally of tallies) {
+            for (let i = 0; i < choiceCount; i++) {
+                if (encryptedTallies[i] === 0n) {
+                    encryptedTallies[i] = tally.encryptedTallies[i];
+                }
+                else {
+                    // Homomorphic addition
+                    encryptedTallies[i] = this.votingPublicKey.addition(encryptedTallies[i], tally.encryptedTallies[i]);
+                }
+            }
+            totalVoters += tally.voterCount;
+        }
+        return {
+            jurisdictionId: this.config.id,
+            level: jurisdictional_level_1.JurisdictionLevel.County,
+            encryptedTallies,
+            voterCount: totalVoters,
+            timestamp: Date.now(),
+            childJurisdictions: tallies.map((t) => t.jurisdictionId),
+        };
+    }
+    toKey(id) {
+        if (id instanceof Uint8Array) {
+            return Array.from(id)
+                .map((b) => b.toString(16).padStart(2, '0'))
+                .join('');
+        }
+        return String(id);
+    }
+}
+exports.CountyAggregator = CountyAggregator;
+/**
+ * State-level aggregator - combines county tallies
+ */
+class StateAggregator {
+    config;
+    countyTallies = new Map();
+    votingPublicKey;
+    constructor(config, votingPublicKey) {
+        if (config.level !== jurisdictional_level_1.JurisdictionLevel.State) {
+            throw new Error('StateAggregator requires state-level config');
+        }
+        this.config = config;
+        this.votingPublicKey = votingPublicKey;
+    }
+    addCountyTally(tally) {
+        const key = this.toKey(tally.jurisdictionId);
+        this.countyTallies.set(key, tally);
+    }
+    getTally() {
+        const tallies = Array.from(this.countyTallies.values());
+        if (tallies.length === 0) {
+            throw new Error('No county tallies to aggregate');
+        }
+        const choiceCount = tallies[0].encryptedTallies.length;
+        const encryptedTallies = Array(choiceCount).fill(0n);
+        let totalVoters = 0;
+        for (const tally of tallies) {
+            for (let i = 0; i < choiceCount; i++) {
+                if (encryptedTallies[i] === 0n) {
+                    encryptedTallies[i] = tally.encryptedTallies[i];
+                }
+                else {
+                    encryptedTallies[i] = this.votingPublicKey.addition(encryptedTallies[i], tally.encryptedTallies[i]);
+                }
+            }
+            totalVoters += tally.voterCount;
+        }
+        return {
+            jurisdictionId: this.config.id,
+            level: jurisdictional_level_1.JurisdictionLevel.State,
+            encryptedTallies,
+            voterCount: totalVoters,
+            timestamp: Date.now(),
+            childJurisdictions: tallies.map((t) => t.jurisdictionId),
+        };
+    }
+    toKey(id) {
+        if (id instanceof Uint8Array) {
+            return Array.from(id)
+                .map((b) => b.toString(16).padStart(2, '0'))
+                .join('');
+        }
+        return String(id);
+    }
+}
+exports.StateAggregator = StateAggregator;
+/**
+ * National-level aggregator - combines state tallies and decrypts final result
+ */
+class NationalAggregator {
+    config;
+    stateTallies = new Map();
+    votingPublicKey;
+    constructor(config, votingPublicKey) {
+        if (config.level !== jurisdictional_level_1.JurisdictionLevel.National) {
+            throw new Error('NationalAggregator requires national-level config');
+        }
+        this.config = config;
+        this.votingPublicKey = votingPublicKey;
+    }
+    addStateTally(tally) {
+        const key = this.toKey(tally.jurisdictionId);
+        this.stateTallies.set(key, tally);
+    }
+    getTally() {
+        const tallies = Array.from(this.stateTallies.values());
+        if (tallies.length === 0) {
+            throw new Error('No state tallies to aggregate');
+        }
+        const choiceCount = tallies[0].encryptedTallies.length;
+        const encryptedTallies = Array(choiceCount).fill(0n);
+        let totalVoters = 0;
+        for (const tally of tallies) {
+            for (let i = 0; i < choiceCount; i++) {
+                if (encryptedTallies[i] === 0n) {
+                    encryptedTallies[i] = tally.encryptedTallies[i];
+                }
+                else {
+                    encryptedTallies[i] = this.votingPublicKey.addition(encryptedTallies[i], tally.encryptedTallies[i]);
+                }
+            }
+            totalVoters += tally.voterCount;
+        }
+        return {
+            jurisdictionId: this.config.id,
+            level: jurisdictional_level_1.JurisdictionLevel.National,
+            encryptedTallies,
+            voterCount: totalVoters,
+            timestamp: Date.now(),
+            childJurisdictions: tallies.map((t) => t.jurisdictionId),
+        };
+    }
+    toKey(id) {
+        if (id instanceof Uint8Array) {
+            return Array.from(id)
+                .map((b) => b.toString(16).padStart(2, '0'))
+                .join('');
+        }
+        return String(id);
+    }
+}
+exports.NationalAggregator = NationalAggregator;
+// Re-export types and enums for convenience
+var jurisdictional_level_2 = require("./enumerations/jurisdictional-level");
+Object.defineProperty(exports, "JurisdictionLevel", { enumerable: true, get: function () { return jurisdictional_level_2.JurisdictionLevel; } });
+//# sourceMappingURL=hierarchical-aggregator.js.map

package/src/lib/voting/hierarchical-aggregator.js.map

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

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

@@ -9,6 +9,7 @@
  * - Plurality voting
  * - Proper role separation (Poll vs Tallier)
  * - Homomorphic encryption for privacy
+ * - U.S. scale hierarchical aggregation
  *
  * @example
  * ```typescript
@@ -32,13 +33,15 @@
  * ```
  */
 export { Poll } from './poll-core';
-export { VotingPoll } from './poll';
 export { PollTallier } from './tallier';
 export { VoteEncoder } from './encoder';
 export { PollFactory } from './factory';
 export { VotingSecurityValidator, VOTING_SECURITY } from './security';
-export { ImmutableAuditLog, AuditEventType, type AuditEntry, type AuditLog, } from './audit';
-export { PublicBulletinBoard, type BulletinBoard, type BulletinBoardEntry, type TallyProof, } from './bulletin-board';
-export { PollEventLogger, EventType, type EventLogger, type EventLogEntry, type PollConfiguration, } from './event-logger';
-export { VotingMethod, type VoteReceipt, type PollResults, type RoundResult, type EncryptedVote, type SupermajorityConfig, } from './types';
+export { ImmutableAuditLog } from './audit';
+export { PublicBulletinBoard } from './bulletin-board';
+export { PollEventLogger } from './event-logger';
+export { PrecinctAggregator, CountyAggregator, StateAggregator, NationalAggregator, } from './hierarchical-aggregator';
+export { BatchVoteProcessor } from './persistent-state';
+export * from './enumerations';
+export type * from './interfaces';
 //# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,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,EACL,iBAAiB,EACjB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAElB,KAAK,mBAAmB,GACzB,MAAM,SAAS,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"}

package/src/lib/voting/index.js

@@ -10,6 +10,7 @@
  * - Plurality voting
  * - Proper role separation (Poll vs Tallier)
  * - Homomorphic encryption for privacy
+ * - U.S. scale hierarchical aggregation
  *
  * @example
  * ```typescript
@@ -33,11 +34,10 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VotingMethod = exports.EventType = exports.PollEventLogger = exports.PublicBulletinBoard = exports.AuditEventType = exports.ImmutableAuditLog = exports.VOTING_SECURITY = exports.VotingSecurityValidator = exports.PollFactory = exports.VoteEncoder = exports.PollTallier = exports.VotingPoll = exports.Poll = void 0;
+exports.BatchVoteProcessor = exports.NationalAggregator = exports.StateAggregator = exports.CountyAggregator = exports.PrecinctAggregator = exports.PollEventLogger = exports.PublicBulletinBoard = exports.ImmutableAuditLog = exports.VOTING_SECURITY = exports.VotingSecurityValidator = exports.PollFactory = exports.VoteEncoder = exports.PollTallier = exports.Poll = void 0;
+const tslib_1 = require("tslib");
 var poll_core_1 = require("./poll-core");
 Object.defineProperty(exports, "Poll", { enumerable: true, get: function () { return poll_core_1.Poll; } });
-var poll_1 = require("./poll");
-Object.defineProperty(exports, "VotingPoll", { enumerable: true, get: function () { return poll_1.VotingPoll; } });
 var tallier_1 = require("./tallier");
 Object.defineProperty(exports, "PollTallier", { enumerable: true, get: function () { return tallier_1.PollTallier; } });
 var encoder_1 = require("./encoder");
@@ -49,12 +49,17 @@ Object.defineProperty(exports, "VotingSecurityValidator", { enumerable: true, ge
 Object.defineProperty(exports, "VOTING_SECURITY", { enumerable: true, get: function () { return security_1.VOTING_SECURITY; } });
 var audit_1 = require("./audit");
 Object.defineProperty(exports, "ImmutableAuditLog", { enumerable: true, get: function () { return audit_1.ImmutableAuditLog; } });
-Object.defineProperty(exports, "AuditEventType", { enumerable: true, get: function () { return audit_1.AuditEventType; } });
 var bulletin_board_1 = require("./bulletin-board");
 Object.defineProperty(exports, "PublicBulletinBoard", { enumerable: true, get: function () { return bulletin_board_1.PublicBulletinBoard; } });
 var event_logger_1 = require("./event-logger");
 Object.defineProperty(exports, "PollEventLogger", { enumerable: true, get: function () { return event_logger_1.PollEventLogger; } });
-Object.defineProperty(exports, "EventType", { enumerable: true, get: function () { return event_logger_1.EventType; } });
-var types_1 = require("./types");
-Object.defineProperty(exports, "VotingMethod", { enumerable: true, get: function () { return types_1.VotingMethod; } });
+var hierarchical_aggregator_1 = require("./hierarchical-aggregator");
+Object.defineProperty(exports, "PrecinctAggregator", { enumerable: true, get: function () { return hierarchical_aggregator_1.PrecinctAggregator; } });
+Object.defineProperty(exports, "CountyAggregator", { enumerable: true, get: function () { return hierarchical_aggregator_1.CountyAggregator; } });
+Object.defineProperty(exports, "StateAggregator", { enumerable: true, get: function () { return hierarchical_aggregator_1.StateAggregator; } });
+Object.defineProperty(exports, "NationalAggregator", { enumerable: true, get: function () { return hierarchical_aggregator_1.NationalAggregator; } });
+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);
 //# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;AAEH,yCAAmC;AAA1B,iGAAA,IAAI,OAAA;AACb,+BAAoC;AAA3B,kGAAA,UAAU,OAAA;AACnB,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,iCAKiB;AAJf,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AAIhB,mDAK0B;AAJxB,qHAAA,mBAAmB,OAAA;AAKrB,+CAMwB;AALtB,+GAAA,eAAe,OAAA;AACf,yGAAA,SAAS,OAAA;AAKX,iCAQiB;AAPf,qGAAA,YAAY,OAAA"}
+{"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"}

package/src/lib/voting/interfaces/aggregated-tally.d.ts

@@ -0,0 +1,11 @@
+import type { PlatformID } from '../../../interfaces';
+import { JurisdictionLevel } from '../enumerations/jurisdictional-level';
+export interface AggregatedTally<TID extends PlatformID = Uint8Array> {
+    jurisdictionId: TID;
+    level: JurisdictionLevel;
+    encryptedTallies: bigint[];
+    voterCount: number;
+    timestamp: number;
+    childJurisdictions?: TID[];
+}
+//# sourceMappingURL=aggregated-tally.d.ts.map

package/src/lib/voting/interfaces/aggregated-tally.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregated-tally.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/aggregated-tally.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,MAAM,WAAW,eAAe,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IAClE,cAAc,EAAE,GAAG,CAAC;IACpB,KAAK,EAAE,iBAAiB,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,GAAG,EAAE,CAAC;CAC5B"}

package/src/{interfaces/member-with-mnemonic.js → lib/voting/interfaces/aggregated-tally.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=member-with-mnemonic.js.map
+//# sourceMappingURL=aggregated-tally.js.map

package/src/lib/voting/interfaces/aggregated-tally.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregated-tally.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/aggregated-tally.ts"],"names":[],"mappings":""}

package/src/lib/voting/interfaces/audit-entry.d.ts

@@ -0,0 +1,25 @@
+import type { PlatformID } from '../../../interfaces';
+import { AuditEventType } from '../enumerations/audit-event-type';
+export interface AuditEntry<TID extends PlatformID> {
+    /** Sequence number (monotonically increasing) */
+    readonly sequence: number;
+    /** Event type */
+    readonly eventType: AuditEventType;
+    /** Microsecond-precision timestamp */
+    readonly timestamp: number;
+    /** Poll identifier */
+    readonly pollId: TID;
+    /** Hash of voter ID (for vote events) */
+    readonly voterIdHash?: Uint8Array;
+    /** Authority/creator ID (for creation/closure events) */
+    readonly authorityId?: TID;
+    /** Hash of previous entry (chain integrity) */
+    readonly previousHash: Uint8Array;
+    /** Hash of this entry's data */
+    readonly entryHash: Uint8Array;
+    /** Cryptographic signature from authority */
+    readonly signature: Uint8Array;
+    /** Additional metadata */
+    readonly metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=audit-entry.d.ts.map

package/src/lib/voting/interfaces/audit-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-entry.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/audit-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,MAAM,WAAW,UAAU,CAAC,GAAG,SAAS,UAAU;IAChD,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iBAAiB;IACjB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C"}

package/src/lib/voting/interfaces/audit-entry.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=audit-entry.js.map

package/src/lib/voting/interfaces/audit-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-entry.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/audit-entry.ts"],"names":[],"mappings":""}

package/src/lib/voting/interfaces/audit-log.d.ts

@@ -0,0 +1,13 @@
+import type { PlatformID } from '../../../interfaces';
+import { AuditEntry } from './audit-entry';
+export interface AuditLog<TID extends PlatformID> {
+    /** Get all entries in chronological order */
+    getEntries(): readonly AuditEntry<TID>[];
+    /** Get entries for a specific poll */
+    getEntriesForPoll(pollId: TID): readonly AuditEntry<TID>[];
+    /** Verify the entire chain integrity */
+    verifyChain(): boolean;
+    /** Verify a specific entry's signature */
+    verifyEntry(entry: AuditEntry<TID>): boolean;
+}
+//# sourceMappingURL=audit-log.d.ts.map

package/src/lib/voting/interfaces/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/audit-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,QAAQ,CAAC,GAAG,SAAS,UAAU;IAC9C,6CAA6C;IAC7C,UAAU,IAAI,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IACzC,sCAAsC;IACtC,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3D,wCAAwC;IACxC,WAAW,IAAI,OAAO,CAAC;IACvB,0CAA0C;IAC1C,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;CAC9C"}

package/src/lib/voting/interfaces/audit-log.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=audit-log.js.map

package/src/lib/voting/interfaces/audit-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/audit-log.ts"],"names":[],"mappings":""}

package/src/lib/voting/interfaces/bulletin-board-entry.d.ts

@@ -0,0 +1,20 @@
+import type { PlatformID } from '../../../interfaces';
+export interface BulletinBoardEntry<TID extends PlatformID = Uint8Array> {
+    /** Sequence number (monotonically increasing) */
+    readonly sequence: number;
+    /** Microsecond-precision timestamp */
+    readonly timestamp: number;
+    /** Poll identifier */
+    readonly pollId: TID;
+    /** Encrypted vote data */
+    readonly encryptedVote: bigint[];
+    /** Hash of voter ID (anonymized) */
+    readonly voterIdHash: Uint8Array;
+    /** Merkle root of all entries up to this point */
+    readonly merkleRoot: Uint8Array;
+    /** Hash of this entry */
+    readonly entryHash: Uint8Array;
+    /** Authority signature */
+    readonly signature: Uint8Array;
+}
+//# sourceMappingURL=bulletin-board-entry.d.ts.map

package/src/lib/voting/interfaces/bulletin-board-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulletin-board-entry.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/bulletin-board-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IACrE,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;CAChC"}

package/src/lib/voting/interfaces/bulletin-board-entry.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=bulletin-board-entry.js.map

package/src/lib/voting/interfaces/bulletin-board-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulletin-board-entry.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/bulletin-board-entry.ts"],"names":[],"mappings":""}

package/src/lib/voting/interfaces/bulletin-board.d.ts

@@ -0,0 +1,24 @@
+import type { PlatformID } from '../../../interfaces';
+import { BulletinBoardEntry } from './bulletin-board-entry';
+import { TallyProof } from './tally-proof';
+export interface BulletinBoard<TID extends PlatformID = Uint8Array> {
+    /** Publish encrypted vote to bulletin board */
+    publishVote(pollId: TID, encryptedVote: bigint[], voterIdHash: Uint8Array): BulletinBoardEntry<TID>;
+    /** Publish tally with cryptographic proof */
+    publishTally(pollId: TID, tallies: bigint[], choices: string[], encryptedVotes: bigint[][]): TallyProof<TID>;
+    /** Get all entries for a poll */
+    getEntries(pollId: TID): readonly BulletinBoardEntry<TID>[];
+    /** Get all entries (entire bulletin board) */
+    getAllEntries(): readonly BulletinBoardEntry<TID>[];
+    /** Get tally proof for a poll */
+    getTallyProof(pollId: TID): TallyProof<TID> | undefined;
+    /** Verify entry signature and hash */
+    verifyEntry(entry: BulletinBoardEntry<TID>): boolean;
+    /** Verify tally proof */
+    verifyTallyProof(proof: TallyProof<TID>): boolean;
+    /** Verify Merkle tree integrity */
+    verifyMerkleTree(): boolean;
+    /** Export complete bulletin board for archival */
+    export(): Uint8Array;
+}
+//# sourceMappingURL=bulletin-board.d.ts.map

package/src/lib/voting/interfaces/bulletin-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulletin-board.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/bulletin-board.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,aAAa,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IAChE,+CAA+C;IAC/C,WAAW,CACT,MAAM,EAAE,GAAG,EACX,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,EAAE,UAAU,GACtB,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAE3B,6CAA6C;IAC7C,YAAY,CACV,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,cAAc,EAAE,MAAM,EAAE,EAAE,GACzB,UAAU,CAAC,GAAG,CAAC,CAAC;IACnB,iCAAiC;IACjC,UAAU,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;IAE5D,8CAA8C;IAC9C,aAAa,IAAI,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;IAEpD,iCAAiC;IACjC,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAExD,sCAAsC;IACtC,WAAW,CAAC,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IAErD,yBAAyB;IACzB,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IAElD,mCAAmC;IACnC,gBAAgB,IAAI,OAAO,CAAC;IAE5B,kDAAkD;IAClD,MAAM,IAAI,UAAU,CAAC;CACtB"}

package/src/lib/voting/interfaces/bulletin-board.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=bulletin-board.js.map

package/src/lib/voting/interfaces/bulletin-board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulletin-board.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/bulletin-board.ts"],"names":[],"mappings":""}

package/src/lib/voting/interfaces/checkpoint-manager-extended.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformID } from '../../../interfaces';
+import { AggregatedTally } from './aggregated-tally';
+import { ICheckpointManager } from './checkpoint-manager';
+import { CheckpointMetadata } from './checkpoint-metadata';
+import { StateSnapshot } from './state-snapshot';
+/**
+ * Checkpoint manager interface - implemented in node-ecies-lib
+ */
+export interface ICheckpointManagerExtended<TID extends PlatformID = Uint8Array> extends ICheckpointManager<TID> {
+    saveCheckpoint(tally: AggregatedTally<TID>): Promise<void>;
+    loadLatestCheckpoint(): Promise<StateSnapshot<TID> | null>;
+    listCheckpoints(): Promise<CheckpointMetadata[]>;
+}
+//# sourceMappingURL=checkpoint-manager-extended.d.ts.map

package/src/lib/voting/interfaces/checkpoint-manager-extended.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager-extended.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/checkpoint-manager-extended.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,0BAA0B,CACzC,GAAG,SAAS,UAAU,GAAG,UAAU,CACnC,SAAQ,kBAAkB,CAAC,GAAG,CAAC;IAC/B,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3D,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;CAClD"}

package/src/lib/voting/interfaces/checkpoint-manager-extended.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=checkpoint-manager-extended.js.map

package/src/lib/voting/interfaces/checkpoint-manager-extended.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager-extended.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/checkpoint-manager-extended.ts"],"names":[],"mappings":""}

package/src/lib/voting/interfaces/checkpoint-manager.d.ts

@@ -0,0 +1,8 @@
+import type { PlatformID } from '../../../interfaces';
+import { AggregatedTally } from './aggregated-tally';
+export interface ICheckpointManager<TID extends PlatformID = Uint8Array> {
+    saveCheckpoint(tally: AggregatedTally<TID>): Promise<void>;
+    loadLatestCheckpoint(): Promise<unknown | null>;
+    listCheckpoints(): Promise<unknown[]>;
+}
+//# sourceMappingURL=checkpoint-manager.d.ts.map

package/src/lib/voting/interfaces/checkpoint-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/checkpoint-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IACrE,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,oBAAoB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChD,eAAe,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACvC"}

package/src/lib/voting/interfaces/checkpoint-manager.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=checkpoint-manager.js.map

package/src/lib/voting/interfaces/checkpoint-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/checkpoint-manager.ts"],"names":[],"mappings":""}

package/src/lib/voting/interfaces/checkpoint-metadata.d.ts

@@ -0,0 +1,9 @@
+import { JurisdictionLevel } from '../enumerations';
+export interface CheckpointMetadata {
+    jurisdictionId: string;
+    level: JurisdictionLevel;
+    voterCount: number;
+    timestamp: number;
+    checkpointNumber: number;
+}
+//# sourceMappingURL=checkpoint-metadata.d.ts.map

package/src/lib/voting/interfaces/checkpoint-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-metadata.d.ts","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/checkpoint-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/src/lib/voting/interfaces/checkpoint-metadata.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=checkpoint-metadata.js.map

package/src/lib/voting/interfaces/checkpoint-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-metadata.js","sourceRoot":"","sources":["../../../../../../../packages/digitaldefiance-ecies-lib/src/lib/voting/interfaces/checkpoint-metadata.ts"],"names":[],"mappings":""}