@vocdoni/davinci-sdk 0.0.3 → 0.0.4

package/README.md

@@ -549,6 +549,27 @@ if (hasVoted) {
 }
 ```
 
+#### Checking if Address is Able to Vote
+
+Get participant information including voting weight for an address:
+
+```typescript
+const participantInfo = await sdk.isAddressAbleToVote(processId, voterAddress);
+
+console.log('Address:', participantInfo.key);
+console.log('Voting weight:', participantInfo.weight);
+
+// Use this to verify voter eligibility before submitting a vote
+if (participantInfo) {
+  console.log(`Address ${participantInfo.key} is eligible with weight ${participantInfo.weight}`);
+}
+```
+
+This method is useful for:
+- Verifying voter eligibility before vote submission
+- Displaying voting power/weight to users
+- Building voter dashboards and analytics
+
 ## 💡 Examples
 
 ### Complete Voting Flow

package/dist/contracts.d.ts

@@ -293,9 +293,8 @@ type ProcessStatusChangedCallback = EntityCallback<[string, bigint, bigint]>;
  * @param processID - The process ID
  * @param root - The new census root
  * @param uri - The new census URI
- * @param maxVotes - The maximum number of votes
  */
-type ProcessCensusUpdatedCallback = EntityCallback<[string, string, string, bigint]>;
+type ProcessCensusUpdatedCallback = EntityCallback<[string, string, string]>;
 /**
  * Callback for when a process duration changes.
  * @param processID - The process ID
@@ -372,7 +371,6 @@ interface BallotMode {
 }
 interface CensusData {
     censusOrigin: CensusOrigin;
-    maxVotes: string;
     censusRoot: string;
     censusURI: string;
 }
@@ -420,6 +418,7 @@ interface CSPSignOutput {
     censusOrigin: CensusOrigin;
     root: string;
     address: string;
+    weight: string;
     processId: string;
     publicKey: string;
     signature: string;
@@ -430,7 +429,7 @@ interface RawResult<T = any> {
 }
 interface GoDavinciCryptoWasm {
     proofInputs(inputJson: string): RawResult<DavinciCryptoOutput>;
-    cspSign(censusOrigin: number, privKey: string, processId: string, address: string): RawResult<CSPSignOutput>;
+    cspSign(censusOrigin: number, privKey: string, processId: string, address: string, weight: string): RawResult<CSPSignOutput>;
     cspVerify(cspProof: string): RawResult<boolean>;
     cspCensusRoot(censusOrigin: number, privKey: string): RawResult<{
         root: string;

package/dist/index.d.ts

@@ -194,6 +194,8 @@ interface PublishCensusResponse {
     publishedAt: string;
     /** The constructed URI for accessing the census */
     uri: string;
+    /** The size of the census. */
+    size: number;
 }
 interface Snapshot {
     /** ISO timestamp of the snapshot date. */
@@ -263,11 +265,11 @@ interface HealthResponse {
 declare class VocdoniCensusService extends BaseService {
     constructor(baseURL: string);
     /**
-     * Constructs the URI for accessing a census by its root
-     * @param censusRoot - The census root (hex-prefixed)
+     * Constructs the URI for accessing a census
+     * @param relativePath - The relative path
      * @returns The constructed URI for the census
      */
-    getCensusUri(censusRoot: string): string;
+    getCensusUri(relativePath: string): string;
     createCensus(): Promise<string>;
     addParticipants(censusId: string, participants: CensusParticipant$1[]): Promise<void>;
     getParticipants(censusId: string): Promise<CensusParticipant$1[]>;
@@ -457,7 +459,6 @@ interface BallotMode {
 }
 interface CensusData {
     censusOrigin: CensusOrigin;
-    maxVotes: string;
     censusRoot: string;
     censusURI: string;
 }
@@ -468,14 +469,13 @@ interface EncryptionKey {
 
 interface CreateProcessRequest {
     processId: string;
-    censusRoot: string;
+    census: {
+        censusOrigin: CensusOrigin;
+        censusRoot: string;
+        censusURI: string;
+    };
     ballotMode: BallotMode;
     signature: string;
-    /**
-     * The censusOrigin specifies the origin type of the census used in the request.
-     * This attribute allows the API to determine how the census data should be processed or verified.
-     */
-    censusOrigin: CensusOrigin;
 }
 interface CreateProcessResponse {
     processId: string;
@@ -548,8 +548,8 @@ interface VoteProof {
 interface VoteRequest {
     /** The `processId` you obtained when creating the process. */
     processId: string;
-    /** Your Merkle‐proof that you're in the census. */
-    censusProof: CensusProof;
+    /** Your census proof (only required for CSP, not for MerkleTree). */
+    censusProof?: CensusProof;
     /** Your encrypted ballot. */
     ballot: VoteBallot;
     /** The zkSNARK proof that the ballot is well‐formed. */
@@ -615,6 +615,10 @@ interface WorkerStats {
 interface WorkersResponse {
     workers: WorkerStats[];
 }
+interface ParticipantInfoResponse {
+    key: string;
+    weight: string;
+}
 
 declare class VocdoniSequencerService extends BaseService {
     constructor(baseURL: string);
@@ -625,6 +629,7 @@ declare class VocdoniSequencerService extends BaseService {
     submitVote(vote: VoteRequest): Promise<void>;
     getVoteStatus(processId: string, voteId: string): Promise<VoteStatusResponse>;
     hasAddressVoted(processId: string, address: string): Promise<boolean>;
+    isAddressAbleToVote(processId: string, address: string): Promise<ParticipantInfoResponse>;
     getInfo(): Promise<InfoResponse>;
     pushMetadata(metadata: ElectionMetadata): Promise<string>;
     getMetadata(hashOrUrl: string): Promise<ElectionMetadata>;
@@ -864,9 +869,8 @@ type ProcessStatusChangedCallback = EntityCallback<[string, bigint, bigint]>;
  * @param processID - The process ID
  * @param root - The new census root
  * @param uri - The new census URI
- * @param maxVotes - The maximum number of votes
  */
-type ProcessCensusUpdatedCallback = EntityCallback<[string, string, string, bigint]>;
+type ProcessCensusUpdatedCallback = EntityCallback<[string, string, string]>;
 /**
  * Callback for when a process duration changes.
  * @param processID - The process ID
@@ -1094,6 +1098,7 @@ interface CSPSignOutput {
     censusOrigin: CensusOrigin;
     root: string;
     address: string;
+    weight: string;
     processId: string;
     publicKey: string;
     signature: string;
@@ -1104,7 +1109,7 @@ interface RawResult<T = any> {
 }
 interface GoDavinciCryptoWasm {
     proofInputs(inputJson: string): RawResult<DavinciCryptoOutput>;
-    cspSign(censusOrigin: number, privKey: string, processId: string, address: string): RawResult<CSPSignOutput>;
+    cspSign(censusOrigin: number, privKey: string, processId: string, address: string, weight: string): RawResult<CSPSignOutput>;
     cspVerify(cspProof: string): RawResult<boolean>;
     cspCensusRoot(censusOrigin: number, privKey: string): RawResult<{
         root: string;
@@ -1164,22 +1169,24 @@ declare class DavinciCrypto {
      * @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): Promise<CSPSignOutput>;
+    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.CensusOriginCSP)
      * @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, processId: string, publicKey: string, signature: string): Promise<boolean>;
+    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.CensusOriginCSP)
@@ -1204,27 +1211,29 @@ interface BaseProcess {
         type: CensusOrigin;
         /** Census root */
         root: string;
-        /** Census size */
-        size: number;
         /** Census URI */
         uri: string;
     };
     /** Ballot configuration */
     ballot: BallotMode;
     /** Election questions and choices (required) */
-    questions: Array<{
+    questions: Array<ProcessQuestion>;
+}
+/**
+ * Question structure used in process configuration and metadata
+ */
+type ProcessQuestion = {
+    title: string;
+    description?: string;
+    choices: Array<{
         title: string;
-        description?: string;
-        choices: Array<{
-            title: string;
-            value: number;
-        }>;
+        value: number;
     }>;
-}
+};
 /**
- * Configuration for creating a process
+ * Base configuration shared by both process creation variants
  */
-interface ProcessConfig extends Omit<BaseProcess, 'census'> {
+interface BaseProcessConfig {
     /**
      * Census - either a Census object (PlainCensus, WeightedCensus, CspCensus, PublishedCensus)
      * or manual configuration. If a Census object is provided and not published, it will be
@@ -1240,6 +1249,8 @@ interface ProcessConfig extends Omit<BaseProcess, 'census'> {
         /** Census URI */
         uri: string;
     };
+    /** Ballot configuration */
+    ballot: BallotMode;
     /** Process timing - use either duration-based or date-based configuration */
     timing: {
         /** Start date/time (Date object, ISO string, or Unix timestamp, default: now + 60 seconds) */
@@ -1250,6 +1261,31 @@ interface ProcessConfig extends Omit<BaseProcess, 'census'> {
         endDate?: Date | string | number;
     };
 }
+/**
+ * Process configuration with metadata fields (title, description, questions)
+ * The metadata will be created and uploaded automatically
+ */
+interface ProcessConfigWithMetadata extends BaseProcessConfig {
+    /** Process title */
+    title: string;
+    /** Process description (optional) */
+    description?: string;
+    /** Election questions and choices (at least one required) */
+    questions: [ProcessQuestion, ...ProcessQuestion[]];
+}
+/**
+ * Process configuration with a pre-existing metadata URI
+ * No metadata upload will occur - the provided URI will be used directly
+ */
+interface ProcessConfigWithMetadataUri extends BaseProcessConfig {
+    /** Pre-existing metadata URI to use instead of uploading new metadata */
+    metadataUri: string;
+}
+/**
+ * Configuration for creating a process
+ * Use either metadata fields (title, questions) or a pre-existing metadataUri
+ */
+type ProcessConfig = ProcessConfigWithMetadata | ProcessConfigWithMetadataUri;
 /**
  * Result of process creation
  */
@@ -1379,7 +1415,8 @@ declare class ProcessOrchestrationService {
      */
     private dateToUnixTimestamp;
     /**
-     * Creates metadata from the simplified configuration
+     * Creates metadata from the configuration with metadata fields
+     * This method should only be called with ProcessConfigWithMetadata
      */
     private createMetadata;
     /**
@@ -2178,6 +2215,23 @@ declare class DavinciSDK {
      * ```
      */
     hasAddressVoted(processId: string, address: string): Promise<boolean>;
