@vocdoni/davinci-sdk 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -1110,7 +1110,7 @@ interface DavinciCryptoOutput {
     voteId: string;
     circomInputs: ProofInputs;
 }
-interface CSPSignOutput {
+interface CSPSignOutput$1 {
     censusOrigin: CensusOrigin;
     root: string;
     address: string;
@@ -1125,7 +1125,7 @@ interface RawResult<T = any> {
 }
 interface GoDavinciCryptoWasm {
     proofInputs(inputJson: string): RawResult<DavinciCryptoOutput>;
-    cspSign(censusOrigin: number, privKey: string, processId: string, address: string, weight: string): RawResult<CSPSignOutput>;
+    cspSign(censusOrigin: number, privKey: string, processId: string, address: string, weight: string): RawResult<CSPSignOutput$1>;
     cspVerify(cspProof: string): RawResult<boolean>;
     cspCensusRoot(censusOrigin: number, privKey: string): RawResult<{
         root: string;
@@ -1189,7 +1189,7 @@ declare class DavinciCrypto {
      * @returns The CSP proof as a parsed JSON object
      * @throws if called before `await init()`, or if Go returns an error
      */
-    cspSign(censusOrigin: CensusOrigin, privKey: string, processId: string, address: string, weight: string): Promise<CSPSignOutput>;
+    cspSign(censusOrigin: CensusOrigin, privKey: string, processId: string, address: string, weight: string): Promise<CSPSignOutput$1>;
     /**
      * Verify a CSP (Credential Service Provider) proof.
      * @param censusOrigin - The census origin type (e.g., CensusOrigin.CensusOriginCSP)
@@ -1690,6 +1690,48 @@ declare class ProcessOrchestrationService {
     setProcessMaxVoters(processId: string, maxVoters: number): Promise<void>;
 }
 
+interface Ciphertext {
+    c1: [string, string];
+    c2: [string, string];
+}
+interface BallotInputsOutput {
+    processId: string;
+    address: string;
+    ballot: {
+        curveType: string;
+        ciphertexts: Ciphertext[];
+    };
+    ballotInputsHash: string;
+    voteId: string;
+    circomInputs: ProofInputs;
+}
+
+declare class BallotInputGenerator {
+    private builder?;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the ballot input generator
+     * Must be called before generating inputs
+     */
+    init(): Promise<void>;
+    /**
+     * Generate ballot inputs for voting
+     * @param processId - Process ID (hex string without 0x)
+     * @param address - Voter address (hex string without 0x)
+     * @param encryptionKey - Encryption public key [x, y]
+     * @param ballotMode - Ballot mode configuration
+     * @param choices - Array of voter choices
+     * @param weight - Voter weight
+     * @param customK - Optional custom randomness (will be generated if not provided)
+     * @returns Ballot inputs ready for proof generation
+     */
+    generateInputs(processId: string, address: string, encryptionKey: {
+        x: string;
+        y: string;
+    }, ballotMode: BallotMode, choices: number[], weight: string, customK?: string): Promise<BallotInputsOutput>;
+}
+
 /**
  * Simplified vote configuration interface for end users
  */
@@ -1742,12 +1784,15 @@ interface VoteOrchestrationConfig {
  */
 declare class VoteOrchestrationService {
     private apiService;
-    private getCrypto;
+    private getBallotInputGenerator;
     private signer;
     private censusProviders;
     private readonly verifyCircuitFiles;
     private readonly verifyProof;
-    constructor(apiService: VocdoniApiService, getCrypto: () => Promise<DavinciCrypto>, signer: Signer, censusProviders?: CensusProviders, config?: VoteOrchestrationConfig);
+    private wasmCache;
+    private zkeyCache;
+    private vkeyCache;
+    constructor(apiService: VocdoniApiService, getBallotInputGenerator: () => Promise<BallotInputGenerator>, signer: Signer, censusProviders?: CensusProviders, config?: VoteOrchestrationConfig);
     /**
      * Submit a vote with simplified configuration
      * This method handles all the complex orchestration internally:
@@ -1828,7 +1873,7 @@ declare class VoteOrchestrationService {
      */
     private getCensusProof;
     /**
-     * Generate vote proof inputs using DavinciCrypto
+     * Generate vote proof inputs using BallotInputGenerator
      */
     private generateVoteProofInputs;
     /**
@@ -1836,7 +1881,11 @@ declare class VoteOrchestrationService {
      */
     private validateChoices;
     /**
-     * Generate zk-SNARK proof using CircomProof
+     * Verify hash of downloaded file
+     */
+    private verifyHash;
+    /**
+     * Generate zk-SNARK proof using snarkjs directly (no CircomProof wrapper)
      */
     private generateZkProof;
     private hexToBytes;
@@ -1844,10 +1893,6 @@ declare class VoteOrchestrationService {
      * Sign the vote using the signer
      */
     private signVote;
-    /**
-     * Submit the vote request to the sequencer
-     */
-    private submitVoteRequest;
 }
 
 /**
@@ -1946,6 +1991,85 @@ declare function signProcessCreation(processId: string, signer: Signer | Wallet)
  */
 declare function validateProcessId(processId: string): boolean;
 
+interface CSPSignOutput {
+    censusOrigin: CensusOrigin;
+    root: string;
+    address: string;
+    weight: string;
+    processId: string;
+    publicKey: string;
+    signature: string;
+}
+interface DavinciCSPOptions {
+    /** URL to wasm_exec.js */
+    wasmExecUrl: string;
+    /** URL to the compiled davinci_crypto.wasm */
+    wasmUrl: string;
+    /** How long (ms) to wait for the Go runtime to attach DavinciCrypto */
+    initTimeoutMs?: number;
+    /** Optional SHA-256 hash to verify wasm_exec.js integrity */
+    wasmExecHash?: string;
+    /** Optional SHA-256 hash to verify davinci_crypto.wasm integrity */
+    wasmHash?: string;
+}
+declare class DavinciCSP {
+    private go;
+    private initialized;
+    private readonly wasmExecUrl;
+    private readonly wasmUrl;
+    private readonly initTimeoutMs;
+    private readonly wasmExecHash?;
+    private readonly wasmHash?;
+    private static wasmExecCache;
+    private static wasmBinaryCache;
+    constructor(opts: DavinciCSPOptions);
+    /**
+     * Computes SHA-256 hash of the given data and compares it with the expected hash.
+     * @param data - The data to hash (string or ArrayBuffer)
+     * @param expectedHash - The expected SHA-256 hash in hexadecimal format
+     * @param filename - The filename for error reporting
+     * @throws Error if the computed hash doesn't match the expected hash
+     */
+    private verifyHash;
+    /**
+     * Must be awaited before calling CSP functions.
+     * Safe to call multiple times.
+     */
+    init(): Promise<void>;
+    /**
+     * Generate a CSP (Credential Service Provider) signature for census proof.
+     * @param censusOrigin - The census origin type (e.g., CensusOrigin.CSP)
+     * @param privKey - The private key in hex format
+     * @param processId - The process ID in hex format
+     * @param address - The address in hex format
+     * @param weight - The vote weight as a decimal string
+     * @returns The CSP proof as a parsed JSON object
+     * @throws if called before `await init()`, or if Go returns an error
+     */
+    cspSign(censusOrigin: CensusOrigin, privKey: string, processId: string, address: string, weight: string): Promise<CSPSignOutput>;
+    /**
+     * Verify a CSP (Credential Service Provider) proof.
+     * @param censusOrigin - The census origin type (e.g., CensusOrigin.CSP)
+     * @param root - The census root
+     * @param address - The address
+     * @param weight - The vote weight as a decimal string
+     * @param processId - The process ID
+     * @param publicKey - The public key
+     * @param signature - The signature
+     * @returns The verification result
+     * @throws if called before `await init()`, or if Go returns an error
+     */
+    cspVerify(censusOrigin: CensusOrigin, root: string, address: string, weight: string, processId: string, publicKey: string, signature: string): Promise<boolean>;
+    /**
+     * Generate a CSP (Credential Service Provider) census root.
+     * @param censusOrigin - The census origin type (e.g., CensusOrigin.CSP)
+     * @param privKey - The private key in hex format
+     * @returns The census root as a hexadecimal string
+     * @throws if called before `await init()`, or if Go returns an error
+     */
+    cspCensusRoot(censusOrigin: CensusOrigin, privKey: string): Promise<string>;
+}
+
 /**
  * Configuration interface for the DavinciSDK
  */
@@ -2004,6 +2128,8 @@ declare class DavinciSDK {
     private _processOrchestrator?;
     private _voteOrchestrator?;
     private davinciCrypto?;
+    private davinciCSP?;
+    private ballotInputGenerator?;
     private initialized;
     private censusProviders;
     constructor(config: DavinciSDKConfig);
@@ -2034,6 +2160,14 @@ declare class DavinciSDK {
      * Get or initialize the DavinciCrypto service for cryptographic operations
      */
     getCrypto(): Promise<DavinciCrypto>;
+    /**
+     * Get or initialize the DavinciCSP service for CSP cryptographic operations
+     */
+    getCSP(): Promise<DavinciCSP>;
+    /**
+     * Get or initialize the BallotInputGenerator service for ballot input generation
+     */
+    getBallotInputGenerator(): Promise<BallotInputGenerator>;
     /**
      * Get the process orchestration service for simplified process creation.
      * Requires a signer with a provider for blockchain interactions.
@@ -2716,5 +2850,5 @@ declare class DavinciSDK {
     private ensureProvider;
 }
 
-export { BaseService, Census, CensusNotUpdatable, CensusOrchestrator, CensusOrigin, CircomProof, ContractServiceError, CspCensus, DavinciCrypto, DavinciSDK, ElectionMetadataTemplate, ElectionResultsTypeNames, MerkleCensus, OffchainCensus, OffchainDynamicCensus, OnchainCensus, OrganizationAdministratorError, OrganizationCreateError, OrganizationDeleteError, OrganizationRegistryService, OrganizationUpdateError, ProcessCensusError, ProcessCreateError, ProcessDurationError, ProcessOrchestrationService, ProcessRegistryService, ProcessResultError, ProcessStateTransitionError, ProcessStatus, ProcessStatusError, PublishedCensus, SmartContractService, TxStatus, VocdoniApiService, VocdoniCensusService, VocdoniSequencerService, VoteOrchestrationService, VoteStatus, assertCSPCensusProof, assertMerkleCensusProof, createProcessSignatureMessage, getElectionMetadataTemplate, isCSPCensusProof, isMerkleCensusProof, signProcessCreation, validateProcessId };
-export type { AbstainProperties, AnyJson, ApiError, ApprovalProperties, BallotMode, BaseCensusProof, BaseProcess, BudgetProperties, CSPCensusProof, CSPCensusProofProvider, CSPSignOutput, CensusData, CensusParticipant, CensusProof, CensusProviders, CensusSizeResponse, Choice, ChoiceProperties, CircomProofOptions, CreateProcessRequest, CreateProcessResponse, CustomMeta, DavinciCryptoCiphertext, DavinciCryptoInputs, DavinciCryptoOptions, DavinciCryptoOutput, DavinciSDKConfig, ElectionMetadata, ElectionResultsType, EncryptionKey, EntityCallback, GetProcessResponse, Groth16Proof, HealthResponse, IChoice, IQuestion, InfoResponse, JsonArray, JsonMap, ListProcessesResponse, MerkleCensusProof, MerkleCensusProofProvider, MultiLanguage, OrganizationAdministratorAddedCallback, OrganizationAdministratorRemovedCallback, OrganizationCreatedCallback, OrganizationInfo, OrganizationUpdatedCallback, Participant, ParticipantInfoResponse, ProcessCensusUpdatedCallback, ProcessConfig, ProcessConfigWithMetadata, ProcessConfigWithMetadataUri, ProcessCreatedCallback, ProcessCreationResult, ProcessDurationChangedCallback, ProcessInfo, ProcessMaxVotersChangedCallback, ProcessQuestion, ProcessResultsSetCallback, ProcessStateTransitionedCallback, ProcessStatusChangedCallback, ProofInputs, ProtocolVersion, PublishCensusResponse, QuadraticProperties, Question, SequencerStats, Snapshot, SnapshotsQueryParams, SnapshotsResponse, TxStatusEvent, VocdoniApiServiceConfig, VoteBallot, VoteCiphertext, VoteConfig, VoteOrchestrationConfig, VoteProof, VoteRequest, VoteResult, VoteStatusInfo, VoteStatusResponse, WorkerStats, WorkersResponse };
+export { BallotInputGenerator, BaseService, Census, CensusNotUpdatable, CensusOrchestrator, CensusOrigin, CircomProof, ContractServiceError, CspCensus, DavinciCSP, DavinciCrypto, DavinciSDK, ElectionMetadataTemplate, ElectionResultsTypeNames, MerkleCensus, OffchainCensus, OffchainDynamicCensus, OnchainCensus, OrganizationAdministratorError, OrganizationCreateError, OrganizationDeleteError, OrganizationRegistryService, OrganizationUpdateError, ProcessCensusError, ProcessCreateError, ProcessDurationError, ProcessOrchestrationService, ProcessRegistryService, ProcessResultError, ProcessStateTransitionError, ProcessStatus, ProcessStatusError, PublishedCensus, SmartContractService, TxStatus, VocdoniApiService, VocdoniCensusService, VocdoniSequencerService, VoteOrchestrationService, VoteStatus, assertCSPCensusProof, assertMerkleCensusProof, createProcessSignatureMessage, getElectionMetadataTemplate, isCSPCensusProof, isMerkleCensusProof, signProcessCreation, validateProcessId };
+export type { AbstainProperties, AnyJson, ApiError, ApprovalProperties, BallotMode, BaseCensusProof, BaseProcess, BudgetProperties, CSPCensusProof, CSPCensusProofProvider, CSPSignOutput$1 as CSPSignOutput, CensusData, CensusParticipant, CensusProof, CensusProviders, CensusSizeResponse, Choice, ChoiceProperties, CircomProofOptions, CreateProcessRequest, CreateProcessResponse, CustomMeta, DavinciCryptoCiphertext, DavinciCryptoInputs, DavinciCryptoOptions, DavinciCryptoOutput, DavinciSDKConfig, ElectionMetadata, ElectionResultsType, EncryptionKey, EntityCallback, GetProcessResponse, Groth16Proof, HealthResponse, IChoice, IQuestion, InfoResponse, JsonArray, JsonMap, ListProcessesResponse, MerkleCensusProof, MerkleCensusProofProvider, MultiLanguage, OrganizationAdministratorAddedCallback, OrganizationAdministratorRemovedCallback, OrganizationCreatedCallback, OrganizationInfo, OrganizationUpdatedCallback, Participant, ParticipantInfoResponse, ProcessCensusUpdatedCallback, ProcessConfig, ProcessConfigWithMetadata, ProcessConfigWithMetadataUri, ProcessCreatedCallback, ProcessCreationResult, ProcessDurationChangedCallback, ProcessInfo, ProcessMaxVotersChangedCallback, ProcessQuestion, ProcessResultsSetCallback, ProcessStateTransitionedCallback, ProcessStatusChangedCallback, ProofInputs, ProtocolVersion, PublishCensusResponse, QuadraticProperties, Question, SequencerStats, Snapshot, SnapshotsQueryParams, SnapshotsResponse, TxStatusEvent, VocdoniApiServiceConfig, VoteBallot, VoteCiphertext, VoteConfig, VoteOrchestrationConfig, VoteProof, VoteRequest, VoteResult, VoteStatusInfo, VoteStatusResponse, WorkerStats, WorkersResponse };