@varla/sdk 2.18.0 → 2.20.0

package/dist/views/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/views/system.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAGnB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,kBAAkB,CAAC;IACnC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,eAAe,EAAE,qBAAqB,CAAC;IACvC,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,kBAAkB,GAAG;IAC7D,cAAc,EAAE,kBAAkB,CAAC;IACnC,eAAe,EAAE,mBAAmB,CAAC;CACtC,CAAC;AAEF;;;;;;GAMG;AAEH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAW9B;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,CAAC;IACjC,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,CAAC;IACjC,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CACpD,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA2BvC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/views/system.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEhG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAGnB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,kBAAkB,CAAC;IACnC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,eAAe,EAAE,qBAAqB,CAAC;IACvC,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,kBAAkB,GAAG;IAC7D,cAAc,EAAE,kBAAkB,CAAC;IACnC,eAAe,EAAE,mBAAmB,CAAC;IACrC,aAAa,EAAE,iBAAiB,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AAEH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAW9B;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,CAAC;IACjC,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,CAAC;IACjC,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CACpD,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA4BvC"}

package/dist/views/system.js

@@ -49,6 +49,7 @@ export async function readSystemDashboardSnapshot(params) {
         oracle,
         poolSharePrice: poolDashboard.sharePrice,
         poolHealthScore: poolDashboard.healthScore,
+        coreAddresses: coreDashboard.coreAddresses,
     };
 }
 //# sourceMappingURL=system.js.map

package/dist/views/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/views/system.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAGpE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQ/C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAgBlG;;;;;;GAMG;AACH,mVAAmV;AACnV,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAIxC;IACC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3F,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,kBAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACzC,oBAAoB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3C,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;KAC5C,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAKjD;IACC,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/D,iBAAiB,CAAC;YAChB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;QACF,iBAAiB,CAAC;YAChB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;QACF,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;KAC5C,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,QAAQ;QAC5B,QAAQ,EAAE,aAAa,CAAC,IAAI;QAC5B,cAAc,EAAE,aAAa,CAAC,UAAU;QACxC,OAAO,EAAE;YACP,YAAY,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK;YAC3C,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK;YACvC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK;SACpC;QACD,eAAe,EAAE,aAAa,CAAC,SAAS;QACxC,MAAM;QACN,cAAc,EAAE,aAAa,CAAC,UAAU;QACxC,eAAe,EAAE,aAAa,CAAC,WAAW;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/views/system.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAGpE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQ/C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAiBlG;;;;;;GAMG;AACH,mVAAmV;AACnV,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAIxC;IACC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3F,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,kBAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACzC,oBAAoB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3C,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;KAC5C,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAKjD;IACC,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/D,iBAAiB,CAAC;YAChB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;QACF,iBAAiB,CAAC;YAChB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;QACF,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;KAC5C,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,QAAQ;QAC5B,QAAQ,EAAE,aAAa,CAAC,IAAI;QAC5B,cAAc,EAAE,aAAa,CAAC,UAAU;QACxC,OAAO,EAAE;YACP,YAAY,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK;YAC3C,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK;YACvC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK;SACpC;QACD,eAAe,EAAE,aAAa,CAAC,SAAS;QACxC,MAAM;QACN,cAAc,EAAE,aAAa,CAAC,UAAU;QACxC,eAAe,EAAE,aAAa,CAAC,WAAW;QAC1C,aAAa,EAAE,aAAa,CAAC,aAAa;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

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

package/src/actions/liquidator.ts

@@ -5,6 +5,14 @@ import type { Address, PublicClient } from "viem";
 import { abis } from "../generated.js";
 import type { SimulatedTx } from "./oracle.js";
 
+type LiquidatorKind = "standard" | "merge" | "convert";
+
+function getLiquidatorAbi(kind: LiquidatorKind | undefined) {
+  if (kind === "merge") return abis.VARLAMERGELIQUIDATOR_ABI;
+  if (kind === "convert") return abis.VARLACONVERTLIQUIDATOR_ABI;
+  return abis.VARLALIQUIDATOR_ABI;
+}
+
 // ---------------------------------------------------------------------------
 // Liquidator (bot flows) write helpers
 // ---------------------------------------------------------------------------
@@ -74,3 +82,76 @@ export async function prepareLiquidatorResolveBadDebtWithReserve(params: {
     account: params.account,
   } as any)) as any;
 }
