threshold-elgamal 0.1.32 → 0.1.34

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { generateParameters, encrypt, decrypt } from './elgamal';
 import { generateKeys, generateKeyShares, combinePublicKeys, createDecryptionShare, combineDecryptionShares, thresholdDecrypt } from './thresholdElgamal';
 import type { EncryptedMessage, Parameters } from './types';
-import { getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup } from './utils/utils';
-export { generateParameters, encrypt, decrypt, generateKeys, generateKeyShares, combinePublicKeys, createDecryptionShare, combineDecryptionShares, thresholdDecrypt, getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup, };
+import { getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup, serializeEncryptedMessage, deserializeEncryptedMessage } from './utils/utils';
+export { generateParameters, encrypt, decrypt, generateKeys, generateKeyShares, combinePublicKeys, createDecryptionShare, combineDecryptionShares, thresholdDecrypt, getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup, serializeEncryptedMessage, deserializeEncryptedMessage, };
 export type { EncryptedMessage, Parameters };

package/dist/index.js

@@ -1,4 +1,4 @@
 import { generateParameters, encrypt, decrypt } from "./elgamal.js";
 import { generateKeys, generateKeyShares, combinePublicKeys, createDecryptionShare, combineDecryptionShares, thresholdDecrypt, } from "./thresholdElgamal.js";
-import { getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup, } from "./utils/utils.js";
-export { generateParameters, encrypt, decrypt, generateKeys, generateKeyShares, combinePublicKeys, createDecryptionShare, combineDecryptionShares, thresholdDecrypt, getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup, };
+import { getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup, serializeEncryptedMessage, deserializeEncryptedMessage, } from "./utils/utils.js";
+export { generateParameters, encrypt, decrypt, generateKeys, generateKeyShares, combinePublicKeys, createDecryptionShare, combineDecryptionShares, thresholdDecrypt, getRandomBigIntegerInRange, multiplyEncryptedValues, getGroup, serializeEncryptedMessage, deserializeEncryptedMessage, };

package/dist/utils/utils.d.ts

