@varla/sdk 2.15.1 → 2.16.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @varla-xyz/protocol
 
+## 2.16.0
+
+### Minor Changes
+
+- 42777b6: Add receipt retry support and post-borrow/withdraw hooks to leverage loop executors with resumable step execution.
+
+  - Added receipt retry helper utilities and exports for robust transaction receipt polling
+  - Extended leverage and deleverage loop params with retry options, post-step hooks, delays, and resume-from-step support
+
 ## 2.15.1
 
 ### Patch Changes

package/dist/leverage/deleverageExecute.d.ts

@@ -4,13 +4,14 @@
  * Drives a deleverage plan by delegating on-chain operations (withdraw/repay)
  * to SDK action helpers and off-chain operations (sell) to a consumer callback.
  */
-import type { Address, PublicClient, WalletClient } from "viem";
+import type { Address, Hash, PublicClient, WalletClient } from "viem";
+import type { ReceiptRetryOptions } from "./receipt.js";
 import type { DeleveragePlan, DeleverageStep, SellResult } from "./types.js";
 export type OnDeleverageProgress = (info: {
     completed: number;
     total: number;
     step: DeleverageStep;
-    hash?: `0x${string}`;
+    hash?: Hash;
     sellResult?: SellResult;
 }) => void;
 export type RunDeleverageLoopParams = {
@@ -32,11 +33,62 @@ export type RunDeleverageLoopParams = {
      * the loop aborts with a `SlippageExceededError`.
      */
     maxSlippageBps?: bigint;
+    /**
+     * Receipt retry options for `waitForTransactionReceipt`.
+     *
+     * By default the executor retries up to 5 times with exponential backoff
+     * (2s → 4s → 8s → 16s → 32s). Set `{ maxRetries: 0 }` to disable retries.
+     */
+    receiptRetry?: ReceiptRetryOptions;
+    /**
+     * Hook called after each successful withdraw step (receipt confirmed),
+     * before the next sell step. Use this to refresh CLOB position caches, etc.
+     *
+     * @param info Withdraw step details and tx hash.
+     */
+    onPostWithdraw?: (info: {
+        step: Extract<DeleverageStep, {
+            kind: "withdraw";
+        }>;
+        hash: Hash;
+    }) => Promise<void>;
+    /**
+     * Milliseconds to sleep after each withdraw confirmation before proceeding
+     * to the next sell step. Gives the CLOB server time to re-index on-chain
+     * token balance changes.
+     *
+     * Applied AFTER `onPostWithdraw` (if provided). Default: 0 (no delay).
+     */
+    postWithdrawDelayMs?: number;
+    /**
+     * Resume a previously failed execution by skipping steps before this index.
+     *
+     * When a previous call returned `{ failedAtStep: N }`, pass `startFromStep: N`
+     * to resume from exactly where it left off.
+     *
+     * Default: 0 (run all steps from the beginning).
+     */
+    startFromStep?: number;
 };
 export type RunDeleverageLoopResult = {
     completed: boolean;
+    /** If execution stopped early, the index of the failed step (absolute). */
     failedAtStep?: number;
     error?: unknown;
 };
+/**
+ * Execute a deleverage (unwind) loop plan step-by-step.
+ *
+ * For each step:
+ * - "withdraw": prepares + sends `VarlaCore.withdraw()` tx
+ * - "sell": delegates to `onSellStep` callback (off-chain CLOB trade)
+ * - "repay": prepares + sends `VarlaCore.repay()` tx
+ *
+ * **Reliability features (v2):**
+ * - `receiptRetry`: configurable exponential backoff for receipt polling
+ * - `onPostWithdraw`: hook for CLOB cache refresh after each withdraw
+ * - `postWithdrawDelayMs`: sleep after withdraw for CLOB indexer sync
+ * - `startFromStep`: resume from a previously failed step index
+ */
 export declare function runDeleverageLoop(params: RunDeleverageLoopParams): Promise<RunDeleverageLoopResult>;
 //# sourceMappingURL=deleverageExecute.d.ts.map

package/dist/leverage/deleverageExecute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleverageExecute.d.ts","sourceRoot":"","sources":["../../src/leverage/deleverageExecute.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIhE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7E,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IAErB,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,KAAK,IAAI,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,2BAA2B,CAAC,CAAC;IACnF,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACrF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAgFlC"}
+{"version":3,"file":"deleverageExecute.d.ts","sourceRoot":"","sources":["../../src/leverage/deleverageExecute.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAItE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7E,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IAErB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,KAAK,IAAI,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,2BAA2B,CAAC,CAAC;IACnF,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACrF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAIxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAEnC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE;YAAE,IAAI,EAAE,UAAU,CAAA;SAAE,CAAC,CAAC;QACpD,IAAI,EAAE,IAAI,CAAC;KACZ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAiGlC"}

package/dist/leverage/deleverageExecute.js

@@ -1,13 +1,37 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 import { prepareCoreRepay, prepareCoreWithdraw } from "../actions/core.js";
 import { sendTx } from "../actions/tx.js";
+import { waitForReceiptWithRetry } from "./receipt.js";
 import { SlippageExceededError } from "./types.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ---------------------------------------------------------------------------
+// Executor
+// ---------------------------------------------------------------------------
+/**
+ * Execute a deleverage (unwind) loop plan step-by-step.
+ *
+ * For each step:
+ * - "withdraw": prepares + sends `VarlaCore.withdraw()` tx
+ * - "sell": delegates to `onSellStep` callback (off-chain CLOB trade)
+ * - "repay": prepares + sends `VarlaCore.repay()` tx
+ *
+ * **Reliability features (v2):**
+ * - `receiptRetry`: configurable exponential backoff for receipt polling
+ * - `onPostWithdraw`: hook for CLOB cache refresh after each withdraw
+ * - `postWithdrawDelayMs`: sleep after withdraw for CLOB indexer sync
+ * - `startFromStep`: resume from a previously failed step index
+ */
 export async function runDeleverageLoop(params) {
-    const { plan, positionId, publicClient, walletClient, coreAddress, account, onSellStep, onProgress, confirmations = 1, maxSlippageBps, } = params;
+    const { plan, positionId, publicClient, walletClient, coreAddress, account, onSellStep, onProgress, confirmations = 1, maxSlippageBps, receiptRetry, onPostWithdraw, postWithdrawDelayMs = 0, startFromStep = 0, } = params;
     const total = plan.steps.length;
     // Track actual collateral proceeds from the most recent sell step.
     let lastSellActualCollateral;
-    for (let i = 0; i < total; i++) {
+    for (let i = startFromStep; i < total; i++) {
         const step = plan.steps[i];
         try {
             if (step.kind === "withdraw") {
@@ -19,8 +43,16 @@ export async function runDeleverageLoop(params) {
                     amounts: [step.amount],
                 });
                 const hash = await sendTx({ walletClient: walletClient, request: sim.request });
-                await publicClient.waitForTransactionReceipt({ hash, confirmations });
+                await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
                 onProgress?.({ completed: i + 1, total, step, hash });
+                // Post-withdraw hook — let consumer refresh CLOB token balance cache, etc.
+                if (onPostWithdraw) {
+                    await onPostWithdraw({ step, hash });
+                }
+                // Post-withdraw delay — give CLOB server time to re-index.
+                if (postWithdrawDelayMs > 0) {
+                    await sleep(postWithdrawDelayMs);
+                }
                 continue;
             }
             if (step.kind === "sell") {
@@ -51,7 +83,7 @@ export async function runDeleverageLoop(params) {
                     amount: repayAmount,
                 });
                 const hash = await sendTx({ walletClient: walletClient, request: sim.request });
-                await publicClient.waitForTransactionReceipt({ hash, confirmations });
+                await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
                 onProgress?.({ completed: i + 1, total, step, hash });
                 continue;
             }

package/dist/leverage/deleverageExecute.js.map

@@ -1 +1 @@
-{"version":3,"file":"deleverageExecute.js","sourceRoot":"","sources":["../../src/leverage/deleverageExecute.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deleverageExecute.js","sourceRoot":"","sources":["../../src/leverage/deleverageExecute.ts"],"names":[],"mappings":"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"}

package/dist/leverage/execute.d.ts

@@ -5,7 +5,8 @@
  * to SDK action helpers and off-chain operations (buy) to a consumer-provided
  * callback.
  */
-import type { Address, PublicClient, WalletClient } from "viem";
+import type { Address, Hash, PublicClient, WalletClient } from "viem";
+import type { ReceiptRetryOptions } from "./receipt.js";
 import type { BuyResult, LeveragePlan, LeverageStep, LeverageStepResult, OnLeverageProgress } from "./types.js";
 export type RunLeverageLoopParams = {
     /** The plan to execute (from `planLeverageLoop` or `planLeverageFromChain`). */
@@ -39,13 +40,51 @@ export type RunLeverageLoopParams = {
      * the loop aborts with a `SlippageExceededError`.
      */
     maxSlippageBps?: bigint;
+    /**
+     * Receipt retry options for `waitForTransactionReceipt`.
+     *
+     * By default the executor retries up to 5 times with exponential backoff
+     * (2s → 4s → 8s → 16s → 32s). Set `{ maxRetries: 0 }` to disable retries.
+     */
+    receiptRetry?: ReceiptRetryOptions;
+    /**
+     * Hook called after each successful borrow step (receipt confirmed),
+     * before the next buy step. Use this to refresh CLOB balance caches,
+     * wait for off-chain indexers, etc.
+     *
+     * @param info Borrow step details and tx hash.
+     */
+    onPostBorrow?: (info: {
+        step: Extract<LeverageStep, {
+            kind: "borrow";
+        }>;
+        hash: Hash;
+    }) => Promise<void>;
+    /**
+     * Milliseconds to sleep after each borrow confirmation before proceeding
+     * to the next buy step. Gives the CLOB server time to re-index on-chain
+     * balance changes.
+     *
+     * Applied AFTER `onPostBorrow` (if provided). Default: 0 (no delay).
+     */
+    postBorrowDelayMs?: number;
+    /**
+     * Resume a previously failed execution by skipping steps before this index.
+     *
+     * When a previous call returned `{ failedAtStep: N }`, pass `startFromStep: N`
+     * to resume from exactly where it left off. Steps before `startFromStep` are
+     * skipped (their results are NOT included in the returned array).
+     *
+     * Default: 0 (run all steps from the beginning).
+     */
+    startFromStep?: number;
 };
 export type RunLeverageLoopResult = {
-    /** Results for each step, aligned to `plan.steps`. */
+    /** Results for each step executed (starting from `startFromStep`). */
     results: LeverageStepResult[];
     /** Whether all steps completed successfully. */
     completed: boolean;
-    /** If execution stopped early, the index of the failed step. */
+    /** If execution stopped early, the index of the failed step (absolute, relative to plan). */
     failedAtStep?: number;
     /** If execution stopped early, the error. */
     error?: unknown;
@@ -63,6 +102,12 @@ export type RunLeverageLoopResult = {
  * for slippage.
  *
  * If any step fails, execution stops and returns partial results.
+ *
+ * **Reliability features (v2):**
+ * - `receiptRetry`: configurable exponential backoff for receipt polling
+ * - `onPostBorrow`: hook for CLOB balance cache refresh after each borrow
+ * - `postBorrowDelayMs`: sleep after borrow for CLOB indexer sync
+ * - `startFromStep`: resume from a previously failed step index
  */
 export declare function runLeverageLoop(params: RunLeverageLoopParams): Promise<RunLeverageLoopResult>;
 //# sourceMappingURL=execute.d.ts.map

package/dist/leverage/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/leverage/execute.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIhE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAOpB,MAAM,MAAM,qBAAqB,GAAG;IAClC,gFAAgF;IAChF,IAAI,EAAE,YAAY,CAAC;IACnB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,2BAA2B,CAAC,CAAC;IACnF,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAChF,kCAAkC;IAClC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,sDAAsD;IACtD,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAMF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAuGhC"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/leverage/execute.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAItE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAOpB,MAAM,MAAM,qBAAqB,GAAG;IAClC,gFAAgF;IAChF,IAAI,EAAE,YAAY,CAAC;IACnB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,2BAA2B,CAAC,CAAC;IACnF,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAChF,kCAAkC;IAClC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAIxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAEnC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAA;SAAE,CAAC,CAAC;QAChD,IAAI,EAAE,IAAI,CAAC;KACZ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,sEAAsE;IACtE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAsHhC"}

package/dist/leverage/execute.js

@@ -1,8 +1,15 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 import { prepareCoreBorrow, prepareCoreDeposit } from "../actions/core.js";
 import { sendTx } from "../actions/tx.js";
+import { waitForReceiptWithRetry } from "./receipt.js";
 import { SlippageExceededError } from "./types.js";
 // ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ---------------------------------------------------------------------------
 // Executor
 // ---------------------------------------------------------------------------
 /**
@@ -18,14 +25,20 @@ import { SlippageExceededError } from "./types.js";
  * for slippage.
  *
  * If any step fails, execution stops and returns partial results.
+ *
+ * **Reliability features (v2):**
+ * - `receiptRetry`: configurable exponential backoff for receipt polling
+ * - `onPostBorrow`: hook for CLOB balance cache refresh after each borrow
+ * - `postBorrowDelayMs`: sleep after borrow for CLOB indexer sync
+ * - `startFromStep`: resume from a previously failed step index
  */
 export async function runLeverageLoop(params) {
-    const { plan, positionId, publicClient, walletClient, coreAddress, account, onBuyStep, onProgress, confirmations = 1, maxSlippageBps, } = params;
+    const { plan, positionId, publicClient, walletClient, coreAddress, account, onBuyStep, onProgress, confirmations = 1, maxSlippageBps, receiptRetry, onPostBorrow, postBorrowDelayMs = 0, startFromStep = 0, } = params;
     const results = [];
     const totalSteps = plan.steps.length;
     // Track actual tokens from the most recent buy (for slippage-aware deposits).
     let lastBuyActualTokens;
-    for (let i = 0; i < totalSteps; i++) {
+    for (let i = startFromStep; i < totalSteps; i++) {
         const step = plan.steps[i];
         try {
             if (step.kind === "buy") {
@@ -60,7 +73,7 @@ export async function runLeverageLoop(params) {
                     amounts: [depositAmount],
                 });
                 const hash = await sendTx({ walletClient: walletClient, request: sim.request });
-                await publicClient.waitForTransactionReceipt({ hash, confirmations });
+                await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
                 const result = { step, hash };
                 results.push(result);
                 onProgress?.({ completed: i + 1, total: totalSteps, step, result });
@@ -74,10 +87,18 @@ export async function runLeverageLoop(params) {
                     amount: step.collateralAmount,
                 });
                 const hash = await sendTx({ walletClient: walletClient, request: sim.request });
-                await publicClient.waitForTransactionReceipt({ hash, confirmations });
+                await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
                 const result = { step, hash };
                 results.push(result);
                 onProgress?.({ completed: i + 1, total: totalSteps, step, result });
+                // Post-borrow hook — let consumer refresh CLOB balance cache, etc.
+                if (onPostBorrow) {
+                    await onPostBorrow({ step, hash });
+                }
+                // Post-borrow delay — give CLOB server time to re-index.
+                if (postBorrowDelayMs > 0) {
+                    await sleep(postBorrowDelayMs);
+                }
                 continue;
             }
             // Exhaustive check.

package/dist/leverage/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/leverage/execute.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/leverage/execute.ts"],"names":[],"mappings":"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"}

package/dist/leverage/index.d.ts

@@ -27,6 +27,8 @@ export type { PlanDeleverageFromChainParams, PlanLeverageFromChainParams, PlanLe
 export { planDeleverageFromChain, planLeverageFromChain, planLeverageFromChainPrecise, resolveLeveragePositionId, } from "./plan.js";
 export type { ReadErc1155IsApprovedForAllParams } from "./preflight.js";
 export { prepareApprovePositionsTokenIfNeeded, readErc1155IsApprovedForAll, } from "./preflight.js";
+export type { ReceiptRetryOptions } from "./receipt.js";
+export { DEFAULT_RECEIPT_RETRY, waitForReceiptWithRetry } from "./receipt.js";
 export type { BuyResult, DeleveragePlan, DeleverageStep, LeverageDirection, LeveragePlan, LeverageStep, LeverageStepResult, LeverageSummary, OnLeverageProgress, SellResult, } from "./types.js";
 export { collateralForDollars, DEFAULT_MAX_ITERATIONS, DEFAULT_MIN_STEP_COLLATERAL, PRICE_E8, pow10, SlippageExceededError, WAD, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/leverage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/leverage/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,GAAG,GACJ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/leverage/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE9E,YAAY,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,GAAG,GACJ,MAAM,YAAY,CAAC"}

package/dist/leverage/index.js

@@ -8,5 +8,7 @@ export { collateralForTokens, estimateLiquidationPrice, leverageScenario, maxLev
 export { planDeleverageFromChain, planLeverageFromChain, planLeverageFromChainPrecise, resolveLeveragePositionId, } from "./plan.js";
 // Preflight
 export { prepareApprovePositionsTokenIfNeeded, readErc1155IsApprovedForAll, } from "./preflight.js";
+// Receipt retry
+export { DEFAULT_RECEIPT_RETRY, waitForReceiptWithRetry } from "./receipt.js";
 export { collateralForDollars, DEFAULT_MAX_ITERATIONS, DEFAULT_MIN_STEP_COLLATERAL, PRICE_E8, pow10, SlippageExceededError, WAD, } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/leverage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/leverage/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AA2BpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAM/C,YAAY;AACZ,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAMnB,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,YAAY;AACZ,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAcxB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,GAAG,GACJ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/leverage/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AA2BpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAM/C,YAAY;AACZ,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAMnB,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,YAAY;AACZ,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,gBAAgB;AAChB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAc9E,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,GAAG,GACJ,MAAM,YAAY,CAAC"}

package/dist/leverage/receipt.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Robust transaction receipt waiting with exponential backoff.
+ *
+ * Polygon (and other L2s) occasionally drop RPC connections or return
+ * "receipt not found" transiently — even for successfully broadcast txs.
+ * This helper retries `waitForTransactionReceipt` so a single flaky RPC
+ * call doesn't abort a multi-step leverage/deleverage loop.
+ */
+import type { Hash, PublicClient, TransactionReceipt } from "viem";
+export type ReceiptRetryOptions = {
+    /** Maximum number of retry attempts (default: 5). */
+    maxRetries?: number;
+    /** Base delay in ms for first retry (default: 2_000). */
+    baseDelayMs?: number;
+    /** Maximum delay cap in ms (default: 32_000). */
+    maxDelayMs?: number;
+    /** Multiplier applied each retry (default: 2). */
+    backoffMultiplier?: number;
+};
+export declare const DEFAULT_RECEIPT_RETRY: Required<ReceiptRetryOptions>;
+/**
+ * Wait for a transaction receipt with automatic retry and exponential backoff.
+ *
+ * This wraps `publicClient.waitForTransactionReceipt` and handles the common
+ * failure modes seen on Polygon:
+ * - "Transaction receipt not found" (RPC hasn't indexed the block yet)
+ * - Timeouts and connection drops
+ * - 502/503/504 gateway errors
+ *
+ * @throws The original error after all retries are exhausted.
+ */
+export declare function waitForReceiptWithRetry(params: {
+    publicClient: Pick<PublicClient, "waitForTransactionReceipt">;
+    hash: Hash;
+    confirmations?: number;
+    retry?: ReceiptRetryOptions;
+}): Promise<TransactionReceipt>;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/leverage/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/leverage/receipt.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAMnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,mBAAmB,CAK/D,CAAC;AA+CF;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;IAC9D,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8C9B"}

package/dist/leverage/receipt.js

@@ -0,0 +1,95 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+export const DEFAULT_RECEIPT_RETRY = {
+    maxRetries: 5,
+    baseDelayMs: 2_000,
+    maxDelayMs: 32_000,
+    backoffMultiplier: 2,
+};
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Classify whether an error from `waitForTransactionReceipt` is transient
+ * (worth retrying) vs permanent (should be thrown immediately).
+ */
+function isTransientReceiptError(error) {
+    if (!(error instanceof Error))
+        return true; // unknown shape → retry
+    const msg = error.message.toLowerCase();
+    // Permanent: tx reverted on-chain → retrying won't help.
+    if (msg.includes("reverted") || msg.includes("execution reverted"))
+        return false;
+    // Transient: receipt not found, timeout, network issues.
+    if (msg.includes("not found") ||
+        msg.includes("could not be found") ||
+        msg.includes("timeout") ||
+        msg.includes("timed out") ||
+        msg.includes("econnrefused") ||
+        msg.includes("econnreset") ||
+        msg.includes("network") ||
+        msg.includes("fetch") ||
+        msg.includes("502") ||
+        msg.includes("503") ||
+        msg.includes("504") ||
+        msg.includes("rate limit")) {
+        return true;
+    }
+    // Default: retry (better to retry once too many than abort a valid tx).
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+/**
+ * Wait for a transaction receipt with automatic retry and exponential backoff.
+ *
+ * This wraps `publicClient.waitForTransactionReceipt` and handles the common
+ * failure modes seen on Polygon:
+ * - "Transaction receipt not found" (RPC hasn't indexed the block yet)
+ * - Timeouts and connection drops
+ * - 502/503/504 gateway errors
+ *
+ * @throws The original error after all retries are exhausted.
+ */
+export async function waitForReceiptWithRetry(params) {
+    const { publicClient, hash, confirmations = 1 } = params;
+    const opts = { ...DEFAULT_RECEIPT_RETRY, ...params.retry };
+    let lastError;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            const receipt = await publicClient.waitForTransactionReceipt({
+                hash,
+                confirmations,
+            });
+            return receipt;
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry permanent errors (e.g. on-chain revert).
+            if (!isTransientReceiptError(error)) {
+                throw error;
+            }
+            // Don't retry if we've exhausted attempts.
+            if (attempt >= opts.maxRetries) {
+                break;
+            }
+            // Exponential backoff with cap.
+            const delay = Math.min(opts.baseDelayMs * opts.backoffMultiplier ** attempt, opts.maxDelayMs);
+            // No-op in production; useful for debugging.
+            // console.debug(`[receipt-retry] attempt ${attempt + 1}/${opts.maxRetries} for ${hash}, waiting ${delay}ms`);
+            await sleep(delay);
+        }
+    }
+    // Wrap with a descriptive message so the caller knows retries were exhausted.
+    const cause = lastError instanceof Error ? lastError : new Error(String(lastError));
+    const wrapped = new Error(`Transaction receipt not found for ${hash} after ${opts.maxRetries + 1} attempts (${opts.maxRetries} retries). ` +
+        `The transaction was broadcast successfully — it may still confirm. ` +
+        `Original error: ${cause.message}`);
+    wrapped.cause = cause;
+    wrapped.hash = hash;
+    throw wrapped;
+}
+//# sourceMappingURL=receipt.js.map

package/dist/leverage/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../../src/leverage/receipt.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varla/sdk",
-  "version": "2.15.1",
+  "version": "2.16.0",
   "private": false,
   "type": "module",
   "sideEffects": false,

package/src/leverage/deleverageExecute.ts

@@ -7,10 +7,12 @@
  * to SDK action helpers and off-chain operations (sell) to a consumer callback.
  */
 
-import type { Address, PublicClient, WalletClient } from "viem";
+import type { Address, Hash, PublicClient, WalletClient } from "viem";
 
 import { prepareCoreRepay, prepareCoreWithdraw } from "../actions/core.js";
 import { sendTx } from "../actions/tx.js";
+import type { ReceiptRetryOptions } from "./receipt.js";
+import { waitForReceiptWithRetry } from "./receipt.js";
 import type { DeleveragePlan, DeleverageStep, SellResult } from "./types.js";
 import { SlippageExceededError } from "./types.js";
 
@@ -19,7 +21,7 @@ export type OnDeleverageProgress = (info: {
   total: number;
   step: DeleverageStep;
   // keep symmetry with leverage executor
-  hash?: `0x${string}`;
+  hash?: Hash;
   sellResult?: SellResult;
 }) => void;
 
@@ -40,14 +42,81 @@ export type RunDeleverageLoopParams = {
    * the loop aborts with a `SlippageExceededError`.
    */
   maxSlippageBps?: bigint;
+
+  // --- NEW: reliability & hooks ------------------------------------------------
+
+  /**
+   * Receipt retry options for `waitForTransactionReceipt`.
+   *
+   * By default the executor retries up to 5 times with exponential backoff
+   * (2s → 4s → 8s → 16s → 32s). Set `{ maxRetries: 0 }` to disable retries.
+   */
+  receiptRetry?: ReceiptRetryOptions;
+
+  /**
+   * Hook called after each successful withdraw step (receipt confirmed),
+   * before the next sell step. Use this to refresh CLOB position caches, etc.
+   *
+   * @param info Withdraw step details and tx hash.
+   */
+  onPostWithdraw?: (info: {
+    step: Extract<DeleverageStep, { kind: "withdraw" }>;
+    hash: Hash;
+  }) => Promise<void>;
+
+  /**
+   * Milliseconds to sleep after each withdraw confirmation before proceeding
+   * to the next sell step. Gives the CLOB server time to re-index on-chain
+   * token balance changes.
+   *
+   * Applied AFTER `onPostWithdraw` (if provided). Default: 0 (no delay).
+   */
+  postWithdrawDelayMs?: number;
+
+  /**
+   * Resume a previously failed execution by skipping steps before this index.
+   *
+   * When a previous call returned `{ failedAtStep: N }`, pass `startFromStep: N`
+   * to resume from exactly where it left off.
+   *
+   * Default: 0 (run all steps from the beginning).
+   */
+  startFromStep?: number;
 };
 
 export type RunDeleverageLoopResult = {
   completed: boolean;
+  /** If execution stopped early, the index of the failed step (absolute). */
   failedAtStep?: number;
   error?: unknown;
 };
 
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// ---------------------------------------------------------------------------
+// Executor
+// ---------------------------------------------------------------------------
+
+/**
+ * Execute a deleverage (unwind) loop plan step-by-step.
+ *
+ * For each step:
+ * - "withdraw": prepares + sends `VarlaCore.withdraw()` tx
+ * - "sell": delegates to `onSellStep` callback (off-chain CLOB trade)
+ * - "repay": prepares + sends `VarlaCore.repay()` tx
+ *
+ * **Reliability features (v2):**
+ * - `receiptRetry`: configurable exponential backoff for receipt polling
+ * - `onPostWithdraw`: hook for CLOB cache refresh after each withdraw
+ * - `postWithdrawDelayMs`: sleep after withdraw for CLOB indexer sync
+ * - `startFromStep`: resume from a previously failed step index
+ */
 export async function runDeleverageLoop(
   params: RunDeleverageLoopParams,
 ): Promise<RunDeleverageLoopResult> {
@@ -62,6 +131,10 @@ export async function runDeleverageLoop(
     onProgress,
     confirmations = 1,
     maxSlippageBps,
+    receiptRetry,
+    onPostWithdraw,
+    postWithdrawDelayMs = 0,
+    startFromStep = 0,
   } = params;
 
   const total = plan.steps.length;
@@ -69,7 +142,7 @@ export async function runDeleverageLoop(
   // Track actual collateral proceeds from the most recent sell step.
   let lastSellActualCollateral: bigint | undefined;
 
-  for (let i = 0; i < total; i++) {
+  for (let i = startFromStep; i < total; i++) {
     const step = plan.steps[i]!;
     try {
       if (step.kind === "withdraw") {
@@ -81,8 +154,20 @@ export async function runDeleverageLoop(
           amounts: [step.amount],
         });
         const hash = await sendTx({ walletClient: walletClient as any, request: sim.request });
-        await (publicClient as any).waitForTransactionReceipt({ hash, confirmations });
+        await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
+
         onProgress?.({ completed: i + 1, total, step, hash });
+
+        // Post-withdraw hook — let consumer refresh CLOB token balance cache, etc.
+        if (onPostWithdraw) {
+          await onPostWithdraw({ step, hash });
+        }
+
+        // Post-withdraw delay — give CLOB server time to re-index.
+        if (postWithdrawDelayMs > 0) {
+          await sleep(postWithdrawDelayMs);
+        }
+
         continue;
       }
 
@@ -118,7 +203,8 @@ export async function runDeleverageLoop(
           amount: repayAmount,
         });
         const hash = await sendTx({ walletClient: walletClient as any, request: sim.request });
-        await (publicClient as any).waitForTransactionReceipt({ hash, confirmations });
+        await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
+
         onProgress?.({ completed: i + 1, total, step, hash });
         continue;
       }

package/src/leverage/execute.ts

@@ -8,10 +8,12 @@
  * callback.
  */
 
-import type { Address, PublicClient, WalletClient } from "viem";
+import type { Address, Hash, PublicClient, WalletClient } from "viem";
 
 import { prepareCoreBorrow, prepareCoreDeposit } from "../actions/core.js";
 import { sendTx } from "../actions/tx.js";
+import type { ReceiptRetryOptions } from "./receipt.js";
+import { waitForReceiptWithRetry } from "./receipt.js";
 import type {
   BuyResult,
   LeveragePlan,
@@ -55,19 +57,69 @@ export type RunLeverageLoopParams = {
    * the loop aborts with a `SlippageExceededError`.
    */
   maxSlippageBps?: bigint;
+
+  // --- NEW: reliability & hooks ------------------------------------------------
+
+  /**
+   * Receipt retry options for `waitForTransactionReceipt`.
+   *
+   * By default the executor retries up to 5 times with exponential backoff
+   * (2s → 4s → 8s → 16s → 32s). Set `{ maxRetries: 0 }` to disable retries.
+   */
+  receiptRetry?: ReceiptRetryOptions;
+
+  /**
+   * Hook called after each successful borrow step (receipt confirmed),
+   * before the next buy step. Use this to refresh CLOB balance caches,
+   * wait for off-chain indexers, etc.
+   *
+   * @param info Borrow step details and tx hash.
+   */
+  onPostBorrow?: (info: {
+    step: Extract<LeverageStep, { kind: "borrow" }>;
+    hash: Hash;
+  }) => Promise<void>;
+
+  /**
+   * Milliseconds to sleep after each borrow confirmation before proceeding
+   * to the next buy step. Gives the CLOB server time to re-index on-chain
+   * balance changes.
+   *
+   * Applied AFTER `onPostBorrow` (if provided). Default: 0 (no delay).
+   */
+  postBorrowDelayMs?: number;
+
+  /**
+   * Resume a previously failed execution by skipping steps before this index.
+   *
+   * When a previous call returned `{ failedAtStep: N }`, pass `startFromStep: N`
+   * to resume from exactly where it left off. Steps before `startFromStep` are
+   * skipped (their results are NOT included in the returned array).
+   *
+   * Default: 0 (run all steps from the beginning).
+   */
+  startFromStep?: number;
 };
 
 export type RunLeverageLoopResult = {
-  /** Results for each step, aligned to `plan.steps`. */
+  /** Results for each step executed (starting from `startFromStep`). */
   results: LeverageStepResult[];
   /** Whether all steps completed successfully. */
   completed: boolean;
-  /** If execution stopped early, the index of the failed step. */
+  /** If execution stopped early, the index of the failed step (absolute, relative to plan). */
   failedAtStep?: number;
   /** If execution stopped early, the error. */
   error?: unknown;
 };
 
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // ---------------------------------------------------------------------------
 // Executor
 // ---------------------------------------------------------------------------
@@ -85,6 +137,12 @@ export type RunLeverageLoopResult = {
  * for slippage.
  *
  * If any step fails, execution stops and returns partial results.
+ *
+ * **Reliability features (v2):**
+ * - `receiptRetry`: configurable exponential backoff for receipt polling
+ * - `onPostBorrow`: hook for CLOB balance cache refresh after each borrow
+ * - `postBorrowDelayMs`: sleep after borrow for CLOB indexer sync
+ * - `startFromStep`: resume from a previously failed step index
  */
 export async function runLeverageLoop(
   params: RunLeverageLoopParams,
@@ -100,6 +158,10 @@ export async function runLeverageLoop(
     onProgress,
     confirmations = 1,
     maxSlippageBps,
+    receiptRetry,
+    onPostBorrow,
+    postBorrowDelayMs = 0,
+    startFromStep = 0,
   } = params;
 
   const results: LeverageStepResult[] = [];
@@ -108,7 +170,7 @@ export async function runLeverageLoop(
   // Track actual tokens from the most recent buy (for slippage-aware deposits).
   let lastBuyActualTokens: bigint | undefined;
 
-  for (let i = 0; i < totalSteps; i++) {
+  for (let i = startFromStep; i < totalSteps; i++) {
     const step = plan.steps[i]!;
 
     try {
@@ -151,7 +213,7 @@ export async function runLeverageLoop(
         });
 
         const hash = await sendTx({ walletClient: walletClient as any, request: sim.request });
-        await (publicClient as any).waitForTransactionReceipt({ hash, confirmations });
+        await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
 
         const result: LeverageStepResult = { step, hash };
         results.push(result);
@@ -169,12 +231,23 @@ export async function runLeverageLoop(
         });
 
         const hash = await sendTx({ walletClient: walletClient as any, request: sim.request });
-        await (publicClient as any).waitForTransactionReceipt({ hash, confirmations });
+        await waitForReceiptWithRetry({ publicClient, hash, confirmations, retry: receiptRetry });
 
         const result: LeverageStepResult = { step, hash };
         results.push(result);
 
         onProgress?.({ completed: i + 1, total: totalSteps, step, result });
+
+        // Post-borrow hook — let consumer refresh CLOB balance cache, etc.
+        if (onPostBorrow) {
+          await onPostBorrow({ step, hash });
+        }
+
+        // Post-borrow delay — give CLOB server time to re-index.
+        if (postBorrowDelayMs > 0) {
+          await sleep(postBorrowDelayMs);
+        }
+
         continue;
       }
 

package/src/leverage/index.ts

@@ -65,6 +65,9 @@ export {
   prepareApprovePositionsTokenIfNeeded,
   readErc1155IsApprovedForAll,
 } from "./preflight.js";
+export type { ReceiptRetryOptions } from "./receipt.js";
+// Receipt retry
+export { DEFAULT_RECEIPT_RETRY, waitForReceiptWithRetry } from "./receipt.js";
 // Types + constants
 export type {
   BuyResult,

package/src/leverage/receipt.ts

@@ -0,0 +1,143 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+
+/**
+ * Robust transaction receipt waiting with exponential backoff.
+ *
+ * Polygon (and other L2s) occasionally drop RPC connections or return
+ * "receipt not found" transiently — even for successfully broadcast txs.
+ * This helper retries `waitForTransactionReceipt` so a single flaky RPC
+ * call doesn't abort a multi-step leverage/deleverage loop.
+ */
+
+import type { Hash, PublicClient, TransactionReceipt } from "viem";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export type ReceiptRetryOptions = {
+  /** Maximum number of retry attempts (default: 5). */
+  maxRetries?: number;
+  /** Base delay in ms for first retry (default: 2_000). */
+  baseDelayMs?: number;
+  /** Maximum delay cap in ms (default: 32_000). */
+  maxDelayMs?: number;
+  /** Multiplier applied each retry (default: 2). */
+  backoffMultiplier?: number;
+};
+
+export const DEFAULT_RECEIPT_RETRY: Required<ReceiptRetryOptions> = {
+  maxRetries: 5,
+  baseDelayMs: 2_000,
+  maxDelayMs: 32_000,
+  backoffMultiplier: 2,
+};
+
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * Classify whether an error from `waitForTransactionReceipt` is transient
+ * (worth retrying) vs permanent (should be thrown immediately).
+ */
+function isTransientReceiptError(error: unknown): boolean {
+  if (!(error instanceof Error)) return true; // unknown shape → retry
+  const msg = error.message.toLowerCase();
+
+  // Permanent: tx reverted on-chain → retrying won't help.
+  if (msg.includes("reverted") || msg.includes("execution reverted")) return false;
+
+  // Transient: receipt not found, timeout, network issues.
+  if (
+    msg.includes("not found") ||
+    msg.includes("could not be found") ||
+    msg.includes("timeout") ||
+    msg.includes("timed out") ||
+    msg.includes("econnrefused") ||
+    msg.includes("econnreset") ||
+    msg.includes("network") ||
+    msg.includes("fetch") ||
+    msg.includes("502") ||
+    msg.includes("503") ||
+    msg.includes("504") ||
+    msg.includes("rate limit")
+  ) {
+    return true;
+  }
+
+  // Default: retry (better to retry once too many than abort a valid tx).
+  return true;
+}
+
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+
+/**
+ * Wait for a transaction receipt with automatic retry and exponential backoff.
+ *
+ * This wraps `publicClient.waitForTransactionReceipt` and handles the common
+ * failure modes seen on Polygon:
+ * - "Transaction receipt not found" (RPC hasn't indexed the block yet)
+ * - Timeouts and connection drops
+ * - 502/503/504 gateway errors
+ *
+ * @throws The original error after all retries are exhausted.
+ */
+export async function waitForReceiptWithRetry(params: {
+  publicClient: Pick<PublicClient, "waitForTransactionReceipt">;
+  hash: Hash;
+  confirmations?: number;
+  retry?: ReceiptRetryOptions;
+}): Promise<TransactionReceipt> {
+  const { publicClient, hash, confirmations = 1 } = params;
+  const opts = { ...DEFAULT_RECEIPT_RETRY, ...params.retry };
+
+  let lastError: unknown;
+
+  for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+    try {
+      const receipt = await (publicClient as any).waitForTransactionReceipt({
+        hash,
+        confirmations,
+      });
+      return receipt as TransactionReceipt;
+    } catch (error) {
+      lastError = error;
+
+      // Don't retry permanent errors (e.g. on-chain revert).
+      if (!isTransientReceiptError(error)) {
+        throw error;
+      }
+
+      // Don't retry if we've exhausted attempts.
+      if (attempt >= opts.maxRetries) {
+        break;
+      }
+
+      // Exponential backoff with cap.
+      const delay = Math.min(opts.baseDelayMs * opts.backoffMultiplier ** attempt, opts.maxDelayMs);
+
+      // No-op in production; useful for debugging.
+      // console.debug(`[receipt-retry] attempt ${attempt + 1}/${opts.maxRetries} for ${hash}, waiting ${delay}ms`);
+
+      await sleep(delay);
+    }
+  }
+
+  // Wrap with a descriptive message so the caller knows retries were exhausted.
+  const cause = lastError instanceof Error ? lastError : new Error(String(lastError));
+  const wrapped = new Error(
+    `Transaction receipt not found for ${hash} after ${opts.maxRetries + 1} attempts (${opts.maxRetries} retries). ` +
+      `The transaction was broadcast successfully — it may still confirm. ` +
+      `Original error: ${cause.message}`,
+  );
+  (wrapped as any).cause = cause;
+  (wrapped as any).hash = hash;
+  throw wrapped;
+}