@varla/sdk 1.2.0 → 1.10.0

package/dist/views/core.d.ts

@@ -6,6 +6,13 @@ export type ReadAccountSnapshot = {
     healthFactor: bigint;
     maxBorrow: bigint;
 };
+export type ReadCoreAddresses = {
+    collateralToken: Address;
+    positionsToken: Address;
+    pool: Address;
+    oracle: Address;
+    collateralDecimals: number;
+};
 export declare function readAccountSnapshot(params: {
     core: {
         read: {
@@ -14,6 +21,148 @@ export declare function readAccountSnapshot(params: {
     };
     user: Address;
 }): Promise<ReadAccountSnapshot>;
+/**
+ * Read VarlaCore wiring + token metadata that most consumers need.
+ */
+export declare function readCoreAddresses(params: {
+    core: {
+        read: {
+            collateralToken: () => Promise<Address>;
+            positionsToken: () => Promise<Address>;
+            pool: () => Promise<Address>;
+            oracle: () => Promise<Address>;
+            collateralDecimals: () => Promise<number | bigint>;
+        };
+    };
+}): Promise<ReadCoreAddresses>;
+export type ReadMaxPositionsConfig = {
+    maxPositions: bigint;
+    minMaxPositions: bigint;
+    maxMaxPositions: bigint;
+};
+/**
+ * Read max-positions safety bounds + current value (useful for deposit UX).
+ */
+export declare function readMaxPositionsConfig(params: {
+    core: {
+        read: {
+            maxPositions: () => Promise<bigint>;
+            minMaxPositions: () => Promise<bigint>;
+            maxMaxPositions: () => Promise<bigint>;
+        };
+    };
+}): Promise<ReadMaxPositionsConfig>;
+export type ReadAccountPositionsFull = {
+    user: Address;
+    positionIds: bigint[];
+    balances: bigint[];
+};
+/**
+ * Single-call alternative to `readAccountPositions` (no multicall).
+ */
+export declare function readAccountPositionsFull(params: {
+    core: {
+        read: {
+            getPositions: (args: readonly [Address]) => Promise<unknown>;
+        };
+    };
+    user: Address;
+}): Promise<ReadAccountPositionsFull>;
+export type ReadPositionBalances = {
+    user: Address;
+    positionIds: bigint[];
+    balances: bigint[];
+};
+/**
+ * Efficiently hydrate balances for a known list of ids.
+ */
+export declare function readPositionBalances(params: {
+    core: {
+        read: {
+            getPositionBalances: (args: readonly [Address, readonly bigint[]]) => Promise<readonly bigint[]>;
+        };
+    };
+    user: Address;
+    positionIds: readonly bigint[];
+}): Promise<ReadPositionBalances>;
+export type ReadBorrowerState = {
+    user: Address;
+    scaledDebt: bigint;
+    isBorrower: boolean;
+    isLiquidatable: boolean;
+};
+export type ReadPortfolioValue = {
+    user: Address;
+    portfolioValue: bigint;
+};
+export type ReadCoreGlobalDebt = {
+    totalScaledDebt: bigint;
+};
+export type ReadPositionLiquidationConfigOverride = {
+    positionId: bigint;
+    isSet: boolean;
+    maxLiquidationBonusBps: bigint;
+    liquidationFeeBps: bigint;
+};
+/**
+ * Cheap “badge” state useful for account lists and monitoring.
+ */
+export declare function readBorrowerState(params: {
+    core: {
+        read: {
+            getScaledDebt: (args: readonly [Address]) => Promise<bigint>;
+            isBorrower: (args: readonly [Address]) => Promise<boolean>;
+            isLiquidatable: (args: readonly [Address]) => Promise<boolean>;
+        };
+    };
+    user: Address;
+}): Promise<ReadBorrowerState>;
+export declare function readPortfolioValue(params: {
+    core: {
+        read: {
+            getPortfolioValue: (args: readonly [Address]) => Promise<bigint>;
+        };
+    };
+    user: Address;
+}): Promise<ReadPortfolioValue>;
+/**
+ * WARNING: can be large. Prefer `readBorrowersPage` for backends.
+ */
+export declare function readBorrowers(params: {
+    core: {
+        read: {
+            getBorrowers: () => Promise<readonly Address[]>;
+        };
+    };
+}): Promise<Address[]>;
+export declare function readCoreGlobalDebt(params: {
+    core: {
+        read: {
+            totalScaledDebt: () => Promise<bigint>;
+        };
+    };
+}): Promise<ReadCoreGlobalDebt>;
+export declare function readPositionLiquidationConfigOverride(params: {
+    core: {
+        read: {
+            getPositionLiquidationConfigOverride: (args: readonly [bigint]) => Promise<unknown>;
+        };
+    };
+    positionId: bigint;
+}): Promise<ReadPositionLiquidationConfigOverride>;
+export declare function readPositionBalance(params: {
+    core: {
+        read: {
+            positionBalances: (args: readonly [Address, bigint]) => Promise<bigint>;
+        };
+    };
+    user: Address;
+    positionId: bigint;
+}): Promise<{
+    user: Address;
+    positionId: bigint;
+    balance: bigint;
+}>;
 export declare function readAccountPositions(params: {
     core: {
         address: Address;
@@ -30,6 +179,48 @@ export declare function readAccountPositions(params: {
     positionIds: bigint[];
     balances: bigint[];
 }>;
+export type ReadBorrowersPage = {
+    total: number;
+    start: number;
+    end: number;
+    borrowers: Address[];
+};
+/**
+ * Paged read of Core's `_borrowers` set.
+ *
+ * This is intended for monitoring/indexers; it avoids returning a massive array.
+ */
+export declare function readBorrowersPage(params: {
+    core: {
+        address: Address;
+        read: {
+            getBorrowersCount: () => Promise<bigint>;
+        };
+    };
+    client: {
+        multicall: (args: any) => Promise<any>;
+    };
+    start: number;
+    limit: number;
+    chunkSize?: number;
+}): Promise<ReadBorrowersPage>;
+/**
+ * Hydrates a list of borrowers into normalized snapshots.
+ *
+ * Returns results aligned to input order.
+ */
+export declare function readManyAccountSnapshots(params: {
+    core: {
+        address: Address;
+    };
+    client: {
+        multicall: (args: any) => Promise<any>;
+    };
+    users: readonly Address[];
+    chunkSize?: number;
+}): Promise<Array<{
+    user: Address;
+} & ReadAccountSnapshot>>;
 export type ReadHealthFactor = {
     healthFactor: bigint;
     canBeLiquidated: boolean;
@@ -180,4 +371,39 @@ export declare function readManyLiquidationBonusBps(params: {
     healthFactors: readonly bigint[];
     chunkSize?: number;
 }): Promise<ReadManyLiquidationBonusBpsRow[]>;
+export type ReadBorrowLimits = {
+    user: Address;
+    collateralValue: bigint;
+    debt: bigint;
+    maxBorrow: bigint;
+    healthFactor: bigint;
+    canBeLiquidated: boolean;
+};
+/**
+ * A small convenience bundle for frontends/backends.
+ */
+export declare function readBorrowLimits(params: {
+    core: {
+        read: {
+            getCollateralValue: (args: readonly [Address]) => Promise<bigint>;
+            getDebt: (args: readonly [Address]) => Promise<bigint>;
+            getMaxBorrow: (args: readonly [Address]) => Promise<bigint>;
+            getHealthFactor: (args: readonly [Address]) => Promise<unknown>;
+        };
+    };
+    user: Address;
+}): Promise<ReadBorrowLimits>;
+/**
+ * Multicall-chunked version of `readBorrowLimits`.
+ */
+export declare function readManyBorrowLimits(params: {
+    core: {
+        address: Address;
+    };
+    client: {
+        multicall: (args: any) => Promise<any>;
+    };
+    users: readonly Address[];
+    chunkSize?: number;
+}): Promise<ReadBorrowLimits[]>;
 //# sourceMappingURL=core.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/views/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/views/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAGF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACnE,CAAC;KACH,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyB/B;AAED;;GAEG;AAEH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACxC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;SACpD,CAAC;KACH,CAAC;CACH,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkB7B;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AAEH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YACpC,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YACvC,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;SACxC,CAAC;KACH,CAAC;CACH,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAOlC;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;GAEG;AAEH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC9D,CAAC;KACH,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAcpC;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;GAEG;AAEH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,mBAAmB,EAAE,CACnB,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,KACxC,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;SACjC,CAAC;KACH,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAOhC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AAEH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,aAAa,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7D,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3D,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAChE,CAAC;KACH,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAO7B;AAGD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE;QAAE,IAAI,EAAE;YAAE,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IACrF,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG9B;AAED;;GAEG;AAEH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,IAAI,EAAE;QAAE,IAAI,EAAE;YAAE,YAAY,EAAE,MAAM,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CACrE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGrB;AAGD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE;QAAE,IAAI,EAAE;YAAE,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CAC5D,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG9B;AAGD,wBAAsB,qCAAqC,CAAC,MAAM,EAAE;IAClE,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,oCAAoC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACrF,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAcjD;AAGD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,gBAAgB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;SACzE,CAAC;KACH,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAGlE;AAGD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE;YACJ,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;SAC1E,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACxC,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8BzD;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AAEH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,IAAI,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE;YACJ,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;SAC1C,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+C7B;AAED;;;;GAIG;AAEH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,MAAM,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;IACnD,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,mBAAmB,CAAC,CAAC,CAkC1D;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AAEH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,eAAe,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACjE,CAAC;KACH,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAW5B;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF;;GAEG;AAEH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,oBAAoB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;SAC9C,CAAC;KACH,CAAC;CACH,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2BjC;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AAEH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,mBAAmB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;SAC7C,CAAC;KACH,CAAC;CACH,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiBhC;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AAEH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,wBAAwB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACzE,CAAC;KACH,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAWrC;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AAEH,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,+BAA+B,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAChF,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAW5C;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AAEH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,sBAAsB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACvE,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAWnC;AAED;;;;GAIG;AAEH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;SACjE,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAGlD;AAED;;GAEG;AAEH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,sBAAsB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;SAC9E,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1E;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AAEH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,MAAM,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;IACnD,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC,CA2C5C;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;GAEG;AAEH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,kBAAkB,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;YAClE,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;YACvD,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5D,eAAe,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACjE,CAAC;KACH,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgB5B;AAED;;GAEG;AAEH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,MAAM,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;IACnD,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA8E9B"}

package/dist/views/core.js

@@ -1,6 +1,7 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 import { multicallChunks } from "../batch.js";
 import { abis } from "../generated.js";
+// wraps: VarlaCore.getAccountSummary
 export async function readAccountSnapshot(params) {
     const raw = await params.core.read.getAccountSummary([params.user]);
     // viem returns Solidity tuples as arrays (with optional named properties).
@@ -21,6 +22,118 @@ export async function readAccountSnapshot(params) {
     }
     return { portfolioValue, collateralValue, debt, healthFactor, maxBorrow };
 }
+/**
+ * Read VarlaCore wiring + token metadata that most consumers need.
+ */
+// wraps: VarlaCore.collateralToken,VarlaCore.positionsToken,VarlaCore.pool,VarlaCore.oracle,VarlaCore.collateralDecimals
+export async function readCoreAddresses(params) {
+    const [collateralToken, positionsToken, pool, oracle, collateralDecimalsRaw] = await Promise.all([
+        params.core.read.collateralToken(),
+        params.core.read.positionsToken(),
+        params.core.read.pool(),
+        params.core.read.oracle(),
+        params.core.read.collateralDecimals(),
+    ]);
+    const collateralDecimals = typeof collateralDecimalsRaw === "bigint"
+        ? Number(collateralDecimalsRaw)
+        : collateralDecimalsRaw;
+    if (!Number.isInteger(collateralDecimals) || collateralDecimals < 0) {
+        throw new Error(`Invalid collateralDecimals: ${String(collateralDecimalsRaw)}`);
+    }
+    return { collateralToken, positionsToken, pool, oracle, collateralDecimals };
+}
+/**
+ * Read max-positions safety bounds + current value (useful for deposit UX).
+ */
+// wraps: VarlaCore.maxPositions,VarlaCore.minMaxPositions,VarlaCore.maxMaxPositions
+export async function readMaxPositionsConfig(params) {
+    const [maxPositions, minMaxPositions, maxMaxPositions] = await Promise.all([
+        params.core.read.maxPositions(),
+        params.core.read.minMaxPositions(),
+        params.core.read.maxMaxPositions(),
+    ]);
+    return { maxPositions, minMaxPositions, maxMaxPositions };
+}
+/**
+ * Single-call alternative to `readAccountPositions` (no multicall).
+ */
+// wraps: VarlaCore.getPositions
+export async function readAccountPositionsFull(params) {
+    const raw = await params.core.read.getPositions([params.user]);
+    const r = raw;
+    const positionIds = (r.positionIds ?? r[0]);
+    const balances = (r.balances ?? r[1]);
+    if (!Array.isArray(positionIds) || !Array.isArray(balances)) {
+        throw new Error("Unexpected getPositions() return shape");
+    }
+    return {
+        user: params.user,
+        positionIds: positionIds,
+        balances: balances,
+    };
+}
+/**
+ * Efficiently hydrate balances for a known list of ids.
+ */
+// wraps: VarlaCore.getPositionBalances
+export async function readPositionBalances(params) {
+    const balancesReadonly = await params.core.read.getPositionBalances([
+        params.user,
+        params.positionIds,
+    ]);
+    const balances = [...balancesReadonly];
+    return { user: params.user, positionIds: [...params.positionIds], balances };
+}
+/**
+ * Cheap “badge” state useful for account lists and monitoring.
+ */
+// wraps: VarlaCore.getScaledDebt,VarlaCore.isBorrower,VarlaCore.isLiquidatable
+export async function readBorrowerState(params) {
+    const [scaledDebt, isBorrower, isLiquidatable] = await Promise.all([
+        params.core.read.getScaledDebt([params.user]),
+        params.core.read.isBorrower([params.user]),
+        params.core.read.isLiquidatable([params.user]),
+    ]);
+    return { user: params.user, scaledDebt, isBorrower, isLiquidatable };
+}
+// wraps: VarlaCore.getPortfolioValue
+export async function readPortfolioValue(params) {
+    const portfolioValue = await params.core.read.getPortfolioValue([params.user]);
+    return { user: params.user, portfolioValue };
+}
+/**
+ * WARNING: can be large. Prefer `readBorrowersPage` for backends.
+ */
+// wraps: VarlaCore.getBorrowers
+export async function readBorrowers(params) {
+    const borrowers = await params.core.read.getBorrowers();
+    return [...borrowers];
+}
+// wraps: VarlaCore.totalScaledDebt
+export async function readCoreGlobalDebt(params) {
+    const totalScaledDebt = await params.core.read.totalScaledDebt();
+    return { totalScaledDebt };
+}
+// wraps: VarlaCore.getPositionLiquidationConfigOverride
+export async function readPositionLiquidationConfigOverride(params) {
+    const raw = await params.core.read.getPositionLiquidationConfigOverride([params.positionId]);
+    const r = raw;
+    const isSet = r.isSet ?? r[0];
+    const maxLiquidationBonusBps = r.maxLiquidationBonusBps ?? r[1];
+    const liquidationFeeBps = r.liquidationFeeBps ?? r[2];
+    if (typeof isSet !== "boolean" ||
+        typeof maxLiquidationBonusBps !== "bigint" ||
+        typeof liquidationFeeBps !== "bigint") {
+        throw new Error("Unexpected getPositionLiquidationConfigOverride() return shape");
+    }
+    return { positionId: params.positionId, isSet, maxLiquidationBonusBps, liquidationFeeBps };
+}
+// wraps: VarlaCore.positionBalances
+export async function readPositionBalance(params) {
+    const balance = await params.core.read.positionBalances([params.user, params.positionId]);
+    return { user: params.user, positionId: params.positionId, balance };
+}
+// wraps: VarlaCore.getPositionIds,VarlaCore.getPositionBalance
 export async function readAccountPositions(params) {
     const { core, client, user } = params;
     const chunkSize = params.chunkSize ?? 256;
@@ -48,11 +161,98 @@ export async function readAccountPositions(params) {
     }
     return { positionIds, balances };
 }
+/**
+ * Paged read of Core's `_borrowers` set.
+ *
+ * This is intended for monitoring/indexers; it avoids returning a massive array.
+ */
+// wraps: VarlaCore.getBorrowersCount,VarlaCore.getBorrowerAt
+export async function readBorrowersPage(params) {
+    const chunkSize = params.chunkSize ?? 256;
+    if (!Number.isInteger(params.start) || params.start < 0) {
+        throw new Error(`Invalid start: ${params.start}`);
+    }
+    if (!Number.isInteger(params.limit) || params.limit <= 0) {
+        throw new Error(`Invalid limit: ${params.limit}`);
+    }
+    const count = await params.core.read.getBorrowersCount();
+    const total = Number(count);
+    if (!Number.isSafeInteger(total) || total < 0) {
+        throw new Error(`Invalid borrowers count: ${count}`);
+    }
+    const start = Math.min(params.start, total);
+    const end = Math.min(total, start + params.limit);
+    if (end <= start) {
+        return { total, start, end, borrowers: [] };
+    }
+    const calls = Array.from({ length: end - start }, (_, j) => {
+        const i = start + j;
+        return {
+            address: params.core.address,
+            abi: abis.VARLACORE_ABI,
+            functionName: "getBorrowerAt",
+            args: [BigInt(i)],
+        };
+    });
+    const res = await multicallChunks({
+        client: params.client,
+        contracts: calls,
+        chunkSize,
+    });
+    const borrowers = [];
+    for (const r of res) {
+        if (r.status !== "success") {
+            throw new Error(`Core getBorrowerAt multicall failed: ${String(r.error ?? "unknown")}`);
+        }
+        borrowers.push(r.result);
+    }
+    return { total, start, end, borrowers };
+}
+/**
+ * Hydrates a list of borrowers into normalized snapshots.
+ *
+ * Returns results aligned to input order.
+ */
+// wraps: VarlaCore.getAccountSummary
+export async function readManyAccountSnapshots(params) {
+    const chunkSize = params.chunkSize ?? 256;
+    if (params.users.length === 0)
+        return [];
+    const calls = params.users.map((user) => ({
+        address: params.core.address,
+        abi: abis.VARLACORE_ABI,
+        functionName: "getAccountSummary",
+        args: [user],
+    }));
+    const res = await multicallChunks({
+        client: params.client,
+        contracts: calls,
+        chunkSize,
+    });
+    const out = [];
+    for (let i = 0; i < res.length; i++) {
+        const r = res[i];
+        if (r.status !== "success") {
+            throw new Error(`Core getAccountSummary multicall failed: ${String(r.error ?? "unknown")}`);
+        }
+        const snap = await readAccountSnapshot({
+            core: {
+                read: {
+                    getAccountSummary: async () => r.result,
+                },
+            },
+            user: params.users[i],
+        });
+        out.push({ user: params.users[i], ...snap });
+    }
+    return out;
+}
 /**
  * Read the user's health factor and whether liquidation is currently allowed.
  *
  * Normalizes `VarlaCore.getHealthFactor(user)` tuple return.
  */
+// wraps: VarlaCore.getHealthFactor
 export async function readHealthFactor(params) {
     const raw = await params.core.read.getHealthFactor([params.user]);
     const r = raw;
@@ -66,6 +266,7 @@ export async function readHealthFactor(params) {
 /**
  * Normalized wrapper over `VarlaCore.getLiquidationConfig()`.
  */
+// wraps: VarlaCore.getLiquidationConfig
 export async function readLiquidationConfig(params) {
     const raw = await params.core.read.getLiquidationConfig();
     const r = raw;
@@ -92,6 +293,7 @@ export async function readLiquidationConfig(params) {
 /**
  * Normalized wrapper over `VarlaCore.getDefaultLtvConfig()`.
  */
+// wraps: VarlaCore.getDefaultLtvConfig
 export async function readDefaultLtvConfig(params) {
     const raw = await params.core.read.getDefaultLtvConfig();
     const r = raw;
@@ -108,6 +310,7 @@ export async function readDefaultLtvConfig(params) {
 /**
  * Normalized wrapper over `VarlaCore.getTierLiquidationConfig(tier)`.
  */
+// wraps: VarlaCore.getTierLiquidationConfig
 export async function readTierLiquidationConfig(params) {
     const raw = await params.core.read.getTierLiquidationConfig([params.tier]);
     const r = raw;
@@ -121,6 +324,7 @@ export async function readTierLiquidationConfig(params) {
 /**
  * Normalized wrapper over `VarlaCore.getLiquidationParamsForPosition(positionId)`.
  */
+// wraps: VarlaCore.getLiquidationParamsForPosition
 export async function readLiquidationParamsForPosition(params) {
     const raw = await params.core.read.getLiquidationParamsForPosition([params.positionId]);
     const r = raw;
@@ -134,6 +338,7 @@ export async function readLiquidationParamsForPosition(params) {
 /**
  * Normalized wrapper over `VarlaCore.getPositionLtvOverride(positionId)`.
  */
+// wraps: VarlaCore.getPositionLtvOverride
 export async function readPositionLtvOverride(params) {
     const raw = await params.core.read.getPositionLtvOverride([params.positionId]);
     const r = raw;
@@ -149,6 +354,7 @@ export async function readPositionLtvOverride(params) {
  *
  * This is the *effective* LTV for the position (includes early-closure factor and overrides).
  */
+// wraps: VarlaCore.getLtvForPosition
 export async function readLtvForPosition(params) {
     const ltvWad = await params.core.read.getLtvForPosition([params.positionId]);
     return { positionId: params.positionId, ltvWad };
@@ -156,6 +362,7 @@ export async function readLtvForPosition(params) {
 /**
  * Thin wrapper over `VarlaCore.getLiquidationBonusBps(positionId, healthFactor)`.
  */
+// wraps: VarlaCore.getLiquidationBonusBps
 export async function readLiquidationBonusBps(params) {
     const bonusBps = await params.core.read.getLiquidationBonusBps([
         params.positionId,
@@ -168,6 +375,7 @@ export async function readLiquidationBonusBps(params) {
  *
  * Useful for UIs that need to visualize liquidation incentive curves.
  */
+// wraps: VarlaCore.getLiquidationBonusBps
 export async function readManyLiquidationBonusBps(params) {
     const chunkSize = params.chunkSize ?? 256;
     if (params.positionIds.length === 0)
@@ -204,3 +412,99 @@ export async function readManyLiquidationBonusBps(params) {
     }
     return out;
 }
+/**
+ * A small convenience bundle for frontends/backends.
+ */
+// wraps: VarlaCore.getCollateralValue,VarlaCore.getDebt,VarlaCore.getMaxBorrow,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]),
+        readHealthFactor({ core: params.core, user: params.user }),
+    ]);
+    return {
+        user: params.user,
+        collateralValue,
+        debt,
+        maxBorrow,
+        healthFactor: hf.healthFactor,
+        canBeLiquidated: hf.canBeLiquidated,
+    };
+}
+/**
+ * Multicall-chunked version of `readBorrowLimits`.
+ */
+// wraps: VarlaCore.getCollateralValue,VarlaCore.getDebt,VarlaCore.getMaxBorrow,VarlaCore.getHealthFactor
+export async function readManyBorrowLimits(params) {
+    const chunkSize = params.chunkSize ?? 256;
+    if (params.users.length === 0)
+        return [];
+    const calls = params.users.flatMap((user) => [
+        {
+            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",
+            args: [user],
+        },
+        {
+            address: params.core.address,
+            abi: abis.VARLACORE_ABI,
+            functionName: "getHealthFactor",
+            args: [user],
+        },
+    ]);
+    const res = await multicallChunks({
+        client: params.client,
+        contracts: calls,
+        chunkSize,
+    });
+    const out = [];
+    const stride = 4;
+    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")}`);
+        }
+        if (r1.status !== "success") {
+            throw new Error(`Core getDebt multicall failed: ${String(r1.error ?? "unknown")}`);
+        }
+        if (r2.status !== "success") {
+            throw new Error(`Core getMaxBorrow multicall failed: ${String(r2.error ?? "unknown")}`);
+        }
+        if (r3.status !== "success") {
+            throw new Error(`Core getHealthFactor multicall failed: ${String(r3.error ?? "unknown")}`);
+        }
+        const hfRaw = r3.result;
+        const healthFactor = hfRaw.healthFactor ?? hfRaw[0];
+        const canBeLiquidated = hfRaw.canBeLiquidated ?? hfRaw[1];
+        if (typeof healthFactor !== "bigint" || typeof canBeLiquidated !== "boolean") {
+            throw new Error("Unexpected getHealthFactor() return shape");
+        }
+        out.push({
+            user: params.users[i],
+            collateralValue: r0.result,
+            debt: r1.result,
+            maxBorrow: r2.result,
+            healthFactor,
+            canBeLiquidated,
+        });
+    }
+    return out;
+}

package/dist/views/index.d.ts

@@ -5,4 +5,5 @@ export * from "./adapters.js";
 export * from "./accessManager.js";
 export * from "./admin.js";
 export * from "./liquidators.js";
+export * from "./system.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/views/index.js

@@ -6,3 +6,4 @@ export * from "./adapters.js";
 export * from "./accessManager.js";
 export * from "./admin.js";
 export * from "./liquidators.js";
+export * from "./system.js";