@crisp-e3/sdk 0.5.11 → 0.6.0

package/dist/index.d.ts

@@ -82,7 +82,7 @@ type MerkleProof = {
 /**
  * Type representing a vote
  */
-type Vote = bigint[];
+type Vote = number[];
 type ProofData = {
     publicInputs: string[];
     proof: Uint8Array;
@@ -197,33 +197,50 @@ declare const getAddressFromSignature: (signature: `0x${string}`, messageHash?:
  * @param numChoices Number of choices.
  * @returns Maximum value per choice.
  */
-declare const getMaxVoteValue: (numChoices: number) => bigint;
+declare const getMaxVoteValue: (numChoices: number) => number;
 /**
  * Get a zero vote with the given number of choices.
  * @param numChoices Number of choices.
  * @returns A zero vote with the given number of choices.
  */
-declare const getZeroVote: (numChoices: number) => bigint[];
+declare const getZeroVote: (numChoices: number) => number[];
 
 /**
- * Decode an encoded tally into vote counts for n choices.
- * @param tallyBytes The encoded tally as a hex string.
- * @param numChoices Number of choices.
- * @returns Array of vote counts per choice.
+ * Vote encoding and BFV encryption for the CRISP voting protocol.
+ *
+ * Encodes vote choices (numbers per option) into polynomial coefficient arrays
+ * suitable for BFV homomorphic encryption. Each choice is represented as a
+ * segment of binary digits, padded to fit the polynomial degree. Supports
+ * encoding, encryption, decryption, and tally decoding.
  */
-declare const decodeTally: (tallyBytes: string, numChoices: number) => Vote;
+
 /**
- * Encrypt the vote using the public key.
- * @param vote - The vote to encrypt.
- * @param publicKey - The public key to use for encryption.
- * @returns The encrypted vote as a Uint8Array.
+ * Encrypts an encoded vote using BFV homomorphic encryption.
+ *
+ * @param vote - Vote choices to encrypt
+ * @param publicKey - BFV public key
+ * @returns Encrypted ciphertext
  */
 declare const encryptVote: (vote: Vote, publicKey: Uint8Array) => Uint8Array;
 /**
- * Generate a random public key.
- * @returns The generated public key as a Uint8Array.
+ * Decodes raw tally bytes (or hex string) into vote values per choice.
+ * Expects the same segment layout as used in encodeVote.
+ *
+ * @param tallyBytes - Hex string or array of decoded numbers from tally/decryption
+ * @param numChoices - Number of vote options
+ * @returns Vote array with one value per choice
+ */
+declare const decodeTally: (tallyBytes: string | number[], numChoices: number) => Vote;
+/**
+ * Generates a BFV keypair for vote encryption and decryption.
+ *
+ * @returns Object with secretKey and publicKey as Uint8Arrays
  */
-declare const generatePublicKey: () => Uint8Array;
+declare const generateBFVKeys: () => {
+    secretKey: Uint8Array;
+    publicKey: Uint8Array;
+};
+
 /**
  * Validate a vote.
  * @param vote - The vote to validate.
@@ -284,4 +301,4 @@ declare class CrispSDK {
     generateVoteProof(voteProofInputs: VoteProofRequest): Promise<ProofData>;
 }
 
-export { CreditMode, CrispSDK, MERKLE_TREE_MAX_DEPTH, type MaskVoteProofInputs, type RoundDetails, type RoundDetailsResponse, SIGNATURE_MESSAGE, SIGNATURE_MESSAGE_HASH, type TokenDetails, type Vote, type VoteProofInputs, decodeTally, encodeSolidityProof, encryptVote, generateMaskVoteProof, generateMerkleProof, generateMerkleTree, generatePublicKey, generateVoteProof, getAddressFromSignature, getBalanceAt, getIsSlotEmpty, getMaxVoteValue, getPreviousCiphertext, getRoundDetails, getRoundTokenDetails, getTotalSupplyAt, getTreeData, getZeroVote, hashLeaf, validateVote, verifyProof };
+export { CreditMode, CrispSDK, MERKLE_TREE_MAX_DEPTH, type MaskVoteProofInputs, type RoundDetails, type RoundDetailsResponse, SIGNATURE_MESSAGE, SIGNATURE_MESSAGE_HASH, type TokenDetails, type Vote, type VoteProofInputs, decodeTally, encodeSolidityProof, encryptVote, generateBFVKeys, generateMaskVoteProof, generateMerkleProof, generateMerkleTree, generateVoteProof, getAddressFromSignature, getBalanceAt, getIsSlotEmpty, getMaxVoteValue, getPreviousCiphertext, getRoundDetails, getRoundTokenDetails, getTotalSupplyAt, getTreeData, getZeroVote, hashLeaf, validateVote, verifyProof };