@varla/sdk 1.11.4 → 1.13.2

package/dist/leverage/plan.js

@@ -0,0 +1,204 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+import { readLtvForPosition } from "../views/core.js";
+import { planDeleverage, planLeverageLoop, } from "./math.js";
+/**
+ * RPC-aware planner that additionally caps planned debt using:
+ * - pool.maxBorrow() (liquidity + borrow cap)
+ * - user max borrow headroom (collateral-based)
+ * - core.MIN_BORROW() (dust / protocol min)
+ */
+export async function planLeverageFromChainPrecise(params) {
+    const [base, poolMaxBorrow, minBorrow, userSnap] = await Promise.all([
+        planLeverageFromChain(params),
+        params.pool ? params.pool.read.maxBorrow() : Promise.resolve(undefined),
+        params.minStepBorrowFromCore && params.coreMinBorrowRead
+            ? params.coreMinBorrowRead.MIN_BORROW()
+            : Promise.resolve(undefined),
+        params.capByUserMaxBorrow
+            ? params.core.read.getAccountSummary([params.user])
+            : Promise.resolve(undefined),
+    ]);
+    let maxTotalDebt = params.maxTotalDebt;
+    if (poolMaxBorrow !== undefined) {
+        maxTotalDebt =
+            maxTotalDebt === undefined
+                ? poolMaxBorrow
+                : poolMaxBorrow < maxTotalDebt
+                    ? poolMaxBorrow
+                    : maxTotalDebt;
+    }
+    if (params.capByUserMaxBorrow && userSnap !== undefined) {
+        const r = userSnap;
+        const maxBorrow = r.maxBorrow ?? r[4];
+        if (typeof maxBorrow !== "bigint") {
+            throw new Error("Unexpected getAccountSummary() return shape (maxBorrow)");
+        }
+        maxTotalDebt =
+            maxTotalDebt === undefined ? maxBorrow : maxBorrow < maxTotalDebt ? maxBorrow : maxTotalDebt;
+    }
+    const minStepBorrow = minBorrow !== undefined
+        ? params.minStepBorrow !== undefined
+            ? params.minStepBorrow > minBorrow
+                ? params.minStepBorrow
+                : minBorrow
+            : minBorrow
+        : params.minStepBorrow;
+    // Re-run pure planner with caps (base already did oracle+ltv reads).
+    return planLeverageLoop({
+        initialCapital: base.params.initialCapital,
+        tokenPriceE8: base.params.tokenPriceE8,
+        ltvWad: base.params.ltvWad,
+        targetLeverageWad: base.params.targetLeverageWad,
+        maxIterations: base.params.maxIterations,
+        minStepBorrow,
+        maxTotalDebt,
+    });
+}
+/**
+ * Plan a leverage loop by reading on-chain state first.
+ *
+ * 1. Reads the effective LTV for the position
+ * 2. Reads the oracle price
+ * 3. Delegates to `planLeverageLoop()` (pure math)
+ */
+export async function planLeverageFromChain(params) {
+    const [{ ltvWad }, tokenPriceE8, depAllowed, validCollateral] = await Promise.all([
+        readLtvForPosition({ core: params.core, positionId: params.positionId }),
+        (async () => {
+            // Prefer non-reverting reads when possible.
+            if (params.oracle.read.getPositionSnapshot) {
+                const raw = await params.oracle.read.getPositionSnapshot([params.positionId]);
+                const r = raw;
+                const ok = r.priceOk ?? r[0];
+                const priceE8 = r.priceE8 ?? r[1];
+                if (typeof ok !== "boolean" || typeof priceE8 !== "bigint") {
+                    throw new Error("Unexpected getPositionSnapshot() return shape");
+                }
+                if (!ok)
+                    throw new Error("Oracle price unavailable");
+                return priceE8;
+            }
+            if (params.oracle.read.tryGetPrice) {
+                const raw = await params.oracle.read.tryGetPrice([params.positionId]);
+                const r = raw;
+                const ok = r.ok ?? r[0];
+                const price = r.price ?? r[1];
+                if (typeof ok !== "boolean" || typeof price !== "bigint") {
+                    throw new Error("Unexpected tryGetPrice() return shape");
+                }
+                if (!ok)
+                    throw new Error("Oracle price unavailable");
+                return price;
+            }
+            if (!params.oracle.read.getPrice) {
+                throw new Error("Oracle contract is missing price read method");
+            }
+            return params.oracle.read.getPrice([params.positionId]);
+        })(),
+        params.requireDepositAllowed && params.oracle.read.isDepositAllowed
+            ? params.oracle.read.isDepositAllowed([params.positionId])
+            : Promise.resolve(undefined),
+        params.requireValidCollateral && params.oracle.read.isValidCollateral
+            ? params.oracle.read.isValidCollateral([params.positionId])
+            : Promise.resolve(undefined),
+    ]);
+    if (params.requireDepositAllowed) {
+        if (depAllowed === undefined) {
+            throw new Error("Oracle contract is missing isDepositAllowed() read method");
+        }
+        if (!depAllowed) {
+            throw new Error("Deposit not allowed for this position (early-closure window or resolved)");
+        }
+    }
+    if (params.requireValidCollateral) {
+        if (validCollateral === undefined) {
+            throw new Error("Oracle contract is missing isValidCollateral() read method");
+        }
+        if (!validCollateral) {
+            throw new Error("Position is not valid collateral for deposit");
+        }
+    }
+    const loopParams = {
+        initialCapital: params.initialCapital,
+        tokenPriceE8,
+        ltvWad,
+        targetLeverageWad: params.targetLeverageWad,
+        maxIterations: params.maxIterations,
+        minStepBorrow: params.minStepBorrow,
+        maxTotalDebt: params.maxTotalDebt,
+    };
+    return planLeverageLoop(loopParams);
+}
+// ---------------------------------------------------------------------------
+// resolveLeveragePositionId
+// ---------------------------------------------------------------------------
+/**
+ * Convenience helper to pick the correct positionId for a leverage direction.
+ *
+ * Semantics:
+ * - direction="long"  => returns the provided positionId
+ * - direction="short" => returns oracle.getOppositePositionId(positionId)
+ */
+export async function resolveLeveragePositionId(params) {
+    if (params.direction === "long")
+        return params.positionId;
+    if (!params.oracle.read.getOppositePositionId) {
+        throw new Error("Oracle contract is missing getOppositePositionId() read method");
+    }
+    return params.oracle.read.getOppositePositionId([params.positionId]);
+}
+/**
+ * Plan a deleverage (unwind) loop by reading on-chain state first.
+ *
+ * 1. Reads deposited token balance and current debt
+ * 2. Reads the effective LTV and oracle price
+ * 3. Delegates to `planDeleverage()` (pure math)
+ */
+export async function planDeleverageFromChain(params) {
+    const [{ ltvWad }, tokenPriceE8, depositedTokens, currentDebt] = await Promise.all([
+        readLtvForPosition({ core: params.core, positionId: params.positionId }),
+        (async () => {
+            if (params.oracle.read.getPositionSnapshot) {
+                const raw = await params.oracle.read.getPositionSnapshot([params.positionId]);
+                const r = raw;
+                const ok = r.priceOk ?? r[0];
+                const priceE8 = r.priceE8 ?? r[1];
+                if (typeof ok !== "boolean" || typeof priceE8 !== "bigint") {
+                    throw new Error("Unexpected getPositionSnapshot() return shape");
+                }
+                if (!ok)
+                    throw new Error("Oracle price unavailable");
+                return priceE8;
+            }
+            if (params.oracle.read.tryGetPrice) {
+                const raw = await params.oracle.read.tryGetPrice([params.positionId]);
+                const r = raw;
+                const ok = r.ok ?? r[0];
+                const price = r.price ?? r[1];
+                if (typeof ok !== "boolean" || typeof price !== "bigint") {
+                    throw new Error("Unexpected tryGetPrice() return shape");
+                }
+                if (!ok)
+                    throw new Error("Oracle price unavailable");
+                return price;
+            }
+            if (!params.oracle.read.getPrice) {
+                throw new Error("Oracle contract is missing price read method");
+            }
+            return params.oracle.read.getPrice([params.positionId]);
+        })(),
+        params.core.read.positionBalances([params.user, params.positionId]),
+        params.core.read.getDebt([params.user]),
+    ]);
+    const deleverageParams = {
+        depositedTokens,
+        currentDebt,
+        tokenPriceE8,
+        ltvWad,
+        targetDebtReduction: params.targetDebtReduction,
+        maxIterations: params.maxIterations,
+        minStepSell: params.minStepSell,
+    };
+    return planDeleverage(deleverageParams);
+}
+//# sourceMappingURL=plan.js.map

