@varla/sdk 1.11.2 → 1.11.3

package/AGENTS.md

@@ -93,3 +93,97 @@ The SDK can provide raw primitives; **ranking is app-side**:
 - **Cooldown period**
   - As of `contracts/VarlaPool.sol` in this repo, there is **no cooldown / withdraw delay** view.
   - If a cooldown is introduced later, we can add `views.readPoolConfig({ pool })`.
+
+---
+
+## All view helpers (generated)
+
+<!-- BEGIN GENERATED:VIEW_HELPERS -->
+<!--
+This section is auto-generated by scripts/sdk-generate-docs.ts.
+Do not edit manually.
+-->
+
+- `getInterestRateStrategyFromPool`
+- `hydrateOraclePositionIds`
+- `previewBorrow`
+- `previewRepay`
+- `readAccessManagerBasics`
+- `readAccountPositions`
+- `readAccountPositionsFull`
+- `readAccountSnapshot`
+- `readAdapterInfo`
+- `readBadDebtStatus`
+- `readBorrowLimits`
+- `readBorrowerState`
+- `readBorrowers`
+- `readBorrowersPage`
+- `readCalculateLiquidationBonus`
+- `readCanLiquidate`
+- `readConfiguredPositionIds`
+- `readConvertLiquidatorBasics`
+- `readCoreAddresses`
+- `readCoreGlobalDebt`
+- `readDefaultLtvConfig`
+- `readHasRole`
+- `readHealthFactor`
+- `readInterestRateStrategyBasics`
+- `readLenderSnapshot`
+- `readLiquidationBonusBps`
+- `readLiquidationConfig`
+- `readLiquidationParamsForPosition`
+- `readLiquidatorBasics`
+- `readLiquidity`
+- `readLtvForPosition`
+- `readManyAccountSnapshots`
+- `readManyBorrowLimits`
+- `readManyHasRole`
+- `readManyLiquidationBonusBps`
+- `readManyOraclePositionMeta`
+- `readManyPositionSnapshots`
+- `readManyTargetConfigs`
+- `readManyTargetFunctionRoles`
+- `readMaxPositionsConfig`
+- `readMaxRedeem`
+- `readMaxWithdraw`
+- `readMergeLiquidatorBasics`
+- `readNegRiskMarketPositionIds`
+- `readOracleBasics`
+- `readOracleCollateralStatus`
+- `readOracleConfig`
+- `readOracleFinalizationStatus`
+- `readOracleGuardsStatus`
+- `readOraclePositionMeta`
+- `readOraclePriceData`
+- `readOracleRegistry`
+- `readOracleRegistryPage`
+- `readOracleTiming`
+- `readPoolAccounting`
+- `readPoolCaps`
+- `readPoolCoreAddress`
+- `readPoolDebtState`
+- `readPoolHealthScore`
+- `readPoolRates`
+- `readPoolSharePrice`
+- `readPoolSnapshot`
+- `readPortfolioValue`
+- `readPositionBalance`
+- `readPositionBalances`
+- `readPositionCount`
+- `readPositionLiquidationConfigOverride`
+- `readPositionLtvOverride`
+- `readPositionSnapshot`
+- `readPreviewLiquidation`
+- `readPrice`
+- `readProxyAdminPaused`
+- `readRepayTiming`
+- `readRiskTier`
+- `readRoleSummary`
+- `readSpotPrice`
+- `readSystemSnapshot`
+- `readTargetConfig`
+- `readTierLiquidationConfig`
+- `readTieredLtvConfig`
+- `readTryGetPrice`
+- `readTwap`
+<!-- END GENERATED:VIEW_HELPERS -->

package/BACKEND.md

@@ -308,3 +308,97 @@ Useful health signals to emit from a backend:
 - Treat RPC errors as expected: implement retry/backoff and fallbacks.
 - Keep multicalls bounded (chunking) to avoid RPC provider limits.
 
