defi-dash-sdk 0.1.3 → 0.1.4

package/dist/strategies/leverage-preview.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * DeFi Dash SDK - Leverage Preview
+ *
+ * Pure-calculation module for previewing a leveraged position without executing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewLeverage = previewLeverage;
+const sdk_ts_1 = require("@7kprotocol/sdk-ts");
+const types_1 = require("../types");
+const flash_loan_1 = require("../protocols/scallop/flash-loan");
+const utils_1 = require("../utils");
+const calculations_1 = require("../utils/calculations");
+const errors_1 = require("../utils/errors");
+// ── Main function ────────────────────────────────────────────────────────────
+/**
+ * Calculate a full leverage-position preview.
+ *
+ * Includes risk params, APY breakdown, flash-loan fee (on-chain),
+ * and swap slippage from a live 7k quote.
+ */
+async function previewLeverage(params, deps) {
+    const { coinType, multiplier } = params;
+    const { protocol, swapClient, suiClient } = deps;
+    // ── Input validation ───────────────────────────────────────────────────────
+    if (!params.depositAmount && !params.depositValueUsd) {
+        throw new errors_1.InvalidParameterError("Either depositAmount or depositValueUsd must be provided");
+    }
+    if (params.depositAmount && params.depositValueUsd) {
+        throw new errors_1.InvalidParameterError("Cannot provide both depositAmount and depositValueUsd. Choose one.");
+    }
+    const decimals = (0, utils_1.getDecimals)(coinType);
+    // ── Risk parameters ────────────────────────────────────────────────────────
+    const riskParams = await protocol.getAssetRiskParams(coinType);
+    if (multiplier > riskParams.maxMultiplier) {
+        throw new errors_1.InvalidParameterError(`Multiplier ${multiplier}x exceeds protocol max ${riskParams.maxMultiplier.toFixed(2)}x`);
+    }
+    // ── Deposit amount resolution ──────────────────────────────────────────────
+    let depositAmountStr;
+    const price = await (0, sdk_ts_1.getTokenPrice)(coinType);
+    if (params.depositValueUsd) {
+        const amountInToken = params.depositValueUsd / price;
+        depositAmountStr = amountInToken.toFixed(decimals);
+    }
+    else {
+        depositAmountStr = params.depositAmount;
+    }
+    const depositAmount = (0, utils_1.parseUnits)(depositAmountStr, decimals);
+    const depositAmountHuman = Number(depositAmount) / Math.pow(10, decimals);
+    const initialEquityUsd = depositAmountHuman * price;
+    // ── Flash loan calculation ─────────────────────────────────────────────────
+    const flashLoanUsd = initialEquityUsd * (multiplier - 1);
+    const flashLoanUsdc = BigInt(Math.ceil(flashLoanUsd * 1e6));
+    const flashLoanFeeRate = await flash_loan_1.ScallopFlashLoanClient.fetchFlashLoanFeeRate(suiClient, types_1.COIN_TYPES.USDC);
+    const flashLoanFeeUsd = (Number(flashLoanUsdc) / 1e6) * flashLoanFeeRate;
+    const totalPositionUsd = initialEquityUsd * multiplier;
+    const debtUsd = flashLoanUsd + flashLoanFeeUsd;
+    const ltvPercent = (debtUsd / totalPositionUsd) * 100;
+    // ── Liquidation ────────────────────────────────────────────────────────────
+    const totalCollateralAmount = depositAmountHuman * multiplier;
+    const { liquidationPrice, priceDropBuffer } = (0, calculations_1.calculateLiquidationMetrics)(debtUsd, totalCollateralAmount, riskParams.liquidationThreshold, price);
+    // ── APY & Earnings ─────────────────────────────────────────────────────────
+    const depositApy = await protocol.getAssetApy(coinType);
+    const usdcCoinType = types_1.COIN_TYPES.USDC;
+    const borrowApyData = await protocol.getAssetApy(usdcCoinType);
+    const annualSupplyEarnings = totalPositionUsd * depositApy.totalSupplyApy;
+    const annualBorrowCost = debtUsd * borrowApyData.borrowApy;
+    const annualNetEarningsUsd = annualSupplyEarnings - annualBorrowCost;
+    const netApy = initialEquityUsd > 0 ? annualNetEarningsUsd / initialEquityUsd : 0;
+    // ── Swap slippage (7k quote) ───────────────────────────────────────────────
+    let swapSlippagePct = 1.0;
+    let effectiveMultiplier = multiplier;
+    const swapQuotes = await swapClient.quote({
+        amountIn: flashLoanUsdc.toString(),
+        coinTypeIn: types_1.COIN_TYPES.USDC,
+        coinTypeOut: coinType,
+    });
+    if (swapQuotes.length > 0) {
+        const bestQuote = [...swapQuotes].sort((a, b) => Number(b.amountOut) - Number(a.amountOut))[0];
+        const actualAmountOut = Number(bestQuote.amountOut) / Math.pow(10, decimals);
+        const theoreticalAmountOut = Number(flashLoanUsdc) / 1e6 / price;
+        if (theoreticalAmountOut > 0) {
+            const slippageRatio = (theoreticalAmountOut - actualAmountOut) / theoreticalAmountOut;
+            swapSlippagePct = Math.max(0, slippageRatio * 100);
+        }
+        const actualTotalToken = depositAmountHuman + actualAmountOut;
+        effectiveMultiplier =
+            actualAmountOut > 0
+                ? actualTotalToken / depositAmountHuman
+                : multiplier;
+    }
+    return {
+        initialEquityUsd,
+        flashLoanUsdc,
+        flashLoanFeeUsd,
+        totalPositionUsd,
+        debtUsd,
+        effectiveMultiplier,
+        maxMultiplier: riskParams.maxMultiplier,
+        assetLtv: riskParams.ltv,
+        ltvPercent,
+        liquidationThreshold: riskParams.liquidationThreshold,
+        liquidationPrice,
+        priceDropBuffer,
+        supplyApyBreakdown: {
+            base: depositApy.supplyApy,
+            reward: depositApy.rewardApy,
+            total: depositApy.totalSupplyApy,
+        },
+        borrowApyBreakdown: {
+            gross: borrowApyData.borrowApy + borrowApyData.borrowRewardApy,
+            rebate: borrowApyData.borrowRewardApy,
+            net: borrowApyData.borrowApy,
+        },
+        netApy,
+        annualNetEarningsUsd,
+        swapSlippagePct,
+    };
+}
+//# sourceMappingURL=leverage-preview.js.map

