@digitaldefiance/node-ecies-lib 4.7.15 → 4.8.0

package/src/interfaces/voting-poll.d.ts

@@ -0,0 +1,447 @@
+/**
+ * Voting Poll System Interfaces (Node.js Buffer version)
+ *
+ * Node.js-specific interfaces for the voting poll system using Buffer instead of Uint8Array.
+ * These interfaces ensure type safety and API consistency with the browser version.
+ */
+import type { PublicKey, PrivateKey, KeyPair } from 'paillier-bigint';
+/**
+ * Voting methods supported by the poll system
+ */
+export declare enum VotingMethod {
+    Plurality = "plurality",
+    Approval = "approval",
+    Weighted = "weighted",
+    Borda = "borda",
+    Score = "score",
+    YesNo = "yes-no",
+    YesNoAbstain = "yes-no-abstain",
+    Supermajority = "supermajority",
+    RankedChoice = "ranked-choice",
+    TwoRound = "two-round",
+    STAR = "star",
+    STV = "stv",
+    Quadratic = "quadratic",
+    Consensus = "consensus",
+    ConsentBased = "consent-based"
+}
+/**
+ * Vote receipt proving participation.
+ * Cryptographically signed proof that a vote was cast.
+ */
+export interface IVoteReceipt {
+    /** Unique identifier of the voter */
+    voterId: Buffer;
+    /** Unique identifier of the poll */
+    pollId: Buffer;
+    /** Unix timestamp when vote was cast */
+    timestamp: number;
+    /** Cryptographic signature from poll authority */
+    signature: Buffer;
+    /** Random nonce for uniqueness */
+    nonce: Buffer;
+}
+/**
+ * Encrypted vote data using Paillier homomorphic encryption.
+ * Structure varies by voting method.
+ */
+export interface IEncryptedVote {
+    /** Single choice index (for Plurality, Weighted, etc.) */
+    choiceIndex?: number;
+    /** Multiple choice indices (for Approval voting) */
+    choices?: number[];
+    /** Ranked choice indices in preference order (for RCV, Borda) */
+    rankings?: number[];
+    /** Vote weight (for Weighted voting) */
+    weight?: bigint;
+    /** Score value 0-10 (for Score voting) */
+    score?: number;
+    /** Array of encrypted vote values (one per choice) */
+    encrypted: bigint[];
+    /** Plaintext vote data (only for insecure methods) */
+    plaintext?: IPlaintextVote;
+}
+/**
+ * Plaintext vote data for insecure voting methods.
+ * WARNING: Only use for Quadratic, Consensus, or ConsentBased methods.
+ */
+export interface IPlaintextVote {
+    /** Unique identifier of the voter */
+    voterId: Buffer;
+    /** Single choice index */
+    choiceIndex?: number;
+    /** Multiple choice indices */
+    choices?: number[];
+    /** Vote weight */
+    weight?: bigint;
+    /** Objection text (for consent-based voting) */
+    objection?: string;
+}
+/**
+ * Results of a completed poll after tallying.
+ * Includes winner(s), tallies, and round-by-round data for multi-round methods.
+ */
+export interface IPollResults {
+    /** Voting method used */
+    method: VotingMethod;
+    /** Array of choice names */
+    choices: string[];
+    /** Index of winning choice (undefined if tie) */
+    winner?: number;
+    /** Indices of tied winners (for ties or multi-winner methods) */
+    winners?: number[];
+    /** Indices of eliminated choices (for RCV) */
+    eliminated?: number[];
+    /** Round-by-round results (for multi-round methods) */
+    rounds?: IRoundResult[];
+    /** Final vote tallies for each choice */
+    tallies: bigint[];
+    /** Total number of unique voters */
+    voterCount: number;
+}
+/**
+ * Results from a single round of multi-round voting.
+ * Used in RCV, Two-Round, STAR, and STV methods.
+ */
+export interface IRoundResult {
+    /** Round number (1-indexed) */
+    round: number;
+    /** Vote tallies for this round */
+    tallies: bigint[];
+    /** Index of choice eliminated this round (if any) */
+    eliminated?: number;
+    /** Index of winner determined this round (if any) */
+    winner?: number;
+}
+/**
+ * Configuration for supermajority voting.
+ * Defines the required threshold as a fraction (e.g., 2/3, 3/4).
+ */
+export interface ISupermajorityConfig {
+    /** Numerator of the fraction (e.g., 2 for 2/3) */
+    numerator: number;
+    /** Denominator of the fraction (e.g., 3 for 2/3) */
+    denominator: number;
+}
+/**
+ * Member interface for voting operations.
+ * Extends base member with voting-specific capabilities.
+ */
+export interface IVotingMember {
+    /** Unique identifier of the member */
+    readonly id: Buffer;
+    /** ECDSA public key for signing */
+    readonly publicKey: Buffer;
+    /** Paillier public key for vote encryption (optional) */
+    readonly votingPublicKey?: PublicKey;
+    /** Paillier private key for vote decryption (optional) */
+    readonly votingPrivateKey?: PrivateKey;
+    /**
+     * Sign data with member's private key.
+     * @param data - Data to sign
+     * @returns Signature
+     */
+    sign(data: Buffer): Buffer;
+    /**
+     * Verify signature against data.
+     * @param signature - Signature to verify
+     * @param data - Original data
+     * @returns True if signature is valid
+     */
+    verify(signature: Buffer, data: Buffer): boolean;
+}
+/**
+ * Poll interface for vote aggregation and management.
+ * Holds encrypted votes and issues receipts, but cannot decrypt votes.
+ */
+export interface IPoll {
+    /** Unique identifier of the poll */
+    readonly id: Buffer;
+    /** Array of choice names */
+    readonly choices: ReadonlyArray<string>;
+    /** Voting method used */
+    readonly method: VotingMethod;
+    /** Whether poll is closed to new votes */
+    readonly isClosed: boolean;
+    /** Total number of unique voters */
+    readonly voterCount: number;
+    /** Unix timestamp when poll was created */
+    readonly createdAt: number;
+    /** Unix timestamp when poll was closed (undefined if open) */
+    readonly closedAt: number | undefined;
+    /**
+     * Cast a vote in the poll.
+     * @param voter - Member casting the vote
+     * @param vote - Encrypted vote data
+     * @returns Vote receipt
+     * @throws Error if poll is closed or voter already voted
+     */
+    vote(voter: IVotingMember, vote: IEncryptedVote): IVoteReceipt;
+    /**
+     * Verify a vote receipt is valid.
+     * @param voter - Member who cast the vote
+     * @param receipt - Receipt to verify
+     * @returns True if receipt is valid
+     */
+    verifyReceipt(voter: IVotingMember, receipt: IVoteReceipt): boolean;
+    /**
+     * Close the poll to new votes.
+     * @throws Error if poll is already closed
+     */
+    close(): void;
+    /**
+     * Get encrypted votes for tallying (read-only).
+     * @returns Map of voter ID to encrypted vote data
+     */
+    getEncryptedVotes(): ReadonlyMap<string, readonly bigint[]>;
+}
+/**
+ * Vote encoder interface for encrypting votes.
+ * Converts vote choices into encrypted Paillier ciphertexts.
+ */
+export interface IVoteEncoder {
+    /**
+     * Encode a plurality vote (single choice).
+     * @param choiceIndex - Index of chosen option
+     * @param choiceCount - Total number of choices
+     * @returns Encrypted vote
+     */
+    encodePlurality(choiceIndex: number, choiceCount: number): IEncryptedVote;
+    /**
+     * Encode an approval vote (multiple choices).
+     * @param choices - Indices of approved options
+     * @param choiceCount - Total number of choices
+     * @returns Encrypted vote
+     */
+    encodeApproval(choices: number[], choiceCount: number): IEncryptedVote;
+    /**
+     * Encode a weighted vote.
+     * @param choiceIndex - Index of chosen option
+     * @param weight - Vote weight (must be positive)
+     * @param choiceCount - Total number of choices
+     * @returns Encrypted vote
+     */
+    encodeWeighted(choiceIndex: number, weight: bigint, choiceCount: number): IEncryptedVote;
+    /**
+     * Encode a Borda count vote (ranked with points).
+     * @param rankings - Indices in preference order
+     * @param choiceCount - Total number of choices
+     * @returns Encrypted vote
+     */
+    encodeBorda(rankings: number[], choiceCount: number): IEncryptedVote;
+    /**
+     * Encode a ranked choice vote (for IRV).
+     * @param rankings - Indices in preference order
+     * @param choiceCount - Total number of choices
+     * @returns Encrypted vote
+     */
+    encodeRankedChoice(rankings: number[], choiceCount: number): IEncryptedVote;
+    /**
+     * Encode vote based on method.
+     * @param method - Voting method
+     * @param data - Vote data
+     * @param choiceCount - Total number of choices
+     * @returns Encrypted vote
+     */
+    encode(method: VotingMethod, data: {
+        choiceIndex?: number;
+        choices?: number[];
+        rankings?: number[];
+        weight?: bigint;
+    }, choiceCount: number): IEncryptedVote;
+}
+/**
+ * Poll tallier interface for decrypting and tallying votes.
+ * Holds private key and can decrypt results after poll closes.
+ */
+export interface IPollTallier {
+    /**
+     * Tally votes and determine winner(s).
+     * @param poll - Poll to tally
+     * @returns Poll results
+     * @throws Error if poll is not closed
+     */
+    tally(poll: IPoll): IPollResults;
+    /**
+     * Tally ranked choice votes using IRV algorithm.
+     * @param poll - Poll to tally
+     * @returns Poll results with elimination rounds
+     */
+    tallyRankedChoice(poll: IPoll): IPollResults;
+}
+/**
+ * Poll factory interface for creating polls.
+ */
+export interface IPollFactory {
+    /**
+     * Create a poll with specified method.
+     * @param choices - Array of choice names
+     * @param method - Voting method
+     * @param authority - Poll authority
+     * @param options - Optional configuration
+     * @returns New poll
+     */
+    create(choices: string[], method: VotingMethod, authority: IVotingMember, options?: {
+        maxWeight?: bigint;
+    }): IPoll;
+    /**
+     * Create a plurality poll.
+     * @param choices - Array of choice names
+     * @param authority - Poll authority
+     * @returns New poll
+     */
+    createPlurality(choices: string[], authority: IVotingMember): IPoll;
+    /**
+     * Create an approval voting poll.
+     * @param choices - Array of choice names
+     * @param authority - Poll authority
+     * @returns New poll
+     */
+    createApproval(choices: string[], authority: IVotingMember): IPoll;
+    /**
+     * Create a weighted voting poll.
+     * @param choices - Array of choice names
+     * @param authority - Poll authority
+     * @param maxWeight - Maximum vote weight
+     * @returns New poll
+     */
+    createWeighted(choices: string[], authority: IVotingMember, maxWeight: bigint): IPoll;
+    /**
+     * Create a Borda count poll.
+     * @param choices - Array of choice names
+     * @param authority - Poll authority
+     * @returns New poll
+     */
+    createBorda(choices: string[], authority: IVotingMember): IPoll;
+    /**
+     * Create a ranked choice poll.
+     * @param choices - Array of choice names
+     * @param authority - Poll authority
+     * @returns New poll
+     */
+    createRankedChoice(choices: string[], authority: IVotingMember): IPoll;
+}
+/**
+ * Options for deriving Paillier voting keys from ECDH keys.
+ */
+export interface IVotingKeyDerivationOptions {
+    /** Elliptic curve name (default: 'secp256k1') */
+    curveName?: string;
+    /** Public key magic byte (default: 0x04) */
+    publicKeyMagic?: number;
+    /** Raw public key length (default: 64) */
+    rawPublicKeyLength?: number;
+    /** Public key length with prefix (default: 65) */
+    publicKeyLength?: number;
+    /** HMAC algorithm (default: 'sha512') */
+    hmacAlgorithm?: string;
+    /** HKDF info string (default: 'PaillierPrimeGen') */
+    hkdfInfo?: string;
+    /** HKDF output length (default: 64) */
+    hkdfLength?: number;
+    /** Key pair bit length (default: 3072) */
+    keypairBitLength?: number;
+    /** Prime test iterations (default: 256) */
+    primeTestIterations?: number;
+    /** Max prime generation attempts (default: 20000) */
+    maxPrimeAttempts?: number;
+}
+/**
+ * Security level classification for voting methods.
+ * Determines cryptographic security guarantees.
+ */
+export declare enum SecurityLevel {
+    /** Fully homomorphic - no intermediate decryption required */
+    FullyHomomorphic = "fully-homomorphic",
+    /** Multi-round - requires intermediate decryption between rounds */
+    MultiRound = "multi-round",
+    /** Insecure - cannot be made secure with Paillier encryption */
+    Insecure = "insecure"
+}
+/**
+ * Voting security validator interface.
+ * Validates voting methods against security requirements.
+ */
+export interface IVotingSecurityValidator {
+    /**
+     * Check if voting method is fully secure (no intermediate decryption).
+     * @param method - Voting method to check
+     * @returns True if method is fully homomorphic
+     */
+    isFullySecure(method: VotingMethod): boolean;
+    /**
+     * Check if voting method requires multiple rounds.
+     * @param method - Voting method to check
+     * @returns True if method requires intermediate decryption
+     */
+    requiresMultipleRounds(method: VotingMethod): boolean;
+    /**
+     * Get security level for voting method.
+     * @param method - Voting method to check
+     * @returns Security level classification
+     */
+    getSecurityLevel(method: VotingMethod): SecurityLevel;
+    /**
+     * Validate voting method against security requirements.
+     * Throws error if method doesn't meet requirements.
+     * @param method - Voting method to validate
+     * @param options - Validation options
+     * @throws Error if validation fails
+     */
+    validate(method: VotingMethod, options?: {
+        requireFullySecure?: boolean;
+        allowInsecure?: boolean;
+    }): void;
+}
+/**
+ * Integrated ECIES service with voting support.
+ * Provides access to voting key derivation and serialization.
+ */
+export interface IECIESServiceWithVoting {
+    /** Voting service accessor */
+    readonly voting: {
+        /**
+         * Derive Paillier voting keys from ECDH key pair.
+         * @param ecdhPrivateKey - ECDH private key
+         * @param ecdhPublicKey - ECDH public key
+         * @param options - Derivation options
+         * @returns Paillier key pair
+         */
+        deriveVotingKeysFromECDH(ecdhPrivateKey: Buffer, ecdhPublicKey: Buffer, options?: IVotingKeyDerivationOptions): Promise<KeyPair>;
+        /**
+         * Generate deterministic key pair from seed.
+         * WARNING: For testing only!
+         * @param seed - Random seed (min 32 bytes)
+         * @param bitLength - Key bit length
+         * @param iterations - Prime test iterations
+         * @returns Paillier key pair
+         */
+        generateDeterministicKeyPair(seed: Buffer, bitLength?: number, iterations?: number): Promise<KeyPair>;
+        /**
+         * Serialize public key to buffer.
+         * @param publicKey - Public key
+         * @returns Serialized buffer
+         */
+        votingPublicKeyToBuffer(publicKey: PublicKey): Buffer | Promise<Buffer>;
+        /**
+         * Deserialize public key from buffer.
+         * @param buffer - Serialized buffer
+         * @returns Public key
+         */
+        bufferToVotingPublicKey(buffer: Buffer): Promise<PublicKey>;
+        /**
+         * Serialize private key to buffer.
+         * @param privateKey - Private key
+         * @returns Serialized buffer
+         */
+        votingPrivateKeyToBuffer(privateKey: PrivateKey): Buffer;
+        /**
+         * Deserialize private key from buffer.
+         * @param buffer - Serialized buffer
+         * @param publicKey - Corresponding public key
+         * @returns Private key
+         */
+        bufferToVotingPrivateKey(buffer: Buffer, publicKey: PublicKey): Promise<PrivateKey>;
+    };
+}
+//# sourceMappingURL=voting-poll.d.ts.map

