@varla/sdk 1.11.2 → 1.11.4

package/dist/views/core.js

@@ -1,4 +1,5 @@
 // Note: explicit .js extension is required for Node ESM resolution.
+import { erc1155Abi } from "viem";
 import { multicallChunks } from "../batch.js";
 import { abis } from "../generated.js";
 /**
@@ -536,19 +537,17 @@ export async function previewRepay(params) {
 /**
  * A small convenience bundle for frontends/backends.
  */
-// wraps: VarlaCore.getCollateralValue,VarlaCore.getDebt,VarlaCore.getMaxBorrow,VarlaCore.getHealthFactor
+// wraps: VarlaCore.getAccountSummary,VarlaCore.getHealthFactor
 export async function readBorrowLimits(params) {
-    const [collateralValue, debt, maxBorrow, hf] = await Promise.all([
-        params.core.read.getCollateralValue([params.user]),
-        params.core.read.getDebt([params.user]),
-        params.core.read.getMaxBorrow([params.user]),
+    const [snap, hf] = await Promise.all([
+        readAccountSnapshot({ core: params.core, user: params.user }),
         readHealthFactor({ core: params.core, user: params.user }),
     ]);
     return {
         user: params.user,
-        collateralValue,
-        debt,
-        maxBorrow,
+        collateralValue: snap.collateralValue,
+        debt: snap.debt,
+        maxBorrow: snap.maxBorrow,
         healthFactor: hf.healthFactor,
         canBeLiquidated: hf.canBeLiquidated,
     };
@@ -556,7 +555,7 @@ export async function readBorrowLimits(params) {
 /**
  * Multicall-chunked version of `readBorrowLimits`.
  */
-// wraps: VarlaCore.getCollateralValue,VarlaCore.getDebt,VarlaCore.getMaxBorrow,VarlaCore.getHealthFactor
+// wraps: VarlaCore.getAccountSummary,VarlaCore.getHealthFactor
 export async function readManyBorrowLimits(params) {
     const chunkSize = params.chunkSize ?? 256;
     if (params.users.length === 0)
@@ -565,19 +564,7 @@ export async function readManyBorrowLimits(params) {
         {
             address: params.core.address,
             abi: abis.VARLACORE_ABI,
-            functionName: "getCollateralValue",
-            args: [user],
-        },
-        {
-            address: params.core.address,
-            abi: abis.VARLACORE_ABI,
-            functionName: "getDebt",
-            args: [user],
-        },
-        {
-            address: params.core.address,
-            abi: abis.VARLACORE_ABI,
-            functionName: "getMaxBorrow",
+            functionName: "getAccountSummary",
             args: [user],
         },
         {
@@ -593,26 +580,27 @@ export async function readManyBorrowLimits(params) {
         chunkSize,
     });
     const out = [];
-    const stride = 4;
+    const stride = 2;
     for (let i = 0; i < params.users.length; i++) {
         const base = i * stride;
         const r0 = res[base + 0];
         const r1 = res[base + 1];
-        const r2 = res[base + 2];
-        const r3 = res[base + 3];
         if (r0.status !== "success") {
-            throw new Error(`Core getCollateralValue multicall failed: ${String(r0.error ?? "unknown")}`);
+            throw new Error(`Core getAccountSummary multicall failed: ${String(r0.error ?? "unknown")}`);
         }
         if (r1.status !== "success") {
-            throw new Error(`Core getDebt multicall failed: ${String(r1.error ?? "unknown")}`);
+            throw new Error(`Core getHealthFactor multicall failed: ${String(r1.error ?? "unknown")}`);
         }
-        if (r2.status !== "success") {
-            throw new Error(`Core getMaxBorrow multicall failed: ${String(r2.error ?? "unknown")}`);
+        const snapRaw = r0.result;
+        const collateralValue = snapRaw.collateralValue ?? snapRaw[1];
+        const debt = snapRaw.debt ?? snapRaw[2];
+        const maxBorrow = snapRaw.maxBorrow ?? snapRaw[4];
+        if (typeof collateralValue !== "bigint" ||
+            typeof debt !== "bigint" ||
+            typeof maxBorrow !== "bigint") {
+            throw new Error("Unexpected getAccountSummary() return shape");
         }
-        if (r3.status !== "success") {
-            throw new Error(`Core getHealthFactor multicall failed: ${String(r3.error ?? "unknown")}`);
-        }
-        const hfRaw = r3.result;
+        const hfRaw = r1.result;
         const healthFactor = hfRaw.healthFactor ?? hfRaw[0];
         const canBeLiquidated = hfRaw.canBeLiquidated ?? hfRaw[1];
         if (typeof healthFactor !== "bigint" || typeof canBeLiquidated !== "boolean") {
@@ -620,12 +608,172 @@ export async function readManyBorrowLimits(params) {
         }
         out.push({
             user: params.users[i],
-            collateralValue: r0.result,
-            debt: r1.result,
-            maxBorrow: r2.result,
+            collateralValue,
+            debt,
+            maxBorrow,
             healthFactor,
             canBeLiquidated,
         });
     }
     return out;
 }
+function _normalizeOraclePositionSnapshot(raw, positionId) {
+    const r = raw;
+    const priceOk = r.priceOk ?? r[0];
+    const priceE8 = r.priceE8 ?? r[1];
+    const manuallyInvalidated = r.manuallyInvalidated ?? r[2];
+    const riskTierRaw = r.riskTier ?? r[3];
+    const earlyClosureFactorWad = r.earlyClosureFactorWad ?? r[4];
+    if (typeof priceOk !== "boolean" ||
+        typeof priceE8 !== "bigint" ||
+        typeof manuallyInvalidated !== "boolean" ||
+        (typeof riskTierRaw !== "number" && typeof riskTierRaw !== "bigint") ||
+        typeof earlyClosureFactorWad !== "bigint") {
+        throw new Error("Unexpected getPositionSnapshot() return shape");
+    }
+    return {
+        positionId,
+        priceOk,
+        priceE8,
+        manuallyInvalidated,
+        riskTier: Number(riskTierRaw),
+        earlyClosureFactorWad,
+    };
+}
+function _tierDefaultLtv(defaultLtv, riskTier) {
+    if (riskTier === 0)
+        return defaultLtv.conservative;
+    if (riskTier === 1)
+        return defaultLtv.moderate;
+    return defaultLtv.risk;
+}
+/**
+ * Computes current vs potential borrowing capacity.
+ *
+ * - `current` comes from Core.getAccountSummary(user) (deposited positions only).
+ * - `wallet` is computed by reading ERC1155 wallet balances for the provided `walletPositionIds`
+ *   and applying VarlaOracle pricing + VarlaCore LTV rules.
+ *
+ * This helper exists to power UI flows like “Deposit Positions” where you want to show:
+ * - Current max loan (already deposited)
+ * - Potential max loan (if the user also deposits their wallet positions)
+ */
+export async function readHypotheticalBorrowCapacity(params) {
+    const chunkSize = params.chunkSize ?? 256;
+    const [current, defaultLtv] = await Promise.all([
+        readAccountSnapshot({ core: params.core, user: params.user }),
+        readDefaultLtvConfig({ core: params.core }),
+    ]);
+    // Fast path: no wallet ids.
+    if (params.walletPositionIds.length === 0) {
+        const potentialMaxBorrow = current.collateralValue > current.debt ? current.collateralValue - current.debt : 0n;
+        return {
+            user: params.user,
+            current,
+            wallet: { positionIds: [], balances: [], portfolioValue: 0n, collateralValue: 0n },
+            potential: { collateralValue: current.collateralValue, maxBorrow: potentialMaxBorrow },
+        };
+    }
+    // 1) Wallet balances (ERC1155 balanceOf)
+    const balCalls = params.walletPositionIds.map((pid) => ({
+        address: params.positionsToken.address,
+        abi: erc1155Abi,
+        functionName: "balanceOf",
+        args: [params.user, pid],
+    }));
+    const balRes = await multicallChunks({
+        client: params.client,
+        contracts: balCalls,
+        chunkSize,
+    });
+    const heldIds = [];
+    const heldBals = [];
+    for (let i = 0; i < balRes.length; i++) {
+        const r = balRes[i];
+        if (r.status !== "success") {
+            throw new Error(`ERC1155 balanceOf multicall failed: ${String(r.error ?? "unknown")}`);
+        }
+        const bal = r.result;
+        if (typeof bal !== "bigint")
+            throw new Error("Unexpected ERC1155 balanceOf return type");
+        if (bal > 0n) {
+            heldIds.push(params.walletPositionIds[i]);
+            heldBals.push(bal);
+        }
+    }
+    // No wallet positions held.
+    if (heldIds.length === 0) {
+        const potentialMaxBorrow = current.collateralValue > current.debt ? current.collateralValue - current.debt : 0n;
+        return {
+            user: params.user,
+            current,
+            wallet: { positionIds: [], balances: [], portfolioValue: 0n, collateralValue: 0n },
+            potential: { collateralValue: current.collateralValue, maxBorrow: potentialMaxBorrow },
+        };
+    }
+    // 2) Oracle snapshots + Core LTV overrides
+    const snapCalls = heldIds.map((pid) => ({
+        address: params.oracle.address,
+        abi: abis.VARLAORACLE_ABI,
+        functionName: "getPositionSnapshot",
+        args: [pid],
+    }));
+    const ovCalls = heldIds.map((pid) => ({
+        address: params.core.address,
+        abi: abis.VARLACORE_ABI,
+        functionName: "getPositionLtvOverride",
+        args: [pid],
+    }));
+    const [snapRes, ovRes] = await Promise.all([
+        multicallChunks({ client: params.client, contracts: snapCalls, chunkSize }),
+        multicallChunks({ client: params.client, contracts: ovCalls, chunkSize }),
+    ]);
+    const WAD = 1000000000000000000n;
+    const E8 = 100000000n;
+    let walletPortfolioValue = 0n;
+    let walletCollateralValue = 0n;
+    for (let i = 0; i < heldIds.length; i++) {
+        const snapR = snapRes[i];
+        if (snapR.status !== "success") {
+            throw new Error(`Oracle getPositionSnapshot multicall failed: ${String(snapR.error ?? "unknown")}`);
+        }
+        const snap = _normalizeOraclePositionSnapshot(snapR.result, heldIds[i]);
+        const ovR = ovRes[i];
+        if (ovR.status !== "success") {
+            throw new Error(`Core getPositionLtvOverride multicall failed: ${String(ovR.error ?? "unknown")}`);
+        }
+        const ovRaw = ovR.result;
+        const isSet = ovRaw.isSet ?? ovRaw[0];
+        const ltv = ovRaw.ltv ?? ovRaw[1];
+        if (typeof isSet !== "boolean" || typeof ltv !== "bigint") {
+            throw new Error("Unexpected getPositionLtvOverride() return shape");
+        }
+        // Mirror Core accounting semantics.
+        if (snap.manuallyInvalidated)
+            continue;
+        if (!snap.priceOk)
+            continue;
+        const bal = heldBals[i];
+        const pv = (bal * snap.priceE8) / E8;
+        if (pv === 0n)
+            continue;
+        walletPortfolioValue += pv;
+        const baseLtv = isSet ? ltv : _tierDefaultLtv(defaultLtv, snap.riskTier);
+        const effectiveLtv = (baseLtv * snap.earlyClosureFactorWad) / WAD;
+        const cv = (pv * effectiveLtv) / WAD;
+        walletCollateralValue += cv;
+    }
+    const potentialCollateralValue = current.collateralValue + walletCollateralValue;
+    const potentialMaxBorrow = potentialCollateralValue > current.debt ? potentialCollateralValue - current.debt : 0n;
+    return {
+        user: params.user,
+        current,
+        wallet: {
+            positionIds: heldIds,
+            balances: heldBals,
+            portfolioValue: walletPortfolioValue,
+            collateralValue: walletCollateralValue,
+        },
+        potential: { collateralValue: potentialCollateralValue, maxBorrow: potentialMaxBorrow },
+    };
+}

package/package.json

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