package/dist/strategies/leverage-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leverage-preview.js","sourceRoot":"","sources":["../../src/strategies/leverage-preview.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAqCH,0CA0IC;AA5KD,+CAA2D;AAC3D,oCAIkB;AAClB,gEAAyE;AACzE,oCAAmD;AACnD,wDAAoE;AACpE,4CAAwD;AAiBxD,gFAAgF;AAEhF;;;;;GAKG;AACI,KAAK,UAAU,eAAe,CACnC,MAA6B,EAC7B,IAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IACxC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEjD,8EAA8E;IAC9E,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QACrD,MAAM,IAAI,8BAAqB,CAC7B,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACnD,MAAM,IAAI,8BAAqB,CAC7B,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,QAAQ,CAAC,CAAC;IAEvC,8EAA8E;IAC9E,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE/D,IAAI,UAAU,GAAG,UAAU,CAAC,aAAa,EAAE,CAAC;QAC1C,MAAM,IAAI,8BAAqB,CAC7B,cAAc,UAAU,0BAA0B,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACzF,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,IAAI,gBAAwB,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,IAAA,sBAAa,EAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC;QACrD,gBAAgB,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,gBAAgB,GAAG,MAAM,CAAC,aAAc,CAAC;IAC3C,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,kBAAU,EAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,kBAAkB,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1E,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,KAAK,CAAC;IAEpD,8EAA8E;IAC9E,MAAM,YAAY,GAAG,gBAAgB,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC;IAE5D,MAAM,gBAAgB,GAAG,MAAM,mCAAsB,CAAC,qBAAqB,CACzE,SAAS,EACT,kBAAU,CAAC,IAAI,CAChB,CAAC;IACF,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,GAAG,gBAAgB,CAAC;IAEzE,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,UAAU,CAAC;IACvD,MAAM,OAAO,GAAG,YAAY,GAAG,eAAe,CAAC;IAC/C,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,gBAAgB,CAAC,GAAG,GAAG,CAAC;IAEtD,8EAA8E;IAC9E,MAAM,qBAAqB,GAAG,kBAAkB,GAAG,UAAU,CAAC;IAC9D,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,IAAA,0CAA2B,EACvE,OAAO,EACP,qBAAqB,EACrB,UAAU,CAAC,oBAAoB,EAC/B,KAAK,CACN,CAAC;IAEF,8EAA8E;IAC9E,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAExD,MAAM,YAAY,GAAG,kBAAU,CAAC,IAAI,CAAC;IACrC,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAE/D,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,UAAU,CAAC,cAAc,CAAC;IAC1E,MAAM,gBAAgB,GAAG,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3D,MAAM,oBAAoB,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;IACrE,MAAM,MAAM,GACV,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAErE,8EAA8E;IAC9E,IAAI,eAAe,GAAG,GAAG,CAAC;IAC1B,IAAI,mBAAmB,GAAG,UAAU,CAAC;IAErC,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC;QACxC,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;QAClC,UAAU,EAAE,kBAAU,CAAC,IAAI;QAC3B,WAAW,EAAE,QAAQ;KACtB,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CACpC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAC9D,CAAC,CAAC,CAAC,CAAC;QAEL,MAAM,eAAe,GACnB,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,oBAAoB,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC;QAEjE,IAAI,oBAAoB,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,aAAa,GACjB,CAAC,oBAAoB,GAAG,eAAe,CAAC,GAAG,oBAAoB,CAAC;YAClE,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,CAAC;QAC9D,mBAAmB;YACjB,eAAe,GAAG,CAAC;gBACjB,CAAC,CAAC,gBAAgB,GAAG,kBAAkB;gBACvC,CAAC,CAAC,UAAU,CAAC;IACnB,CAAC;IAED,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,eAAe;QACf,gBAAgB;QAChB,OAAO;QACP,mBAAmB;QACnB,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,QAAQ,EAAE,UAAU,CAAC,GAAG;QACxB,UAAU;QACV,oBAAoB,EAAE,UAAU,CAAC,oBAAoB;QACrD,gBAAgB;QAChB,eAAe;QACf,kBAAkB,EAAE;YAClB,IAAI,EAAE,UAAU,CAAC,SAAS;YAC1B,MAAM,EAAE,UAAU,CAAC,SAAS;YAC5B,KAAK,EAAE,UAAU,CAAC,cAAc;SACjC;QACD,kBAAkB,EAAE;YAClB,KAAK,EAAE,aAAa,CAAC,SAAS,GAAG,aAAa,CAAC,eAAe;YAC9D,MAAM,EAAE,aAAa,CAAC,eAAe;YACrC,GAAG,EAAE,aAAa,CAAC,SAAS;SAC7B;QACD,MAAM;QACN,oBAAoB;QACpB,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/strategies/leverage-route.d.ts