package/dist/leverage/plan.js.map

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

package/dist/leverage/preflight.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Leverage module preflight helpers.
+ *
+ * These helpers are intentionally small and “plumbing-only”.
+ * They provide standardized ways to:
+ * - check approvals required for leverage/deleverage loops
+ * - build simulate-first approval txs
+ */
+import type { Address, PublicClient } from "viem";
+import type { SimulatedTx } from "../actions/oracle.js";
+export type ReadErc1155IsApprovedForAllParams = {
+    publicClient: Pick<PublicClient, "readContract">;
+    tokenAddress: Address;
+    owner: Address;
+    operator: Address;
+};
+export declare function readErc1155IsApprovedForAll(params: ReadErc1155IsApprovedForAllParams): Promise<boolean>;
+export declare function prepareApprovePositionsTokenIfNeeded(params: {
+    publicClient: Pick<PublicClient, "simulateContract" | "readContract">;
+    positionsTokenAddress: Address;
+    owner: Address;
+    operator: Address;
+}): Promise<{
+    needed: boolean;
+    tx?: SimulatedTx;
+}>;
+//# sourceMappingURL=preflight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/leverage/preflight.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IACjD,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,cAAc,CAAC,CAAC;IACtE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC,CAkBjD"}

package/dist/leverage/preflight.js

