@ocash/sdk 0.1.4-rc.2 → 0.1.4-rc.3

package/dist/index.cjs

@@ -7362,7 +7362,7 @@ var MerkleEngine = class _MerkleEngine {
               const isZero = BigInt(onChainNorm) === 0n;
               if (!isZero && onChainNorm !== result.rootHash) {
                 const target = state.mergedElements;
-                await this.rollback(chainId, target);
+                await this._rollback(chainId, target);
                 throw new SdkError("MERKLE", "Local merkle root mismatch with on-chain root \u2014 rolled back", {
                   chainId,
                   rootIndex,
@@ -7395,21 +7395,31 @@ var MerkleEngine = class _MerkleEngine {
   }
   // ── Rollback (tree O(1) + sync cursor reset) ──
   /**
-   * Unified rollback: rewind tree to a previous batch boundary AND reset the
-   * sync cursor so memo sync restarts from the same point.
+   * Public rollback: step back one batch (32 elements) from the current position.
+   * Upper-layer code calls this on any error to reset and retry.
    *
    * What gets rolled back:
    * - ChairmanMerkle tree version pointer (O(1) — old nodes still in storage)
    * - Pending leaves buffer (cleared)
    * - Sync cursor: memo + merkle fields (nullifier left unchanged — independent)
    *
+   * @returns true if rollback succeeded, false if already at 0 or target version doesn't exist.
+   */
+  async rollback(chainId) {
+    const state = this.ensureChainState(chainId);
+    const target = Math.max(0, state.mergedElements - SUBTREE_SIZE);
+    return this._rollback(chainId, target);
+  }
+  /**
+   * Internal rollback to an exact batch boundary.
+   *
    * @param targetMergedElements Must be a non-negative multiple of 32.
    *   Pass 0 to reset to the empty tree.
    * @returns true if rollback succeeded, false if the target version doesn't exist.
    */
-  async rollback(chainId, targetMergedElements) {
+  async _rollback(chainId, targetMergedElements) {
     if (targetMergedElements < 0 || targetMergedElements % SUBTREE_SIZE !== 0) {
-      throw new SdkError("MERKLE", "rollback target must be a non-negative multiple of 32", { targetMergedElements });
+      throw new SdkError("MERKLE", "_rollback target must be a non-negative multiple of 32", { targetMergedElements });
     }
     const state = this.ensureChainState(chainId);
     const pending = this.ensurePendingLeaves(chainId);