@@ -49,3 +49,39 @@ export declare const multiplyEncryptedValues: (value1: EncryptedMessage, value2:
  * @returns {bigint[]} An array representing the polynomial coefficients `[a0, a1, ..., a_{threshold-1}]`.
  */
 export declare const generatePolynomial: (threshold: number, prime: bigint) => bigint[];
+/**
+ * Serializes an encrypted message into an object with string representations of its components.
+ * This function is useful for converting the bigint components of an encrypted message into
+ * strings, making them easier to store or transmit as JSON, for instance.
+ *
+ * @param {EncryptedMessage} message - The encrypted message to be serialized. It should have two bigint properties: `c1` and `c2`.
+ * @returns {{ c1: string; c2: string }} An object containing the `c1` and `c2` components of the message as strings.
+ *
+ * @example
+ * // An example encrypted message
+ * const encryptedMessage = { c1: BigInt('1234567890123456789012345678901234567890'), c2: BigInt('0987654321098765432109876543210987654321') };
+ * const serializedMessage = serializeEncryptedMessage(encryptedMessage);
+ * console.log(serializedMessage); // Output: { c1: "1234567890123456789012345678901234567890", c2: "0987654321098765432109876543210987654321" }
+ */
+export declare const serializeEncryptedMessage: (message: EncryptedMessage) => {
+    c1: string;
+    c2: string;
+};
+/**
+ * Deserializes an object containing string representations of an encrypted message's components
+ * back into an `EncryptedMessage` with bigint components. This is useful for reconstructing
+ * encrypted messages from their stringified forms, such as when retrieving them from JSON data.
+ *
+ * @param {{ c1: string; c2: string }} message - An object containing the `c1` and `c2` components of the message as strings.
+ * @returns {EncryptedMessage} The deserialized encrypted message with `c1` and `c2` as bigints.
+ *
+ * @example
+ * // An example serialized message
+ * const serializedMessage = { c1: "1234567890123456789012345678901234567890", c2: "0987654321098765432109876543210987654321" };
+ * const encryptedMessage = deserializeEncryptedMessage(serializedMessage);
+ * console.log(encryptedMessage); // Output: { c1: 1234567890123456789012345678901234567890n, c2: 0987654321098765432109876543210987654321n }
+ */
+export declare const deserializeEncryptedMessage: (message: {
+    c1: string;
+    c2: string;
+}) => EncryptedMessage;

package/dist/utils/utils.js

@@ -61,9 +61,9 @@ export const getRandomBigIntegerInRange = (min, max) => {
     const bitsNeeded = range.toString(2).length;
     // Generate a random bigint within the calculated bits
     let num = randomBigint(bitsNeeded);
-    // Adjust the number to our range
+    // Adjust the number to the range
     num = num % range;
-    // Add the minimum to align with our desired range
+    // Add the minimum to align with the desired range
     return min + num;
 };
 /**
@@ -93,3 +93,33 @@ export const generatePolynomial = (threshold, prime) => {
     }
     return polynomial;
 };
+/**
+ * Serializes an encrypted message into an object with string representations of its components.
+ * This function is useful for converting the bigint components of an encrypted message into
+ * strings, making them easier to store or transmit as JSON, for instance.
+ *
+ * @param {EncryptedMessage} message - The encrypted message to be serialized. It should have two bigint properties: `c1` and `c2`.
+ * @returns {{ c1: string; c2: string }} An object containing the `c1` and `c2` components of the message as strings.
+ *
+ * @example
+ * // An example encrypted message
+ * const encryptedMessage = { c1: BigInt('1234567890123456789012345678901234567890'), c2: BigInt('0987654321098765432109876543210987654321') };
+ * const serializedMessage = serializeEncryptedMessage(encryptedMessage);
+ * console.log(serializedMessage); // Output: { c1: "1234567890123456789012345678901234567890", c2: "0987654321098765432109876543210987654321" }
+ */
+export const serializeEncryptedMessage = (message) => ({ c1: message.c1.toString(), c2: message.c2.toString() });
+/**
+ * Deserializes an object containing string representations of an encrypted message's components
+ * back into an `EncryptedMessage` with bigint components. This is useful for reconstructing
+ * encrypted messages from their stringified forms, such as when retrieving them from JSON data.
+ *
+ * @param {{ c1: string; c2: string }} message - An object containing the `c1` and `c2` components of the message as strings.
+ * @returns {EncryptedMessage} The deserialized encrypted message with `c1` and `c2` as bigints.
+ *
+ * @example
+ * // An example serialized message
+ * const serializedMessage = { c1: "1234567890123456789012345678901234567890", c2: "0987654321098765432109876543210987654321" };
+ * const encryptedMessage = deserializeEncryptedMessage(serializedMessage);
+ * console.log(encryptedMessage); // Output: { c1: 1234567890123456789012345678901234567890n, c2: 0987654321098765432109876543210987654321n }
+ */
+export const deserializeEncryptedMessage = (message) => ({ c1: BigInt(message.c1), c2: BigInt(message.c2) });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "threshold-elgamal",
-    "version": "0.1.32",
+    "version": "0.1.34",
     "description": "Threshold ElGamal in TypeScript",
     "author": "Piotr Piech <piotr@piech.dev>",
     "license": "MIT",
@@ -21,7 +21,7 @@
         "tsc": "tsc",
         "prebuild": "npm run eslint && npm run tsc && npm run test && del-cli dist",
         "build": "tsc --project tsconfig.build.json",
-        "build:skip": "tsc --project tsconfig.build.json",
+        "build:skip": "del-cli dist && tsc --project tsconfig.build.json",
         "test": "vitest --watch=false --reporter=verbose",
         "test:watch": "vitest --watch=true --reporter=verbose",
         "pretypedoc": "del-cli 'docs/*' '!docs/_config.yml'",