@vocdoni/davinci-sdk 0.0.5 → 0.0.7

package/README.md

@@ -321,7 +321,7 @@ For advanced use cases, you can still provide census data manually:
 ```typescript
 const process = await sdk.createProcess({
   census: {
-    type: CensusOrigin.CensusOriginMerkleTree,
+    type: CensusOrigin.OffchainStatic,
     root: "0xabc...",
     size: 100,
     uri: "ipfs://..."
@@ -406,7 +406,7 @@ const processResult = await sdk.createProcess({
   
   // Census configuration
   census: {
-    type: CensusOrigin.CensusOriginMerkleTree,
+    type: CensusOrigin.OffchainStatic,
     root: "0x...",
     size: 1000,
     uri: "ipfs://..."
@@ -431,6 +431,9 @@ const processResult = await sdk.createProcess({
     minValueSum: "0"
   },
   
+  // Maximum voters (optional, defaults to census size)
+  maxVoters: 500, // Limit the process to 500 voters
+  
   // Questions
   questions: [{
     title: "What is your preferred option?",
@@ -500,9 +503,54 @@ console.log('Title:', processInfo.title);
 console.log('Status:', processInfo.status);
 console.log('Start date:', processInfo.startDate);
 console.log('End date:', processInfo.endDate);
+console.log('Max voters:', processInfo.maxVoters);
+console.log('Voters count:', processInfo.votersCount);
 console.log('Questions:', processInfo.questions);
 ```
 
+#### Managing Process MaxVoters
+
+You can update the maximum number of voters allowed for a process after creation:
+
+```typescript
+// Update maxVoters limit
+await sdk.setProcessMaxVoters(processId, 750);
+
+console.log('MaxVoters updated to 750');
+
+// Verify the change
+const updatedProcess = await sdk.getProcess(processId);
+console.log('New maxVoters:', updatedProcess.maxVoters);
+```
+
+For real-time transaction status updates, use the stream version:
+
+```typescript
+import { TxStatus } from '@vocdoni/davinci-sdk';
+
+const stream = sdk.setProcessMaxVotersStream(processId, 750);
+
+for await (const event of stream) {
+  switch (event.status) {
+    case TxStatus.Pending:
+      console.log("📝 Transaction submitted:", event.hash);
+      break;
+      
+    case TxStatus.Completed:
+      console.log("✅ MaxVoters updated successfully");
+      break;
+      
+    case TxStatus.Failed:
+      console.error("❌ Transaction failed:", event.error);
+      break;
+      
+    case TxStatus.Reverted:
+      console.error("⚠️ Transaction reverted:", event.reason);
+      break;
+  }
+}
+```
+
 ### Voting Operations
 
 #### Submitting a Vote