package/src/interfaces/voting-poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voting-poll.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/interfaces/voting-poll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;GAEG;AACH,oBAAY,YAAY;IAEtB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,WAAW;IAChB,YAAY,mBAAmB;IAC/B,aAAa,kBAAkB;IAG/B,YAAY,kBAAkB;IAC9B,QAAQ,cAAc;IACtB,IAAI,SAAS;IACb,GAAG,QAAQ;IAGX,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,YAAY,kBAAkB;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC;IACvC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEtC;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,GAAG,YAAY,CAAC;IAE/D;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAEpE;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;OAGG;IACH,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC;IAC1E;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC;IACvE;;;;;;OAMG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,cAAc,CAAC;IAClB;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC;IACrE;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC;IAC5E;;;;;;OAMG;IACH,MAAM,CACJ,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;QACJ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,EACD,WAAW,EAAE,MAAM,GAClB,cAAc,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC;IACjC;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,KAAK,CAAC;IACT;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,KAAK,CAAC;IACpE;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,KAAK,CAAC;IACnE;;;;;;OAMG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;IACT;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,KAAK,CAAC;IAChE;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,KAAK,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,oBAAY,aAAa;IACvB,8DAA8D;IAC9D,gBAAgB,sBAAsB;IACtC,oEAAoE;IACpE,UAAU,gBAAgB;IAC1B,gEAAgE;IAChE,QAAQ,aAAa;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IAE7C;;;;OAIG;IACH,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IAEtD;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC;IAEtD;;;;;;OAMG;IACH,QAAQ,CACN,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;QACR,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GACA,IAAI,CAAC;CACT;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE;QACf;;;;;;WAMG;QACH,wBAAwB,CACtB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEpB;;;;;;;WAOG;QACH,4BAA4B,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;QAEpB;;;;WAIG;QACH,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACxE;;;;WAIG;QACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5D;;;;WAIG;QACH,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;QACzD;;;;;WAKG;QACH,wBAAwB,CACtB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC;KACxB,CAAC;CACH"}