+    /**
+     * Check if an address is able to vote in a process and get participant information.
+     *
+     * Does NOT require a provider - uses API calls only.
+     *
+     * @param processId - The process ID
+     * @param address - The voter's address
+     * @returns Promise resolving to participant information (key and weight)
+     *
+     * @example
+     * ```typescript
+     * const participantInfo = await sdk.isAddressAbleToVote(processId, "0x1234567890abcdef...");
+     * console.log("Address:", participantInfo.key);
+     * console.log("Weight:", participantInfo.weight);
+     * ```
+     */
+    isAddressAbleToVote(processId: string, address: string): Promise<ParticipantInfoResponse>;
     /**
      * Watch vote status changes in real-time using an async generator.
      * This method yields each status change as it happens, perfect for showing
@@ -2507,4 +2561,4 @@ declare class DavinciSDK {
 }
 
 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, ProcessCensusUpdatedCallback, ProcessConfig, ProcessCreatedCallback, ProcessCreationResult, ProcessDurationChangedCallback, ProcessInfo, 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 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 };

package/dist/index.js

@@ -89,12 +89,12 @@ class VocdoniCensusService extends BaseService {
     super(baseURL);
   }
   /**
-   * Constructs the URI for accessing a census by its root
-   * @param censusRoot - The census root (hex-prefixed)
+   * Constructs the URI for accessing a census
+   * @param relativePath - The relative path
    * @returns The constructed URI for the census
    */
