@digitaldefiance/ecies-lib 4.8.7 → 4.9.1

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

@@ -1,455 +0,0 @@
-/**
- * Voting Poll System Interfaces
- *
- * Common interfaces for the voting poll system that must be implemented
- * consistently across ecies-lib (browser) and node-ecies-lib (Node.js).
- *
- * These interfaces ensure type safety and API consistency across platforms,
- * enabling cross-platform voting applications with identical behavior.
- */
-import type { PublicKey, PrivateKey, KeyPair } from 'paillier-bigint';
-import type { PlatformBuffer } from './platform-buffer';
-/**
- * Voting methods supported by the poll system.
- * See VotingMethod in lib/voting/types.ts for detailed descriptions.
- */
-/**
- * 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: PlatformBuffer;
-    /** Unique identifier of the poll */
-    pollId: PlatformBuffer;
-    /** Unix timestamp when vote was cast */
-    timestamp: number;
-    /** Cryptographic signature from poll authority */
-    signature: PlatformBuffer;
-    /** Random nonce for uniqueness */
-    nonce: PlatformBuffer;
-}
-/**
- * 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: PlatformBuffer;
-    /** 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: PlatformBuffer;
-    /** ECDSA public key for signing */
-    readonly publicKey: PlatformBuffer;
-    /** 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: PlatformBuffer): PlatformBuffer;
-    /**
-     * Verify signature against data.
-     * @param signature - Signature to verify
-     * @param data - Original data
-     * @returns True if signature is valid
-     */
-    verify(signature: PlatformBuffer, data: PlatformBuffer): 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: PlatformBuffer;
-    /** 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: PlatformBuffer, ecdhPublicKey: PlatformBuffer, 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: PlatformBuffer, bitLength?: number, iterations?: number): Promise<KeyPair>;
-        /**
-         * Serialize public key to buffer.
-         * @param publicKey - Public key
-         * @returns Serialized buffer
-         */
-        votingPublicKeyToBuffer(publicKey: PublicKey): PlatformBuffer | Promise<PlatformBuffer>;
-        /**
-         * Deserialize public key from buffer.
-         * @param buffer - Serialized buffer
-         * @returns Public key
-         */
-        bufferToVotingPublicKey(buffer: PlatformBuffer): Promise<PublicKey>;
-        /**
-         * Serialize private key to buffer.
-         * @param privateKey - Private key
-         * @returns Serialized buffer
-         */
-        votingPrivateKeyToBuffer(privateKey: PrivateKey): PlatformBuffer;
-        /**
-         * Deserialize private key from buffer.
-         * @param buffer - Serialized buffer
-         * @param publicKey - Corresponding public key
-         * @returns Private key
-         */
-        bufferToVotingPrivateKey(buffer: PlatformBuffer, publicKey: PublicKey): Promise<PrivateKey>;
-    };
-}
-//# sourceMappingURL=voting-poll.d.ts.map

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

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

package/src/interfaces/voting-poll.js

@@ -1,54 +0,0 @@
-"use strict";
-/**
- * Voting Poll System Interfaces
- *
- * Common interfaces for the voting poll system that must be implemented
- * consistently across ecies-lib (browser) and node-ecies-lib (Node.js).
- *
- * These interfaces ensure type safety and API consistency across platforms,
- * enabling cross-platform voting applications with identical behavior.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SecurityLevel = exports.VotingMethod = void 0;
-/**
- * Voting methods supported by the poll system.
- * See VotingMethod in lib/voting/types.ts for detailed descriptions.
- */
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"voting-poll.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/voting-poll.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAKH;;;GAGG;AAEH;;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/lib/voting/poll.d.ts