+---
+
+## All view helpers (generated)
+
+<!-- BEGIN GENERATED:VIEW_HELPERS -->
+<!--
+This section is auto-generated by scripts/sdk-generate-docs.ts.
+Do not edit manually.
+-->
+
+- `getInterestRateStrategyFromPool`
+- `hydrateOraclePositionIds`
+- `previewBorrow`
+- `previewRepay`
+- `readAccessManagerBasics`
+- `readAccountPositions`
+- `readAccountPositionsFull`
+- `readAccountSnapshot`
+- `readAdapterInfo`
+- `readBadDebtStatus`
+- `readBorrowLimits`
+- `readBorrowerState`
+- `readBorrowers`
+- `readBorrowersPage`
+- `readCalculateLiquidationBonus`
+- `readCanLiquidate`
+- `readConfiguredPositionIds`
+- `readConvertLiquidatorBasics`
+- `readCoreAddresses`
+- `readCoreGlobalDebt`
+- `readDefaultLtvConfig`
+- `readHasRole`
+- `readHealthFactor`
+- `readInterestRateStrategyBasics`
+- `readLenderSnapshot`
+- `readLiquidationBonusBps`
+- `readLiquidationConfig`
+- `readLiquidationParamsForPosition`
+- `readLiquidatorBasics`
+- `readLiquidity`
+- `readLtvForPosition`
+- `readManyAccountSnapshots`
+- `readManyBorrowLimits`
+- `readManyHasRole`
+- `readManyLiquidationBonusBps`
+- `readManyOraclePositionMeta`
+- `readManyPositionSnapshots`
+- `readManyTargetConfigs`
+- `readManyTargetFunctionRoles`
+- `readMaxPositionsConfig`
+- `readMaxRedeem`
+- `readMaxWithdraw`
+- `readMergeLiquidatorBasics`
+- `readNegRiskMarketPositionIds`
+- `readOracleBasics`
+- `readOracleCollateralStatus`
+- `readOracleConfig`
+- `readOracleFinalizationStatus`
+- `readOracleGuardsStatus`
+- `readOraclePositionMeta`
+- `readOraclePriceData`
+- `readOracleRegistry`
+- `readOracleRegistryPage`
+- `readOracleTiming`
+- `readPoolAccounting`
+- `readPoolCaps`
+- `readPoolCoreAddress`
+- `readPoolDebtState`
+- `readPoolHealthScore`
+- `readPoolRates`
+- `readPoolSharePrice`
+- `readPoolSnapshot`
+- `readPortfolioValue`
+- `readPositionBalance`
+- `readPositionBalances`
+- `readPositionCount`
+- `readPositionLiquidationConfigOverride`
+- `readPositionLtvOverride`
+- `readPositionSnapshot`
+- `readPreviewLiquidation`
+- `readPrice`
+- `readProxyAdminPaused`
+- `readRepayTiming`
+- `readRiskTier`
+- `readRoleSummary`
+- `readSpotPrice`
+- `readSystemSnapshot`
+- `readTargetConfig`
+- `readTierLiquidationConfig`
+- `readTieredLtvConfig`
+- `readTryGetPrice`
+- `readTwap`
+<!-- END GENERATED:VIEW_HELPERS -->
+

package/FRONTEND.md

@@ -388,3 +388,97 @@ This keeps UI components clean, and gives you one place to wire:
 - analytics
 - receipt confirmations
 - error mapping
