@varla/sdk 2.14.0 → 2.15.1

package/dist/leverage/index.d.ts

@@ -28,5 +28,5 @@ export { planDeleverageFromChain, planLeverageFromChain, planLeverageFromChainPr
 export type { ReadErc1155IsApprovedForAllParams } from "./preflight.js";
 export { prepareApprovePositionsTokenIfNeeded, readErc1155IsApprovedForAll, } from "./preflight.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, WAD, } 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,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;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"}

package/dist/leverage/index.js

@@ -8,5 +8,5 @@ export { collateralForTokens, estimateLiquidationPrice, leverageScenario, maxLev
 export { planDeleverageFromChain, planLeverageFromChain, planLeverageFromChainPrecise, resolveLeveragePositionId, } from "./plan.js";
 // Preflight
 export { prepareApprovePositionsTokenIfNeeded, readErc1155IsApprovedForAll, } from "./preflight.js";
-export { collateralForDollars, DEFAULT_MAX_ITERATIONS, DEFAULT_MIN_STEP_COLLATERAL, PRICE_E8, pow10, WAD, } from "./types.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,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;AAcxB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,GAAG,GACJ,MAAM,YAAY,CAAC"}

package/dist/leverage/math.d.ts

@@ -55,6 +55,12 @@ export type PlanLeverageLoopParams = {
     startingDebt?: bigint;
     /** Optional absolute cap on total debt (collateral base units). */
     maxTotalDebt?: bigint;
+    /**
+     * Assumed slippage/spread for CLOB buys (bps, e.g. 50 = 0.50%).
+     * Buys use an effectively higher price: `price * (10_000 + slippageBps) / 10_000`.
+     * Default: 0 (ideal execution).
+     */
+    slippageBps?: bigint;
 };
 /**
  * Plan a leverage loop (pure math, zero RPC).
@@ -87,6 +93,12 @@ export type PlanDeleverageParams = {
     maxIterations?: number;
     /** Minimum sell size (in collateral base units) to continue looping. */
     minStepSell?: bigint;
+    /**
+     * Assumed slippage/spread for CLOB sells (bps, e.g. 50 = 0.50%).
+     * Sells use an effectively lower price: `price * (10_000 - slippageBps) / 10_000`.
+     * Default: 0 (ideal execution).
+     */
+    slippageBps?: bigint;
 };
 /**
  * Plan a deleverage (unwind) loop (pure math, zero RPC).

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

@@ -1 +1 @@
-{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/leverage/math.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,YAAY,EAGb,MAAM,YAAY,CAAC;AAgCpB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG1F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAErF;AAMD,MAAM,MAAM,sBAAsB,GAAG;IACnC,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,YAAY,CAwI7E;AAMD,MAAM,MAAM,oBAAoB,GAAG;IACjC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CA+F3E;AAMD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,gBAAgB,CAanB"}
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/leverage/math.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,YAAY,EAGb,MAAM,YAAY,CAAC;AA+CpB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG1F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAErF;AAMD,MAAM,MAAM,sBAAsB,GAAG;IACnC,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,YAAY,CA+J7E;AAMD,MAAM,MAAM,oBAAoB,GAAG;IACjC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAoI3E;AAMD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,gBAAgB,CAanB"}

package/dist/leverage/math.js

@@ -23,6 +23,19 @@ function mulDivUp(a, b, c) {
         throw new Error("mulDivUp: division by zero");
     return (a * b + c - 1n) / c;
 }
+/** BPS base (100%). */
+const BPS_BASE = 10000n;
+/**
+ * Adjust a price for slippage.
+ * - Buying: pay more per token → effective price goes UP.
+ * - Selling: receive less per token → effective price goes DOWN.
+ */
+function applySlippageToBuyPrice(price, slippageBps) {
+    return slippageBps > 0n ? mulDivUp(price, BPS_BASE + slippageBps, BPS_BASE) : price;
+}
+function applySlippageToSellPrice(price, slippageBps) {
+    return slippageBps > 0n ? mulDiv(price, BPS_BASE - slippageBps, BPS_BASE) : price;
+}
 // ---------------------------------------------------------------------------
 // Public helpers
 // ---------------------------------------------------------------------------