@@ -0,0 +1,29 @@
+/**
+ * DeFi Dash SDK - Leverage Route Finder
+ *
+ * Discovers the best protocol for leverage given an asset,
+ * comparing maxMultiplier and net APY across all initialized protocols.
+ */
+import { LendingProtocol, ILendingProtocol, LeveragePreview, LeverageRouteResult, FindBestRouteParams } from "../types";
+export interface FindBestRouteDeps {
+    /** Map of all initialized protocol adapters */
+    protocols: Map<LendingProtocol, ILendingProtocol>;
+    /** Function to call previewLeverage for a given protocol + params */
+    previewFn: (protocol: LendingProtocol, params: {
+        depositAsset: string;
+        depositAmount?: string;
+        depositValueUsd?: number;
+        multiplier: number;
+    }) => Promise<LeveragePreview>;
+    /** Resolve asset symbol to coin type */
+    resolveCoinType: (asset: string) => string;
+}
+/**
+ * Find the best leverage route across all initialized protocols.
+ *
+ * Returns two recommendations:
+ * 1. **bestMaxMultiplier** — the protocol offering the highest possible leverage
+ * 2. **bestApy** — the protocol with the highest net APY at a safe multiplier
+ */
+export declare function findBestLeverageRoute(params: FindBestRouteParams, deps: FindBestRouteDeps): Promise<LeverageRouteResult>;
+//# sourceMappingURL=leverage-route.d.ts.map

package/dist/strategies/leverage-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leverage-route.d.ts","sourceRoot":"","sources":["../../src/strategies/leverage-route.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAWlB,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,SAAS,EAAE,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAClD,qEAAqE;IACrE,SAAS,EAAE,CACT,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,KACE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,wCAAwC;IACxC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAID;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,mBAAmB,CAAC,CA0I9B"}

package/dist/strategies/leverage-route.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * DeFi Dash SDK - Leverage Route Finder
+ *
+ * Discovers the best protocol for leverage given an asset,
+ * comparing maxMultiplier and net APY across all initialized protocols.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findBestLeverageRoute = findBestLeverageRoute;
+const types_1 = require("../types");
+const errors_1 = require("../utils/errors");
+/** Safety margin subtracted from maxMultiplier when requesting a near-max preview */
+const MAX_MULT_SAFETY_MARGIN = 0.01;
+/** Minimum safe multiplier floor (below this leverage has negligible effect) */
+const MIN_SAFE_MULTIPLIER = 1.1;
+// ── Main function ────────────────────────────────────────────────────────────
+/**
+ * Find the best leverage route across all initialized protocols.
+ *
+ * Returns two recommendations:
+ * 1. **bestMaxMultiplier** — the protocol offering the highest possible leverage
+ * 2. **bestApy** — the protocol with the highest net APY at a safe multiplier
+ */
+async function findBestLeverageRoute(params, deps) {
+    // ── Input validation ───────────────────────────────────────────────────────
+    if (!params.depositAmount && !params.depositValueUsd) {
+        throw new errors_1.InvalidParameterError("Either depositAmount or depositValueUsd must be provided");
+    }
+    if (params.depositAmount && params.depositValueUsd) {
+        throw new errors_1.InvalidParameterError("Cannot provide both depositAmount and depositValueUsd. Choose one.");
+    }
+    const coinType = deps.resolveCoinType(params.depositAsset);
+    const allProtocols = Array.from(deps.protocols.keys());
+    // ── Phase 1: Risk params (lightweight) ─────────────────────────────────────
+    const riskResults = await Promise.allSettled(allProtocols.map((protocol) => deps.protocols
+        .get(protocol)
+        .getAssetRiskParams(coinType)
+        .then((riskParams) => ({ protocol, riskParams }))));
+    const successfulRisk = [];
+    const failedProtocols = [];
+    riskResults.forEach((result, i) => {
+        if (result.status === "fulfilled") {
+            successfulRisk.push(result.value);
+        }
+        else {
+            failedProtocols.push({
+                protocol: allProtocols[i],
+                error: result.reason?.message || String(result.reason),
+            });
+        }
+    });
+    if (successfulRisk.length === 0) {
+        throw new errors_1.InvalidParameterError(`No protocol supports asset "${params.depositAsset}" for leverage. ` +
+            `Errors: ${failedProtocols.map((f) => `${f.protocol}: ${f.error}`).join("; ")}`);
+    }
+    // ── Safe multiplier ────────────────────────────────────────────────────────
+    const minMaxMultiplier = Math.min(...successfulRisk.map((r) => r.riskParams.maxMultiplier));
+    const safeMultiplier = Math.max(MIN_SAFE_MULTIPLIER, minMaxMultiplier - types_1.LEVERAGE_MULTIPLIER_BUFFER);
+    // ── Best max-multiplier protocol ───────────────────────────────────────────
+    const bestMaxEntry = successfulRisk.reduce((best, curr) => curr.riskParams.maxMultiplier > best.riskParams.maxMultiplier
+        ? curr
+        : best);
+    // ── Phase 2: Previews ─────────────────────────────────────────────────────
+    const maxMultPreviewPromise = deps.previewFn(bestMaxEntry.protocol, {
+        depositAsset: params.depositAsset,
+        depositAmount: params.depositAmount,
+        depositValueUsd: params.depositValueUsd,
+        multiplier: Math.round((bestMaxEntry.riskParams.maxMultiplier - MAX_MULT_SAFETY_MARGIN) * 100) / 100,
+    });
+    const safePreviewResults = await Promise.allSettled(successfulRisk.map(({ protocol }) => deps
+        .previewFn(protocol, {
+        depositAsset: params.depositAsset,
+        depositAmount: params.depositAmount,
+        depositValueUsd: params.depositValueUsd,
+        multiplier: safeMultiplier,
+    })
+        .then((preview) => ({ protocol, preview }))));
+    const safeSuccessful = [];
+    safePreviewResults.forEach((result, i) => {
+        if (result.status === "fulfilled") {
+            safeSuccessful.push(result.value);
+        }
+        else {
+            failedProtocols.push({
+                protocol: successfulRisk[i].protocol,
+                error: `Failed at safe multiplier ${safeMultiplier}x: ${result.reason?.message}`,
+            });
+        }
+    });
+    if (safeSuccessful.length === 0) {
+        throw new errors_1.InvalidParameterError(`No protocol could preview at safe multiplier ${safeMultiplier}x for "${params.depositAsset}"`);
+    }
+    // ── Best APY protocol ──────────────────────────────────────────────────────
+    const bestApyEntry = safeSuccessful.reduce((best, curr) => curr.preview.netApy > best.preview.netApy ? curr : best);
+    const maxMultPreview = await maxMultPreviewPromise;
+    return {
+        bestMaxMultiplier: {
+            protocol: bestMaxEntry.protocol,
+            multiplier: Math.round((bestMaxEntry.riskParams.maxMultiplier - MAX_MULT_SAFETY_MARGIN) * 100) / 100,
+            preview: maxMultPreview,
+        },
+        bestApy: {
+            protocol: bestApyEntry.protocol,
+            multiplier: safeMultiplier,
+            preview: bestApyEntry.preview,
+        },
+        safeMultiplier,
+        allPreviews: safeSuccessful,
+        failedProtocols,
+    };
+}
+//# sourceMappingURL=leverage-route.js.map