-  getCensusUri(censusRoot) {
-    return `${this.axios.defaults.baseURL}/censuses/${censusRoot}`;
+  getCensusUri(relativePath) {
+    return `${this.axios.defaults.baseURL}${relativePath}`;
   }
   createCensus() {
     return this.request({
@@ -163,10 +163,13 @@ class VocdoniCensusService extends BaseService {
     return this.request({
       method: "POST",
       url: `/censuses/${censusId}/publish`
-    }).then((response) => ({
-      ...response,
-      uri: this.getCensusUri(response.root)
-    }));
+    }).then((apiResponse) => {
+      const { censusUri, ...responseWithoutCensusUri } = apiResponse;
+      return {
+        ...responseWithoutCensusUri,
+        uri: this.getCensusUri(censusUri)
+      };
+    });
   }
   // BigQuery endpoints
   getSnapshots(params) {
@@ -196,13 +199,13 @@ var CensusOrigin = /* @__PURE__ */ ((CensusOrigin2) => {
   return CensusOrigin2;
 })(CensusOrigin || {});
 function isBaseCensusProof(proof) {
-  return !!proof && typeof proof.root === "string" && typeof proof.address === "string" && typeof proof.weight === "string" && typeof proof.censusOrigin === "number" && Object.values(CensusOrigin).includes(proof.censusOrigin);
+  return !!proof && typeof proof.root === "string" && typeof proof.address === "string" && typeof proof.censusOrigin === "number" && Object.values(CensusOrigin).includes(proof.censusOrigin);
 }
 function isMerkleCensusProof(proof) {
-  return isBaseCensusProof(proof) && proof.censusOrigin === 1 /* CensusOriginMerkleTree */ && typeof proof.value === "string" && typeof proof.siblings === "string";
+  return isBaseCensusProof(proof) && proof.censusOrigin === 1 /* CensusOriginMerkleTree */ && typeof proof.weight === "string" && typeof proof.value === "string" && typeof proof.siblings === "string";
 }
 function isCSPCensusProof(proof) {
-  return isBaseCensusProof(proof) && proof.censusOrigin === 2 /* CensusOriginCSP */ && typeof proof.processId === "string" && typeof proof.publicKey === "string" && typeof proof.signature === "string";
+  return isBaseCensusProof(proof) && proof.censusOrigin === 2 /* CensusOriginCSP */ && typeof proof.weight === "string" && typeof proof.processId === "string" && typeof proof.publicKey === "string" && typeof proof.signature === "string";
 }
 function assertMerkleCensusProof(proof) {
   if (!isMerkleCensusProof(proof)) {
@@ -562,6 +565,12 @@ class VocdoniSequencerService extends BaseService {
       throw error;
     }
   }
+  isAddressAbleToVote(processId, address) {
+    return this.request({
+      method: "GET",
+      url: `/processes/${processId}/participants/${address}`
+    });
+  }
   getInfo() {
     return this.request({
       method: "GET",
@@ -985,7 +994,6 @@ class ProcessRegistryService extends SmartContractService {
   newProcess(status, startTime, duration, ballotMode, census, metadata, encryptionKey, initStateRoot) {
     const contractCensus = {
       censusOrigin: BigInt(census.censusOrigin),
-      maxVotes: BigInt(census.maxVotes),
       censusRoot: census.censusRoot,
       censusURI: census.censusURI
     };
@@ -1016,7 +1024,6 @@ class ProcessRegistryService extends SmartContractService {
   setProcessCensus(processID, census) {
     const contractCensus = {
       censusOrigin: BigInt(census.censusOrigin),
-      maxVotes: BigInt(census.maxVotes),
       censusRoot: census.censusRoot,
       censusURI: census.censusURI
     };
@@ -1185,7 +1192,6 @@ class ProcessOrchestrationService {
     const census = {
       type: Number(rawProcess.census.censusOrigin),
       root: rawProcess.census.censusRoot,
-      size: Number(rawProcess.census.maxVotes),
       uri: rawProcess.census.censusURI || ""
     };
     const ballot = {
@@ -1200,11 +1206,11 @@ class ProcessOrchestrationService {
     };
     return {
       processId,
-      title,
+      title: title || "",
       description,
       census,
       ballot,
-      questions,
+      questions: questions || [],
       status: Number(rawProcess.status),
       creator: rawProcess.organizationId,
       startDate: new Date(startTime * 1e3),
@@ -1333,20 +1339,27 @@ class ProcessOrchestrationService {
     const censusConfig = await this.handleCensus(config.census);
     const censusRoot = censusConfig.root;
     const ballotMode = config.ballot;
-    const metadata = this.createMetadata(config);
-    const metadataHash = await this.apiService.sequencer.pushMetadata(metadata);
-    const metadataUri = this.apiService.sequencer.getMetadataUrl(metadataHash);
+    let metadataUri;
+    if ("metadataUri" in config) {
+      metadataUri = config.metadataUri;
+    } else {
+      const metadata = this.createMetadata(config);
+      const metadataHash = await this.apiService.sequencer.pushMetadata(metadata);
+      metadataUri = this.apiService.sequencer.getMetadataUrl(metadataHash);
+    }
     const signature = await signProcessCreation(processId, this.signer);
     const sequencerResult = await this.apiService.sequencer.createProcess({
       processId,
-      censusRoot,
+      census: {
+        censusOrigin: censusConfig.type,
+        censusRoot,
+        censusURI: censusConfig.uri
+      },
       ballotMode,
-      signature,
-      censusOrigin: censusConfig.type
+      signature
     });
     const census = {
       censusOrigin: censusConfig.type,
-      maxVotes: censusConfig.size.toString(),
       censusRoot,
       censusURI: censusConfig.uri
     };
@@ -1415,15 +1428,13 @@ class ProcessOrchestrationService {
     throw new Error("Invalid date format. Use Date object, ISO string, or Unix timestamp.");
   }
   /**
-   * Creates metadata from the simplified configuration
+   * Creates metadata from the configuration with metadata fields
+   * This method should only be called with ProcessConfigWithMetadata
    */
   createMetadata(config) {
     const metadata = getElectionMetadataTemplate();
     metadata.title.default = config.title;
     metadata.description.default = config.description || "";
-    if (!config.questions || config.questions.length === 0) {
-      throw new Error("Questions are required. Please provide at least one question with choices.");
-    }
     metadata.questions = config.questions.map((q) => ({
       title: { default: q.title },
       description: { default: q.description || "" },
@@ -1888,16 +1899,19 @@ class VoteOrchestrationService {
     );
     const { proof } = await this.generateZkProof(circomInputs);
     const signature = await this.signVote(voteId);
-    await this.submitVoteRequest({
+    const voteRequest = {
       processId: config.processId,
-      censusProof,
       ballot: cryptoOutput.ballot,
       ballotProof: proof,
       ballotInputsHash: cryptoOutput.ballotInputsHash,
       address: voterAddress,
       signature,
       voteId
-    });
+    };
+    if (process.census.censusOrigin === CensusOrigin.CensusOriginCSP) {
+      voteRequest.censusProof = censusProof;
+    }
+    await this.submitVoteRequest(voteRequest);
     const status = await this.apiService.sequencer.getVoteStatus(config.processId, voteId);
     return {
       voteId,
@@ -2341,14 +2355,15 @@ class DavinciCrypto {
    * @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
    */
-  async cspSign(censusOrigin, privKey, processId, address) {
+  async cspSign(censusOrigin, privKey, processId, address, weight) {
     if (!this.initialized) {
       throw new Error("DavinciCrypto not initialized \u2014 call `await init()` first");
     }
-    const raw = globalThis.DavinciCrypto.cspSign(censusOrigin, privKey, processId, address);
+    const raw = globalThis.DavinciCrypto.cspSign(censusOrigin, privKey, processId, address, weight);
     if (raw.error) {
       throw new Error(`Go/WASM cspSign error: ${raw.error}`);
     }
@@ -2362,13 +2377,14 @@ class DavinciCrypto {
    * @param censusOrigin - The census origin type (e.g., CensusOrigin.CensusOriginCSP)
    * @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
    */
-  async cspVerify(censusOrigin, root, address, processId, publicKey, signature) {
+  async cspVerify(censusOrigin, root, address, weight, processId, publicKey, signature) {
     if (!this.initialized) {
       throw new Error("DavinciCrypto not initialized \u2014 call `await init()` first");
     }
@@ -2376,6 +2392,7 @@ class DavinciCrypto {
       censusOrigin,
       root,
       address,
+      weight,
       processId,
       publicKey,
       signature
@@ -2827,6 +2844,30 @@ class DavinciSDK {
     }
     return this.voteOrchestrator.hasAddressVoted(processId, address);
   }
+  /**
+   * Check if an address is able to vote in a process and get participant information.
+   *
+   * Does NOT require a provider - uses API calls only.
+   *
+   * @param processId - The process ID
+   * @param address - The voter's address
+   * @returns Promise resolving to participant information (key and weight)
+   *
+   * @example
+   * ```typescript
+   * const participantInfo = await sdk.isAddressAbleToVote(processId, "0x1234567890abcdef...");
+   * console.log("Address:", participantInfo.key);
+   * console.log("Weight:", participantInfo.weight);
+   * ```
+   */
+  async isAddressAbleToVote(processId, address) {
+    if (!this.initialized) {
+      throw new Error(
+        "SDK must be initialized before checking participant info. Call sdk.init() first."
+      );
+    }
+    return this.apiService.sequencer.isAddressAbleToVote(processId, address);
+  }
   /**
    * Watch vote status changes in real-time using an async generator.
    * This method yields each status change as it happens, perfect for showing