@@ -89,7 +102,7 @@ export function collateralForTokens(tokenAmount, tokenPriceE8) {
  * If `maxIterations` is hit, the final iteration ends at `deposit`.
  */
 export function planLeverageLoop(params) {
-    const { initialCapital, tokenPriceE8, ltvWad, targetLeverageWad, maxIterations = DEFAULT_MAX_ITERATIONS, minStepBorrow = DEFAULT_MIN_STEP_COLLATERAL, startingTokens = 0n, startingDebt = 0n, maxTotalDebt, } = params;
+    const { initialCapital, tokenPriceE8, ltvWad, targetLeverageWad, maxIterations = DEFAULT_MAX_ITERATIONS, minStepBorrow = DEFAULT_MIN_STEP_COLLATERAL, startingTokens = 0n, startingDebt = 0n, maxTotalDebt, slippageBps = 0n, } = params;
     if (initialCapital <= 0n)
         throw new Error("initialCapital must be > 0");
     if (tokenPriceE8 <= 0n)
@@ -102,7 +115,12 @@ export function planLeverageLoop(params) {
         throw new Error("startingTokens must be >= 0");
     if (startingDebt < 0n)
         throw new Error("startingDebt must be >= 0");
+    if (slippageBps < 0n)
+        throw new Error("slippageBps must be >= 0");
+    if (slippageBps >= BPS_BASE)
+        throw new Error("slippageBps must be < 10_000");
     const maxLev = maxLeverage(ltvWad);
+    const effectiveBuyPrice = applySlippageToBuyPrice(tokenPriceE8, slippageBps);
     // Target leverage semantics:
     // - undefined => run to max (bounded by maxIterations / minStepBorrow / caps)
     // - <= 1× => treat as 1× (no borrowing)
@@ -132,7 +150,8 @@ export function planLeverageLoop(params) {
             break;
         // buy
         const spendCollateral = collateralAvailable;
-        const tokensBought = tokensForCollateral(spendCollateral, tokenPriceE8);
+        // Use effective (slippage-adjusted) price for buy, but ideal price for expectedTokens display.
+        const tokensBought = tokensForCollateral(spendCollateral, effectiveBuyPrice);
         if (tokensBought <= 0n)
             break;
         // Spend the available collateral for this iteration.
@@ -188,6 +207,16 @@ export function planLeverageLoop(params) {
         estimatedLiquidationPriceE8,
         iterations,
         maxLeverageWad: maxLev,
+        assumedSlippageBps: slippageBps,
+        totalSlippageCost: slippageBps > 0n
+            ? clampPositive(
+            // Ideal tokens - actual tokens, valued at mid price.
+            collateralForTokens(steps
+                .filter((s) => s.kind === "buy")
+                .reduce((acc, s) => acc + tokensForCollateral(s.collateralAmount, tokenPriceE8), 0n) -
+                totalTokens +
+                startingTokens, tokenPriceE8))
+            : 0n,
     };
     return {
         steps,
@@ -208,7 +237,7 @@ export function planLeverageLoop(params) {
  * Steps: withdraw → sell → repay → ...
  */
 export function planDeleverage(params) {
-    const { depositedTokens, currentDebt, tokenPriceE8, ltvWad, targetDebtReduction, maxIterations = DEFAULT_MAX_ITERATIONS, minStepSell = DEFAULT_MIN_STEP_COLLATERAL, } = params;
+    const { depositedTokens, currentDebt, tokenPriceE8, ltvWad, targetDebtReduction, maxIterations = DEFAULT_MAX_ITERATIONS, minStepSell = DEFAULT_MIN_STEP_COLLATERAL, slippageBps = 0n, } = params;
     if (tokenPriceE8 <= 0n)
         throw new Error("tokenPriceE8 must be > 0");
     if (ltvWad <= 0n || ltvWad >= WAD)
@@ -217,6 +246,11 @@ export function planDeleverage(params) {
         throw new Error("depositedTokens must be >= 0");
     if (currentDebt < 0n)
         throw new Error("currentDebt must be >= 0");
+    if (slippageBps < 0n)
+        throw new Error("slippageBps must be >= 0");
+    if (slippageBps >= BPS_BASE)
+        throw new Error("slippageBps must be < 10_000");
+    const effectiveSellPrice = applySlippageToSellPrice(tokenPriceE8, slippageBps);
     const targetRepay = targetDebtReduction === "full" ? currentDebt : targetDebtReduction;
     if (targetRepay <= 0n) {
         return {
@@ -227,6 +261,8 @@ export function planDeleverage(params) {
                 tokensRemaining: depositedTokens,
                 collateralRemaining: 0n,
                 iterations: 0,
+                assumedSlippageBps: slippageBps,
+                totalSlippageCost: 0n,
             },
         };
     }
@@ -235,6 +271,7 @@ export function planDeleverage(params) {
     let remainingDebt = currentDebt;
     let totalSold = 0n;
     let totalRepaid = 0n;
+    let excessCollateral = 0n; // sell proceeds not used for repayment (returned to user)
     for (let i = 0; i < maxIterations; i++) {
         if (remainingDebt <= 0n)
             break;
@@ -255,7 +292,7 @@ export function planDeleverage(params) {
         const tokensToWithdraw = withdrawable < tokensNeededForTarget ? withdrawable : tokensNeededForTarget;
         if (tokensToWithdraw <= 0n)
             break;
-        const collateralProceeds = collateralForTokens(tokensToWithdraw, tokenPriceE8);
+        const collateralProceeds = collateralForTokens(tokensToWithdraw, effectiveSellPrice);
         if (collateralProceeds < minStepSell)
             break;
         // withdraw
@@ -274,8 +311,27 @@ export function planDeleverage(params) {
         steps.push({ kind: "repay", collateralAmount: repayAmount, iteration: i });
         remainingDebt -= repayAmount;
         totalRepaid += repayAmount;
+        excessCollateral += collateralProceeds - repayAmount;
+    }
+    // Phase 2: After all debt is repaid, withdraw and sell remaining tokens.
+    // This ensures "full" close returns all collateral to the user, not just repays debt.
+    // Only fires when debt is fully repaid — if debt remains (underwater/stuck), skip.
+    if (targetDebtReduction === "full" && remainingDebt <= 0n && remainingTokens > 0n) {
+        const collateralProceeds = collateralForTokens(remainingTokens, tokenPriceE8);
+        const iteration = steps.length > 0 ? steps[steps.length - 1].iteration + 1 : 0;
+        steps.push({ kind: "withdraw", amount: remainingTokens, iteration });
+        steps.push({
+            kind: "sell",
+            tokenAmount: remainingTokens,
+            expectedCollateral: collateralProceeds,
+            iteration,
+        });
+        excessCollateral += collateralProceeds;
+        totalSold += remainingTokens;
+        remainingTokens = 0n;
     }
-    const collateralRemaining = clampPositive(collateralForTokens(remainingTokens, tokenPriceE8) - remainingDebt);
+    const collateralRemaining = excessCollateral +
+        clampPositive(collateralForTokens(remainingTokens, tokenPriceE8) - remainingDebt);
     const iterations = steps.length > 0 ? steps[steps.length - 1].iteration + 1 : 0;
     return {
         steps,
@@ -285,6 +341,11 @@ export function planDeleverage(params) {
             tokensRemaining: remainingTokens,
             collateralRemaining,
             iterations,
+            assumedSlippageBps: slippageBps,
+            totalSlippageCost: slippageBps > 0n
+                ? clampPositive(collateralForTokens(totalSold, tokenPriceE8) -
+                    collateralForTokens(totalSold, effectiveSellPrice))
+                : 0n,
         },
     };
 }

package/dist/leverage/math.js.map

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

package/dist/leverage/types.d.ts

@@ -79,6 +79,10 @@ export type LeverageSummary = {
     iterations: number;
     /** Maximum theoretical leverage = 1 / (1 - LTV) as WAD. */
     maxLeverageWad: bigint;
+    /** Assumed slippage/spread used in planning (bps). 0 if not specified. */
+    assumedSlippageBps: bigint;
+    /** Total collateral lost to slippage across all buy steps (base units). */
+    totalSlippageCost: bigint;
 };
 /**
  * Complete leverage plan returned by the planner.
@@ -124,6 +128,10 @@ export type DeleveragePlan = {
         tokensRemaining: bigint;
         collateralRemaining: bigint;
         iterations: number;
+        /** Assumed slippage/spread used in planning (bps). 0 if not specified. */
+        assumedSlippageBps: bigint;
+        /** Total collateral lost to slippage across all sell steps (base units). */
+        totalSlippageCost: bigint;
     };
 };
 /**
@@ -154,4 +162,19 @@ export type OnLeverageProgress = (info: {
     step: LeverageStep;
     result: LeverageStepResult;
 }) => void;
+/**
+ * Thrown by executors when actual fill deviates beyond `maxSlippageBps`.
+ */
+export declare class SlippageExceededError extends Error {
+    readonly expected: bigint;
+    readonly actual: bigint;
+    readonly maxSlippageBps: bigint;
+    readonly side: "buy" | "sell";
+    constructor(params: {
+        expected: bigint;
+        actual: bigint;
+        maxSlippageBps: bigint;
+        side: "buy" | "sell";
+    });
+}
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/leverage/types.js

@@ -40,4 +40,25 @@ export function pow10(n) {
 export function collateralForDollars(params) {
     return params.dollars * pow10(params.decimals);
 }
+// ---------------------------------------------------------------------------
+// Slippage error
+// ---------------------------------------------------------------------------
+/**
+ * Thrown by executors when actual fill deviates beyond `maxSlippageBps`.
+ */
+export class SlippageExceededError extends Error {
+    expected;
+    actual;
+    maxSlippageBps;
+    side;
+    constructor(params) {
+        const pct = (Number(params.maxSlippageBps) / 100).toFixed(2);
+        super(`Slippage exceeded on ${params.side}: expected ${params.expected}, got ${params.actual} (max ${pct}%)`);
+        this.name = "SlippageExceededError";
+        this.expected = params.expected;
+        this.actual = params.actual;
+        this.maxSlippageBps = params.maxSlippageBps;
+        this.side = params.side;
+    }
+}
 //# sourceMappingURL=types.js.map

package/dist/leverage/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/leverage/types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAIpE,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,GAAG,GAAG,oBAA0B,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAY,CAAC;AAErC,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAU,CAAC;AAEtD,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,8BAA8B;AAC9B,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC5E,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,GAAG,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA6C;IAChF,OAAO,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/leverage/types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAIpE,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,GAAG,GAAG,oBAA0B,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAY,CAAC;AAErC,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAU,CAAC;AAEtD,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,8BAA8B;AAC9B,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC5E,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,GAAG,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA6C;IAChF,OAAO,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAoKD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,QAAQ,CAAS;IACjB,MAAM,CAAS;IACf,cAAc,CAAS;IACvB,IAAI,CAAiB;IAE9B,YAAY,MAKX;QACC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7D,KAAK,CACH,wBAAwB,MAAM,CAAC,IAAI,cAAc,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CACvG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF"}

package/package.json

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

package/src/abi/full/OracleUpdaterRouter.ts

@@ -319,6 +319,51 @@ export const ORACLEUPDATERROUTER_ABI = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "index",
+        "type": "uint256"
+      }
+    ],
+    "name": "getPublisherAt",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "getPublisherCount",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "getPublishers",
+    "outputs": [
+      {
+        "internalType": "address[]",
+        "name": "",
+        "type": "address[]"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
@@ -402,7 +447,7 @@ export const ORACLEUPDATERROUTER_ABI = [
     "inputs": [
       {
         "internalType": "address",
-        "name": "",
+        "name": "publisher",
         "type": "address"
       }
     ],

package/src/actions/oracleUpdaterRouter.ts

@@ -267,6 +267,57 @@ export async function readIsPublisher(params: {
   return result as boolean;
 }
 
+/**
+ * Return all current publishers on the OracleUpdaterRouter.
+ *
+ * Reads from the on-chain EnumerableSet — no event scanning required.
+ */
+export async function readOracleUpdaterRouterPublishers(params: {
+  publicClient: Pick<PublicClient, "readContract">;
+  routerAddress: Address;
+}): Promise<readonly Address[]> {
+  const result = await params.publicClient.readContract({
+    address: params.routerAddress,
+    abi: abis.ORACLEUPDATERROUTER_ABI,
+    functionName: "getPublishers",
+    args: [],
+  });
+  return result as readonly Address[];
+}
+
+/**
+ * Return the number of current publishers on the OracleUpdaterRouter.
+ */
+export async function readOracleUpdaterRouterPublisherCount(params: {
+  publicClient: Pick<PublicClient, "readContract">;
+  routerAddress: Address;
+}): Promise<bigint> {
+  const result = await params.publicClient.readContract({
+    address: params.routerAddress,
+    abi: abis.ORACLEUPDATERROUTER_ABI,
+    functionName: "getPublisherCount",
+    args: [],
+  });
+  return BigInt(result as bigint);
+}
+
+/**
+ * Return the publisher at the given index on the OracleUpdaterRouter.
+ */
+export async function readOracleUpdaterRouterPublisherAt(params: {
+  publicClient: Pick<PublicClient, "readContract">;
+  routerAddress: Address;
+  index: bigint;
+}): Promise<Address> {
+  const result = await params.publicClient.readContract({
+    address: params.routerAddress,
+    abi: abis.ORACLEUPDATERROUTER_ABI,
+    functionName: "getPublisherAt",
+    args: [params.index],
+  });
+  return result as Address;
+}
+
 /** Change the AccessManager authority for OracleUpdaterRouter. */
 export async function prepareOracleUpdaterRouterSetAuthority(params: {
   publicClient: { simulateContract: (args: any) => Promise<any> };

package/src/leverage/deleverageExecute.ts

@@ -12,6 +12,7 @@ import type { Address, PublicClient, WalletClient } from "viem";
 import { prepareCoreRepay, prepareCoreWithdraw } from "../actions/core.js";
 import { sendTx } from "../actions/tx.js";
 import type { DeleveragePlan, DeleverageStep, SellResult } from "./types.js";
+import { SlippageExceededError } from "./types.js";
 
 export type OnDeleverageProgress = (info: {
   completed: number;
@@ -33,6 +34,12 @@ export type RunDeleverageLoopParams = {
   onSellStep: (step: Extract<DeleverageStep, { kind: "sell" }>) => Promise<SellResult>;
   onProgress?: OnDeleverageProgress;
   confirmations?: number;
+  /**
+   * Maximum acceptable slippage for sell fills (bps).
+   * If `actualCollateral < expectedCollateral * (10_000 - maxSlippageBps) / 10_000`,
+   * the loop aborts with a `SlippageExceededError`.
+   */
+  maxSlippageBps?: bigint;
 };
 
 export type RunDeleverageLoopResult = {
@@ -54,6 +61,7 @@ export async function runDeleverageLoop(
     onSellStep,
     onProgress,
     confirmations = 1,
+    maxSlippageBps,
   } = params;
 
   const total = plan.steps.length;
@@ -80,6 +88,20 @@ export async function runDeleverageLoop(
 
       if (step.kind === "sell") {
         const res = await onSellStep(step);
+
+        // Slippage guard: reject fills that deviate too far from expected.
+        if (maxSlippageBps !== undefined && step.expectedCollateral > 0n) {
+          const minAcceptable = (step.expectedCollateral * (10_000n - maxSlippageBps)) / 10_000n;
+          if (res.actualCollateral < minAcceptable) {
+            throw new SlippageExceededError({
+              expected: step.expectedCollateral,
+              actual: res.actualCollateral,
+              maxSlippageBps,
+              side: "sell",
+            });
+          }
+        }
+
         lastSellActualCollateral = res.actualCollateral;
         onProgress?.({ completed: i + 1, total, step, sellResult: res });
         continue;

package/src/leverage/execute.ts

@@ -19,6 +19,7 @@ import type {
   LeverageStepResult,
   OnLeverageProgress,
 } from "./types.js";
+import { SlippageExceededError } from "./types.js";
 
 // ---------------------------------------------------------------------------
 // Types
@@ -48,6 +49,12 @@ export type RunLeverageLoopParams = {
   onProgress?: OnLeverageProgress;
   /** Number of block confirmations to wait per tx (default: 1). */
   confirmations?: number;
+  /**
+   * Maximum acceptable slippage for buy fills (bps).
+   * If `actualTokens < expectedTokens * (10_000 - maxSlippageBps) / 10_000`,
+   * the loop aborts with a `SlippageExceededError`.
+   */
+  maxSlippageBps?: bigint;
 };
 
 export type RunLeverageLoopResult = {
@@ -92,6 +99,7 @@ export async function runLeverageLoop(
     onBuyStep,
     onProgress,
     confirmations = 1,
+    maxSlippageBps,
   } = params;
 
   const results: LeverageStepResult[] = [];
@@ -106,6 +114,20 @@ export async function runLeverageLoop(
     try {
       if (step.kind === "buy") {
         const buyResult = await onBuyStep(step);
+
+        // Slippage guard: reject fills that deviate too far from expected.
+        if (maxSlippageBps !== undefined && step.expectedTokens > 0n) {
+          const minAcceptable = (step.expectedTokens * (10_000n - maxSlippageBps)) / 10_000n;
+          if (buyResult.actualTokens < minAcceptable) {
+            throw new SlippageExceededError({
+              expected: step.expectedTokens,
+              actual: buyResult.actualTokens,
+              maxSlippageBps,
+              side: "buy",
+            });
+          }
+        }
+
         lastBuyActualTokens = buyResult.actualTokens;
 
         const result: LeverageStepResult = { step, buyResult };

package/src/leverage/index.ts

@@ -84,5 +84,6 @@ export {
   DEFAULT_MIN_STEP_COLLATERAL,
   PRICE_E8,
   pow10,
+  SlippageExceededError,
   WAD,
 } from "./types.js";