@@ -614,7 +662,7 @@ async function completeVotingExample() {
     title: "Community Budget Allocation",
     description: "Decide how to allocate our community budget",
     census: {
-      type: CensusOrigin.CensusOriginMerkleTree,
+      type: CensusOrigin.OffchainStatic,
       root: publishResult.root,
       size: censusSize,
       uri: publishResult.uri

package/dist/contracts.d.ts

@@ -224,6 +224,11 @@ declare class ProcessStatusError extends ContractServiceError {
  */
 declare class ProcessCensusError extends ContractServiceError {
 }
+/**
+ * Error thrown when the census origin does not allow to modify the census root or uri.
+ */
+declare class CensusNotUpdatable extends ContractServiceError {
+}
 /**
  * Error thrown when process duration change fails.
  */
@@ -302,12 +307,15 @@ type ProcessCensusUpdatedCallback = EntityCallback<[string, string, string]>;
  */
 type ProcessDurationChangedCallback = EntityCallback<[string, bigint]>;
 /**
- * Callback for when a process state root is updated.
+ * Callback for when a process state transitions (valid state transition published).
  * @param processID - The process ID
  * @param sender - Address of the account that updated the state root
- * @param newStateRoot - The new state root
+ * @param oldStateRoot - The state root before the state transition
+ * @param newStateRoot - The new state root after the state transition
+ * @param newVotersCount - The number of single voters for the process updated after the state transition
+ * @param newOverwrittenVotesCount - The number of votes that has been overwritten updated after the state transition
  */
-type ProcessStateRootUpdatedCallback = EntityCallback<[string, string, bigint]>;
+type ProcessStateTransitionedCallback = EntityCallback<[string, string, bigint, bigint, bigint, bigint]>;
 /**
  * Callback for when process results are set.
  * @param processID - The process ID
@@ -315,6 +323,12 @@ type ProcessStateRootUpdatedCallback = EntityCallback<[string, string, bigint]>;
  * @param result - The results array
  */
 type ProcessResultsSetCallback = EntityCallback<[string, string, bigint[]]>;
+/**
+ * Callback for when process maxVoters is changed.
+ * @param processID - The process ID
+ * @param maxVoters - The new maxVoters value
+ */
+type ProcessMaxVotersChangedCallback = EntityCallback<[string, bigint]>;
 
 interface OrganizationInfo {
     name: string;
@@ -353,10 +367,14 @@ declare class OrganizationRegistryService extends SmartContractService {
  * Census origin types
  */
 declare enum CensusOrigin {
-    /** Indicates that the census is derived from a Merkle Tree structure */
-    CensusOriginMerkleTree = 1,
-    /** Indicates that the census is provided by a Credential Service Provider (CSP) */
-    CensusOriginCSP = 2
+    /** Offchain static Merkle Tree census */
+    OffchainStatic = 1,
+    /** Offchain dynamic Merkle Tree census */
+    OffchainDynamic = 2,
+    /** Onchain Merkle Tree census */
+    Onchain = 3,
+    /** Credential Service Provider (CSP) census using EdDSA BLS12-377 */
+    CSP = 4
 }
 
 interface BallotMode {
@@ -463,13 +481,14 @@ declare class ProcessRegistryService extends SmartContractService {
     getMaxCensusOrigin(): Promise<bigint>;
     getMaxStatus(): Promise<bigint>;
     getProcessNonce(address: string): Promise<bigint>;
-    getProcessDirect(processID: string): Promise<[bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.EncryptionKeyStructOutput, bigint, bigint, bigint, bigint, bigint, bigint, bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.BallotModeStructOutput, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.CensusStructOutput] & {
+    getProcessDirect(processID: string): Promise<[bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.EncryptionKeyStructOutput, bigint, bigint, bigint, bigint, bigint, bigint, bigint, bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.BallotModeStructOutput, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.CensusStructOutput] & {
         status: bigint;
         organizationId: string;
         encryptionKey: _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.EncryptionKeyStructOutput;
         latestStateRoot: bigint;
         startTime: bigint;
         duration: bigint;
+        maxVoters: bigint;
         votersCount: bigint;
         overwrittenVotesCount: bigint;
         creationBlock: bigint;
@@ -480,7 +499,7 @@ declare class ProcessRegistryService extends SmartContractService {
     }>;
     getRVerifier(): Promise<string>;
     getSTVerifier(): Promise<string>;
-    newProcess(status: ProcessStatus, startTime: number, duration: number, ballotMode: BallotMode, census: CensusData, metadata: string, encryptionKey: EncryptionKey, initStateRoot: bigint): AsyncGenerator<TxStatusEvent<{
+    newProcess(status: ProcessStatus, startTime: number, duration: number, maxVoters: number, ballotMode: BallotMode, census: CensusData, metadata: string, encryptionKey: EncryptionKey, initStateRoot: bigint): AsyncGenerator<TxStatusEvent<{
         success: boolean;
     }>, void, unknown>;
     setProcessStatus(processID: string, newStatus: ProcessStatus): AsyncGenerator<TxStatusEvent<{
@@ -492,6 +511,9 @@ declare class ProcessRegistryService extends SmartContractService {
     setProcessDuration(processID: string, duration: number): AsyncGenerator<TxStatusEvent<{
         success: boolean;
     }>, void, unknown>;
+    setProcessMaxVoters(processID: string, maxVoters: number): AsyncGenerator<TxStatusEvent<{
+        success: boolean;
+    }>, void, unknown>;
     /**
      * Matches the on-chain `submitStateTransition(processId, proof, input)`
      */
@@ -513,10 +535,11 @@ declare class ProcessRegistryService extends SmartContractService {
     onProcessStatusChanged(cb: ProcessStatusChangedCallback): void;
     onCensusUpdated(cb: ProcessCensusUpdatedCallback): void;
     onProcessDurationChanged(cb: ProcessDurationChangedCallback): void;
-    onStateRootUpdated(cb: ProcessStateRootUpdatedCallback): void;
+    onStateTransitioned(cb: ProcessStateTransitionedCallback): void;
     onProcessResultsSet(cb: ProcessResultsSetCallback): void;
+    onProcessMaxVotersChanged(cb: ProcessMaxVotersChangedCallback): void;
     removeAllListeners(): void;
 }
 
-export { ContractServiceError, OrganizationAdministratorError, OrganizationCreateError, OrganizationDeleteError, OrganizationRegistryService, OrganizationUpdateError, ProcessCensusError, ProcessCreateError, ProcessDurationError, ProcessRegistryService, ProcessResultError, ProcessStateTransitionError, ProcessStatus, ProcessStatusError, SmartContractService, TxStatus };
-export type { EntityCallback, OrganizationAdministratorAddedCallback, OrganizationAdministratorRemovedCallback, OrganizationCreatedCallback, OrganizationInfo, OrganizationUpdatedCallback, ProcessCensusUpdatedCallback, ProcessCreatedCallback, ProcessDurationChangedCallback, ProcessResultsSetCallback, ProcessStateRootUpdatedCallback, ProcessStatusChangedCallback, TxStatusEvent };
+export { CensusNotUpdatable, ContractServiceError, OrganizationAdministratorError, OrganizationCreateError, OrganizationDeleteError, OrganizationRegistryService, OrganizationUpdateError, ProcessCensusError, ProcessCreateError, ProcessDurationError, ProcessRegistryService, ProcessResultError, ProcessStateTransitionError, ProcessStatus, ProcessStatusError, SmartContractService, TxStatus };
+export type { EntityCallback, OrganizationAdministratorAddedCallback, OrganizationAdministratorRemovedCallback, OrganizationCreatedCallback, OrganizationInfo, OrganizationUpdatedCallback, ProcessCensusUpdatedCallback, ProcessCreatedCallback, ProcessDurationChangedCallback, ProcessMaxVotersChangedCallback, ProcessResultsSetCallback, ProcessStateTransitionedCallback, ProcessStatusChangedCallback, TxStatusEvent };

package/dist/index.d.ts

@@ -108,10 +108,14 @@ declare class BaseService {
  * Census origin types
  */
 declare enum CensusOrigin {
-    /** Indicates that the census is derived from a Merkle Tree structure */
-    CensusOriginMerkleTree = 1,
-    /** Indicates that the census is provided by a Credential Service Provider (CSP) */
-    CensusOriginCSP = 2
+    /** Offchain static Merkle Tree census */
+    OffchainStatic = 1,
+    /** Offchain dynamic Merkle Tree census */
+    OffchainDynamic = 2,
+    /** Onchain Merkle Tree census */
+    Onchain = 3,
+    /** Credential Service Provider (CSP) census using EdDSA BLS12-377 */
+    CSP = 4
 }
 interface CensusParticipant$1 {
     key: string;
@@ -124,18 +128,18 @@ interface BaseCensusProof {
     address: string;
     /** The weight as a decimal string. */
     weight: string;
-    /** Census origin type: CensusOriginMerkleTree for merkle proofs, CensusOriginCSP for csp proofs */
+    /** Census origin type: OffchainStatic/OffchainDynamic/Onchain for merkle proofs, CSP for csp proofs */
     censusOrigin: CensusOrigin;
 }
 interface MerkleCensusProof extends BaseCensusProof {
-    censusOrigin: CensusOrigin.CensusOriginMerkleTree;
+    censusOrigin: CensusOrigin.OffchainStatic | CensusOrigin.OffchainDynamic | CensusOrigin.Onchain;
     /** The leaf value (hex-prefixed weight). */
     value: string;
     /** The serialized sibling path (hex-prefixed). */
     siblings: string;
 }
 interface CSPCensusProof extends BaseCensusProof {
-    censusOrigin: CensusOrigin.CensusOriginCSP;
+    censusOrigin: CensusOrigin.CSP;
     /** The process id signed with the address (hex-prefixed). */
     processId: string;
     /** The public key of the csp (hex-prefixed). */
@@ -308,8 +312,9 @@ declare abstract class Census {
     protected _censusRoot: string | null;
     protected _censusURI: string | null;
     protected _type: CensusType;
+    protected _censusOrigin: CensusOrigin;
     protected _size: number | null;
-    constructor(type: CensusType);
+    constructor(type: CensusType, censusOrigin?: CensusOrigin);
     get censusId(): string | null;
     get censusRoot(): string | null;
     get censusURI(): string | null;
@@ -317,7 +322,7 @@ declare abstract class Census {
     get size(): number | null;
     get isPublished(): boolean;
     /**
-     * Convert CensusType to CensusOrigin enum for API compatibility
+     * Get the census origin (OffchainStatic, OffchainDynamic, Onchain, or CSP)
      */
     get censusOrigin(): CensusOrigin;
 }
@@ -328,7 +333,11 @@ declare abstract class Census {
  */
 declare class PlainCensus extends Census {
     private _participants;
-    constructor();
+    /**
+     * Creates a new PlainCensus
+     * @param censusOrigin - The census origin (defaults to OffchainStatic for backward compatibility)
+     */
+    constructor(censusOrigin?: CensusOrigin);
     /**
      * Add participant(s) with automatic weight=1
      * @param addresses - Single address or array of addresses
@@ -369,7 +378,11 @@ interface WeightedParticipant {
  */
 declare class WeightedCensus extends Census {
     private _participants;
-    constructor();
+    /**
+     * Creates a new WeightedCensus
+     * @param censusOrigin - The census origin (defaults to OffchainStatic for backward compatibility)
+     */
+    constructor(censusOrigin?: CensusOrigin);
     /**
      * Add participant(s) with custom weights
      * Weight can be provided as string, number, or bigint - will be converted to string internally
@@ -421,7 +434,15 @@ declare class CspCensus extends Census {
  * Use this when you have the census root, URI, and size from a previous publication
  */
 declare class PublishedCensus extends Census {
-    constructor(type: CensusType, root: string, uri: string, size: number);
+    /**
+     * Creates a PublishedCensus from existing census data
+     * @param type - The census type (PLAIN, WEIGHTED, or CSP)
+     * @param root - The census root
+     * @param uri - The census URI
+     * @param size - The census size (number of participants)
+     * @param censusOrigin - The census origin (optional - defaults based on type if not provided)
+     */
+    constructor(type: CensusType, root: string, uri: string, size: number, censusOrigin?: CensusOrigin);
 }
 
 /**
@@ -496,6 +517,7 @@ interface GetProcessResponse {
     ballotMode: BallotMode;
     census: CensusData;
     votersCount: string;
+    maxVoters: string;
     overwrittenVotesCount: string;
     isAcceptingVotes: boolean;
     sequencerStats: {
@@ -857,12 +879,15 @@ type ProcessCensusUpdatedCallback = EntityCallback<[string, string, string]>;
  */
 type ProcessDurationChangedCallback = EntityCallback<[string, bigint]>;
 /**
- * Callback for when a process state root is updated.
+ * Callback for when a process state transitions (valid state transition published).
  * @param processID - The process ID
  * @param sender - Address of the account that updated the state root
- * @param newStateRoot - The new state root
+ * @param oldStateRoot - The state root before the state transition
+ * @param newStateRoot - The new state root after the state transition
+ * @param newVotersCount - The number of single voters for the process updated after the state transition
+ * @param newOverwrittenVotesCount - The number of votes that has been overwritten updated after the state transition
  */
-type ProcessStateRootUpdatedCallback = EntityCallback<[string, string, bigint]>;
+type ProcessStateTransitionedCallback = EntityCallback<[string, string, bigint, bigint, bigint, bigint]>;
 /**
  * Callback for when process results are set.
  * @param processID - The process ID
@@ -870,6 +895,12 @@ type ProcessStateRootUpdatedCallback = EntityCallback<[string, string, bigint]>;
  * @param result - The results array
  */
 type ProcessResultsSetCallback = EntityCallback<[string, string, bigint[]]>;
+/**
+ * Callback for when process maxVoters is changed.
+ * @param processID - The process ID
+ * @param maxVoters - The new maxVoters value
+ */
+type ProcessMaxVotersChangedCallback = EntityCallback<[string, bigint]>;
 
 declare enum ProcessStatus {
     READY = 0,
@@ -891,13 +922,14 @@ declare class ProcessRegistryService extends SmartContractService {
     getMaxCensusOrigin(): Promise<bigint>;
     getMaxStatus(): Promise<bigint>;
     getProcessNonce(address: string): Promise<bigint>;
-    getProcessDirect(processID: string): Promise<[bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.EncryptionKeyStructOutput, bigint, bigint, bigint, bigint, bigint, bigint, bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.BallotModeStructOutput, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.CensusStructOutput] & {
+    getProcessDirect(processID: string): Promise<[bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.EncryptionKeyStructOutput, bigint, bigint, bigint, bigint, bigint, bigint, bigint, bigint, string, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.BallotModeStructOutput, _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.CensusStructOutput] & {
         status: bigint;
         organizationId: string;
         encryptionKey: _vocdoni_davinci_contracts_dist_src_ProcessRegistry.IProcessRegistry.EncryptionKeyStructOutput;
         latestStateRoot: bigint;
         startTime: bigint;
         duration: bigint;
+        maxVoters: bigint;
         votersCount: bigint;
         overwrittenVotesCount: bigint;
         creationBlock: bigint;
@@ -908,7 +940,7 @@ declare class ProcessRegistryService extends SmartContractService {
     }>;
     getRVerifier(): Promise<string>;
     getSTVerifier(): Promise<string>;
-    newProcess(status: ProcessStatus, startTime: number, duration: number, ballotMode: BallotMode, census: CensusData, metadata: string, encryptionKey: EncryptionKey, initStateRoot: bigint): AsyncGenerator<TxStatusEvent<{
+    newProcess(status: ProcessStatus, startTime: number, duration: number, maxVoters: number, ballotMode: BallotMode, census: CensusData, metadata: string, encryptionKey: EncryptionKey, initStateRoot: bigint): AsyncGenerator<TxStatusEvent<{
         success: boolean;
     }>, void, unknown>;
     setProcessStatus(processID: string, newStatus: ProcessStatus): AsyncGenerator<TxStatusEvent<{
@@ -920,6 +952,9 @@ declare class ProcessRegistryService extends SmartContractService {
     setProcessDuration(processID: string, duration: number): AsyncGenerator<TxStatusEvent<{
         success: boolean;
     }>, void, unknown>;
+    setProcessMaxVoters(processID: string, maxVoters: number): AsyncGenerator<TxStatusEvent<{
+        success: boolean;
+    }>, void, unknown>;
     /**
      * Matches the on-chain `submitStateTransition(processId, proof, input)`
      */
@@ -941,8 +976,9 @@ declare class ProcessRegistryService extends SmartContractService {
     onProcessStatusChanged(cb: ProcessStatusChangedCallback): void;
     onCensusUpdated(cb: ProcessCensusUpdatedCallback): void;
     onProcessDurationChanged(cb: ProcessDurationChangedCallback): void;
-    onStateRootUpdated(cb: ProcessStateRootUpdatedCallback): void;
+    onStateTransitioned(cb: ProcessStateTransitionedCallback): void;
     onProcessResultsSet(cb: ProcessResultsSetCallback): void;
+    onProcessMaxVotersChanged(cb: ProcessMaxVotersChangedCallback): void;
     removeAllListeners(): void;
 }
 
@@ -1239,6 +1275,11 @@ interface BaseProcessConfig {
         /** End date/time (Date object, ISO string, or Unix timestamp, cannot be used with duration) */
         endDate?: Date | string | number;
     };
+    /**
+     * Maximum number of voters allowed for this process (optional, defaults to census size)
+     * This parameter limits how many votes can be cast in the process.
+     */
+    maxVoters?: number;
 }
 /**
  * Process configuration with metadata fields (title, description, questions)
@@ -1292,6 +1333,8 @@ interface ProcessInfo extends BaseProcess {
     duration: number;
     /** Time remaining in seconds (0 if ended, negative if not started) */
     timeRemaining: number;
+    /** Maximum number of voters allowed */
+    maxVoters: number;
     /** Process results (array of BigInt values) */
     result: bigint[];
     /** Number of votes cast */
@@ -1592,6 +1635,56 @@ declare class ProcessOrchestrationService {
      * ```
      */
     resumeProcess(processId: string): Promise<void>;
+    /**
+     * Sets the maximum number of voters for a process.
+     * Returns an async generator that yields transaction status events.
+     *
+     * @param processId - The process ID
+     * @param maxVoters - The new maximum number of voters
+     * @returns AsyncGenerator yielding transaction status events
+     *
+     * @example
+     * ```typescript
+     * const stream = sdk.setProcessMaxVotersStream("0x1234567890abcdef...", 500);
+     *
+     * for await (const event of stream) {
+     *   switch (event.status) {
+     *     case "pending":
+     *       console.log("Transaction pending:", event.hash);
+     *       break;
+     *     case "completed":
+     *       console.log("MaxVoters updated successfully");
+     *       break;
+     *     case "failed":
+     *       console.error("Transaction failed:", event.error);
+     *       break;
+     *     case "reverted":
+     *       console.error("Transaction reverted:", event.reason);
+     *       break;
+     *   }
+     * }
+     * ```
+     */
+    setProcessMaxVotersStream(processId: string, maxVoters: number): AsyncGenerator<TxStatusEvent<{
+        success: boolean;
+    }>>;
+    /**
+     * Sets the maximum number of voters for a process.
+     * This is a simplified method that waits for transaction completion.
+     *
+     * For real-time transaction status updates, use setProcessMaxVotersStream() instead.
+     *
+     * @param processId - The process ID
+     * @param maxVoters - The new maximum number of voters
+     * @returns Promise resolving when the maxVoters is updated
+     *
+     * @example
+     * ```typescript
+     * await sdk.setProcessMaxVoters("0x1234567890abcdef...", 500);
+     * console.log("MaxVoters updated successfully");
+     * ```
+     */
+    setProcessMaxVoters(processId: string, maxVoters: number): Promise<void>;
 }
 
 /**
@@ -1809,6 +1902,11 @@ declare class ProcessStatusError extends ContractServiceError {
  */
 declare class ProcessCensusError extends ContractServiceError {
 }
+/**
+ * Error thrown when the census origin does not allow to modify the census root or uri.
+ */
+declare class CensusNotUpdatable extends ContractServiceError {
+}
 /**
  * Error thrown when process duration change fails.
  */
@@ -1996,7 +2094,7 @@ declare class DavinciSDK {
      *   title: "My Election",
      *   description: "A simple election",
      *   census: {
-     *     type: CensusOrigin.CensusOriginMerkleTree,
+     *     type: CensusOrigin.OffchainStatic,
      *     root: "0x1234...",
      *     size: 100,
      *     uri: "ipfs://..."
@@ -2077,7 +2175,7 @@ declare class DavinciSDK {
      *   title: "My Election",
      *   description: "A simple election",
      *   census: {
-     *     type: CensusOrigin.CensusOriginMerkleTree,
+     *     type: CensusOrigin.OffchainStatic,
      *     root: "0x1234...",
      *     size: 100,
      *     uri: "ipfs://your-census-uri"
@@ -2531,6 +2629,63 @@ declare class DavinciSDK {
      * ```
      */
     resumeProcess(processId: string): Promise<void>;
+    /**
+     * Sets the maximum number of voters for a process and returns an async generator
+     * that yields transaction status events. This allows you to change the voter limit
+     * after process creation.
+     *
+     * Requires a signer with a provider for blockchain interactions.
+     *
+     * @param processId - The process ID
+     * @param maxVoters - The new maximum number of voters
+     * @returns AsyncGenerator yielding transaction status events
+     * @throws Error if signer does not have a provider
+     *
+     * @example
+     * ```typescript
+     * const stream = sdk.setProcessMaxVotersStream("0x1234567890abcdef...", 500);
+     *
+     * for await (const event of stream) {
+     *   switch (event.status) {
+     *     case TxStatus.Pending:
+     *       console.log("Transaction pending:", event.hash);
+     *       break;
+     *     case TxStatus.Completed:
+     *       console.log("MaxVoters updated successfully");
+     *       break;
+     *     case TxStatus.Failed:
+     *       console.error("Transaction failed:", event.error);
+     *       break;
+     *     case TxStatus.Reverted:
+     *       console.error("Transaction reverted:", event.reason);
+     *       break;
+     *   }
+     * }
+     * ```
+     */
+    setProcessMaxVotersStream(processId: string, maxVoters: number): AsyncGenerator<TxStatusEvent<{
+        success: boolean;
+    }>, any, any>;
+    /**
+     * Sets the maximum number of voters for a process.
+     * This is the simplified method that waits for transaction completion.
+     *
+     * For real-time transaction status updates, use setProcessMaxVotersStream() instead.
+     *
+     * Requires a signer with a provider for blockchain interactions.
+     *
+     * @param processId - The process ID
+     * @param maxVoters - The new maximum number of voters
+     * @returns Promise resolving when the maxVoters is updated
+     * @throws Error if signer does not have a provider
+     *
+     * @example
+     * ```typescript
+     * await sdk.setProcessMaxVoters("0x1234567890abcdef...", 500);
+     * console.log("MaxVoters updated successfully");
+     * ```
+     */
+    setProcessMaxVoters(processId: string, maxVoters: number): Promise<void>;
     /**
      * Resolve contract address based on configuration priority:
      * 1. Custom addresses from user config (if provided)
@@ -2558,5 +2713,5 @@ declare class DavinciSDK {
     private ensureProvider;
 }
 
-export { BaseService, Census, CensusOrchestrator, CensusOrigin, CensusType, CircomProof, ContractServiceError, CspCensus, DavinciCrypto, DavinciSDK, ElectionMetadataTemplate, ElectionResultsTypeNames, OrganizationAdministratorError, OrganizationCreateError, OrganizationDeleteError, OrganizationRegistryService, OrganizationUpdateError, PlainCensus, ProcessCensusError, ProcessCreateError, ProcessDurationError, ProcessOrchestrationService, ProcessRegistryService, ProcessResultError, ProcessStateTransitionError, ProcessStatus, ProcessStatusError, PublishedCensus, SmartContractService, TxStatus, VocdoniApiService, VocdoniCensusService, VocdoniSequencerService, VoteOrchestrationService, VoteStatus, WeightedCensus, assertCSPCensusProof, assertMerkleCensusProof, createProcessSignatureMessage, getElectionMetadataTemplate, isCSPCensusProof, isMerkleCensusProof, signProcessCreation, validateProcessId };
-export type { AbstainProperties, AnyJson, ApiError, ApprovalProperties, BallotMode, BaseCensusProof, BaseProcess, BudgetProperties, CSPCensusProof, CSPCensusProofProvider, CSPSignOutput, CensusData, CensusParticipant$1 as 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, ParticipantInfoResponse, ProcessCensusUpdatedCallback, ProcessConfig, ProcessConfigWithMetadata, ProcessConfigWithMetadataUri, ProcessCreatedCallback, ProcessCreationResult, ProcessDurationChangedCallback, ProcessInfo, ProcessQuestion, ProcessResultsSetCallback, ProcessStateRootUpdatedCallback, ProcessStatusChangedCallback, ProofInputs, ProtocolVersion, PublishCensusResponse, QuadraticProperties, Question, SequencerStats, Snapshot, SnapshotsQueryParams, SnapshotsResponse, TxStatusEvent, VocdoniApiServiceConfig, VoteBallot, VoteCiphertext, VoteConfig, VoteOrchestrationConfig, VoteProof, VoteRequest, VoteResult, VoteStatusInfo, VoteStatusResponse, WeightedParticipant, WorkerStats, WorkersResponse };
+export { BaseService, Census, CensusNotUpdatable, CensusOrchestrator, CensusOrigin, CensusType, CircomProof, ContractServiceError, CspCensus, DavinciCrypto, DavinciSDK, ElectionMetadataTemplate, ElectionResultsTypeNames, OrganizationAdministratorError, OrganizationCreateError, OrganizationDeleteError, OrganizationRegistryService, OrganizationUpdateError, PlainCensus, ProcessCensusError, ProcessCreateError, ProcessDurationError, ProcessOrchestrationService, ProcessRegistryService, ProcessResultError, ProcessStateTransitionError, ProcessStatus, ProcessStatusError, PublishedCensus, SmartContractService, TxStatus, VocdoniApiService, VocdoniCensusService, VocdoniSequencerService, VoteOrchestrationService, VoteStatus, WeightedCensus, assertCSPCensusProof, assertMerkleCensusProof, createProcessSignatureMessage, getElectionMetadataTemplate, isCSPCensusProof, isMerkleCensusProof, signProcessCreation, validateProcessId };
+export type { AbstainProperties, AnyJson, ApiError, ApprovalProperties, BallotMode, BaseCensusProof, BaseProcess, BudgetProperties, CSPCensusProof, CSPCensusProofProvider, CSPSignOutput, CensusData, CensusParticipant$1 as 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, 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, WeightedParticipant, WorkerStats, WorkersResponse };