+
+// ---------------------------------------------------------------------------
+// Liquidator admin/config helpers (VarlaLiquidatorBase)
+// ---------------------------------------------------------------------------
+
+export async function prepareLiquidatorSetTreasury(params: {
+  publicClient: Pick<PublicClient, "simulateContract">;
+  liquidatorAddress: Address;
+  account: Address;
+  treasury: Address;
+  kind?: LiquidatorKind;
+}): Promise<SimulatedTx> {
+  return (await params.publicClient.simulateContract({
+    address: params.liquidatorAddress,
+    abi: getLiquidatorAbi(params.kind),
+    functionName: "setTreasury",
+    args: [params.treasury],
+    account: params.account,
+  } as any)) as any;
+}
+
+export async function prepareLiquidatorSetStaking(params: {
+  publicClient: Pick<PublicClient, "simulateContract">;
+  liquidatorAddress: Address;
+  account: Address;
+  staking: Address;
+  kind?: LiquidatorKind;
+}): Promise<SimulatedTx> {
+  return (await params.publicClient.simulateContract({
+    address: params.liquidatorAddress,
+    abi: getLiquidatorAbi(params.kind),
+    functionName: "setStaking",
+    args: [params.staking],
+    account: params.account,
+  } as any)) as any;
+}
+
+export async function prepareLiquidatorRescueErc20(params: {
+  publicClient: Pick<PublicClient, "simulateContract">;
+  liquidatorAddress: Address;
+  account: Address;
+  token: Address;
+  to: Address;
+  amount: bigint;
+  kind?: LiquidatorKind;
+}): Promise<SimulatedTx> {
+  return (await params.publicClient.simulateContract({
+    address: params.liquidatorAddress,
+    abi: getLiquidatorAbi(params.kind),
+    functionName: "rescueERC20",
+    args: [params.token, params.to, params.amount],
+    account: params.account,
+  } as any)) as any;
+}
+
+export async function prepareLiquidatorRescueErc1155(params: {
+  publicClient: Pick<PublicClient, "simulateContract">;
+  liquidatorAddress: Address;
+  account: Address;
+  token: Address;
+  to: Address;
+  id: bigint;
+  amount: bigint;
+  kind?: LiquidatorKind;
+}): Promise<SimulatedTx> {
+  return (await params.publicClient.simulateContract({
+    address: params.liquidatorAddress,
+    abi: getLiquidatorAbi(params.kind),
+    functionName: "rescueERC1155",
+    args: [params.token, params.to, params.id, params.amount],
+    account: params.account,
+  } as any)) as any;
+}

package/src/actions/oracle.ts

@@ -83,6 +83,38 @@ export async function prepareOracleSetPositionEarlyClosureWindowOverride(params:
   } as any)) as any;
 }
 
