@crisp-e3/sdk 0.13.0 → 0.15.0

package/dist/index.d.ts

@@ -38,6 +38,7 @@ type RoundDetails = {
     startTime: bigint;
     endTime: bigint;
     startBlock: bigint;
+    snapshotBlock: bigint;
     committeePublicKey: Uint8Array;
     emojis: [string, string];
     tokenAddress: string;
@@ -80,6 +81,15 @@ type MerkleProof = {
  * Type representing a vote
  */
 type Vote = number[];
+/**
+ * Type representing a decoded tally: one total per option.
+ *
+ * @remarks
+ * Uses `bigint` because an aggregated tally coefficient is a sum over all ballots,
+ * so a total can exceed `Number.MAX_SAFE_INTEGER`. This matches the `BigUint` the
+ * CRISP server returns and the `uint256` the CRISP contract returns.
+ */
+type TallyResult = bigint[];
 type ProofData = {
     publicInputs: string[];
     proof: Uint8Array;
@@ -139,6 +149,7 @@ type E3StateLiteResponse = {
     start_time: number;
     end_time: number;
     start_block: number;
+    snapshot_block: number;
     committee_public_key: number[];
     emojis: [string, string];
     token_address: string;
@@ -403,6 +414,17 @@ declare const getScaledBalance: (balance: bigint, decimals: bigint) => bigint;
  * encoding, encryption, decryption, and tally decoding.
  */
 
+/**
+ * Encodes vote choices into a polynomial coefficient array for BFV encryption.
+ * Each choice occupies floor(MAX_MSG_NON_ZERO_COEFFS / n) binary coefficients;
+ * remaining slots in the first MAX_MSG_NON_ZERO_COEFFS coeffs are zero; then
+ * the vector is padded to the BFV degree.
+ *
+ * @param vote - Array of numeric values per choice (e.g. [10, 5] for 2 options)
+ * @returns Array of 0s and 1s representing coefficients
+ * @throws If vote has fewer than 2 choices, any value exceeds max for its segment, or degree is too small
+ */
+declare const encodeVote: (vote: Vote) => number[];
 /**
  * Encrypts an encoded vote using BFV homomorphic encryption.
  *
@@ -412,14 +434,29 @@ declare const getScaledBalance: (balance: bigint, decimals: bigint) => bigint;
  */
 declare const encryptVote: (vote: Vote, publicKey: Uint8Array) => Uint8Array;
 /**
- * Decodes raw tally bytes (or hex string) into vote values per choice.
+ * Decodes raw tally bytes (or coefficients) into a total per choice.
  * Expects the same segment layout as used in encodeVote.
  *
- * @param tallyBytes - Hex string or array of decoded numbers from tally/decryption
+ * Mirrors `crisp_utils::decode_tally` (Rust) and `CRISPProgram.decodeTally` (Solidity):
+ * only the first MAX_MSG_NON_ZERO_COEFFS coefficients carry the payload, split into
+ * `floor(MAX_MSG_NON_ZERO_COEFFS / numChoices)` binary coefficients per choice, MSB first.
+ *
+ * @param tallyBytes - Hex string, or the polynomial coefficients from tally/decryption
+ * @param numChoices - Number of vote options: an integer from 2 to MAX_VOTE_OPTIONS
+ * @returns One total per choice
+ * @throws If numChoices is outside 2..MAX_VOTE_OPTIONS or not an integer, or there are fewer
+ *         coefficients than the payload region
+ */
+declare const decodeTally: (tallyBytes: string | number[] | bigint[], numChoices: number) => TallyResult;
+/**
+ * Decrypts a BFV-encrypted vote and decodes it to vote values.
+ *
+ * @param ciphertext - Encrypted vote
+ * @param secretKey - BFV secret key
  * @param numChoices - Number of vote options
- * @returns Vote array with one value per choice
+ * @returns One total per choice
  */
-declare const decodeTally: (tallyBytes: string | number[], numChoices: number) => Vote;
+declare const decryptVote: (ciphertext: Uint8Array, secretKey: Uint8Array, numChoices: number) => TallyResult;
 /**
  * Generates a BFV keypair for vote encryption and decryption.
  *
@@ -594,4 +631,4 @@ declare class CrispSDK {
     getPreviousCiphertext(e3Id: number, address: string): Promise<Uint8Array | undefined>;
 }
 
-export { type BroadcastVoteRequest, type BroadcastVoteResponse, CreditMode, CrispSDK, type CurrentRoundResponse, type E3StateLiteResponse, type JsonResponse, MAX_MSG_NON_ZERO_COEFFS, MAX_VOTE_OPTIONS, MERKLE_TREE_MAX_DEPTH, type MaskVoteProofInputs, type NewRoundRequest, type OnChainRoundData, type ProofData, type RoundDetails, SIGNATURE_MESSAGE, SIGNATURE_MESSAGE_HASH, type TokenDetails, type TokenHolder, type Vote, type VoteProofInputs, type VoteResponseStatus, type VoteStatusResponse, type WebResultResponse, broadcastVote, decodeTally, destroyBBApi, encodeSolidityProof, encryptVote, generateBFVKeys, generateMaskVoteProof, generateMerkleProof, generateMerkleTree, generateVoteProof, getAddressFromSignature, getAllRoundResults, getBalanceAt, getCurrentRound, getEligibleAddresses, getMaxVoteValue, getOnChainRoundData, getPreviousCiphertext, getRoundCiphertext, getRoundDetails, getRoundPublicKey, getRoundResult, getRoundStateLite, getRoundTokenDetails, getScaledBalance, getTokenHolderHashes, getTotalSupplyAt, getTreeData, getVoteStatus, getZeroVote, hashLeaf, requestNewRound, validateVote, verifyProof };
+export { type BroadcastVoteRequest, type BroadcastVoteResponse, CreditMode, CrispSDK, type CurrentRoundResponse, type E3StateLiteResponse, type JsonResponse, MAX_MSG_NON_ZERO_COEFFS, MAX_VOTE_OPTIONS, MERKLE_TREE_MAX_DEPTH, type MaskVoteProofInputs, type NewRoundRequest, type OnChainRoundData, type ProofData, type RoundDetails, SIGNATURE_MESSAGE, SIGNATURE_MESSAGE_HASH, type TallyResult, type TokenDetails, type TokenHolder, type Vote, type VoteProofInputs, type VoteResponseStatus, type VoteStatusResponse, type WebResultResponse, broadcastVote, decodeTally, decryptVote, destroyBBApi, encodeSolidityProof, encodeVote, encryptVote, generateBFVKeys, generateMaskVoteProof, generateMerkleProof, generateMerkleTree, generateVoteProof, getAddressFromSignature, getAllRoundResults, getBalanceAt, getCurrentRound, getEligibleAddresses, getMaxVoteValue, getOnChainRoundData, getPreviousCiphertext, getRoundCiphertext, getRoundDetails, getRoundPublicKey, getRoundResult, getRoundStateLite, getRoundTokenDetails, getScaledBalance, getTokenHolderHashes, getTotalSupplyAt, getTreeData, getVoteStatus, getZeroVote, hashLeaf, requestNewRound, validateVote, verifyProof };

package/dist/index.js

@@ -172,6 +172,7 @@ var getRoundDetails = async (serverUrl, e3Id) => {
     startTime: BigInt(data.start_time),
     endTime: BigInt(data.end_time),
     startBlock: BigInt(data.start_block),
+    snapshotBlock: BigInt(data.snapshot_block),
     committeePublicKey: new Uint8Array(data.committee_public_key),
     emojis: data.emojis,
     numOptions: BigInt(data.num_options),
@@ -185,7 +186,7 @@ var getRoundTokenDetails = async (serverUrl, e3Id) => {
   return {
     tokenAddress: roundDetails.tokenAddress,
     threshold: roundDetails.balanceThreshold,
-    snapshotBlock: roundDetails.startBlock
+    snapshotBlock: roundDetails.snapshotBlock
   };
 };
 var getOnChainRoundData = async (programAddress, e3Id, chainId) => {
@@ -294,7 +295,7 @@ var getMaxVoteValue = (numChoices) => {
 var getZeroVote = (numChoices) => {
   return Array(numChoices).fill(0);
 };
-var decodeBytesToNumbers = (data) => {
+var decodeBytesToBigInts = (data) => {
   if (data.length % 8 !== 0) {
     throw new Error("Data length must be multiple of 8");
   }
@@ -304,7 +305,7 @@ var decodeBytesToNumbers = (data) => {
   for (let i = 0; i < arrayLength; i++) {
     result.push(view.getBigUint64(i * 8, true));
   }
-  return result.map(Number);
+  return result;
 };
 var numberArrayToBigInt64Array = (numberArray) => {
   return BigInt64Array.from(numberArray.map(BigInt));
@@ -337,6 +338,9 @@ var encodeVote = (vote) => {
   if (numChoices < 2) {
     throw new Error("Vote must have at least two choices");
   }
+  if (numChoices > MAX_VOTE_OPTIONS) {
+    throw new Error(`Number of choices (${numChoices}) exceeds MAX_VOTE_OPTIONS (${MAX_VOTE_OPTIONS})`);
+  }
   const bfvParams = getZkInputsGenerator().getBFVParams();
   const degree = bfvParams.degree;
   if (degree < MAX_MSG_NON_ZERO_COEFFS) {
@@ -370,27 +374,38 @@ var encryptVote = (vote, publicKey) => {
   return getZkInputsGenerator().encryptVote(publicKey, numberArrayToBigInt64Array(encodedVote));
 };
 var decodeTally = (tallyBytes, numChoices) => {
+  if (!Number.isInteger(numChoices) || numChoices < 2) {
+    throw new Error(`Number of choices (${numChoices}) must be an integer of at least 2`);
+  }
+  if (numChoices > MAX_VOTE_OPTIONS) {
+    throw new Error(`Number of choices (${numChoices}) exceeds MAX_VOTE_OPTIONS (${MAX_VOTE_OPTIONS})`);
+  }
+  let coefficients;
   if (typeof tallyBytes === "string") {
     const hexString = tallyBytes.startsWith("0x") ? tallyBytes : `0x${tallyBytes}`;
-    tallyBytes = decodeBytesToNumbers(hexToBytes2(hexString));
+    coefficients = decodeBytesToBigInts(hexToBytes2(hexString));
+  } else {
+    coefficients = tallyBytes.map(BigInt);
   }
-  if (numChoices <= 0) {
-    throw new Error("Number of choices must be positive");
+  if (coefficients.length < MAX_MSG_NON_ZERO_COEFFS) {
+    throw new Error(`decoded coefficient count (${coefficients.length}) is less than MAX_MSG_NON_ZERO_COEFFS (${MAX_MSG_NON_ZERO_COEFFS})`);
   }
   const segmentSize = Math.floor(MAX_MSG_NON_ZERO_COEFFS / numChoices);
   const results = [];
   for (let choiceIdx = 0; choiceIdx < numChoices; choiceIdx++) {
     const segmentStart = choiceIdx * segmentSize;
-    const segment = tallyBytes.slice(segmentStart, segmentStart + segmentSize);
-    let value = 0;
-    for (let i = 0; i < segment.length; i++) {
-      const weight = 2 ** (segment.length - 1 - i);
-      value += segment[i] * weight;
+    let value = 0n;
+    for (let i = 0; i < segmentSize; i++) {
+      value += coefficients[segmentStart + i] << BigInt(segmentSize - 1 - i);
     }
     results.push(value);
   }
   return results;
 };
+var decryptVote = (ciphertext, secretKey, numChoices) => {
+  const decryptedVote = getZkInputsGenerator().decryptVote(secretKey, ciphertext);
+  return decodeTally(Array.from(decryptedVote), numChoices);
+};
 var generateBFVKeys = () => {
   return getZkInputsGenerator().generateKeys();
 };
@@ -3625,8 +3640,10 @@ export {
   SIGNATURE_MESSAGE_HASH,
   broadcastVote,
   decodeTally,
+  decryptVote,
   destroyBBApi,
   encodeSolidityProof,
+  encodeVote,
   encryptVote,
   generateBFVKeys,
   generateMaskVoteProof,