@@ -1,125 +0,0 @@
-import { KeyPair as PaillierKeyPair } from 'paillier-bigint';
-import { PlatformID } from '../../interfaces';
-import { Member } from '../../member';
-import { ECIESService } from '../../services/ecies/service';
-import { VotingService } from '../../services/voting.service';
-export interface ECKeyPairBuffer {
-    privateKey: Uint8Array;
-    publicKey: Uint8Array;
-}
-/**
- * Result of a voting poll with decrypted tallies
- */
-export interface VotingPollResults {
-    /** Total number of votes cast */
-    totalVotes: bigint;
-    /** Tallies for each choice */
-    tallies: bigint[];
-    /** Choice names */
-    choices: string[];
-    /** Percentage for each choice (0-100) */
-    percentages: number[];
-    /** Index of the winning choice */
-    winnerIndex: number;
-    /** Name of the winning choice */
-    winnerName: string;
-    /** Number of unique voters */
-    voterCount: number;
-}
-/**
- * VotingPoll provides a high-level interface for conducting secure, verifiable polls
- * using Paillier homomorphic encryption.
- *
- * Features:
- * - Privacy-preserving vote aggregation (votes remain encrypted until tally)
- * - Verifiable receipts for each voter
- * - Multiple tallying and analysis methods
- * - Ranked choice voting support
- * - Weighted voting support
- */
-export declare class VotingPoll<TID extends PlatformID = Uint8Array> {
-    readonly choices: string[];
-    readonly votes: bigint[];
-    private readonly paillierKeyPair;
-    private readonly ecKeyPair;
-    private readonly eciesService;
-    readonly receipts: Map<string, Uint8Array>;
-    private readonly createdAt;
-    private closedAt?;
-    constructor(eciesService: ECIESService, choices: string[], paillierKeyPair: PaillierKeyPair, ecKeyPair: ECKeyPairBuffer, votes: bigint[]);
-    generateEncryptedReceipt(member: Member<TID>): Promise<Uint8Array>;
-    memberVoted(member: Member<TID>): boolean;
-    verifyReceipt(member: Member<TID>, encryptedReceipt: Uint8Array): Promise<boolean>;
-    vote(choiceIndex: number, member: Member<TID>): Promise<Uint8Array>;
-    voteWeighted(choiceIndex: number, weight: bigint, member: Member<TID>): Promise<Uint8Array>;
-    voteRanked(rankedChoices: number[], member: Member<TID>): Promise<Uint8Array>;
-    voteApproval(approvedChoices: number[], member: Member<TID>): Promise<Uint8Array>;
-    get tallies(): bigint[];
-    getTally(choiceIndex: number): bigint;
-    get leadingChoice(): string;
-    /**
-     * Get the index of the leading choice
-     */
-    get leadingChoiceIndex(): number;
-    /**
-     * Get complete poll results with percentages and winner
-     */
-    getResults(): VotingPollResults;
-    /**
-     * Get sorted results (descending by vote count)
-     */
-    getSortedResults(): Array<{
-        choice: string;
-        index: number;
-        tally: bigint;
-        percentage: number;
-    }>;
-    /**
-     * Check if there is a tie for first place
-     */
-    get hasTie(): boolean;
-    /**
-     * Get all choices tied for first place
-     */
-    get tiedChoices(): string[];
-    /**
-     * Get total number of unique voters
-     */
-    get voterCount(): number;
-    /**
-     * Get total encrypted votes (sum of all choice tallies)
-     * Note: This returns encrypted sum - decrypt with getTotalVotes()
-     */
-    get encryptedTotalVotes(): bigint;
-    /**
-     * Get total decrypted vote count
-     */
-    getTotalVotes(): bigint;
-    /**
-     * Close the poll (no more votes can be cast)
-     */
-    close(): void;
-    /**
-     * Check if poll is closed
-     */
-    get isClosed(): boolean;
-    /**
-     * Get poll creation timestamp
-     */
-    get createdAtTimestamp(): Date;
-    /**
-     * Get poll closed timestamp (undefined if not closed)
-     */
-    get closedAtTimestamp(): Date | undefined;
-    /**
-     * Get poll duration in milliseconds (undefined if not closed)
-     */
-    get durationMs(): number | undefined;
-    static newPoll(eciesService: ECIESService, choices: string[], paillierKeyPair: PaillierKeyPair, ecKeyPair: ECKeyPairBuffer): VotingPoll;
-    static newPollWithKeys(eciesService: ECIESService, votingService: VotingService, choices: string[]): Promise<{
-        poll: VotingPoll;
-        paillierKeyPair: PaillierKeyPair;
-        ecKeyPair: ECKeyPairBuffer;
-    }>;
-}
-//# sourceMappingURL=poll.d.ts.map

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

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