@dorafactory/maci-sdk 0.1.3-pre.46.beta.10 → 0.1.3-pre.46.beta.12

package/dist/index.js

@@ -6712,6 +6712,30 @@ var MaciApiClient = class {
       { method: "GET" }
     );
   }
+  // ==================== Claim Key APIs ====================
+  /**
+   * Claim MACI Key
+   * Assign the next available pre-generated MACI key pair for an AMACI round (first-come-first-served).
+   * Returns pubkey, secretKey, and the full deactivate Merkle proof.
+   * WARNING: secretKey is returned only once and cannot be retrieved again.
+   */
+  async claimMaciKey(params) {
+    const { contractAddress, ...body } = params;
+    return this.fetch(`/v1/rounds/${contractAddress}/claim-key`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
+  /**
+   * Get Claim Statistics
+   * Returns total key slots (scale), claimed count, and available count for the round.
+   * Public endpoint — no authentication required.
+   */
+  async getClaimStats(params) {
+    return this.fetch(`/v1/rounds/${params.contractAddress}/claim-key-stats`, {
+      method: "GET"
+    });
+  }
 };
 
 // src/maci.ts
@@ -8071,6 +8095,7 @@ var VoterClient = class _VoterClient {
     contractAddress,
     deactivateIdx,
     voterScale,
+    preComputedProof,
     newPubkey,
     pollId,
     wasmFile,
@@ -8114,6 +8139,18 @@ var VoterClient = class _VoterClient {
     let preComputedLeaf;
     if (deactivates && deactivates.length > 0) {
       resolvedDeactivates = deactivates.map((d) => d.map(BigInt));
+    } else if (preComputedProof) {
+      if (deactivateIdx === void 0) {
+        throw new Error(
+          "buildPreAddNewKeyPayload: `deactivateIdx` is required when `preComputedProof` is provided"
+        );
+      }
+      preComputedLeaf = preComputedProof.deactivateLeaf.map(BigInt);
+      preComputedTreeProof = {
+        root: preComputedProof.root,
+        pathElements: preComputedProof.pathElements
+      };
+      resolvedDeactivates = [];
     } else {
       if (!contractAddress) {
         throw new Error(
@@ -8127,7 +8164,7 @@ var VoterClient = class _VoterClient {
       }
       if (voterScale === void 0) {
         throw new Error(
-          "buildPreAddNewKeyPayload: `voterScale` is required when `deactivates` is not provided"
+          "buildPreAddNewKeyPayload: `voterScale` is required for the K-anonymous API path"
         );
       }
       const indicesParam = buildKAnonymousIndices(deactivateIdx, voterScale);
@@ -8678,6 +8715,7 @@ var VoterClient = class _VoterClient {
     deactivates,
     deactivateIdx,
     voterScale,
+    preComputedProof,
     pollId,
     wasmFile,
     zkeyFile,
@@ -8699,6 +8737,7 @@ var VoterClient = class _VoterClient {
       contractAddress,
       deactivateIdx,
       voterScale,
+      preComputedProof,
       newPubkey,
       pollId: pollId !== void 0 ? BigInt(pollId) : void 0,
       wasmFile,
@@ -8718,6 +8757,19 @@ var VoterClient = class _VoterClient {
       account: newVoterClient
     };
   }
+  /**
+   * Claim the next available pre-generated MACI key pair for an AMACI round via SaaS API.
+   * The key is assigned on a first-come-first-served basis.
+   * WARNING: secretKey is returned only once — save it immediately, it cannot be retrieved again.
+   * @param params - Parameters including contractAddress and ticket
+   * @returns Claimed key pair with full deactivate Merkle proof
+   */
+  async saasClaimKey(params) {
+    if (!this.saasApiClient) {
+      throw new Error("SaaS API client not initialized");
+    }
+    return await this.saasApiClient.claimMaciKey(params);
+  }
   /**
    * Vote via SaaS API with automatic payload building
    * @param params - Parameters including contract address, operator pubkey, vote options, and ticket