package/src/interfaces/voting-poll.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Voting Poll System Interfaces (Node.js Buffer version)
+ *
+ * Node.js-specific interfaces for the voting poll system using Buffer instead of Uint8Array.
+ * These interfaces ensure type safety and API consistency with the browser version.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityLevel = exports.VotingMethod = void 0;
+/**
+ * Voting methods supported by the poll system
+ */
+var VotingMethod;
+(function (VotingMethod) {
+    // Fully homomorphic (single-round, privacy-preserving)
+    VotingMethod["Plurality"] = "plurality";
+    VotingMethod["Approval"] = "approval";
+    VotingMethod["Weighted"] = "weighted";
+    VotingMethod["Borda"] = "borda";
+    VotingMethod["Score"] = "score";
+    VotingMethod["YesNo"] = "yes-no";
+    VotingMethod["YesNoAbstain"] = "yes-no-abstain";
+    VotingMethod["Supermajority"] = "supermajority";
+    // Multi-round (requires decryption between rounds)
+    VotingMethod["RankedChoice"] = "ranked-choice";
+    VotingMethod["TwoRound"] = "two-round";
+    VotingMethod["STAR"] = "star";
+    VotingMethod["STV"] = "stv";
+    // Insecure (requires non-additive operations)
+    VotingMethod["Quadratic"] = "quadratic";
+    VotingMethod["Consensus"] = "consensus";
+    VotingMethod["ConsentBased"] = "consent-based";
+})(VotingMethod || (exports.VotingMethod = VotingMethod = {}));
+/**
+ * Security level classification for voting methods.
+ * Determines cryptographic security guarantees.
+ */
+var SecurityLevel;
+(function (SecurityLevel) {
+    /** Fully homomorphic - no intermediate decryption required */
+    SecurityLevel["FullyHomomorphic"] = "fully-homomorphic";
+    /** Multi-round - requires intermediate decryption between rounds */
+    SecurityLevel["MultiRound"] = "multi-round";
+    /** Insecure - cannot be made secure with Paillier encryption */
+    SecurityLevel["Insecure"] = "insecure";
+})(SecurityLevel || (exports.SecurityLevel = SecurityLevel = {}));
+//# sourceMappingURL=voting-poll.js.map

