@crisp-e3/sdk 0.6.0 → 0.7.0

package/README.md

@@ -149,10 +149,10 @@ const address = await getAddressFromSignature(signature, messageHash)
 #### State Utilities
 
 ```typescript
-import { getPreviousCiphertext, getIsSlotEmpty } from '@crisp-e3/sdk'
+import { getPreviousCiphertext } from '@crisp-e3/sdk'
 
 const previousCiphertext = await getPreviousCiphertext(serverUrl, e3Id, slotAddress)
-const isEmpty = await getIsSlotEmpty(serverUrl, e3Id, slotAddress)
+// Returns undefined when the slot is empty (404)
 ```
 
 ## API
@@ -170,10 +170,8 @@ const isEmpty = await getIsSlotEmpty(serverUrl, e3Id, slotAddress)
 - `getRoundDetails(serverUrl: string, e3Id: number): Promise<RoundDetails>` - Get round details
 - `getRoundTokenDetails(serverUrl: string, e3Id: number): Promise<TokenDetails>` - Get token details
   for a round
-- `getPreviousCiphertext(serverUrl: string, e3Id: number, address: string): Promise<Uint8Array>` -
-  Get previous ciphertext for a slot
-- `getIsSlotEmpty(serverUrl: string, e3Id: number, address: string): Promise<boolean>` - Check if a
-  slot is empty
+- `getPreviousCiphertext(serverUrl: string, e3Id: number, address: string): Promise<Uint8Array | undefined>` -
+  Get previous ciphertext for a slot (undefined when slot is empty)
 
 ### Token Functions
 

package/dist/index.d.ts

@@ -146,21 +146,15 @@ declare const getRoundDetails: (serverUrl: string, e3Id: number) => Promise<Roun
  */
 declare const getRoundTokenDetails: (serverUrl: string, e3Id: number) => Promise<TokenDetails>;
 /**
- * Get the previous ciphertext for a slot from the CRISP server
- * @param serverUrl - The base URL of the CRISP server
- * @param e3Id - The e3Id of the round
- * @param address - The address of the slot
- * @returns The previous ciphertext for the slot
- */
-declare const getPreviousCiphertext: (serverUrl: string, e3Id: number, address: string) => Promise<Uint8Array>;
-/**
- * Check if a slot is empty for a given E3 ID and slot address
+ * Get the previous ciphertext for a slot from the CRISP server.
+ * Returns undefined when the slot is empty (404).
+ *
  * @param serverUrl - The base URL of the CRISP server
  * @param e3Id - The e3Id of the round
  * @param address - The address of the slot
- * @returns Whether the slot is empty or not
+ * @returns The previous ciphertext for the slot, or undefined if the slot is empty
  */
-declare const getIsSlotEmpty: (serverUrl: string, e3Id: number, address: string) => Promise<boolean>;
+declare const getPreviousCiphertext: (serverUrl: string, e3Id: number, address: string) => Promise<Uint8Array | undefined>;
 
 declare const MERKLE_TREE_MAX_DEPTH = 20;
 /**
@@ -241,6 +235,7 @@ declare const generateBFVKeys: () => {
     publicKey: Uint8Array;
 };
 
+declare const destroyBBApi: () => void;
 /**
  * Validate a vote.
  * @param vote - The vote to validate.
@@ -295,10 +290,15 @@ declare class CrispSDK {
     generateMaskVoteProof(maskProofInputs: MaskVoteProofRequest): Promise<ProofData>;
     /**
      * Generate a proof for a vote.
+     *
+     * Note: The previous ciphertext is not used in the proof computation. This method still calls
+     * the same server API (previous-ciphertext) as {@link generateMaskVoteProof} to prevent the
+     * server from inferring the vote type (mask vs normal) from the client's API usage pattern.
+     *
      * @param voteProofInputs - The inputs required to generate the vote proof.
      * @returns A promise that resolves to the generated proof data.
      */
     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, generateBFVKeys, generateMaskVoteProof, generateMerkleProof, generateMerkleTree, generateVoteProof, getAddressFromSignature, getBalanceAt, getIsSlotEmpty, getMaxVoteValue, getPreviousCiphertext, getRoundDetails, getRoundTokenDetails, getTotalSupplyAt, getTreeData, getZeroVote, hashLeaf, validateVote, verifyProof };
+export { CreditMode, CrispSDK, MERKLE_TREE_MAX_DEPTH, type MaskVoteProofInputs, type ProofData, type RoundDetails, type RoundDetailsResponse, SIGNATURE_MESSAGE, SIGNATURE_MESSAGE_HASH, type TokenDetails, type Vote, type VoteProofInputs, decodeTally, destroyBBApi, encodeSolidityProof, encryptVote, generateBFVKeys, generateMaskVoteProof, generateMerkleProof, generateMerkleTree, generateVoteProof, getAddressFromSignature, getBalanceAt, getMaxVoteValue, getPreviousCiphertext, getRoundDetails, getRoundTokenDetails, getTotalSupplyAt, getTreeData, getZeroVote, hashLeaf, validateVote, verifyProof };