threshold-elgamal 0.1.26 → 0.1.28

package/README.md

@@ -97,28 +97,24 @@ import {
     thresholdDecrypt,
 } from "threshold-elgamal";
 
-const primeBits = 2048; // Bit length of the prime modulus
 const threshold = 3; // A scenario for 3 participants with a threshold of 3
-const { prime, generator } = getGroup(2048);
+const { prime, generator } = getGroup(); // 2048-bit by default
 
 // Each participant generates their public key share and private key individually
-const participant1Keys = generateKeys(1, threshold, primeBits);
-const participant2Keys = generateKeys(2, threshold, primeBits);
-const participant3Keys = generateKeys(3, threshold, primeBits);
+const participant1Keys = generateKeys(1, threshold);
+const participant2Keys = generateKeys(2, threshold);
+const participant3Keys = generateKeys(3, threshold);
 
 // Combine the public keys to form a single public key
-const combinedPublicKey = combinePublicKeys(
-    [
-        participant1Keys.publicKey,
-        participant2Keys.publicKey,
-        participant3Keys.publicKey,
-    ],
-    prime,
-);
+const commonPublicKey = combinePublicKeys([
+    participant1Keys.publicKey,
+    participant2Keys.publicKey,
+    participant3Keys.publicKey,
+]);
 
 // Encrypt a message using the combined public key
 const secret = 42;
