@vocdoni/davinci-sdk 0.0.2 → 0.0.3

package/dist/index.mjs

@@ -213,6 +213,281 @@ function assertCSPCensusProof(proof) {
   }
 }
 
+var CensusType = /* @__PURE__ */ ((CensusType2) => {
+  CensusType2["PLAIN"] = "plain";
+  CensusType2["WEIGHTED"] = "weighted";
+  CensusType2["CSP"] = "csp";
+  return CensusType2;
+})(CensusType || {});
+class Census {
+  constructor(type) {
+    this._censusId = null;
+    this._censusRoot = null;
+    this._censusURI = null;
+    this._size = null;
+    this._type = type;
+  }
+  get censusId() {
+    return this._censusId;
+  }
+  get censusRoot() {
+    return this._censusRoot;
+  }
+  get censusURI() {
+    return this._censusURI;
+  }
+  get type() {
+    return this._type;
+  }
+  get size() {
+    return this._size;
+  }
+  get isPublished() {
+    return this._censusRoot !== null && this._censusURI !== null;
+  }
+  /**
+   * Convert CensusType to CensusOrigin enum for API compatibility
+   */
+  get censusOrigin() {
+    switch (this._type) {
+      case "plain" /* PLAIN */:
+      case "weighted" /* WEIGHTED */:
+        return CensusOrigin.CensusOriginMerkleTree;
+      case "csp" /* CSP */:
+        return CensusOrigin.CensusOriginCSP;
+      default:
+        throw new Error(`Unknown census type: ${this._type}`);
+    }
+  }
+}
+
+class PlainCensus extends Census {
+  constructor() {
+    super(CensusType.PLAIN);
+    this._participants = /* @__PURE__ */ new Set();
+  }
+  /**
+   * Add participant(s) with automatic weight=1
+   * @param addresses - Single address or array of addresses
+   */
+  add(addresses) {
+    const toAdd = Array.isArray(addresses) ? addresses : [addresses];
+    for (const address of toAdd) {
+      this.validateAddress(address);
+      this._participants.add(address.toLowerCase());
+    }
+  }
+  /**
+   * Remove participant by address
+   */
+  remove(address) {
+    this._participants.delete(address.toLowerCase());
+  }
+  /**
+   * Get all participants as CensusParticipant array (for API)
+   * All participants have weight="1"
+   */
+  get participants() {
+    return Array.from(this._participants).map((key) => ({
+      key,
+      weight: "1"
+      // Everyone has weight=1 in plain census
+    }));
+  }
+  /**
+   * Get addresses only
+   */
+  get addresses() {
+    return Array.from(this._participants);
+  }
+  validateAddress(address) {
+    if (!address || typeof address !== "string") {
+      throw new Error("Address is required and must be a string");
+    }
+    if (!/^(0x)?[0-9a-fA-F]{40}$/i.test(address)) {
+      throw new Error(`Invalid Ethereum address format: ${address}`);
+    }
+  }
+  /**
+   * Internal method called after publishing
+   * @internal
+   */
+  _setPublishedData(root, uri, size, censusId) {
+    this._censusRoot = root;
+    this._censusURI = uri;
+    this._size = size;
+    if (censusId) this._censusId = censusId;
+  }
+}
+
+class WeightedCensus extends Census {
+  constructor() {
+    super(CensusType.WEIGHTED);
+    this._participants = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Add participant(s) with custom weights
+   * Weight can be provided as string, number, or bigint - will be converted to string internally
+   * @param participant - Single participant or array of participants with custom weights
+   */
+  add(participant) {
+    const toAdd = Array.isArray(participant) ? participant : [participant];
+    for (const p of toAdd) {
+      this.validateParticipant(p);
+      const weightString = this.normalizeWeight(p.weight);
+      this._participants.set(p.key.toLowerCase(), weightString);
+    }
+  }
+  /**
+   * Remove participant by address
+   */
+  remove(address) {
+    this._participants.delete(address.toLowerCase());
+  }
+  /**
+   * Get all participants as CensusParticipant array
+   */
+  get participants() {
+    return Array.from(this._participants.entries()).map(([key, weight]) => ({
+      key,
+      weight
+    }));
+  }
+  /**
+   * Get participant addresses
+   */
+  get addresses() {
+    return Array.from(this._participants.keys());
+  }
+  /**
+   * Get weight for specific address
+   */
+  getWeight(address) {
+    return this._participants.get(address.toLowerCase());
+  }
+  /**
+   * Normalizes weight from string, number, or bigint to string
+   */
+  normalizeWeight(weight) {
+    if (typeof weight === "string") {
+      if (!/^\d+$/.test(weight)) {
+        throw new Error(`Invalid weight format: ${weight}. Must be a positive integer.`);
+      }
+      return weight;
+    }
+    if (typeof weight === "number") {
+      if (!Number.isInteger(weight) || weight < 0) {
+        throw new Error(`Invalid weight: ${weight}. Must be a positive integer.`);
+      }
+      return weight.toString();
+    }
+    if (typeof weight === "bigint") {
+      if (weight < 0n) {
+        throw new Error(`Invalid weight: ${weight}. Must be a positive integer.`);
+      }
+      return weight.toString();
+    }
+    throw new Error(`Invalid weight type. Must be string, number, or bigint.`);
+  }
+  validateParticipant(participant) {
+    if (!participant.key || typeof participant.key !== "string") {
+      throw new Error("Participant key (address) is required");
+    }
+    if (!/^(0x)?[0-9a-fA-F]{40}$/i.test(participant.key)) {
+      throw new Error(`Invalid Ethereum address format: ${participant.key}`);
+    }
+    if (participant.weight === void 0 || participant.weight === null) {
+      throw new Error("Participant weight is required");
+    }
+  }
+  /**
+   * Internal method called after publishing
+   * @internal
+   */
+  _setPublishedData(root, uri, size, censusId) {
+    this._censusRoot = root;
+    this._censusURI = uri;
+    this._size = size;
+    if (censusId) this._censusId = censusId;
+  }
+}
+
+class CspCensus extends Census {
+  constructor(publicKey, cspURI, size) {
+    super(CensusType.CSP);
+    if (!/^(0x)?[0-9a-fA-F]+$/.test(publicKey)) {
+      throw new Error("Public key is missing or invalid");
+    }
+    try {
+      new URL(cspURI);
+    } catch {
+      throw new Error("CSP URI is missing or invalid");
+    }
+    this._publicKey = publicKey;
+    this._cspURI = cspURI;
+    this._censusRoot = publicKey;
+    this._censusURI = cspURI;
+    this._size = size;
+  }
+  get publicKey() {
+    return this._publicKey;
+  }
+  get cspURI() {
+    return this._cspURI;
+  }
+}
+
+class PublishedCensus extends Census {
+  constructor(type, root, uri, size) {
+    super(type);
+    this._censusRoot = root;
+    this._censusURI = uri;
+    this._size = size;
+  }
+}
+
+class CensusOrchestrator {
+  constructor(censusService) {
+    this.censusService = censusService;
+  }
+  /**
+   * Publishes a PlainCensus or WeightedCensus
+   * Creates a working census, adds participants, and publishes it
+   */
+  async publish(census) {
+    if (census.isPublished) {
+      throw new Error("Census is already published");
+    }
+    if (census.participants.length === 0) {
+      throw new Error("Cannot publish empty census");
+    }
+    const censusId = await this.censusService.createCensus();
+    await this.censusService.addParticipants(censusId, census.participants);
+    const publishResponse = await this.censusService.publishCensus(censusId);
+    census._setPublishedData(
+      publishResponse.root,
+      publishResponse.uri,
+      publishResponse.participantCount,
+      censusId
+    );
+  }
+  /**
+   * Gets census data for process creation
+   * Throws if census is not published
+   */
+  getCensusData(census) {
+    if (!census.isPublished) {
+      throw new Error("Census must be published before creating a process");
+    }
+    return {
+      type: census.censusOrigin,
+      root: census.censusRoot,
+      uri: census.censusURI,
+      size: census.size
+    };
+  }
+}
+
 function createProcessSignatureMessage(processId) {
   const cleanProcessId = processId.replace(/^0x/, "").toLowerCase();
   return `I am creating a new voting process for the davinci.vote protocol identified with id ${cleanProcessId}`;
@@ -303,11 +578,15 @@ class VocdoniSequencerService extends BaseService {
       try {
         const response = await fetch(hashOrUrl);
         if (!response.ok) {
-          throw new Error(`Failed to fetch metadata from URL: ${response.status} ${response.statusText}`);
+          throw new Error(
+            `Failed to fetch metadata from URL: ${response.status} ${response.statusText}`
+          );
         }
         return await response.json();
       } catch (error) {
-        throw new Error(`Failed to fetch metadata from URL: ${error instanceof Error ? error.message : "Unknown error"}`);
+        throw new Error(
+          `Failed to fetch metadata from URL: ${error instanceof Error ? error.message : "Unknown error"}`
+        );
       }
     }
     if (!isHexString(hashOrUrl)) {
@@ -343,101 +622,6 @@ class VocdoniApiService {
   }
 }
 
-const DEFAULT_ENVIRONMENT_URLS = {
-  dev: {
-    sequencer: "https://sequencer-dev.davinci.vote",
-    census: "https://c3-dev.davinci.vote",
-    chain: "sepolia"
-  },
-  stg: {
-    sequencer: "https://sequencer1.davinci.vote",
-    census: "https://c3.davinci.vote",
-    chain: "sepolia"
-  },
-  prod: {
-    // TODO: Add production URLs when available
-    sequencer: "",
-    census: "",
-    chain: "mainnet"
-  }
-};
-function getEnvironmentConfig(environment) {
-  return DEFAULT_ENVIRONMENT_URLS[environment];
-}
-function getEnvironmentUrls(environment) {
-  const config = DEFAULT_ENVIRONMENT_URLS[environment];
-  return {
-    sequencer: config.sequencer,
-    census: config.census
-  };
-}
-function getEnvironmentChain(environment) {
-  return DEFAULT_ENVIRONMENT_URLS[environment].chain;
-}
-function resolveConfiguration(options = {}) {
-  const environment = options.environment || "prod";
-  const defaultConfig = getEnvironmentConfig(environment);
-  const resolvedConfig = { ...defaultConfig };
-  if (options.customUrls) {
-    if (options.customUrls.sequencer !== void 0) {
-      resolvedConfig.sequencer = options.customUrls.sequencer;
-    }
-    if (options.customUrls.census !== void 0) {
-      resolvedConfig.census = options.customUrls.census;
-    }
-  }
-  if (options.customChain) {
-    resolvedConfig.chain = options.customChain;
-  }
-  return resolvedConfig;
-}
-function resolveUrls(options = {}) {
-  const config = resolveConfiguration(options);
-  return {
-    sequencer: config.sequencer,
-    census: config.census
-  };
-}
-
-var processRegistry = {
-	sepolia: "0x50CA6A350f3A9C7B8a82eE7a4D5F0f21C54D68e3",
-	uzh: "0x69B16f67Bd2fB18bD720379E9C1Ef5EaD3872d67",
-	mainnet: "0x0",
-	celo: "0xDda6c75d32c375946C8ae9be41B2F3539dB1118A"
-};
-var organizationRegistry = {
-	sepolia: "0xF30678f579Fd89b86295503dC179d5d3aed47a98",
-	uzh: "0xf7BCE4546805547bE526Ca864d6722Ed193E51Aa",
-	mainnet: "0x0",
-	celo: "0xE17D701EA8f34022F97fC2Ec68c73D42bF99D0BD"
-};
-var stateTransitionVerifierGroth16 = {
-	sepolia: "0x96EcBbD6aB5fDC063E0fC426F2700290DeeAFE4E",
-	uzh: "0x5e4673CD378F05cc3Ae25804539c91E711548741",
-	mainnet: "0x0",
-	celo: "0x2DaF913D423128258b2F378E320F9D9D3Be5eCf5"
-};
-var resultsVerifierGroth16 = {
-	sepolia: "0x3ab37C40f7d0649f7a15BA3230f14AB29B51eDCC",
-	uzh: "0x00c7F87731346F592197E49A90Ad6EC236Ad9985",
-	mainnet: "0x0",
-	celo: "0x808276962217AD1ED3af7D51bFc791903CAd9389"
-};
-var sequencerRegistry = {
-	sepolia: "0x0",
-	uzh: "0x0",
-	mainnet: "0x0",
-	celo: "0x0"
-};
-var addressesJson = {
-	processRegistry: processRegistry,
-	organizationRegistry: organizationRegistry,
-	stateTransitionVerifierGroth16: stateTransitionVerifierGroth16,
-	resultsVerifierGroth16: resultsVerifierGroth16,
-	sequencerRegistry: sequencerRegistry
-};
-
-const deployedAddresses = addressesJson;
 var TxStatus = /* @__PURE__ */ ((TxStatus2) => {
   TxStatus2["Pending"] = "pending";
   TxStatus2["Completed"] = "completed";
@@ -456,19 +640,19 @@ class SmartContractService {
    * Sends a transaction and yields status events during its lifecycle.
    * This method handles the complete transaction flow from submission to completion,
    * including error handling and status updates.
-   * 
+   *
    * @template T - The type of the successful response data
    * @param txPromise - Promise resolving to the transaction response
    * @param responseHandler - Function to process the successful transaction result
    * @returns AsyncGenerator yielding transaction status events
-   * 
+   *
    * @example
    * ```typescript
    * const txStream = await this.sendTx(
    *   contract.someMethod(),
    *   async () => await contract.getUpdatedValue()
    * );
-   * 
+   *
    * for await (const event of txStream) {
    *   switch (event.status) {
    *     case TxStatus.Pending:
@@ -505,12 +689,12 @@ class SmartContractService {
    * Executes a transaction stream and returns the result or throws an error.
    * This is a convenience method that processes a transaction stream and either
    * returns the successful result or throws an appropriate error.
-   * 
+   *
    * @template T - The type of the successful response data
    * @param stream - AsyncGenerator of transaction status events
    * @returns Promise resolving to the successful response data
    * @throws Error if the transaction fails or reverts
-   * 
+   *
    * @example
    * ```typescript
    * try {
@@ -540,11 +724,11 @@ class SmartContractService {
    * Normalizes event listener arguments between different ethers.js versions.
    * This helper method ensures consistent event argument handling regardless of
    * whether the event payload follows ethers v5 or v6 format.
-   * 
+   *
    * @template Args - Tuple type representing the expected event arguments
    * @param callback - The event callback function to normalize
    * @returns Normalized event listener function
-   * 
+   *
    * @example
    * ```typescript
    * contract.on('Transfer', this.normalizeListener((from: string, to: string, amount: BigInt) => {
@@ -567,12 +751,12 @@ class SmartContractService {
    * Sets up an event listener with automatic fallback for RPCs that don't support eth_newFilter.
    * First attempts to use contract.on() which relies on eth_newFilter. If the RPC doesn't support
    * this method (error code -32601), automatically falls back to polling with queryFilter.
-   * 
+   *
    * @template Args - Tuple type representing the event arguments
    * @param contract - The contract instance to listen to
    * @param eventFilter - The event filter to listen for
    * @param callback - The callback function to invoke when the event occurs
-   * 
+   *
    * @example
    * ```typescript
    * this.setupEventListener(
@@ -598,13 +782,14 @@ class SmartContractService {
       };
       if ("send" in provider && typeof provider.send === "function") {
         try {
-          await provider.send("eth_newFilter", [testFilter]);
+          const filterId = await provider.send("eth_newFilter", [testFilter]);
+          await provider.send("eth_getFilterChanges", [filterId]);
           contract.on(eventFilter, normalizedCallback);
           return;
         } catch (error) {
           if (this.isUnsupportedMethodError(error)) {
             console.warn(
-              "RPC does not support eth_newFilter, falling back to polling for events. This may result in delayed event notifications."
+              "RPC does not fully support eth_newFilter/eth_getFilterChanges, falling back to polling for events. This may result in delayed event notifications."
             );
             this.setupPollingListener(contract, eventFilter, callback);
             return;
@@ -629,18 +814,23 @@ class SmartContractService {
     }
   }
   /**
-   * Checks if an error indicates that the RPC method is unsupported (eth_newFilter).
-   * 
+   * Checks if an error indicates that the RPC method is unsupported or filter operations are not working.
+   * This includes:
+   * - Method not found (-32601): RPC doesn't support eth_newFilter
+   * - Filter not found (-32000): RPC doesn't properly maintain filters
+   *
    * @param error - The error to check
-   * @returns true if the error indicates unsupported method
+   * @returns true if the error indicates unsupported or broken filter functionality
    */
   isUnsupportedMethodError(error) {
-    return error?.code === -32601 || error?.error?.code === -32601 || error?.data?.code === -32601 || typeof error?.message === "string" && error.message.includes("unsupported method");
+    const isMethodNotFound = error?.code === -32601 || error?.error?.code === -32601 || error?.data?.code === -32601 || typeof error?.message === "string" && error.message.includes("unsupported method");
+    const isFilterNotFound = (error?.code === -32e3 || error?.error?.code === -32e3 || error?.code === "UNKNOWN_ERROR" && error?.error?.code === -32e3) && (error?.message?.includes("filter not found") || error?.error?.message?.includes("filter not found"));
+    return isMethodNotFound || isFilterNotFound;
   }
   /**
    * Sets up a polling-based event listener as fallback when eth_newFilter is not supported.
    * Periodically queries for new events and invokes the callback for each new event found.
-   * 
+   *
    * @template Args - Tuple type representing the event arguments
    * @param contract - The contract instance to poll
    * @param eventFilter - The event filter to poll for
@@ -692,7 +882,7 @@ class SmartContractService {
   }
   /**
    * Sets the polling interval for event listeners using the fallback mechanism.
-   * 
+   *
    * @param intervalMs - Polling interval in milliseconds
    */
   setEventPollingInterval(intervalMs) {
@@ -703,7 +893,7 @@ class SmartContractService {
 class ContractServiceError extends Error {
   /**
    * Creates a new ContractServiceError instance.
-   * 
+   *
    * @param message - The error message describing what went wrong
    * @param operation - The operation that was being performed when the error occurred
    */
@@ -856,7 +1046,7 @@ class ProcessRegistryService extends SmartContractService {
   }
   /**
    * Sets the results for a voting process.
-   * 
+   *
    * @param processID - The ID of the process to set results for
    * @param proof - Zero-knowledge proof validating the results
    * @param input - Input data for the proof verification
@@ -864,11 +1054,7 @@ class ProcessRegistryService extends SmartContractService {
    */
   setProcessResults(processID, proof, input) {
     return this.sendTx(
-      this.contract.setProcessResults(
-        processID,
-        proof,
-        input
-      ).catch((e) => {
+      this.contract.setProcessResults(processID, proof, input).catch((e) => {
         throw new ProcessResultError(e.message, "setResults");
       }),
       async () => ({ success: true })
@@ -930,6 +1116,34 @@ class ProcessOrchestrationService {
     this.organizationRegistry = organizationRegistry;
     this.getCrypto = getCrypto;
     this.signer = signer;
+    this.censusOrchestrator = new CensusOrchestrator(apiService.census);
+  }
+  /**
+   * Handles census - auto-publishes if needed and returns census config
+   * @private
+   */
+  async handleCensus(census) {
+    if ("isPublished" in census) {
+      if (census instanceof PlainCensus || census instanceof WeightedCensus) {
+        if (!census.isPublished) {
+          const censusBaseURL = this.apiService.census?.["axios"]?.defaults?.baseURL;
+          if (!censusBaseURL || censusBaseURL === "" || censusBaseURL === "undefined") {
+            throw new Error(
+              'Census API URL is required to publish PlainCensus or WeightedCensus. Please provide "censusUrl" when initializing DavinciSDK, or use a pre-published census.'
+            );
+          }
+          await this.censusOrchestrator.publish(census);
+        }
+      }
+      const censusData = this.censusOrchestrator.getCensusData(census);
+      return {
+        type: censusData.type,
+        root: censusData.root,
+        size: censusData.size,
+        uri: censusData.uri
+      };
+    }
+    return census;
   }
   /**
    * Gets user-friendly process information by transforming raw contract data
@@ -1005,10 +1219,10 @@ class ProcessOrchestrationService {
   /**
    * Creates a complete voting process and returns an async generator that yields transaction status events.
    * This method allows you to monitor the transaction progress in real-time.
-   * 
+   *
    * @param config - Process configuration
    * @returns AsyncGenerator yielding transaction status events with ProcessCreationResult
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.createProcessStream({
@@ -1019,7 +1233,7 @@ class ProcessOrchestrationService {
    *   timing: { ... },
    *   questions: [ ... ]
    * });
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case "pending":
@@ -1081,16 +1295,16 @@ class ProcessOrchestrationService {
   /**
    * Creates a complete voting process with minimal configuration.
    * This is the ultra-easy method for end users that handles all the complex orchestration internally.
-   * 
+   *
    * For real-time transaction status updates, use createProcessStream() instead.
-   * 
+   *
    * The method automatically:
    * - Gets encryption keys and initial state root from the sequencer
    * - Handles process creation signatures
    * - Coordinates between sequencer API and on-chain contract calls
    * - Creates and pushes metadata
    * - Submits the on-chain transaction
-   * 
+   *
    * @param config - Simplified process configuration
    * @returns Promise resolving to the process creation result
    */
@@ -1114,7 +1328,8 @@ class ProcessOrchestrationService {
     const { startTime, duration } = this.calculateTiming(config.timing);
     const signerAddress = await this.signer.getAddress();
     const processId = await this.processRegistry.getNextProcessId(signerAddress);
-    const censusRoot = config.census.root;
+    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);
@@ -1125,13 +1340,13 @@ class ProcessOrchestrationService {
       censusRoot,
       ballotMode,
       signature,
-      censusOrigin: config.census.type
+      censusOrigin: censusConfig.type
     });
     const census = {
-      censusOrigin: config.census.type,
-      maxVotes: config.census.size.toString(),
+      censusOrigin: censusConfig.type,
+      maxVotes: censusConfig.size.toString(),
       censusRoot,
-      censusURI: config.census.uri
+      censusURI: censusConfig.uri
     };
     return {
       processId,
@@ -1222,14 +1437,14 @@ class ProcessOrchestrationService {
   /**
    * Ends a voting process by setting its status to ENDED.
    * Returns an async generator that yields transaction status events.
-   * 
+   *
    * @param processId - The process ID to end
    * @returns AsyncGenerator yielding transaction status events
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.endProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case "pending":
@@ -1271,12 +1486,12 @@ class ProcessOrchestrationService {
   /**
    * Ends a voting process by setting its status to ENDED.
    * This is a simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use endProcessStream() instead.
-   * 
+   *
    * @param processId - The process ID to end
    * @returns Promise resolving when the process is ended
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.endProcess("0x1234567890abcdef...");
@@ -1298,14 +1513,14 @@ class ProcessOrchestrationService {
   /**
    * Pauses a voting process by setting its status to PAUSED.
    * Returns an async generator that yields transaction status events.
-   * 
+   *
    * @param processId - The process ID to pause
    * @returns AsyncGenerator yielding transaction status events
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.pauseProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case "pending":
@@ -1347,12 +1562,12 @@ class ProcessOrchestrationService {
   /**
    * Pauses a voting process by setting its status to PAUSED.
    * This is a simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use pauseProcessStream() instead.
-   * 
+   *
    * @param processId - The process ID to pause
    * @returns Promise resolving when the process is paused
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.pauseProcess("0x1234567890abcdef...");
@@ -1374,14 +1589,14 @@ class ProcessOrchestrationService {
   /**
    * Cancels a voting process by setting its status to CANCELED.
    * Returns an async generator that yields transaction status events.
-   * 
+   *
    * @param processId - The process ID to cancel
    * @returns AsyncGenerator yielding transaction status events
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.cancelProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case "pending":
@@ -1423,12 +1638,12 @@ class ProcessOrchestrationService {
   /**
    * Cancels a voting process by setting its status to CANCELED.
    * This is a simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use cancelProcessStream() instead.
-   * 
+   *
    * @param processId - The process ID to cancel
    * @returns Promise resolving when the process is canceled
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.cancelProcess("0x1234567890abcdef...");
@@ -1451,14 +1666,14 @@ class ProcessOrchestrationService {
    * Resumes a voting process by setting its status to READY.
    * This is typically used to resume a paused process.
    * Returns an async generator that yields transaction status events.
-   * 
+   *
    * @param processId - The process ID to resume
    * @returns AsyncGenerator yielding transaction status events
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.resumeProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case "pending":
@@ -1501,12 +1716,12 @@ class ProcessOrchestrationService {
    * Resumes a voting process by setting its status to READY.
    * This is typically used to resume a paused process.
    * This is a simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use resumeProcessStream() instead.
-   * 
+   *
    * @param processId - The process ID to resume
    * @returns Promise resolving when the process is resumed
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.resumeProcess("0x1234567890abcdef...");
@@ -1594,11 +1809,7 @@ class CircomProof {
       }
       this.zkeyCache.set(zkeyUrl, zkeyBin);
     }
-    const { proof, publicSignals } = await groth16.fullProve(
-      inputs,
-      wasmBin,
-      zkeyBin
-    );
+    const { proof, publicSignals } = await groth16.fullProve(inputs, wasmBin, zkeyBin);
     return {
       proof,
       publicSignals
@@ -1633,11 +1844,13 @@ var VoteStatus = /* @__PURE__ */ ((VoteStatus2) => {
 })(VoteStatus || {});
 
 class VoteOrchestrationService {
-  constructor(apiService, getCrypto, signer, censusProviders = {}) {
+  constructor(apiService, getCrypto, signer, censusProviders = {}, config = {}) {
     this.apiService = apiService;
     this.getCrypto = getCrypto;
     this.signer = signer;
     this.censusProviders = censusProviders;
+    this.verifyCircuitFiles = config.verifyCircuitFiles ?? true;
+    this.verifyProof = config.verifyProof ?? true;
   }
   /**
    * Submit a vote with simplified configuration
@@ -1646,7 +1859,7 @@ class VoteOrchestrationService {
    * - Gets census proof (Merkle or CSP)
    * - Generates cryptographic proofs
    * - Signs and submits the vote
-   * 
+   *
    * @param config - Simplified vote configuration
    * @returns Promise resolving to vote submission result
    */
@@ -1694,7 +1907,7 @@ class VoteOrchestrationService {
   }
   /**
    * Get the status of a submitted vote
-   * 
+   *
    * @param processId - The process ID
    * @param voteId - The vote ID
    * @returns Promise resolving to vote status information
@@ -1709,7 +1922,7 @@ class VoteOrchestrationService {
   }
   /**
    * Check if an address has voted in a process
-   * 
+   *
    * @param processId - The process ID
    * @param address - The voter's address
    * @returns Promise resolving to boolean indicating if the address has voted
@@ -1720,19 +1933,19 @@ class VoteOrchestrationService {
   /**
    * Watch vote status changes in real-time using an async generator.
    * Yields each status change as it happens, allowing for reactive UI updates.
-   * 
+   *
    * @param processId - The process ID
    * @param voteId - The vote ID
    * @param options - Optional configuration
    * @returns AsyncGenerator yielding vote status updates
-   * 
+   *
    * @example
    * ```typescript
    * const vote = await sdk.submitVote({ processId, choices: [1] });
-   * 
+   *
    * for await (const statusInfo of sdk.watchVoteStatus(vote.processId, vote.voteId)) {
    *   console.log(`Vote status: ${statusInfo.status}`);
-   *   
+   *
    *   switch (statusInfo.status) {
    *     case VoteStatus.Pending:
    *       console.log("⏳ Processing...");
@@ -1769,7 +1982,7 @@ class VoteOrchestrationService {
   /**
    * Wait for a vote to reach a specific status.
    * This is a simpler alternative to watchVoteStatus() that returns only the final status.
-   * 
+   *
    * @param processId - The process ID
    * @param voteId - The vote ID
    * @param targetStatus - The target status to wait for (default: "settled")
@@ -1872,12 +2085,20 @@ class VoteOrchestrationService {
     const circomProof = new CircomProof({
       wasmUrl: info.circuitUrl,
       zkeyUrl: info.provingKeyUrl,
-      vkeyUrl: info.verificationKeyUrl
+      vkeyUrl: info.verificationKeyUrl,
+      // Only pass hashes if verifyCircuitFiles is enabled
+      ...this.verifyCircuitFiles && {
+        wasmHash: info.circuitHash,
+        zkeyHash: info.provingKeyHash,
+        vkeyHash: info.verificationKeyHash
+      }
     });
     const { proof, publicSignals } = await circomProof.generate(circomInputs);
-    const isValid = await circomProof.verify(proof, publicSignals);
-    if (!isValid) {
-      throw new Error("Generated proof is invalid");
+    if (this.verifyProof) {
+      const isValid = await circomProof.verify(proof, publicSignals);
+      if (!isValid) {
+        throw new Error("Generated proof is invalid");
+      }
     }
     return { proof, publicSignals };
   }
@@ -1915,10 +2136,7 @@ class VoteOrchestrationService {
 class OrganizationRegistryService extends SmartContractService {
   constructor(contractAddress, runner) {
     super();
-    this.contract = OrganizationRegistry__factory.connect(
-      contractAddress,
-      runner
-    );
+    this.contract = OrganizationRegistry__factory.connect(contractAddress, runner);
   }
   // ─── READ OPERATIONS ───────────────────────────────────────────────────────
   async getOrganization(id) {
@@ -2194,25 +2412,23 @@ class DavinciCrypto {
 class DavinciSDK {
   constructor(config) {
     this.initialized = false;
-    const resolvedConfig = resolveConfiguration({
-      environment: config.environment,
-      customUrls: {
-        sequencer: config.sequencerUrl,
-        census: config.censusUrl
-      },
-      customChain: config.chain
-    });
+    const hasCustomAddresses = !!config.addresses && Object.keys(config.addresses).length > 0;
     this.config = {
       signer: config.signer,
-      sequencerUrl: config.sequencerUrl ?? resolvedConfig.sequencer,
-      censusUrl: config.censusUrl ?? resolvedConfig.census,
-      chain: config.chain ?? resolvedConfig.chain,
-      contractAddresses: config.contractAddresses || {},
-      useSequencerAddresses: config.useSequencerAddresses || false
+      sequencerUrl: config.sequencerUrl,
+      censusUrl: config.censusUrl,
+      customAddresses: config.addresses || {},
+      fetchAddressesFromSequencer: !hasCustomAddresses,
+      // Automatic: fetch if no custom addresses
+      verifyCircuitFiles: config.verifyCircuitFiles ?? true,
+      // Default to true for security
+      verifyProof: config.verifyProof ?? true
+      // Default to true for security
     };
     this.apiService = new VocdoniApiService({
       sequencerURL: this.config.sequencerUrl,
-      censusURL: this.config.censusUrl
+      censusURL: this.config.censusUrl || ""
+      // Use empty string if not provided
     });
     this.censusProviders = config.censusProviders || {};
   }
@@ -2222,9 +2438,10 @@ class DavinciSDK {
    */
   async init() {
     if (this.initialized) return;
-    if (this.config.useSequencerAddresses) {
-      await this.updateContractAddressesFromSequencer();
+    if (this.config.fetchAddressesFromSequencer) {
+      await this.fetchContractAddressesFromSequencer();
     }
+    if (!this.config.censusUrl) ;
     this.initialized = true;
   }
   /**
@@ -2236,28 +2453,34 @@ class DavinciSDK {
   /**
    * Get the process registry service for process management.
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @throws Error if signer does not have a provider
    */
   get processes() {
     this.ensureProvider();
     if (!this._processRegistry) {
       const processRegistryAddress = this.resolveContractAddress("processRegistry");
-      this._processRegistry = new ProcessRegistryService(processRegistryAddress, this.config.signer);
+      this._processRegistry = new ProcessRegistryService(
+        processRegistryAddress,
+        this.config.signer
+      );
     }
     return this._processRegistry;
   }
   /**
    * Get the organization registry service for organization management.
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @throws Error if signer does not have a provider
    */
   get organizations() {
     this.ensureProvider();
     if (!this._organizationRegistry) {
       const organizationRegistryAddress = this.resolveContractAddress("organizationRegistry");
-      this._organizationRegistry = new OrganizationRegistryService(organizationRegistryAddress, this.config.signer);
+      this._organizationRegistry = new OrganizationRegistryService(
+        organizationRegistryAddress,
+        this.config.signer
+      );
     }
     return this._organizationRegistry;
   }
@@ -2278,7 +2501,7 @@ class DavinciSDK {
   /**
    * Get the process orchestration service for simplified process creation.
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @throws Error if signer does not have a provider
    */
   get processOrchestrator() {
@@ -2303,7 +2526,11 @@ class DavinciSDK {
         this.apiService,
         () => this.getCrypto(),
         this.config.signer,
-        this.censusProviders
+        this.censusProviders,
+        {
+          verifyCircuitFiles: this.config.verifyCircuitFiles,
+          verifyProof: this.config.verifyProof
+        }
       );
     }
     return this._voteOrchestrator;
@@ -2312,24 +2539,24 @@ class DavinciSDK {
    * Gets user-friendly process information from the blockchain.
    * This method fetches raw contract data and transforms it into a user-friendly format
    * that matches the ProcessConfig interface used for creation, plus additional runtime data.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to fetch
    * @returns Promise resolving to user-friendly process information
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * const processInfo = await sdk.getProcess("0x1234567890abcdef...");
-   * 
+   *
    * // Access the same fields as ProcessConfig
    * console.log("Title:", processInfo.title);
    * console.log("Description:", processInfo.description);
    * console.log("Questions:", processInfo.questions);
    * console.log("Census size:", processInfo.census.size);
    * console.log("Ballot config:", processInfo.ballot);
-   * 
+   *
    * // Plus additional runtime information
    * console.log("Status:", processInfo.status);
    * console.log("Creator:", processInfo.creator);
@@ -2337,7 +2564,7 @@ class DavinciSDK {
    * console.log("End date:", processInfo.endDate);
    * console.log("Duration:", processInfo.duration, "seconds");
    * console.log("Time remaining:", processInfo.timeRemaining, "seconds");
-   * 
+   *
    * // Access raw contract data if needed
    * console.log("Raw data:", processInfo.raw);
    * ```
@@ -2353,13 +2580,13 @@ class DavinciSDK {
    * Creates a complete voting process and returns an async generator that yields transaction status events.
    * This method allows you to monitor the transaction progress in real-time, including pending, completed,
    * failed, and reverted states.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param config - Simplified process configuration
    * @returns AsyncGenerator yielding transaction status events
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.createProcessStream({
@@ -2395,7 +2622,7 @@ class DavinciSDK {
    *     }
    *   ]
    * });
-   * 
+   *
    * // Monitor transaction progress
    * for await (const event of stream) {
    *   switch (event.status) {
@@ -2430,22 +2657,22 @@ class DavinciSDK {
   /**
    * Creates a complete voting process with minimal configuration.
    * This is the ultra-easy method for end users that handles all the complex orchestration internally.
-   * 
+   *
    * For real-time transaction status updates, use createProcessStream() instead.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * The method automatically:
    * - Gets encryption keys and initial state root from the sequencer
    * - Handles process creation signatures
    * - Coordinates between sequencer API and on-chain contract calls
    * - Creates and pushes metadata
    * - Submits the on-chain transaction
-   * 
+   *
    * @param config - Simplified process configuration
    * @returns Promise resolving to the process creation result
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * // Option 1: Using duration (traditional approach)
@@ -2482,7 +2709,7 @@ class DavinciSDK {
    *     }
    *   ]
    * });
-   * 
+   *
    * // Option 2: Using start and end dates
    * const result2 = await sdk.createProcess({
    *   title: "Weekend Vote",
@@ -2503,18 +2730,20 @@ class DavinciSDK {
   /**
    * Submit a vote with simplified configuration.
    * This is the ultra-easy method for end users that handles all the complex voting workflow internally.
-   * 
+   *
    * Does NOT require a provider - can be used with a bare Wallet for signing only.
-   * 
+   * IMPORTANT: Requires censusUrl to be configured in the SDK for fetching census proofs (unless using custom census providers).
+   *
    * The method automatically:
    * - Fetches process information and validates voting is allowed
    * - Gets census proof (Merkle tree based)
    * - Generates cryptographic proofs and encrypts the vote
    * - Signs and submits the vote to the sequencer
-   * 
+   *
    * @param config - Simplified vote configuration
    * @returns Promise resolving to vote submission result
-   * 
+   * @throws Error if censusUrl is not configured (unless using custom census providers)
+   *
    * @example
    * ```typescript
    * // Submit a vote with voter's private key
@@ -2523,14 +2752,14 @@ class DavinciSDK {
    *   choices: [1, 0], // Vote for option 1 in question 1, option 0 in question 2
    *   voterKey: "0x1234567890abcdef..." // Voter's private key
    * });
-   * 
+   *
    * console.log("Vote ID:", voteResult.voteId);
    * console.log("Status:", voteResult.status);
-   * 
+   *
    * // Submit a vote with a Wallet instance
    * import { Wallet } from "ethers";
    * const voterWallet = new Wallet("0x...");
-   * 
+   *
    * const voteResult2 = await sdk.submitVote({
    *   processId: "0x1234567890abcdef...",
    *   choices: [2], // Single question vote
@@ -2542,17 +2771,22 @@ class DavinciSDK {
     if (!this.initialized) {
       throw new Error("SDK must be initialized before submitting votes. Call sdk.init() first.");
     }
+    if (!this.config.censusUrl && !this.censusProviders.merkle && !this.censusProviders.csp) {
+      throw new Error(
+        "Census URL is required for voting. Provide censusUrl in the SDK constructor config, or use custom census providers."
+      );
+    }
     return this.voteOrchestrator.submitVote(config);
   }
   /**
    * Get the status of a submitted vote.
-   * 
+   *
    * Does NOT require a provider - uses API calls only.
-   * 
+   *
    * @param processId - The process ID
    * @param voteId - The vote ID returned from submitVote()
    * @returns Promise resolving to vote status information
-   * 
+   *
    * @example
    * ```typescript
    * const statusInfo = await sdk.getVoteStatus(processId, voteId);
@@ -2568,13 +2802,13 @@ class DavinciSDK {
   }
   /**
    * Check if an address has voted in a process.
-   * 
+   *
    * Does NOT require a provider - uses API calls only.
-   * 
+   *
    * @param processId - The process ID
    * @param address - The voter's address
    * @returns Promise resolving to boolean indicating if the address has voted
-   * 
+   *
    * @example
    * ```typescript
    * const hasVoted = await sdk.hasAddressVoted(processId, "0x1234567890abcdef...");
@@ -2585,22 +2819,24 @@ class DavinciSDK {
    */
   async hasAddressVoted(processId, address) {
     if (!this.initialized) {
-      throw new Error("SDK must be initialized before checking vote status. Call sdk.init() first.");
+      throw new Error(
+        "SDK must be initialized before checking vote status. Call sdk.init() first."
+      );
     }
     return this.voteOrchestrator.hasAddressVoted(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 
+   * This method yields each status change as it happens, perfect for showing
    * progress indicators in UI applications.
-   * 
+   *
    * Does NOT require a provider - uses API calls only.
-   * 
+   *
    * @param processId - The process ID
    * @param voteId - The vote ID
    * @param options - Optional configuration
    * @returns AsyncGenerator yielding vote status updates
-   * 
+   *
    * @example
    * ```typescript
    * // Submit vote
@@ -2608,11 +2844,11 @@ class DavinciSDK {
    *   processId: "0x1234567890abcdef...",
    *   choices: [1]
    * });
-   * 
+   *
    * // Watch status changes in real-time
    * for await (const statusInfo of sdk.watchVoteStatus(voteResult.processId, voteResult.voteId)) {
    *   console.log(`Vote status: ${statusInfo.status}`);
-   *   
+   *
    *   switch (statusInfo.status) {
    *     case VoteStatus.Pending:
    *       console.log("⏳ Processing...");
@@ -2632,7 +2868,9 @@ class DavinciSDK {
    */
   watchVoteStatus(processId, voteId, options) {
     if (!this.initialized) {
-      throw new Error("SDK must be initialized before watching vote status. Call sdk.init() first.");
+      throw new Error(
+        "SDK must be initialized before watching vote status. Call sdk.init() first."
+      );
     }
     return this.voteOrchestrator.watchVoteStatus(processId, voteId, options);
   }
@@ -2640,16 +2878,16 @@ class DavinciSDK {
    * Wait for a vote to reach a specific status.
    * This is a simpler alternative to watchVoteStatus() that returns only the final status.
    * Useful for waiting for vote confirmation and processing without needing to handle each intermediate status.
-   * 
+   *
    * Does NOT require a provider - uses API calls only.
-   * 
+   *
    * @param processId - The process ID
    * @param voteId - The vote ID
    * @param targetStatus - The target status to wait for (default: "settled")
    * @param timeoutMs - Maximum time to wait in milliseconds (default: 300000 = 5 minutes)
    * @param pollIntervalMs - Polling interval in milliseconds (default: 5000 = 5 seconds)
    * @returns Promise resolving to final vote status
-   * 
+   *
    * @example
    * ```typescript
    * // Submit vote and wait for it to be settled
@@ -2657,7 +2895,7 @@ class DavinciSDK {
    *   processId: "0x1234567890abcdef...",
    *   choices: [1]
    * });
-   * 
+   *
    * // Wait for the vote to be fully processed
    * const finalStatus = await sdk.waitForVoteStatus(
    *   voteResult.processId,
@@ -2666,31 +2904,39 @@ class DavinciSDK {
    *   300000,    // 5 minute timeout
    *   5000       // Check every 5 seconds
    * );
-   * 
+   *
    * console.log("Vote final status:", finalStatus.status);
    * ```
    */
   async waitForVoteStatus(processId, voteId, targetStatus = VoteStatus.Settled, timeoutMs = 3e5, pollIntervalMs = 5e3) {
     if (!this.initialized) {
-      throw new Error("SDK must be initialized before waiting for vote status. Call sdk.init() first.");
+      throw new Error(
+        "SDK must be initialized before waiting for vote status. Call sdk.init() first."
+      );
     }
-    return this.voteOrchestrator.waitForVoteStatus(processId, voteId, targetStatus, timeoutMs, pollIntervalMs);
+    return this.voteOrchestrator.waitForVoteStatus(
+      processId,
+      voteId,
+      targetStatus,
+      timeoutMs,
+      pollIntervalMs
+    );
   }
   /**
-   * Ends a voting process by setting its status to ENDED and returns an async generator 
-   * that yields transaction status events. This method allows you to monitor the 
+   * Ends a voting process by setting its status to ENDED and returns an async generator
+   * that yields transaction status events. This method allows you to monitor the
    * transaction progress in real-time.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to end
    * @returns AsyncGenerator yielding transaction status events
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.endProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case TxStatus.Pending:
@@ -2719,15 +2965,15 @@ class DavinciSDK {
   /**
    * Ends a voting process by setting its status to ENDED.
    * This is the simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use endProcessStream() instead.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to end
    * @returns Promise resolving when the process is ended
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.endProcess("0x1234567890abcdef...");
@@ -2742,20 +2988,20 @@ class DavinciSDK {
     return this.processOrchestrator.endProcess(processId);
   }
   /**
-   * Pauses a voting process by setting its status to PAUSED and returns an async generator 
-   * that yields transaction status events. This method allows you to monitor the 
+   * Pauses a voting process by setting its status to PAUSED and returns an async generator
+   * that yields transaction status events. This method allows you to monitor the
    * transaction progress in real-time.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to pause
    * @returns AsyncGenerator yielding transaction status events
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.pauseProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case TxStatus.Pending:
@@ -2784,15 +3030,15 @@ class DavinciSDK {
   /**
    * Pauses a voting process by setting its status to PAUSED.
    * This is the simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use pauseProcessStream() instead.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to pause
    * @returns Promise resolving when the process is paused
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.pauseProcess("0x1234567890abcdef...");
@@ -2807,20 +3053,20 @@ class DavinciSDK {
     return this.processOrchestrator.pauseProcess(processId);
   }
   /**
-   * Cancels a voting process by setting its status to CANCELED and returns an async generator 
-   * that yields transaction status events. This method allows you to monitor the 
+   * Cancels a voting process by setting its status to CANCELED and returns an async generator
+   * that yields transaction status events. This method allows you to monitor the
    * transaction progress in real-time.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to cancel
    * @returns AsyncGenerator yielding transaction status events
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.cancelProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case TxStatus.Pending:
@@ -2849,15 +3095,15 @@ class DavinciSDK {
   /**
    * Cancels a voting process by setting its status to CANCELED.
    * This is the simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use cancelProcessStream() instead.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to cancel
    * @returns Promise resolving when the process is canceled
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.cancelProcess("0x1234567890abcdef...");
@@ -2872,19 +3118,19 @@ class DavinciSDK {
     return this.processOrchestrator.cancelProcess(processId);
   }
   /**
-   * Resumes a voting process by setting its status to READY and returns an async generator 
+   * Resumes a voting process by setting its status to READY and returns an async generator
    * that yields transaction status events. This is typically used to resume a paused process.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to resume
    * @returns AsyncGenerator yielding transaction status events
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * const stream = sdk.resumeProcessStream("0x1234567890abcdef...");
-   * 
+   *
    * for await (const event of stream) {
    *   switch (event.status) {
    *     case TxStatus.Pending:
@@ -2914,15 +3160,15 @@ class DavinciSDK {
    * Resumes a voting process by setting its status to READY.
    * This is typically used to resume a paused process.
    * This is the simplified method that waits for transaction completion.
-   * 
+   *
    * For real-time transaction status updates, use resumeProcessStream() instead.
-   * 
+   *
    * Requires a signer with a provider for blockchain interactions.
-   * 
+   *
    * @param processId - The process ID to resume
    * @returns Promise resolving when the process is resumed
    * @throws Error if signer does not have a provider
-   * 
+   *
    * @example
    * ```typescript
    * await sdk.resumeProcess("0x1234567890abcdef...");
@@ -2938,64 +3184,50 @@ class DavinciSDK {
   }
   /**
    * Resolve contract address based on configuration priority:
-   * 1. If useSequencerAddresses is true: addresses from sequencer (highest priority)
-   * 2. Custom addresses from config (if provided by user)
-   * 3. Default deployed addresses from npm package
+   * 1. Custom addresses from user config (if provided)
+   * 2. Addresses from sequencer (fetched during init if no custom addresses provided)
    */
   resolveContractAddress(contractName) {
-    if (this.config.useSequencerAddresses) {
-      return this.getDefaultContractAddress(contractName);
-    }
-    const customAddress = this.config.contractAddresses[contractName];
+    const customAddress = this.config.customAddresses[contractName];
     if (customAddress) {
       return customAddress;
     }
-    return this.getDefaultContractAddress(contractName);
-  }
-  /**
-   * Get default contract address from deployed addresses
-   */
-  getDefaultContractAddress(contractName) {
-    const chain = this.config.chain;
-    switch (contractName) {
-      case "processRegistry":
-        return deployedAddresses.processRegistry[chain];
-      case "organizationRegistry":
-        return deployedAddresses.organizationRegistry[chain];
-      case "stateTransitionVerifier":
-        return deployedAddresses.stateTransitionVerifierGroth16[chain];
-      case "resultsVerifier":
-        return deployedAddresses.resultsVerifierGroth16[chain];
-      case "sequencerRegistry":
-        return deployedAddresses.sequencerRegistry[chain];
-      default:
-        throw new Error(`Unknown contract: ${contractName}`);
+    if (!this.config.customAddresses[contractName]) {
+      throw new Error(
+        `Contract address for '${contractName}' not found. Make sure SDK is initialized with sdk.init() or provide custom addresses in config.`
+      );
     }
+    return this.config.customAddresses[contractName];
   }
   /**
-   * Update contract addresses from sequencer info if useSequencerAddresses is enabled
-   * Sequencer addresses have priority over user-provided addresses
+   * Fetch contract addresses from sequencer info
+   * This is called during init() if custom addresses are not provided
    */
-  async updateContractAddressesFromSequencer() {
+  async fetchContractAddressesFromSequencer() {
     try {
       const info = await this.apiService.sequencer.getInfo();
       const contracts = info.contracts;
       if (contracts.process) {
+        this.config.customAddresses.processRegistry = contracts.process;
         this._processRegistry = new ProcessRegistryService(contracts.process, this.config.signer);
-        this.config.contractAddresses.processRegistry = contracts.process;
       }
       if (contracts.organization) {
-        this._organizationRegistry = new OrganizationRegistryService(contracts.organization, this.config.signer);
-        this.config.contractAddresses.organizationRegistry = contracts.organization;
+        this.config.customAddresses.organizationRegistry = contracts.organization;
+        this._organizationRegistry = new OrganizationRegistryService(
+          contracts.organization,
+          this.config.signer
+        );
       }
       if (contracts.stateTransitionVerifier) {
-        this.config.contractAddresses.stateTransitionVerifier = contracts.stateTransitionVerifier;
+        this.config.customAddresses.stateTransitionVerifier = contracts.stateTransitionVerifier;
       }
       if (contracts.resultsVerifier) {
-        this.config.contractAddresses.resultsVerifier = contracts.resultsVerifier;
+        this.config.customAddresses.resultsVerifier = contracts.resultsVerifier;
       }
     } catch (error) {
-      console.warn("Failed to fetch contract addresses from sequencer, using defaults:", error);
+      throw new Error(
+        `Failed to fetch contract addresses from sequencer: ${error instanceof Error ? error.message : String(error)}. You can provide custom addresses in the SDK config to avoid this error.`
+      );
     }
   }
   /**
@@ -3024,5 +3256,5 @@ class DavinciSDK {
   }
 }
 
-export { BaseService, CensusOrigin, CircomProof, ContractServiceError, DEFAULT_ENVIRONMENT_URLS, DavinciCrypto, DavinciSDK, ElectionMetadataTemplate, ElectionResultsTypeNames, OrganizationAdministratorError, OrganizationCreateError, OrganizationDeleteError, OrganizationRegistryService, OrganizationUpdateError, ProcessCensusError, ProcessCreateError, ProcessDurationError, ProcessOrchestrationService, ProcessRegistryService, ProcessResultError, ProcessStateTransitionError, ProcessStatus, ProcessStatusError, SmartContractService, TxStatus, VocdoniApiService, VocdoniCensusService, VocdoniSequencerService, VoteOrchestrationService, VoteStatus, assertCSPCensusProof, assertMerkleCensusProof, createProcessSignatureMessage, deployedAddresses, getElectionMetadataTemplate, getEnvironmentChain, getEnvironmentConfig, getEnvironmentUrls, isCSPCensusProof, isMerkleCensusProof, resolveConfiguration, resolveUrls, signProcessCreation, validateProcessId };
+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 };
 //# sourceMappingURL=index.mjs.map