+
+---
+
+## All view helpers (generated)
+
+<!-- BEGIN GENERATED:VIEW_HELPERS -->
+<!--
+This section is auto-generated by scripts/sdk-generate-docs.ts.
+Do not edit manually.
+-->
+
+- `getInterestRateStrategyFromPool`
+- `hydrateOraclePositionIds`
+- `previewBorrow`
+- `previewRepay`
+- `readAccessManagerBasics`
+- `readAccountPositions`
+- `readAccountPositionsFull`
+- `readAccountSnapshot`
+- `readAdapterInfo`
+- `readBadDebtStatus`
+- `readBorrowLimits`
+- `readBorrowerState`
+- `readBorrowers`
+- `readBorrowersPage`
+- `readCalculateLiquidationBonus`
+- `readCanLiquidate`
+- `readConfiguredPositionIds`
+- `readConvertLiquidatorBasics`
+- `readCoreAddresses`
+- `readCoreGlobalDebt`
+- `readDefaultLtvConfig`
+- `readHasRole`
+- `readHealthFactor`
+- `readInterestRateStrategyBasics`
+- `readLenderSnapshot`
+- `readLiquidationBonusBps`
+- `readLiquidationConfig`
+- `readLiquidationParamsForPosition`
+- `readLiquidatorBasics`
+- `readLiquidity`
+- `readLtvForPosition`
+- `readManyAccountSnapshots`
+- `readManyBorrowLimits`
+- `readManyHasRole`
+- `readManyLiquidationBonusBps`
+- `readManyOraclePositionMeta`
+- `readManyPositionSnapshots`
+- `readManyTargetConfigs`
+- `readManyTargetFunctionRoles`
+- `readMaxPositionsConfig`
+- `readMaxRedeem`
+- `readMaxWithdraw`
+- `readMergeLiquidatorBasics`
+- `readNegRiskMarketPositionIds`
+- `readOracleBasics`
+- `readOracleCollateralStatus`
+- `readOracleConfig`
+- `readOracleFinalizationStatus`
+- `readOracleGuardsStatus`
+- `readOraclePositionMeta`
+- `readOraclePriceData`
+- `readOracleRegistry`
+- `readOracleRegistryPage`
+- `readOracleTiming`
+- `readPoolAccounting`
+- `readPoolCaps`
+- `readPoolCoreAddress`
+- `readPoolDebtState`
+- `readPoolHealthScore`
+- `readPoolRates`
+- `readPoolSharePrice`
+- `readPoolSnapshot`
+- `readPortfolioValue`
+- `readPositionBalance`
+- `readPositionBalances`
+- `readPositionCount`
+- `readPositionLiquidationConfigOverride`
+- `readPositionLtvOverride`
+- `readPositionSnapshot`
+- `readPreviewLiquidation`
+- `readPrice`
+- `readProxyAdminPaused`
+- `readRepayTiming`
+- `readRiskTier`
+- `readRoleSummary`
+- `readSpotPrice`
+- `readSystemSnapshot`
+- `readTargetConfig`
+- `readTierLiquidationConfig`
+- `readTieredLtvConfig`
+- `readTryGetPrice`
+- `readTwap`
+<!-- END GENERATED:VIEW_HELPERS -->

package/dist/actions/oracleUpdaterRouter.d.ts

@@ -1,4 +1,4 @@
-import type { Address, Hash } from "viem";
+import type { Address, Hash, Hex } from "viem";
 /**
  * EIP-712 payload builder for OracleUpdaterRouter.
  *
@@ -51,6 +51,16 @@ export declare const ORACLE_UPDATER_ROUTER_TYPES: {
         readonly type: "bytes32";
     }];
 };
+/**
+ * Hardcoded UPDATE_TYPEHASH from the deployed OracleUpdaterRouter contract.
+ *
+ * Computed from:
+ * keccak256("Update(address oracle,uint256 chainId,address publisher,uint256 nonce,uint256 deadline,bytes32 positionIdsHash,bytes32 priceListHash,bytes32 twapListHash,bytes32 liquidityListHash)")
+ *
+ * IMPORTANT: This must match the contract's hardcoded UPDATE_TYPEHASH exactly.
+ * If the contract is redeployed with a different type hash, this must be updated.
+ */
+export declare const UPDATE_TYPEHASH: Hash;
 /**
  * Convert an update with dynamic arrays into the typed-data "message" shape expected by the router.
  */
@@ -65,9 +75,21 @@ export declare function toOracleUpdaterRouterTypedMessage(u: OracleUpdaterRouter
     readonly twapListHash: `0x${string}`;
     readonly liquidityListHash: `0x${string}`;
 };