-const encryptedMessage = encrypt(secret, prime, generator, combinedPublicKey);
+const encryptedMessage = encrypt(secret, prime, generator, commonPublicKey);
 
 // Decryption shares
 const decryptionShares = [
@@ -139,6 +135,7 @@ const thresholdDecryptedMessage = thresholdDecrypt(
     prime,
 );
 console.log(thresholdDecryptedMessage); // 42
+expect(thresholdDecryptedMessage).toBe(secret);
 ```
 
 ### Voting and multiplication with threshold scheme for 3 participants
@@ -157,24 +154,20 @@ import {
     getGroup,
 } from "threshold-elgamal";
 
-const primeBits = 2048; // Bit length of the prime modulus
 const threshold = 3; // A scenario for 3 participants with a threshold of 3
-const { prime, generator } = getGroup(2048);
+const { prime, generator } = getGroup(); // 2048-bit by default
 
 // Each participant generates their public key share and private key individually
-const participant1Keys = generateKeys(1, threshold, primeBits);
-const participant2Keys = generateKeys(2, threshold, primeBits);
-const participant3Keys = generateKeys(3, threshold, primeBits);
+const participant1Keys = generateKeys(1, threshold);
+const participant2Keys = generateKeys(2, threshold);
+const participant3Keys = generateKeys(3, threshold);
 
 // Combine the public keys to form a single public key
-const combinedPublicKey = combinePublicKeys(
-    [
-        participant1Keys.publicKey,
-        participant2Keys.publicKey,
-        participant3Keys.publicKey,
-    ],
-    prime,
-);
+const commonPublicKey = combinePublicKeys([
+    participant1Keys.publicKey,
+    participant2Keys.publicKey,
+    participant3Keys.publicKey,
+]);
 
 // Participants cast their encrypted votes for two options
 const voteOption1 = [6, 7, 1]; // Votes for option 1 by participants 1, 2, and 3
@@ -182,10 +175,10 @@ const voteOption2 = [10, 7, 4]; // Votes for option 2 by participants 1, 2, and
 
 // Encrypt votes for both options
 const encryptedVotesOption1 = voteOption1.map((vote) =>
-    encrypt(vote, prime, generator, combinedPublicKey),
+    encrypt(vote, prime, generator, commonPublicKey),
 );
 const encryptedVotesOption2 = voteOption2.map((vote) =>
-    encrypt(vote, prime, generator, combinedPublicKey),
+    encrypt(vote, prime, generator, commonPublicKey),
 );
 
 // Multiply encrypted votes together to aggregate

package/dist/thresholdElgamal.d.ts

@@ -39,7 +39,7 @@ export declare const generateKeyShares: (n: number, threshold: number, primeBits
  * @param {bigint} prime - The prime modulus used in the ElGamal system.
  * @returns {bigint} The combined public key.
  */
-export declare const combinePublicKeys: (publicKeys: bigint[], prime: bigint) => bigint;
+export declare const combinePublicKeys: (publicKeys: bigint[], prime?: bigint) => bigint;
 /**
  * Performs a partial decryption on a ciphertext using an individual's private key share.
  *

package/dist/thresholdElgamal.js

@@ -59,7 +59,7 @@ export const generateKeyShares = (n, threshold, primeBits = 2048) => {
  * @param {bigint} prime - The prime modulus used in the ElGamal system.
  * @returns {bigint} The combined public key.
  */
-export const combinePublicKeys = (publicKeys, prime) => publicKeys.reduce((acc, current) => (acc * current) % prime, 1n);
+export const combinePublicKeys = (publicKeys, prime = getGroup(2048).prime) => publicKeys.reduce((acc, current) => (acc * current) % prime, 1n);
 /**
  * Performs a partial decryption on a ciphertext using an individual's private key share.
  *

package/dist/utils/testUtils.d.ts

@@ -4,7 +4,7 @@ export declare const thresholdSetup: (partiesCount: number, threshold: number, p
         privateKey: bigint;
         publicKey: bigint;
     }[];
-    combinedPublicKey: bigint;
+    commonPublicKey: bigint;
     prime: bigint;
     generator: bigint;
 };

package/dist/utils/testUtils.js

@@ -7,12 +7,12 @@ export const thresholdSetup = (partiesCount, threshold, primeBits = 2048) => {
     const { prime, generator } = getGroup(primeBits);
     const keyShares = generateKeyShares(partiesCount, threshold, primeBits);
     const publicKeys = keyShares.map((ks) => ks.publicKey);
-    const combinedPublicKey = combinePublicKeys(publicKeys, prime);
-    return { keyShares, combinedPublicKey, prime, generator };
+    const commonPublicKey = combinePublicKeys(publicKeys, prime);
+    return { keyShares, commonPublicKey, prime, generator };
 };
 export const testSecureEncryptionAndDecryption = (participantsCount, threshold, secret) => {
-    const { keyShares, combinedPublicKey, prime, generator } = thresholdSetup(participantsCount, threshold);
-    const encryptedMessage = encrypt(secret, prime, generator, combinedPublicKey);
+    const { keyShares, commonPublicKey, prime, generator } = thresholdSetup(participantsCount, threshold);
+    const encryptedMessage = encrypt(secret, prime, generator, commonPublicKey);
     const selectedDecryptionShares = keyShares
         .sort(() => Math.random() - 0.5)
         .slice(0, threshold)
@@ -23,8 +23,8 @@ export const testSecureEncryptionAndDecryption = (participantsCount, threshold,
 };
 export const homomorphicMultiplicationTest = (participantsCount, threshold, messages) => {
     const expectedProduct = messages.reduce((product, secret) => product * secret, 1);
-    const { keyShares, combinedPublicKey, prime, generator } = thresholdSetup(participantsCount, threshold);
-    const encryptedMessages = messages.map((secret) => encrypt(secret, prime, generator, combinedPublicKey));
+    const { keyShares, commonPublicKey, prime, generator } = thresholdSetup(participantsCount, threshold);
+    const encryptedMessages = messages.map((secret) => encrypt(secret, prime, generator, commonPublicKey));
     const encryptedProduct = encryptedMessages.reduce((product, encryptedMessage) => multiplyEncryptedValues(product, encryptedMessage, prime), { c1: 1n, c2: 1n });
     const selectedDecryptionShares = keyShares
         .sort(() => Math.random() - 0.5)
@@ -35,10 +35,10 @@ export const homomorphicMultiplicationTest = (participantsCount, threshold, mess
     expect(decryptedProduct).toBe(expectedProduct);
 };
 export const votingTest = (participantsCount, threshold, candidatesCount) => {
-    const { keyShares, combinedPublicKey, prime, generator } = thresholdSetup(participantsCount, threshold);
+    const { keyShares, commonPublicKey, prime, generator } = thresholdSetup(participantsCount, threshold);
     const votesMatrix = Array.from({ length: participantsCount }, () => Array.from({ length: candidatesCount }, () => getRandomScore(1, 10)));
     const expectedProducts = Array.from({ length: candidatesCount }, (_, candidateIndex) => votesMatrix.reduce((product, votes) => product * votes[candidateIndex], 1));
-    const encryptedVotesMatrix = votesMatrix.map((votes) => votes.map((vote) => encrypt(vote, prime, generator, combinedPublicKey)));
+    const encryptedVotesMatrix = votesMatrix.map((votes) => votes.map((vote) => encrypt(vote, prime, generator, commonPublicKey)));
     const encryptedProducts = Array.from({ length: candidatesCount }, (_, candidateIndex) => encryptedVotesMatrix.reduce((product, encryptedVotes) => multiplyEncryptedValues(product, encryptedVotes[candidateIndex], prime), { c1: 1n, c2: 1n }));
     const partialDecryptionsMatrix = encryptedProducts.map((product) => keyShares
         .slice(0, threshold)

package/dist/utils/utils.d.ts

@@ -21,7 +21,7 @@ export declare const randomBigint: (bits: number) => bigint;
  * @param {2048 | 3072 | 4096} primeBits - The bit length of the prime modulus (2048, 3072, or 4096).
  * @returns {Object} The group parameters including prime and generator.
  */
-export declare const getGroup: (primeBits: 2048 | 3072 | 4096) => {
+export declare const getGroup: (primeBits?: 2048 | 3072 | 4096) => {
     prime: bigint;
     generator: bigint;
 };

package/dist/utils/utils.js

@@ -37,7 +37,7 @@ export const randomBigint = (bits) => {
  * @param {2048 | 3072 | 4096} primeBits - The bit length of the prime modulus (2048, 3072, or 4096).
  * @returns {Object} The group parameters including prime and generator.
  */
-export const getGroup = (primeBits) => {
+export const getGroup = (primeBits = 2048) => {
     switch (primeBits) {
         case 2048:
             return GROUPS.ffdhe2048;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "threshold-elgamal",
-    "version": "0.1.26",
+    "version": "0.1.28",
     "description": "Threshold ElGamal in TypeScript",
     "author": "Piotr Piech <piotr@piech.dev>",
     "license": "MIT",