package/dist/strategies/leverage-route.js.map

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

package/dist/strategies/leverage.d.ts

@@ -6,7 +6,7 @@
 import { Transaction } from "@mysten/sui/transactions";
 import { SuiClient } from "@mysten/sui/client";
 import { MetaAg } from "@7kprotocol/sdk-ts";
-import { ILendingProtocol, LeveragePreview } from "../types";
+import { ILendingProtocol } from "../types";
 import { ScallopFlashLoanClient } from "../protocols/scallop/flash-loan";
 export interface LeverageBuildParams {
     protocol: ILendingProtocol;
@@ -18,46 +18,6 @@ export interface LeverageBuildParams {
     depositAmount: bigint;
     multiplier: number;
 }
-/**
- * Calculate leverage position preview without executing
- *
- * Computes expected position metrics including flash loan amount,
- * total position value, LTV, and liquidation parameters.
- *
- * @param params - Preview calculation parameters
- * @param params.depositCoinType - Full coin type of deposit asset
- * @param params.depositAmount - Deposit amount in raw units (bigint)
- * @param params.multiplier - Target leverage multiplier (e.g., 2.0 for 2x)
- *
- * @returns Preview containing position metrics and risk parameters
- *
- * @example
- * ```typescript
- * const preview = await calculateLeveragePreview({
- *   depositCoinType: '0x2::sui::SUI',
- *   depositAmount: 1000000000n,  // 1 SUI
- *   multiplier: 2.0
- * });
- *
- * console.log(`Flash loan needed: ${preview.flashLoanUsdc / 1e6} USDC`);
- * console.log(`Total position: $${preview.totalPositionUsd}`);
- * console.log(`LTV: ${preview.ltvPercent}%`);
- * ```
- *
- * @remarks
- * - Fetches current market prices from 7k Protocol
- * - Assumes 60% LTV threshold for liquidation calculations
- * - Adds 2% buffer to flash loan amount for safety
- *
- * @note This function is intentionally placed here as it's tightly coupled
- * with the leverage strategy logic. Consider moving to a separate preview
- * module if reuse across strategies is needed.
- */
-export declare function calculateLeveragePreview(params: {
-    depositCoinType: string;
-    depositAmount: bigint;
-    multiplier: number;
-}): Promise<LeveragePreview>;
 /**
  * Build leverage transaction as a Programmable Transaction Block (PTB)
  *
@@ -65,9 +25,9 @@ export declare function calculateLeveragePreview(params: {
  *
  * **Transaction Flow:**
  * 1. Borrow USDC via flash loan from Scallop
- * 2. Swap USDC to deposit asset via 7k Protocol aggregator
- * 3. Merge user's deposit with swapped amount
- * 4. Refresh protocol oracles
+ * 2. Refresh protocol oracles (before swap to avoid Pyth conflicts)
+ * 3. Swap USDC to deposit asset via 7k Protocol aggregator
+ * 4. Merge user's deposit with swapped amount
  * 5. Deposit total collateral to lending protocol
  * 6. Borrow USDC from protocol to repay flash loan
  * 7. Repay flash loan (transaction fails if not repaid)

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

@@ -1 +1 @@
-{"version":3,"file":"leverage.d.ts","sourceRoot":"","sources":["../../src/strategies/leverage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAEhB,eAAe,EAGhB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAIzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,eAAe,EAAE,sBAAsB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA+If"}
+{"version":3,"file":"leverage.d.ts","sourceRoot":"","sources":["../../src/strategies/leverage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAGjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAIzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,eAAe,EAAE,sBAAsB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0If"}

package/dist/strategies/leverage.js

@@ -5,76 +5,11 @@
  * Builds leverage transactions using flash loan + swap + deposit + borrow
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateLeveragePreview = calculateLeveragePreview;
 exports.buildLeverageTransaction = buildLeverageTransaction;
 const sdk_ts_1 = require("@7kprotocol/sdk-ts");
 const types_1 = require("../types");
 const utils_1 = require("../utils");
-const constants_1 = require("../protocols/suilend/constants");
-/**
- * Calculate leverage position preview without executing
- *
- * Computes expected position metrics including flash loan amount,
- * total position value, LTV, and liquidation parameters.
- *
- * @param params - Preview calculation parameters
- * @param params.depositCoinType - Full coin type of deposit asset
- * @param params.depositAmount - Deposit amount in raw units (bigint)
- * @param params.multiplier - Target leverage multiplier (e.g., 2.0 for 2x)
- *
- * @returns Preview containing position metrics and risk parameters
- *
- * @example
- * ```typescript
- * const preview = await calculateLeveragePreview({
- *   depositCoinType: '0x2::sui::SUI',
- *   depositAmount: 1000000000n,  // 1 SUI
- *   multiplier: 2.0
- * });
- *
- * console.log(`Flash loan needed: ${preview.flashLoanUsdc / 1e6} USDC`);
- * console.log(`Total position: $${preview.totalPositionUsd}`);
- * console.log(`LTV: ${preview.ltvPercent}%`);
- * ```
- *
- * @remarks
- * - Fetches current market prices from 7k Protocol
- * - Assumes 60% LTV threshold for liquidation calculations
- * - Adds 2% buffer to flash loan amount for safety
- *
- * @note This function is intentionally placed here as it's tightly coupled
- * with the leverage strategy logic. Consider moving to a separate preview
- * module if reuse across strategies is needed.
- */
-async function calculateLeveragePreview(params) {
-    const { depositCoinType, depositAmount, multiplier } = params;
-    const normalized = (0, utils_1.normalizeCoinType)(depositCoinType);
-    const reserve = (0, constants_1.getReserveByCoinType)(normalized);
-    const decimals = reserve?.decimals || 8;
-    const depositPrice = await (0, sdk_ts_1.getTokenPrice)(normalized);
-    const depositAmountHuman = Number(depositAmount) / Math.pow(10, decimals);
-    const initialEquityUsd = depositAmountHuman * depositPrice;
-    // Flash loan amount = Initial Equity * (Multiplier - 1)
-    const flashLoanUsd = initialEquityUsd * (multiplier - 1);
-    const flashLoanUsdc = BigInt(Math.ceil(flashLoanUsd * 1e6 * 1.02)); // 2% buffer
-    const totalPositionUsd = initialEquityUsd * multiplier;
-    const debtUsd = flashLoanUsd;
-    const ltvPercent = (debtUsd / totalPositionUsd) * 100;
-    // Assume 60% LTV for liquidation calculation
-    const LTV = 0.6;
-    const liquidationPrice = debtUsd / (depositAmountHuman * multiplier) / LTV;
-    const priceDropBuffer = (1 - liquidationPrice / depositPrice) * 100;
-    return {
-        initialEquityUsd,
-        flashLoanUsdc,
-        totalPositionUsd,
-        debtUsd,
-        effectiveMultiplier: multiplier,
-        ltvPercent,
-        liquidationPrice,
-        priceDropBuffer,
-    };
-}
+const common_1 = require("./common");
 /**
  * Build leverage transaction as a Programmable Transaction Block (PTB)
  *
@@ -82,9 +17,9 @@ async function calculateLeveragePreview(params) {
  *
  * **Transaction Flow:**
  * 1. Borrow USDC via flash loan from Scallop
- * 2. Swap USDC to deposit asset via 7k Protocol aggregator
- * 3. Merge user's deposit with swapped amount
- * 4. Refresh protocol oracles
+ * 2. Refresh protocol oracles (before swap to avoid Pyth conflicts)
+ * 3. Swap USDC to deposit asset via 7k Protocol aggregator
+ * 4. Merge user's deposit with swapped amount
  * 5. Deposit total collateral to lending protocol
  * 6. Borrow USDC from protocol to repay flash loan
  * 7. Repay flash loan (transaction fails if not repaid)
@@ -136,37 +71,30 @@ async function buildLeverageTransaction(tx, params) {
     // These cannot be used as collateral because we borrow USDC to repay the flash loan
     const normalizedDeposit = (0, utils_1.normalizeCoinType)(depositCoinType);
     if (types_1.UNSUPPORTED_COIN_TYPES.includes(normalizedDeposit)) {
-        // Check ❌: What about listing errors like solidity contract styles to avoid gerneral error message or using enum for erros.
+        // TODO(#6): Use typed UnsupportedAssetError instead of generic Error
         throw new Error(`Unsupported deposit asset for leverage strategy. Stablecoins like USDC cannot be used as collateral.`);
     }
-    // Use SDK-level COIN_DECIMALS for decimal info, fallback to reserve lookup
-    // TODO: Future improvement - make protocol adapters provide decimal info
     const normalized = normalizedDeposit;
-    const reserve = (0, constants_1.getReserveByCoinType)(normalized);
-    const decimals = types_1.COIN_DECIMALS[normalized] ?? reserve?.decimals ?? 8;
-    // Calculate preview to get flash loan amount
-    const preview = await calculateLeveragePreview({
-        depositCoinType: normalized,
-        depositAmount,
-        multiplier,
-    });
-    const flashLoanUsdc = preview.flashLoanUsdc;
+    const decimals = (0, utils_1.getDecimals)(normalized);
+    // Calculate flash loan amount directly
+    const depositPrice = await (0, sdk_ts_1.getTokenPrice)(normalized);
+    const initialEquityUsd = (Number(depositAmount) / 10 ** decimals) * depositPrice;
+    const flashLoanUsdc = BigInt(Math.ceil(initialEquityUsd * (multiplier - 1) * 1e6));
     // 1. Flash loan USDC from Scallop
-    // TODO: Support other flash loan assets (USDT) in the future
+    // TODO(#7): Support other flash loan assets (USDT) in the future
     const FLASH_LOAN_ASSET = "usdc";
     const [loanCoin, receipt] = flashLoanClient.borrowFlashLoan(tx, flashLoanUsdc, FLASH_LOAN_ASSET);
-    // 2. Swap USDC → deposit asset
+    // 2. Refresh oracles BEFORE swap to avoid Pyth hot potato conflicts.
+    // The 7k swap may add Pyth oracle update commands for DEX routing.
+    // If refreshOracles also adds Pyth updates for the same feeds AFTER
+    // the swap, both create Pyth hot potatoes for the same price feeds,
+    // causing dynamic_field::add abort. Refreshing first ensures the
+    // protocol's Pyth lifecycle completes before the swap starts.
+    await protocol.refreshOracles(tx, [normalized, types_1.USDC_COIN_TYPE], userAddress);
+    // 3. Swap USDC → deposit asset
     // Note: Stablecoins are already rejected above, so swap is always needed
-    const swapQuotes = await swapClient.quote({
-        amountIn: flashLoanUsdc.toString(),
-        coinTypeIn: types_1.USDC_COIN_TYPE,
-        coinTypeOut: normalized,
-    });
-    if (swapQuotes.length === 0) {
-        throw new Error(`No swap quotes found for USDC → ${reserve?.symbol ?? normalized}`);
-    }
-    const bestQuote = swapQuotes.sort((a, b) => Number(b.amountOut) - Number(a.amountOut))[0];
-    // TODO: Make slippage configurable via leverage params
+    const { quote: bestQuote } = await (0, common_1.findBestSwapQuote)(swapClient, flashLoanUsdc.toString(), types_1.USDC_COIN_TYPE, normalized, `USDC \u2192 ${normalized.split("::").pop() ?? normalized}`);
+    // TODO(#8): Make slippage configurable via leverage params
     const SLIPPAGE_BPS = 100; // 1%
     const swappedAsset = await swapClient.swap({
         quote: bestQuote,
@@ -174,29 +102,36 @@ async function buildLeverageTransaction(tx, params) {
         coinIn: loanCoin,
         tx: tx,
     }, SLIPPAGE_BPS);
-    // 3. Prepare deposit coin (merge user's asset with swapped)
+    // 4. Prepare deposit coin (merge user's asset with swapped)
     let depositCoin;
     const isSui = normalized.endsWith("::sui::SUI");
     if (isSui) {
         // For SUI: swappedAsset is already Coin<SUI> from swap
         // Split user's deposit from gas and merge INTO swapped asset
-        // TODO: Optimize SUI handling - consider checking balance first
+        // TODO(#9): Optimize SUI handling - consider checking balance first
         const [userDeposit] = tx.splitCoins(tx.gas, [tx.pure.u64(depositAmount)]);
         tx.mergeCoins(swappedAsset, [userDeposit]);
         depositCoin = swappedAsset;
     }
     else {
-        // For non-SUI: fetch user's coins, merge, split exact amount
-        const userCoins = await suiClient.getCoins({
-            owner: userAddress,
-            coinType: normalized,
-        });
-        if (userCoins.data.length === 0) {
-            throw new Error(`No ${reserve?.symbol} coins found in wallet`);
+        // For non-SUI: fetch ALL user's coins (paginated), merge, split exact amount
+        const allCoins = [];
+        let cursor = undefined;
+        do {
+            const page = await suiClient.getCoins({
+                owner: userAddress,
+                coinType: normalized,
+                cursor: cursor ?? undefined,
+            });
+            allCoins.push(...page.data);
+            cursor = page.hasNextPage ? page.nextCursor : null;
+        } while (cursor);
+        if (allCoins.length === 0) {
+            throw new Error(`No ${normalized.split("::").pop()} coins found in wallet`);
         }
-        const primaryCoin = tx.object(userCoins.data[0].coinObjectId);
-        if (userCoins.data.length > 1) {
-            const otherCoins = userCoins.data
+        const primaryCoin = tx.object(allCoins[0].coinObjectId);
+        if (allCoins.length > 1) {
+            const otherCoins = allCoins
                 .slice(1)
                 .map((c) => tx.object(c.coinObjectId));
             tx.mergeCoins(primaryCoin, otherCoins);
@@ -208,18 +143,14 @@ async function buildLeverageTransaction(tx, params) {
         tx.mergeCoins(swappedAsset, [userContribution]);
         depositCoin = swappedAsset;
     }
-    // 4. Refresh oracles (required before deposit/borrow operations)
-    await protocol.refreshOracles(tx, [normalized, types_1.USDC_COIN_TYPE], userAddress);
     // 5. Deposit to lending protocol
     await protocol.deposit(tx, depositCoin, normalized, userAddress);
     // 6. Calculate repayment amount (flash loan + fee + borrow interest buffer)
-    // TODO: Consider adding flash loan fee query method to protocol SDK
+    // TODO(#10): Consider adding flash loan fee query method to protocol SDK
     // const flashLoanFee = ScallopFlashLoanClient.calculateFee(flashLoanUsdc);
     const repaymentAmount = flashLoanUsdc;
-    // Add 0.5% buffer for borrow interest that accrues immediately
-    // This ensures we borrow enough to cover the flash loan repayment
-    const BORROW_FEE_BUFFER = 1.005;
-    const borrowAmount = BigInt(Math.ceil(Number(repaymentAmount) * BORROW_FEE_BUFFER));
+    // Add buffer for borrow interest that accrues immediately
+    const borrowAmount = BigInt(Math.ceil(Number(repaymentAmount) * common_1.BORROW_FEE_BUFFER));
     // 7. Borrow USDC to repay flash loan
     const borrowedUsdc = await protocol.borrow(tx, types_1.USDC_COIN_TYPE, borrowAmount.toString(), userAddress, true);
     // 8. Repay flash loan (excess amount is returned to user)

package/dist/strategies/leverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"leverage.js","sourceRoot":"","sources":["../../src/strategies/leverage.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA8DH,4DAsCC;AAyDD,4DAkJC;AA3SD,+CAA2D;AAC3D,oCAMkB;AAElB,oCAA6C;AAC7C,8DAAsE;AAatE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACI,KAAK,UAAU,wBAAwB,CAAC,MAI9C;IACC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAE9D,MAAM,UAAU,GAAG,IAAA,yBAAiB,EAAC,eAAe,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAA,gCAAoB,EAAC,UAAU,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;IAExC,MAAM,YAAY,GAAG,MAAM,IAAA,sBAAa,EAAC,UAAU,CAAC,CAAC;IACrD,MAAM,kBAAkB,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1E,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,YAAY,CAAC;IAE3D,wDAAwD;IACxD,MAAM,YAAY,GAAG,gBAAgB,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY;IAEhF,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,UAAU,CAAC;IACvD,MAAM,OAAO,GAAG,YAAY,CAAC;IAC7B,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,gBAAgB,CAAC,GAAG,GAAG,CAAC;IAEtD,6CAA6C;IAC7C,MAAM,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,gBAAgB,GAAG,OAAO,GAAG,CAAC,kBAAkB,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC;IAC3E,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,gBAAgB,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC;IAEpE,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,gBAAgB;QAChB,OAAO;QACP,mBAAmB,EAAE,UAAU;QAC/B,UAAU;QACV,gBAAgB;QAChB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACI,KAAK,UAAU,wBAAwB,CAC5C,EAAe,EACf,MAA2B;IAE3B,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,UAAU,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,aAAa,EACb,UAAU,GACX,GAAG,MAAM,CAAC;IAEX,+DAA+D;IAC/D,oFAAoF;IACpF,MAAM,iBAAiB,GAAG,IAAA,yBAAiB,EAAC,eAAe,CAAC,CAAC;IAC7D,IAAI,8BAAsB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvD,4HAA4H;QAC5H,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,MAAM,UAAU,GAAG,iBAAiB,CAAC;IACrC,MAAM,OAAO,GAAG,IAAA,gCAAoB,EAAC,UAAU,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,qBAAa,CAAC,UAAU,CAAC,IAAI,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;IAErE,6CAA6C;IAC7C,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC;QAC7C,eAAe,EAAE,UAAU;QAC3B,aAAa;QACb,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE5C,kCAAkC;IAClC,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,MAAe,CAAC;IACzC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,eAAe,CACzD,EAAE,EACF,aAAa,EACb,gBAAgB,CACjB,CAAC;IAEF,+BAA+B;IAC/B,yEAAyE;IACzE,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC;QACxC,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;QAClC,UAAU,EAAE,sBAAc;QAC1B,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,mCAAmC,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CACpD,CAAC,CAAC,CAAC,CAAC;IAEL,uDAAuD;IACvD,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,KAAK;IAC/B,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,IAAI,CACxC;QACE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,QAAQ;QAChB,EAAE,EAAE,EAAE;KACP,EACD,YAAY,CACb,CAAC;IAEF,4DAA4D;IAC5D,IAAI,WAAgB,CAAC;IACrB,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEhD,IAAI,KAAK,EAAE,CAAC;QACV,uDAAuD;QACvD,6DAA6D;QAC7D,gEAAgE;QAChE,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC1E,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3C,WAAW,GAAG,YAAY,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,6DAA6D;QAC7D,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;YACzC,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,UAAU;SACrB,CAAC,CAAC;QAEH,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,MAAM,OAAO,EAAE,MAAM,wBAAwB,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI;iBAC9B,KAAK,CAAC,CAAC,CAAC;iBACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YACzC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;QAED,oDAAoD;QACpD,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE;YACpD,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;SAC3B,CAAC,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAChD,WAAW,GAAG,YAAY,CAAC;IAC7B,CAAC;IAED,iEAAiE;IACjE,MAAM,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,sBAAc,CAAC,EAAE,WAAW,CAAC,CAAC;IAE7E,iCAAiC;IACjC,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAEjE,4EAA4E;IAC5E,oEAAoE;IACpE,2EAA2E;IAC3E,MAAM,eAAe,GAAG,aAAa,CAAC;IAEtC,+DAA+D;IAC/D,kEAAkE;IAClE,MAAM,iBAAiB,GAAG,KAAK,CAAC;IAChC,MAAM,YAAY,GAAG,MAAM,CACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,iBAAiB,CAAC,CACvD,CAAC;IAEF,qCAAqC;IACrC,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,MAAM,CACxC,EAAE,EACF,sBAAc,EACd,YAAY,CAAC,QAAQ,EAAE,EACvB,WAAW,EACX,IAAI,CACL,CAAC;IAEF,0DAA0D;IAC1D,eAAe,CAAC,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"leverage.js","sourceRoot":"","sources":["../../src/strategies/leverage.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAgFH,4DA6IC;AAzND,+CAA2D;AAC3D,oCAIkB;AAElB,oCAA0D;AAC1D,qCAAgE;AAahE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACI,KAAK,UAAU,wBAAwB,CAC5C,EAAe,EACf,MAA2B;IAE3B,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,UAAU,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,aAAa,EACb,UAAU,GACX,GAAG,MAAM,CAAC;IAEX,+DAA+D;IAC/D,oFAAoF;IACpF,MAAM,iBAAiB,GAAG,IAAA,yBAAiB,EAAC,eAAe,CAAC,CAAC;IAC7D,IAAI,8BAAsB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvD,qEAAqE;QACrE,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,UAAU,CAAC,CAAC;IAEzC,uCAAuC;IACvC,MAAM,YAAY,GAAG,MAAM,IAAA,sBAAa,EAAC,UAAU,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,GAAG,YAAY,CAAC;IACjF,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAEnF,kCAAkC;IAClC,iEAAiE;IACjE,MAAM,gBAAgB,GAAG,MAAe,CAAC;IACzC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,eAAe,CACzD,EAAE,EACF,aAAa,EACb,gBAAgB,CACjB,CAAC;IAEF,qEAAqE;IACrE,mEAAmE;IACnE,oEAAoE;IACpE,oEAAoE;IACpE,iEAAiE;IACjE,8DAA8D;IAC9D,MAAM,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,sBAAc,CAAC,EAAE,WAAW,CAAC,CAAC;IAE7E,+BAA+B;IAC/B,yEAAyE;IACzE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,0BAAiB,EAClD,UAAU,EACV,aAAa,CAAC,QAAQ,EAAE,EACxB,sBAAc,EACd,UAAU,EACV,eAAe,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAC5D,CAAC;IAEF,2DAA2D;IAC3D,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,KAAK;IAC/B,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,IAAI,CACxC;QACE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,QAAQ;QAChB,EAAE,EAAE,EAAE;KACP,EACD,YAAY,CACb,CAAC;IAEF,4DAA4D;IAC5D,IAAI,WAAgB,CAAC;IACrB,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEhD,IAAI,KAAK,EAAE,CAAC;QACV,uDAAuD;QACvD,6DAA6D;QAC7D,oEAAoE;QACpE,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC1E,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3C,WAAW,GAAG,YAAY,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,6EAA6E;QAC7E,MAAM,QAAQ,GAAqD,EAAE,CAAC;QACtE,IAAI,MAAM,GAA8B,SAAS,CAAC;QAClD,GAAG,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;gBACpC,KAAK,EAAE,WAAW;gBAClB,QAAQ,EAAE,UAAU;gBACpB,MAAM,EAAE,MAAM,IAAI,SAAS;aAC5B,CAAC,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,CAAC,QAAQ,MAAM,EAAE;QAEjB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,QAAQ;iBACxB,KAAK,CAAC,CAAC,CAAC;iBACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YACzC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;QAED,oDAAoD;QACpD,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE;YACpD,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;SAC3B,CAAC,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAChD,WAAW,GAAG,YAAY,CAAC;IAC7B,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAEjE,4EAA4E;IAC5E,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,eAAe,GAAG,aAAa,CAAC;IAEtC,0DAA0D;IAC1D,MAAM,YAAY,GAAG,MAAM,CACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,0BAAiB,CAAC,CACvD,CAAC;IAEF,qCAAqC;IACrC,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,MAAM,CACxC,EAAE,EACF,sBAAc,EACd,YAAY,CAAC,QAAQ,EAAE,EACvB,WAAW,EACX,IAAI,CACL,CAAC;IAEF,0DAA0D;IAC1D,eAAe,CAAC,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAC9E,CAAC"}

package/dist/strategies/scallop-leverage.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DeFi Dash SDK - Scallop Leverage Transaction Builder
+ *
+ * Builds leverage transactions using the native Scallop SDK builder,
+ * which handles oracle price updates via updateAssetPricesQuick.
+ */
+import { SuiClient } from "@mysten/sui/client";
+import { MetaAg } from "@7kprotocol/sdk-ts";
+export interface ScallopLeverageBuildParams {
+    coinType: string;
+    depositAmount?: string;
+    depositValueUsd?: number;
+    multiplier: number;
+    userAddress: string;
+    secretKey: string;
+}
+export interface ScallopLeverageDeps {
+    suiClient: SuiClient;
+    swapClient: MetaAg;
+}
+export interface ScallopLeverageBuildResult {
+    /** Scallop txBlock (builder.createTxBlock()) — call `builder.signAndSendTxBlock(tx)` to execute */
+    tx: any;
+    /** Scallop builder instance (needed for signAndSendTxBlock) */
+    builder: any;
+}
+/**
+ * Build a Scallop leverage transaction using the native Scallop SDK builder.
+ *
+ * Returns the built txBlock and builder so the caller can handle
+ * dry-run / execution logic.
+ */
+export declare function buildScallopLeverageTransaction(params: ScallopLeverageBuildParams, deps: ScallopLeverageDeps): Promise<ScallopLeverageBuildResult>;
+//# sourceMappingURL=scallop-leverage.d.ts.map