+export async function prepareOracleSetLowLiquidityConfig(params: {
+  publicClient: Pick<PublicClient, "simulateContract">;
+  oracleAddress: Address;
+  account: Address;
+  tier: number;
+  gracePeriod: bigint;
+  decayPeriod: bigint;
+}): Promise<SimulatedTx> {
+  return (await params.publicClient.simulateContract({
+    address: params.oracleAddress,
+    abi: abis.VARLAORACLE_ABI,
+    functionName: "setLowLiquidityConfig",
+    args: [params.tier, params.gracePeriod, params.decayPeriod],
+    account: params.account,
+  } as any)) as any;
+}
+
+export async function prepareOracleSetLowLiquidityGraceBlocksLiquidation(params: {
+  publicClient: Pick<PublicClient, "simulateContract">;
+  oracleAddress: Address;
+  account: Address;
+  shouldBlock: boolean;
+}): Promise<SimulatedTx> {
+  return (await params.publicClient.simulateContract({
+    address: params.oracleAddress,
+    abi: abis.VARLAORACLE_ABI,
+    functionName: "setLowLiquidityGraceBlocksLiquidation",
+    args: [params.shouldBlock],
+    account: params.account,
+  } as any)) as any;
+}
+
 export async function prepareOracleClearPositionEarlyClosureWindowOverride(params: {
   publicClient: Pick<PublicClient, "simulateContract">;
   oracleAddress: Address;
@@ -563,8 +595,11 @@ export async function seedOracleFromJsonFiles(params: {
 }): Promise<SeedOracleFromJsonResult> {
   let readFileSync: ((path: string, enc: "utf8") => string) | undefined;
   try {
-    // Node 18+/Bun supports `node:fs`.
-    ({ readFileSync } = (await import("node:fs")) as any);
+    // Use Function(...) so browser bundlers don't statically analyze node:fs imports.
+    const importRuntime = Function("s", "return import(s)") as (
+      specifier: string,
+    ) => Promise<{ readFileSync?: (path: string, enc: "utf8") => string }>;
+    ({ readFileSync } = (await importRuntime(["node", "fs"].join(":"))) as any);
   } catch {
     throw new Error(
       "seedOracleFromJsonFiles() is Node-only. In browsers, load JSON via fetch and call seedOracleFromJson().",

package/src/views/core.ts

@@ -904,6 +904,27 @@ export type ReadCoreDashboard = {
   ];
 };
 
+export type ReadConfiguredPositionDepositRow = {
+  positionId: bigint;
+  conditionId: `0x${string}`;
+  depositedBalance: bigint;
+  priceOk: boolean;
+  spotPriceE8: bigint;
+  twapPriceE8: bigint;
+  priceE8: bigint;
+  effectivePriceE8: bigint;
+  usedFallbackPrice: boolean;
+  depositValue: bigint;
+};
+
+export type ReadConfiguredPositionDepositsSummary = {
+  configuredCount: number;
+  pricedCount: number;
+  totalDepositedBalance: bigint;
+  totalDepositedValue: bigint;
+  rows: ReadConfiguredPositionDepositRow[];
+};
+
 /**
  * Normalized wrapper over `VarlaCore.getTierLiquidationConfig(tier)`.
  */
@@ -1076,6 +1097,166 @@ export async function readCoreDashboard(params: {
   };
 }
 
+/**
+ * Reads deposited balances for all oracle-configured positions.
+ *
+ * Uses:
+ * - `oracle.getConfiguredPositions()`
+ * - `positionsToken.balanceOf(core, positionId)`
+ * - `oracle.getPositionSnapshot(positionId)` for pricing
+ * - `oracle.getPriceData(positionId)` for fallback pricing
+ * - `oracle.getConditionId(positionId)` for market mapping
+ */
+// wraps: VarlaOracle.getConfiguredPositions,ERC1155.balanceOf,VarlaOracle.getPositionSnapshot,VarlaOracle.getPriceData,VarlaOracle.getConditionId
+export async function readConfiguredPositionDepositsSummary(params: {
+  core: { address: Address };
+  oracle: { address: Address };
+  positionsToken: { address: Address };
+  client: { multicall: (args: any) => Promise<any> };
+  chunkSize?: number;
+}): Promise<ReadConfiguredPositionDepositsSummary> {
+  const chunkSize = params.chunkSize ?? 256;
+
+  const cfgRes = await multicallChunks({
+    client: params.client as any,
+    contracts: [
+      {
+        address: params.oracle.address,
+        abi: abis.VARLAORACLE_ABI,
+        functionName: "getConfiguredPositions" as const,
+      },
+    ] as any,
+    chunkSize,
+  });
+
+  const cfg0: any = (cfgRes as any[])[0];
+  if (!cfg0 || cfg0.status !== "success" || !Array.isArray(cfg0.result)) {
+    throw new Error(`Configured positions read failed: ${String(cfg0?.error ?? "unknown")}`);
+  }
+
+  const positionIds = [...(cfg0.result as readonly bigint[])];
+  if (positionIds.length === 0) {
+    return {
+      configuredCount: 0,
+      pricedCount: 0,
+      totalDepositedBalance: 0n,
+      totalDepositedValue: 0n,
+      rows: [],
+    };
+  }
+
+  const calls = positionIds.flatMap((pid) => [
+    {
+      address: params.positionsToken.address,
+      abi: erc1155Abi,
+      functionName: "balanceOf" as const,
+      args: [params.core.address, pid] as const,
+    },
+    {
+      address: params.oracle.address,
+      abi: abis.VARLAORACLE_ABI,
+      functionName: "getPositionSnapshot" as const,
+      args: [pid] as const,
+    },
+    {
+      address: params.oracle.address,
+      abi: abis.VARLAORACLE_ABI,
+      functionName: "getPriceData" as const,
+      args: [pid] as const,
+    },
+    {
+      address: params.oracle.address,
+      abi: abis.VARLAORACLE_ABI,
+      functionName: "getConditionId" as const,
+      args: [pid] as const,
+    },
+  ]);
+
+  const res = await multicallChunks({
+    client: params.client as any,
+    contracts: calls as any,
+    chunkSize,
+  });
+
+  const rows: ReadConfiguredPositionDepositRow[] = [];
+  let totalDepositedBalance = 0n;
+  let totalDepositedValue = 0n;
+  let pricedCount = 0;
+
+  for (let i = 0; i < positionIds.length; i++) {
+    const balR: any = (res as any[])[i * 4];
+    const snapR: any = (res as any[])[i * 4 + 1];
+    const priceR: any = (res as any[])[i * 4 + 2];
+    const condR: any = (res as any[])[i * 4 + 3];
+    const pid = positionIds[i]!;
+
+    if (balR?.status !== "success") {
+      throw new Error(
+        `Configured position balance read failed: ${String(balR?.error ?? "unknown")}`,
+      );
+    }
+    if (snapR?.status !== "success") {
+      throw new Error(
+        `Configured position snapshot read failed: ${String(snapR?.error ?? "unknown")}`,
+      );
+    }
+    if (priceR?.status !== "success") {
+      throw new Error(
+        `Configured position priceData read failed: ${String(priceR?.error ?? "unknown")}`,
+      );
+    }
+    if (condR?.status !== "success") {
+      throw new Error(
+        `Configured position condition read failed: ${String(condR?.error ?? "unknown")}`,
+      );
+    }
+
+    const depositedBalance = balR.result as bigint;
+    if (typeof depositedBalance !== "bigint") {
+      throw new Error("Unexpected ERC1155.balanceOf return type");
+    }
+
+    const snap = _normalizeOraclePositionSnapshot(snapR.result, pid);
+    const priceData = _normalizeOraclePriceData(priceR.result, pid);
+    const conditionId = condR.result as `0x${string}`;
+    if (typeof conditionId !== "string" || !conditionId.startsWith("0x")) {
+      throw new Error("Unexpected getConditionId() return shape");
+    }
+
+    const fallbackPriceE8 = _minPositive(priceData.priceE8, priceData.twapE8);
+    const hasSnapshotPrice = snap.priceOk && snap.priceE8 > 0n;
+    const effectivePriceE8 = hasSnapshotPrice ? snap.priceE8 : fallbackPriceE8;
+    const priced = effectivePriceE8 > 0n;
+    const usedFallbackPrice = !hasSnapshotPrice && priced;
+    const depositValue = priced ? (depositedBalance * effectivePriceE8) / _E8 : 0n;
+
+    totalDepositedBalance += depositedBalance;
+    totalDepositedValue += depositValue;
+    if (priced) pricedCount += 1;
+
+    rows.push({
+      positionId: pid,
+      conditionId,
+      depositedBalance,
+      priceOk: snap.priceOk,
+      spotPriceE8: priceData.priceE8,
+      twapPriceE8: priceData.twapE8,
+      priceE8: snap.priceE8,
+      effectivePriceE8,
+      usedFallbackPrice,
+      depositValue,
+    });
+  }
+
+  return {
+    configuredCount: positionIds.length,
+    pricedCount,
+    totalDepositedBalance,
+    totalDepositedValue,
+    rows,
+  };
+}
+
 export type ReadLiquidationParamsForPosition = {
   positionId: bigint;
   maxLiquidationBonusBps: bigint;
@@ -1590,6 +1771,12 @@ type _OraclePositionSnapshot = {
   earlyClosureFactorWad: bigint;
 };
 
+type _OraclePriceData = {
+  positionId: bigint;
+  priceE8: bigint;
+  twapE8: bigint;
+};
+
 function _normalizeOraclePositionSnapshot(
   raw: unknown,
   positionId: bigint,
@@ -1621,6 +1808,31 @@ function _normalizeOraclePositionSnapshot(
   };
 }
 
+function _normalizeOraclePriceData(raw: unknown, positionId: bigint): _OraclePriceData {
+  const r: any = raw as any;
+  const priceE8 = r.price ?? r[0];
+  const twapE8 = r.twap ?? r[1];
+
+  if (typeof priceE8 !== "bigint" || typeof twapE8 !== "bigint") {
+    throw new Error("Unexpected getPriceData() return shape");
+  }
+
+  return {
+    positionId,
+    priceE8,
+    twapE8,
+  };
+}
+
+function _minPositive(a: bigint, b: bigint): bigint {
+  const aOk = a > 0n;
+  const bOk = b > 0n;
+  if (aOk && bOk) return a < b ? a : b;
+  if (aOk) return a;
+  if (bOk) return b;
+  return 0n;
+}
+
 function _tierDefaultLtv(defaultLtv: ReadDefaultLtvConfig, riskTier: number): bigint {
   if (riskTier === 0) return defaultLtv.conservative;
   if (riskTier === 1) return defaultLtv.moderate;

package/src/views/oracle.ts

@@ -275,6 +275,12 @@ export type ReadOracleTiming = {
   lastUpdated: bigint;
 };
 
+export type ReadOracleLowLiquidity = {
+  positionId: bigint;
+  lowLiquiditySince: bigint;
+  lowLiquidityFactorWad: bigint;
+};
+
 export type ReadOracleDashboardRow = {
   positionId: bigint;
   snapshot: ReadPositionSnapshot;
@@ -291,6 +297,65 @@ export type ReadOracleDashboard = {
   rows: ReadOracleDashboardRow[];
 };
 
+// wraps: VarlaOracle.getLowLiquiditySince,VarlaOracle.getLowLiquidityFactor
+export async function readManyOracleLowLiquidity(params: {
+  oracle: { address: Address };
+  client: { multicall: (args: any) => Promise<any> };
+  positionIds: readonly bigint[];
+  chunkSize?: number;
+}): Promise<ReadOracleLowLiquidity[]> {
+  const chunkSize = params.chunkSize ?? 256;
+  if (params.positionIds.length === 0) return [];
+
+  const calls = params.positionIds.flatMap((pid) => [
+    {
+      address: params.oracle.address,
+      abi: abis.VARLAORACLE_ABI,
+      functionName: "getLowLiquiditySince" as const,
+      args: [pid] as const,
+    },
+    {
+      address: params.oracle.address,
+      abi: abis.VARLAORACLE_ABI,
+      functionName: "getLowLiquidityFactor" as const,
+      args: [pid] as const,
+    },
+  ]);
+
+  const res = await multicallChunks({
+    client: params.client as any,
+    contracts: calls as any,
+    chunkSize,
+  });
+
+  const out: ReadOracleLowLiquidity[] = [];
+  const stride = 2;
+  for (let i = 0; i < params.positionIds.length; i++) {
+    const base = i * stride;
+    const r0: any = (res as any[])[base + 0];
+    const r1: any = (res as any[])[base + 1];
+
+    if (r0.status !== "success") {
+      throw new Error(
+        `Oracle getLowLiquiditySince multicall failed: ${String(r0.error ?? "unknown")}`,
+      );
+    }
+    if (r1.status !== "success") {
+      throw new Error(
+        `Oracle getLowLiquidityFactor multicall failed: ${String(r1.error ?? "unknown")}`,
+      );
+    }
+
+    out.push({
+      positionId: params.positionIds[i]!,
+      lowLiquiditySince: r0.result as bigint,
+      lowLiquidityFactorWad: r1.result as bigint,
+    });
+  }
+
+  return out;
+}
+
 // wraps: VarlaOracle.getPriceData
 export async function readOraclePriceData(params: {
   oracle: {

package/src/views/system.ts

@@ -1,6 +1,6 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 
-import type { ReadDefaultLtvConfig, ReadLiquidationConfig } from "./core.js";
+import type { ReadCoreAddresses, ReadDefaultLtvConfig, ReadLiquidationConfig } from "./core.js";
 import { readCoreDashboard, readDefaultLtvConfig, readLiquidationConfig } from "./core.js";
 import type { ReadOracleConfig } from "./oracle.js";
 import { readOracleConfig } from "./oracle.js";
@@ -25,6 +25,7 @@ export type ReadSystemSnapshot = {
 export type ReadSystemDashboardSnapshot = ReadSystemSnapshot & {
   poolSharePrice: ReadPoolSharePrice;
   poolHealthScore: ReadPoolHealthScore;
+  coreAddresses: ReadCoreAddresses;
 };
 
 /**
@@ -86,5 +87,6 @@ export async function readSystemDashboardSnapshot(params: {
     oracle,
     poolSharePrice: poolDashboard.sharePrice,
     poolHealthScore: poolDashboard.healthScore,
+    coreAddresses: coreDashboard.coreAddresses,
   };
 }