package/src/interfaces/voting-poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voting-poll.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/interfaces/voting-poll.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH;;GAEG;AACH,IAAY,YAqBX;AArBD,WAAY,YAAY;IACtB,uDAAuD;IACvD,uCAAuB,CAAA;IACvB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,+BAAe,CAAA;IACf,+BAAe,CAAA;IACf,gCAAgB,CAAA;IAChB,+CAA+B,CAAA;IAC/B,+CAA+B,CAAA;IAE/B,mDAAmD;IACnD,8CAA8B,CAAA;IAC9B,sCAAsB,CAAA;IACtB,6BAAa,CAAA;IACb,2BAAW,CAAA;IAEX,8CAA8C;IAC9C,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;IACvB,8CAA8B,CAAA;AAChC,CAAC,EArBW,YAAY,4BAAZ,YAAY,QAqBvB;AAkWD;;;GAGG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,8DAA8D;IAC9D,uDAAsC,CAAA;IACtC,oEAAoE;IACpE,2CAA0B,CAAA;IAC1B,gEAAgE;IAChE,sCAAqB,CAAA;AACvB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB"}

package/src/interfaces/voting-service.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Common interface for VotingService across ecies-lib and node-ecies-lib (Node.js Buffer version)
+ *
+ * This interface defines the shared contract that both browser (Web Crypto)
+ * and Node.js (crypto module) implementations must adhere to, ensuring
+ * consistent behavior and cross-platform compatibility.
+ */
+import type { KeyPair, PrivateKey, PublicKey } from 'paillier-bigint';
+import type { IsolatedPrivateKey } from '../isolated-private';
+import type { IsolatedPublicKey } from '../isolated-public';
+/**
+ * Common interface for VotingService implementations (Node.js Buffer version)
+ */
+export interface IVotingService {
+    /**
+     * Serialize a base Paillier public key with magic/version/keyId
+     * Format: [magic:4][version:1][keyId:32][n_length:4][n:variable]
+     *
+     * @param publicKey - Paillier public key to serialize
+     * @returns Buffer
+     */
+    votingPublicKeyToBuffer(publicKey: PublicKey): Buffer | Promise<Buffer>;
+    /**
+     * Deserialize a base Paillier public key from buffer
+     * Format: [magic:4][version:1][keyId:32][n_length:4][n:variable]
+     *
+     * @param buffer - Serialized public key
+     * @returns Deserialized Paillier public key
+     */
+    bufferToVotingPublicKey(buffer: Buffer): Promise<PublicKey>;
+    /**
+     * Serialize a base Paillier private key with magic/version
+     * Format: [magic:4][version:1][lambda_length:4][lambda:variable][mu_length:4][mu:variable]
+     *
+     * @param privateKey - Paillier private key to serialize
+     * @returns Buffer
+     */
+    votingPrivateKeyToBuffer(privateKey: PrivateKey): Buffer;
+    /**
+     * Deserialize a base Paillier private key from buffer
+     * Format: [magic:4][version:1][lambda_length:4][lambda:variable][mu_length:4][mu:variable]
+     *
+     * @param buffer - Serialized private key
+     * @param publicKey - Corresponding public key
+     * @returns Deserialized Paillier private key
+     */
+    bufferToVotingPrivateKey(buffer: Buffer, publicKey: PublicKey): Promise<PrivateKey>;
+    /**
+     * Serialize an IsolatedPublicKey with magic/version/keyId/instanceId
+     * Format: [magic:4][version:1][keyId:32][instanceId:32][n_length:4][n:variable]
+     *
+     * @param publicKey - Isolated public key to serialize
+     * @returns Buffer
+     */
+    isolatedPublicKeyToBuffer(publicKey: IsolatedPublicKey): Buffer;
+    /**
+     * Deserialize an IsolatedPublicKey from buffer
+     * Format: [magic:4][version:1][keyId:32][instanceId:32][n_length:4][n:variable]
+     *
+     * @param buffer - Serialized isolated public key
+     * @returns Deserialized IsolatedPublicKey
+     */
+    bufferToIsolatedPublicKey(buffer: Buffer): Promise<IsolatedPublicKey>;
+    /**
+     * Serialize an IsolatedPrivateKey
+     * Uses same format as base private key
+     *
+     * @param privateKey - Isolated private key to serialize
+     * @returns Buffer
+     */
+    isolatedPrivateKeyToBuffer(privateKey: IsolatedPrivateKey): Buffer;
+    /**
+     * Deserialize an IsolatedPrivateKey from buffer
+     *
+     * @param buffer - Serialized isolated private key
+     * @param publicKey - Corresponding IsolatedPublicKey
+     * @returns Deserialized IsolatedPrivateKey
+     */
+    bufferToIsolatedPrivateKey(buffer: Buffer, publicKey: IsolatedPublicKey): Promise<IsolatedPrivateKey>;
+    /**
+     * Derive Paillier voting keys from ECDH key pair
+     *
+     * SECURITY: This is the proper way to generate voting keys - they must be
+     * derived from ECDH keys to bind them to user identity.
+     *
+     * @param ecdhPrivateKey - ECDH private key
+     * @param ecdhPublicKey - ECDH public key
+     * @param options - Optional derivation parameters
+     * @returns Paillier key pair
+     */
+    deriveVotingKeysFromECDH(ecdhPrivateKey: Buffer, ecdhPublicKey: Buffer, options?: Record<string, unknown>): Promise<KeyPair>;
+    /**
+     * Generate deterministic Paillier key pair from seed
+     *
+     * WARNING: For testing only! Production voting keys MUST be derived from
+     * ECDH keys using deriveVotingKeysFromECDH().
+     *
+     * @param seed - Random seed for deterministic generation
+     * @param bitLength - Key bit length (default: 3072)
+     * @param iterations - Prime test iterations (default: 256)
+     * @returns Paillier key pair
+     */
+    generateDeterministicKeyPair(seed: Buffer, bitLength?: number, iterations?: number): Promise<KeyPair>;
+}
+/**
+ * Extended interface for IsolatedPublicKey with async methods (Node.js Buffer version)
+ * These are the actual methods used by the voting service implementations
+ */
+export interface IIsolatedPublicKeyAsync {
+    readonly keyId: Buffer;
+    getKeyId(): Buffer;
+    getInstanceId(): Buffer;
+    updateInstanceId(): Promise<void>;
+    verifyKeyIdAsync(): Promise<void>;
+    encryptAsync(m: bigint): Promise<bigint>;
+    multiplyAsync(ciphertext: bigint, constant: bigint): Promise<bigint>;
+    additionAsync(a: bigint, b: bigint): Promise<bigint>;
+    extractInstanceId(ciphertext: bigint): Promise<Buffer>;
+}
+/**
+ * Extended interface for IsolatedPrivateKey with async methods (Node.js Buffer version)
+ * These are the actual methods used by the voting service implementations
+ */
+export interface IIsolatedPrivateKeyAsync {
+    decryptAsync(taggedCiphertext: bigint): Promise<bigint>;
+    getOriginalKeyId(): Buffer;
+    getOriginalInstanceId(): Buffer;
+    getOriginalPublicKey(): IIsolatedPublicKeyAsync;
+}
+//# sourceMappingURL=voting-service.d.ts.map

package/src/interfaces/voting-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voting-service.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/interfaces/voting-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;;;;OAMG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE5D;;;;;;OAMG;IACH,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;IAEzD;;;;;;;OAOG;IACH,wBAAwB,CACtB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;OAMG;IACH,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAEhE;;;;;;OAMG;IACH,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEtE;;;;;;OAMG;IACH,0BAA0B,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC;IAEnE;;;;;;OAMG;IACH,0BAA0B,CACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,wBAAwB,CACtB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;;;;;OAUG;IACH,4BAA4B,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,IAAI,MAAM,CAAC;IACnB,aAAa,IAAI,MAAM,CAAC;IACxB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,gBAAgB,IAAI,MAAM,CAAC;IAC3B,qBAAqB,IAAI,MAAM,CAAC;IAChC,oBAAoB,IAAI,uBAAuB,CAAC;CACjD"}

package/src/interfaces/voting-service.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Common interface for VotingService across ecies-lib and node-ecies-lib (Node.js Buffer version)
+ *
+ * This interface defines the shared contract that both browser (Web Crypto)
+ * and Node.js (crypto module) implementations must adhere to, ensuring
+ * consistent behavior and cross-platform compatibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=voting-service.js.map

package/src/interfaces/voting-service.js.map

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