+/**
+ * Compute the EIP-712 digest that should be signed.
+ * This manually computes the digest to ensure exact match with the contract's hashUpdate().
+ */
+export declare function computeOracleUpdaterDigest(params: {
+    routerAddress: Address;
+    update: OracleUpdaterRouterUpdate;
+}): Hash;
 export declare function signOracleUpdaterRouterUpdate(params: {
     walletClient: {
-        signTypedData: (args: any) => Promise<Hash>;
+        signMessage: (args: {
+            message: {
+                raw: Hex;
+            };
+        }) => Promise<Hash>;
     };
     routerAddress: Address;
     update: OracleUpdaterRouterUpdate;

package/dist/actions/oracleUpdaterRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oracleUpdaterRouter.d.ts","sourceRoot":"","sources":["../../src/actions/oracleUpdaterRouter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAK1C;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;CAG/B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY9B,CAAC;AAUX;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,yBAAyB;;;;;;;;;;EAY7E;AAED,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,YAAY,EAAE;QACZ,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7C,CAAC;IACF,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,yBAAyB,CAAC;CACnC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED,wBAAsB,6CAA6C,CAAC,MAAM,EAAE;IAC1E,YAAY,EAAE;QAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;IAChE,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,yBAAyB,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;CACjB,GAAG,OAAO,CAAC,GAAG,CAAC,CAqBf"}
+{"version":3,"file":"oracleUpdaterRouter.d.ts","sourceRoot":"","sources":["../../src/actions/oracleUpdaterRouter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAK/C;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;CAG/B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY9B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE,IACwC,CAAC;AAuBvE;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,yBAAyB;;;;;;;;;;EAY7E;AA+DD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,yBAAyB,CAAC;CACnC,GAAG,IAAI,CAMP;AAED,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,YAAY,EAAE;QACZ,WAAW,EAAE,CAAC,IAAI,EAAE;YAAE,OAAO,EAAE;gBAAE,GAAG,EAAE,GAAG,CAAA;aAAE,CAAA;SAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACjE,CAAC;IACF,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,yBAAyB,CAAC;CACnC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB;AAED,wBAAsB,6CAA6C,CAAC,MAAM,EAAE;IAC1E,YAAY,EAAE;QAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;IAChE,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,yBAAyB,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;CACjB,GAAG,OAAO,CAAC,GAAG,CAAC,CAqBf"}

package/dist/actions/oracleUpdaterRouter.js

@@ -1,5 +1,5 @@
 // Note: explicit .js extension is required for Node ESM resolution.
-import { encodeAbiParameters, keccak256 } from "viem";
+import { concat, encodeAbiParameters, encodePacked, keccak256, toHex } from "viem";
 import { abis } from "../generated.js";
 /**
  * EIP-712 payload builder for OracleUpdaterRouter.
@@ -25,13 +25,31 @@ export const ORACLE_UPDATER_ROUTER_TYPES = {
         { name: "liquidityListHash", type: "bytes32" },
     ],
 };
+/**
+ * Hardcoded UPDATE_TYPEHASH from the deployed OracleUpdaterRouter contract.
+ *
+ * Computed from:
+ * keccak256("Update(address oracle,uint256 chainId,address publisher,uint256 nonce,uint256 deadline,bytes32 positionIdsHash,bytes32 priceListHash,bytes32 twapListHash,bytes32 liquidityListHash)")
+ *
+ * IMPORTANT: This must match the contract's hardcoded UPDATE_TYPEHASH exactly.
+ * If the contract is redeployed with a different type hash, this must be updated.
+ */
+export const UPDATE_TYPEHASH = "0xfb5c9ee2f30c92eeb6fe0049d8ba63d98fcbb57cccd2761e2fd7275ac1bd9bd0";
+/**
+ * Hardcoded EIP712Domain type hash.
+ * keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)")
+ */
+const EIP712_DOMAIN_TYPEHASH = "0x8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f";
+/**
+ * Hash a uint256[] array using Solidity's abi.encodePacked semantics.
+ * Matches: keccak256(abi.encodePacked(uint256[]))
+ */
 function hashU256Array(xs) {
-    // Solidity uses keccak256(abi.encodePacked(uint256[])) for the struct hash.
-    // abi.encodePacked(uint256[]) is just tight packing of each uint256 as 32 bytes.
     if (xs.length === 0)
         return keccak256(new Uint8Array([]));
-    const bytes = encodeAbiParameters(Array(xs.length).fill({ type: "uint256" }), xs);
-    return keccak256(bytes);
+    // abi.encodePacked(uint256[]) is just tight packing of each uint256 as 32 bytes
+    const packed = encodePacked(xs.map(() => "uint256"), xs);
+    return keccak256(packed);
 }
 /**
  * Convert an update with dynamic arrays into the typed-data "message" shape expected by the router.
@@ -49,18 +67,74 @@ export function toOracleUpdaterRouterTypedMessage(u) {
         liquidityListHash: hashU256Array(u.liquidityList),
     };
 }
+/**
+ * Compute the EIP-712 domain separator for the OracleUpdaterRouter.
+ */
+function computeDomainSeparator(chainId, routerAddress) {
+    return keccak256(encodeAbiParameters([
+        { type: "bytes32" },
+        { type: "bytes32" },
+        { type: "bytes32" },
+        { type: "uint256" },
+        { type: "address" },
+    ], [
+        EIP712_DOMAIN_TYPEHASH,
+        keccak256(toHex(ORACLE_UPDATER_ROUTER_EIP712.name)),
+        keccak256(toHex(ORACLE_UPDATER_ROUTER_EIP712.version)),
+        chainId,
+        routerAddress,
+    ]));
+}
+/**
+ * Compute the struct hash for an Update using the contract's exact UPDATE_TYPEHASH.
+ * This bypasses viem's automatic type hash computation to ensure exact match with the contract.
+ */
+function computeStructHash(update) {
+    const msg = toOracleUpdaterRouterTypedMessage(update);
+    return keccak256(encodeAbiParameters([
+        { type: "bytes32" }, // UPDATE_TYPEHASH
+        { type: "address" }, // oracle
+        { type: "uint256" }, // chainId
+        { type: "address" }, // publisher
+        { type: "uint256" }, // nonce
+        { type: "uint256" }, // deadline
+        { type: "bytes32" }, // positionIdsHash
+        { type: "bytes32" }, // priceListHash
+        { type: "bytes32" }, // twapListHash
+        { type: "bytes32" }, // liquidityListHash
+    ], [
+        UPDATE_TYPEHASH,
+        msg.oracle,
+        msg.chainId,
+        msg.publisher,
+        msg.nonce,
+        msg.deadline,
+        msg.positionIdsHash,
+        msg.priceListHash,
+        msg.twapListHash,
+        msg.liquidityListHash,
+    ]));
+}
+/**
+ * Compute the EIP-712 digest that should be signed.
+ * This manually computes the digest to ensure exact match with the contract's hashUpdate().
+ */
+export function computeOracleUpdaterDigest(params) {
+    const domainSeparator = computeDomainSeparator(params.update.chainId, params.routerAddress);
+    const structHash = computeStructHash(params.update);
+    // EIP-712: "\x19\x01" ++ domainSeparator ++ structHash
+    return keccak256(concat(["0x1901", domainSeparator, structHash]));
+}
 export async function signOracleUpdaterRouterUpdate(params) {
-    return (await params.walletClient.signTypedData({
-        domain: {
-            name: ORACLE_UPDATER_ROUTER_EIP712.name,
-            version: ORACLE_UPDATER_ROUTER_EIP712.version,
-            chainId: params.update.chainId,
-            verifyingContract: params.routerAddress,
-        },
-        primaryType: "Update",
-        types: ORACLE_UPDATER_ROUTER_TYPES,
-        message: toOracleUpdaterRouterTypedMessage(params.update),
-    }));
+    // Manually compute the EIP-712 digest to ensure exact match with contract
+    const digest = computeOracleUpdaterDigest({
+        routerAddress: params.routerAddress,
+        update: params.update,
+    });
+    // Sign the raw digest (not a personal_sign, just the raw hash)
+    return params.walletClient.signMessage({
+        message: { raw: digest },
+    });
 }
 export async function prepareOracleUpdaterRouterUpdatePricesWithSig(params) {
     return await params.publicClient.simulateContract({

package/package.json

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