@@ -0,0 +1,34 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+import { erc1155Abi } from "viem";
+import { prepareErc1155SetApprovalForAll } from "../actions/erc1155.js";
+export async function readErc1155IsApprovedForAll(params) {
+    const approved = await params.publicClient.readContract({
+        address: params.tokenAddress,
+        abi: erc1155Abi,
+        functionName: "isApprovedForAll",
+        args: [params.owner, params.operator],
+    });
+    if (typeof approved !== "boolean") {
+        throw new Error("Unexpected isApprovedForAll return type");
+    }
+    return approved;
+}
+export async function prepareApprovePositionsTokenIfNeeded(params) {
+    const approved = await readErc1155IsApprovedForAll({
+        publicClient: params.publicClient,
+        tokenAddress: params.positionsTokenAddress,
+        owner: params.owner,
+        operator: params.operator,
+    });
+    if (approved)
+        return { needed: false };
+    const tx = await prepareErc1155SetApprovalForAll({
+        publicClient: params.publicClient,
+        tokenAddress: params.positionsTokenAddress,
+        account: params.owner,
+        operator: params.operator,
+        approved: true,
+    });
+    return { needed: true, tx };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/leverage/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/leverage/preflight.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAYpE,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAUxE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAyC;IAEzC,MAAM,QAAQ,GAAG,MAAO,MAAM,CAAC,YAAoB,CAAC,YAAY,CAAC;QAC/D,OAAO,EAAE,MAAM,CAAC,YAAY;QAC5B,GAAG,EAAE,UAAU;QACf,YAAY,EAAE,kBAAkB;QAChC,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC;KACtC,CAAC,CAAC;IACH,IAAI,OAAO,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oCAAoC,CAAC,MAK1D;IACC,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC;QACjD,YAAY,EAAE,MAAM,CAAC,YAAmB;QACxC,YAAY,EAAE,MAAM,CAAC,qBAAqB;QAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;IAEH,IAAI,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAEvC,MAAM,EAAE,GAAG,MAAM,+BAA+B,CAAC;QAC/C,YAAY,EAAE,MAAM,CAAC,YAAmB;QACxC,YAAY,EAAE,MAAM,CAAC,qBAAqB;QAC1C,OAAO,EAAE,MAAM,CAAC,KAAK;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC9B,CAAC"}

package/dist/leverage/types.d.ts

@@ -0,0 +1,157 @@
+import type { Hash } from "viem";
+/** WAD precision (1e18). */
+export declare const WAD = 1000000000000000000n;
+/** Oracle price precision (1e8 = $1.00). */
+export declare const PRICE_E8 = 100000000n;
+/** Default maximum loop iterations (safety cap). */
+export declare const DEFAULT_MAX_ITERATIONS = 10;
+/**
+ * Default minimum step size, expressed in the collateral token's base units.
+ *
+ * NOTE:
+ * - This is intentionally conservative and primarily exists as a safety/DoS cap
+ *   to prevent extremely long plans due to diminishing returns.
+ * - Consumers SHOULD override this using on-chain `core.MIN_BORROW()` and/or by
+ *   computing a USD-denominated threshold using token decimals.
+ */
+export declare const DEFAULT_MIN_STEP_COLLATERAL = 1000000n;
+/** Compute 10^n as bigint. */
+export declare function pow10(n: number): bigint;
+/**
+ * Returns a collateral base-unit amount corresponding to a whole-dollar amount.
+ *
+ * Example:
+ * - decimals=6, dollars=1 => 1_000_000
+ * - decimals=18, dollars=1 => 1_000_000_000_000_000_000
+ */
+export declare function collateralForDollars(params: {
+    decimals: number;
+    dollars: bigint;
+}): bigint;
+/** Direction of the leveraged position. */
+export type LeverageDirection = "long" | "short";
+/**
+ * A single step in a leverage loop.
+ *
+ * Steps alternate between off-chain token acquisition ("buy") and on-chain
+ * Varla operations ("deposit" / "borrow").
+ *
+ * The first step is always "buy" (user buys tokens with their initial capital),
+ * followed by deposit → borrow → buy → deposit → borrow → ... until the
+ * target leverage is reached or iterations are exhausted.
+ */
+export type LeverageStep = {
+    kind: "buy";
+    /** Collateral amount to spend on the CLOB (collateral base units). */
+    collateralAmount: bigint;
+    /** Expected token amount at the given price (before slippage). */
+    expectedTokens: bigint;
+    /** Iteration index (0 = initial buy, 1 = first re-buy, etc.). */
+    iteration: number;
+} | {
+    kind: "deposit";
+    /** Token amount to deposit into VarlaCore. */
+    amount: bigint;
+    /** Iteration index. */
+    iteration: number;
+} | {
+    kind: "borrow";
+    /** Collateral amount to borrow from VarlaPool. */
+    collateralAmount: bigint;
+    /** Iteration index. */
+    iteration: number;
+};
+/**
+ * Summary statistics for a planned leverage loop.
+ */
+export type LeverageSummary = {
+    /** Total outcome tokens held after all iterations. */
+    totalTokens: bigint;
+    /** Total collateral-token debt owed to VarlaPool (base units). */
+    totalDebt: bigint;
+    /** Net equity = totalTokens * price - totalDebt (collateral base units). */
+    netEquity: bigint;
+    /** Effective leverage as WAD (e.g. 3e18 = 3.0×). */
+    effectiveLeverageWad: bigint;
+    /** Estimated liquidation price (8 decimals). HF = 1.0 at this price. */
+    estimatedLiquidationPriceE8: bigint;
+    /** Number of loop iterations performed. */
+    iterations: number;
+    /** Maximum theoretical leverage = 1 / (1 - LTV) as WAD. */
+    maxLeverageWad: bigint;
+};
+/**
+ * Complete leverage plan returned by the planner.
+ */
+export type LeveragePlan = {
+    /** Ordered steps to execute. */
+    steps: LeverageStep[];
+    /** Summary statistics. */
+    summary: LeverageSummary;
+    /** Input parameters used to generate this plan. */
+    params: {
+        initialCapital: bigint;
+        tokenPriceE8: bigint;
+        ltvWad: bigint;
+        targetLeverageWad: bigint | undefined;
+        maxIterations: number;
+        minStepBorrow: bigint;
+    };
+};
+export type DeleverageStep = {
+    kind: "sell";
+    /** Token amount to sell on CLOB. */
+    tokenAmount: bigint;
+    /** Expected collateral proceeds at current price (before slippage). */
+    expectedCollateral: bigint;
+    iteration: number;
+} | {
+    kind: "repay";
+    /** Collateral amount to repay. */
+    collateralAmount: bigint;
+    iteration: number;
+} | {
+    kind: "withdraw";
+    /** Token amount to withdraw from VarlaCore. */
+    amount: bigint;
+    iteration: number;
+};
+export type DeleveragePlan = {
+    steps: DeleverageStep[];
+    summary: {
+        tokensToSell: bigint;
+        totalRepayment: bigint;
+        tokensRemaining: bigint;
+        collateralRemaining: bigint;
+        iterations: number;
+    };
+};
+/**
+ * Result of an off-chain token buy, returned by the consumer's callback.
+ */
+export type BuyResult = {
+    /** Actual tokens received (may differ from `expectedTokens` due to slippage). */
+    actualTokens: bigint;
+};
+/**
+ * Result of an off-chain token sell, returned by the consumer's callback.
+ */
+export type SellResult = {
+    /** Actual collateral received (may differ from `expectedCollateral` due to slippage). */
+    actualCollateral: bigint;
+};
+export type LeverageStepResult = {
+    step: LeverageStep;
+    hash?: Hash;
+    buyResult?: BuyResult;
+};
+/**
+ * Progress callback during leverage execution.
+ */
+export type OnLeverageProgress = (info: {
+    completed: number;
+    total: number;
+    step: LeverageStep;
+    result: LeverageStepResult;
+}) => void;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/leverage/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAMjC,4BAA4B;AAC5B,eAAO,MAAM,GAAG,uBAA6B,CAAC;AAE9C,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,aAAe,CAAC;AAErC,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,WAAa,CAAC;AAMtD,8BAA8B;AAC9B,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE1F;AAMD,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,2BAA2B,EAAE,MAAM,CAAC;IACpC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,gCAAgC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,0BAA0B;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,mDAAmD;IACnD,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;QACtC,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAMF,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,yFAAyF;IACzF,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;CAC5B,KAAK,IAAI,CAAC"}

package/dist/leverage/types.js

@@ -0,0 +1,43 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** WAD precision (1e18). */
+export const WAD = 1000000000000000000n;
+/** Oracle price precision (1e8 = $1.00). */
+export const PRICE_E8 = 100000000n;
+/** Default maximum loop iterations (safety cap). */
+export const DEFAULT_MAX_ITERATIONS = 10;
+/**
+ * Default minimum step size, expressed in the collateral token's base units.
+ *
+ * NOTE:
+ * - This is intentionally conservative and primarily exists as a safety/DoS cap
+ *   to prevent extremely long plans due to diminishing returns.
+ * - Consumers SHOULD override this using on-chain `core.MIN_BORROW()` and/or by
+ *   computing a USD-denominated threshold using token decimals.
+ */
+export const DEFAULT_MIN_STEP_COLLATERAL = 1000000n;
+// ---------------------------------------------------------------------------
+// Amount / units helpers
+// ---------------------------------------------------------------------------
+/** Compute 10^n as bigint. */
+export function pow10(n) {
+    if (!Number.isInteger(n) || n < 0)
+        throw new Error(`pow10: invalid n=${n}`);
+    let out = 1n;
+    for (let i = 0; i < n; i++)
+        out *= 10n;
+    return out;
+}
+/**
+ * Returns a collateral base-unit amount corresponding to a whole-dollar amount.
+ *
+ * Example:
+ * - decimals=6, dollars=1 => 1_000_000
+ * - decimals=18, dollars=1 => 1_000_000_000_000_000_000
+ */
+export function collateralForDollars(params) {
+    return params.dollars * pow10(params.decimals);
+}
+//# sourceMappingURL=types.js.map

package/dist/leverage/types.js.map

@@ -0,0 +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"}

package/dist/meta.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Chain/platform metadata.
+ *
+ * The SDK intentionally treats the protocol as "collateral-token generic".
+ * However, many apps want to display chain-specific stablecoin symbols and
+ * choose sensible defaults without extra RPC calls.
+ */
+import type { Address } from "viem";
+/** All chains the protocol is deployed on. */
+export declare const SUPPORTED_CHAINS: readonly ["polygon", "bsc"];
+export type VarlaChainKey = (typeof SUPPORTED_CHAINS)[number];
+/** Type guard: returns `true` if `value` is a known chain key. */
+export declare function isSupportedChain(value: string): value is VarlaChainKey;
+/**
+ * Assert that `value` is a supported chain key, throwing a descriptive
+ * error otherwise.  Useful at configuration/startup boundaries.
+ */
+export declare function assertSupportedChain(value: string): asserts value is VarlaChainKey;
+export type StablecoinKind = "USDC" | "USDT";
+export type CollateralMeta = {
+    kind: StablecoinKind;
+    symbol: string;
+    decimals: number;
+    /** Optional known address (may be omitted for future chains). */
+    address?: Address;
+};
+export type ChainMeta = {
+    chain: VarlaChainKey;
+    /** Platform/integration name shown to users. */
+    platform: "polymarket" | "opinion";
+    collateral: CollateralMeta;
+};
+/**
+ * Returns chain defaults for UI/backends.
+ *
+ * NOTE:
+ * - Addresses are best-effort and should not be treated as canonical.
+ * - For authoritative on-chain state, read `core.collateralToken()` and
+ *   ERC20 metadata at runtime.
+ */
+export declare function getChainMeta(chain: VarlaChainKey): ChainMeta;
+//# sourceMappingURL=meta.d.ts.map

package/dist/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,6BAA8B,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAMlF;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,gDAAgD;IAChD,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,UAAU,EAAE,cAAc,CAAC;CAC5B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAsB5D"}

package/dist/meta.js

@@ -0,0 +1,47 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+/** All chains the protocol is deployed on. */
+export const SUPPORTED_CHAINS = ["polygon", "bsc"];
+/** Type guard: returns `true` if `value` is a known chain key. */
+export function isSupportedChain(value) {
+    return SUPPORTED_CHAINS.includes(value);
+}
+/**
+ * Assert that `value` is a supported chain key, throwing a descriptive
+ * error otherwise.  Useful at configuration/startup boundaries.
+ */
+export function assertSupportedChain(value) {
+    if (!isSupportedChain(value)) {
+        throw new Error(`Unsupported chain "${value}". Expected one of: ${SUPPORTED_CHAINS.join(", ")}`);
+    }
+}
+/**
+ * Returns chain defaults for UI/backends.
+ *
+ * NOTE:
+ * - Addresses are best-effort and should not be treated as canonical.
+ * - For authoritative on-chain state, read `core.collateralToken()` and
+ *   ERC20 metadata at runtime.
+ */
+export function getChainMeta(chain) {
+    if (chain === "polygon") {
+        return {
+            chain,
+            platform: "polymarket",
+            collateral: {
+                kind: "USDC",
+                symbol: "USDC",
+                decimals: 6,
+            },
+        };
+    }
+    return {
+        chain,
+        platform: "opinion",
+        collateral: {
+            kind: "USDT",
+            symbol: "USDT",
+            decimals: 18,
+        },
+    };
+}
+//# sourceMappingURL=meta.js.map

package/dist/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAYpE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,KAAK,CAAU,CAAC;AAI5D,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,uBAAuB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;AACH,CAAC;AAmBD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;YACL,KAAK;YACL,QAAQ,EAAE,YAAY;YACtB,UAAU,EAAE;gBACV,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,CAAC;aACZ;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK;QACL,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE;YACV,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;AACJ,CAAC"}

package/dist/types.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/views/accessManager.js

@@ -183,3 +183,4 @@ export async function readManyTargetConfigs(params) {
     }
     return out;
 }
+//# sourceMappingURL=accessManager.js.map

package/dist/views/accessManager.js.map

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

package/dist/views/adapters.js

@@ -10,3 +10,4 @@ export async function readAdapterInfo(params) {
     ]);
     return { collateral, positions };
 }
+//# sourceMappingURL=adapters.js.map

package/dist/views/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/views/adapters.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAgBpE;;GAEG;AACH,+JAA+J;AAC/J,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAgC;IACpE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE;QAChC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE;KAChC,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC"}