@varla/sdk 2.12.0 → 2.13.1

package/src/abi/subsets/VarlaOracle.registry.ts

@@ -170,6 +170,22 @@ export const VARLAORACLE_ABI_REGISTRY = [
     "name": "InvalidMaxStaleness",
     "type": "error"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "value",
+        "type": "uint256"
+      },
+      {
+        "internalType": "uint256",
+        "name": "floor",
+        "type": "uint256"
+      }
+    ],
+    "name": "InvalidMinLiquidity",
+    "type": "error"
+  },
   {
     "inputs": [
       {
@@ -396,6 +412,25 @@ export const VARLAORACLE_ABI_REGISTRY = [
     "name": "LowLiquidityConfigUpdated",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "bool",
+        "name": "oldValue",
+        "type": "bool"
+      },
+      {
+        "indexed": false,
+        "internalType": "bool",
+        "name": "newValue",
+        "type": "bool"
+      }
+    ],
+    "name": "LowLiquidityGraceBlocksLiquidationUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -440,6 +475,25 @@ export const VARLAORACLE_ABI_REGISTRY = [
     "name": "MaxStalenessUpdated",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "oldMinLiquidity",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "newMinLiquidity",
+        "type": "uint256"
+      }
+    ],
+    "name": "MinLiquidityUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [

package/src/addresses/index.ts

@@ -2,5 +2,5 @@
 // Do not edit manually.
 
 export * from "./polygon.js";
-export * from "./bsc.js";
+export * from "./polygonProxy.js";
 

package/src/addresses/polygon.json

@@ -3,15 +3,15 @@
   "generatedAt": "",
   "deploymentsDir": "polygon",
   "contracts": {
-    "VarlaAccessManager": "0x5CdDC155463929961Efa5d2F591E322eC747f10F",
-    "VarlaOracle": "0xcd0FEd1962e8cE1579bC36F1Bd13174B32648770",
-    "VarlaCore": "0x182796B1d17a75E8a65005371d3D529c1277e003",
-    "VarlaPool": "0xBaF1f2cfe38373198c4f7c4db3C208Aab0DeF8B0",
-    "OracleUpdaterRouter": "0x00Db61AfC2242b1fb7fcB91307f34bB1E3d3BfBe",
-    "VarlaLiquidator": "0x033F0ede074330ceC7Ff513D3C02cB26A6F56F7b",
-    "VarlaMergeLiquidator": "0xf07816374Fd0c626Db1F12642547a640C95E4CDC",
-    "VarlaConvertLiquidator": "0xD3Ee3e685AeA47819B087df6277f66baaF9F0Ed5",
-    "PolymarketCtfAdapter": "0x689968baC7A21Ca88867beb277CB29794C530259",
-    "PolymarketNegRiskMergeAdapter": "0xaD595Fc654a14C0dd037427623ac3b4Ff80E5D12"
+    "VarlaAccessManager": "0xEAC5659248A4f4c8440961874FA7994c6B821ad0",
+    "VarlaOracle": "0x6D6d16860c9366a97AbC02402cFe7988F9c20a8d",
+    "VarlaCore": "0x79870b76C01900e53a909b1F77d2CF3f1935c5D8",
+    "VarlaPool": "0xf1d4be6c15b6F7Fb66CE2C85368d26a603eb3cC0",
+    "OracleUpdaterRouter": "0xd98799d440034CeC1CE41c8495cdeF0dA18951C1",
+    "VarlaLiquidator": "0xD570aeFD9C54f816a53786ed1888fE4A03be359A",
+    "VarlaMergeLiquidator": "0x71becFD9AC3aeE3F3BD24A8518022147Efc18b4d",
+    "VarlaConvertLiquidator": "0x842905cA77B50eCDf2D890516fCD7E9A324B44e9",
+    "PolymarketCtfAdapter": "0x3bd6570DB3f6D6965F78399817678950d6eC6e4C",
+    "PolymarketNegRiskMergeAdapter": "0x424886B053D1eED5FE98A94988CFC8CA28c7C0A7"
   }
 }

package/src/addresses/polygon.ts

@@ -1,16 +1,18 @@
-// Auto-generated from varla-protocol deployments/polygon
+// Auto-generated from varla-protocol deployments/polygon (immutable)
 import type { AddressBook } from "../types";
 
 export const polygon: AddressBook = {
-  accessManager: "0x5CdDC155463929961Efa5d2F591E322eC747f10F",
-  oracle: "0xcd0FEd1962e8cE1579bC36F1Bd13174B32648770",
-  core: "0x182796B1d17a75E8a65005371d3D529c1277e003",
-  pool: "0xBaF1f2cfe38373198c4f7c4db3C208Aab0DeF8B0",
-  oracleUpdaterRouter: "0x00Db61AfC2242b1fb7fcB91307f34bB1E3d3BfBe",
-  liquidator: "0x033F0ede074330ceC7Ff513D3C02cB26A6F56F7b",
-  mergeLiquidator: "0xf07816374Fd0c626Db1F12642547a640C95E4CDC",
-  convertLiquidator: "0xD3Ee3e685AeA47819B087df6277f66baaF9F0Ed5",
-  polymarketCtfAdapter: "0x689968baC7A21Ca88867beb277CB29794C530259",
-  negRiskMergeAdapter: "0xaD595Fc654a14C0dd037427623ac3b4Ff80E5D12",
+  accessManager: "0xEAC5659248A4f4c8440961874FA7994c6B821ad0",
+  oracle: "0x6D6d16860c9366a97AbC02402cFe7988F9c20a8d",
+  core: "0x79870b76C01900e53a909b1F77d2CF3f1935c5D8",
+  pool: "0xf1d4be6c15b6F7Fb66CE2C85368d26a603eb3cC0",
+  oracleUpdaterRouter: "0xd98799d440034CeC1CE41c8495cdeF0dA18951C1",
+  interestRateStrategy: "0x6eE2F00463632476614a01332aD490c87978fa1d",
+  proxyAdmin: "0xf42B3A7E9850DF4D6Ea0a58CF72C531b3B479aAB",
+  liquidator: "0xD570aeFD9C54f816a53786ed1888fE4A03be359A",
+  mergeLiquidator: "0x71becFD9AC3aeE3F3BD24A8518022147Efc18b4d",
+  convertLiquidator: "0x842905cA77B50eCDf2D890516fCD7E9A324B44e9",
+  polymarketCtfAdapter: "0x3bd6570DB3f6D6965F78399817678950d6eC6e4C",
+  negRiskMergeAdapter: "0x424886B053D1eED5FE98A94988CFC8CA28c7C0A7",
 };
 

package/src/addresses/polygonProxy.ts

@@ -0,0 +1,18 @@
+// Auto-generated from varla-protocol deployments/polygon (proxy)
+import type { AddressBook } from "../types";
+
+export const polygonProxy: AddressBook = {
+  accessManager: "0xEAC5659248A4f4c8440961874FA7994c6B821ad0",
+  oracle: "0x1021A3B50F824873D96Ef126e4622cFFcD8d59bc",
+  core: "0x336A935210b39E01aC296f211274492caF013F77",
+  pool: "0x990DA16Fb01186C5Ffc3f185ff07c126C6705d76",
+  oracleUpdaterRouter: "0xd98799d440034CeC1CE41c8495cdeF0dA18951C1",
+  interestRateStrategy: "0x2C1D739947F1DD4F1E683f9e98F8c7B3d4a31464",
+  proxyAdmin: "0xf42B3A7E9850DF4D6Ea0a58CF72C531b3B479aAB",
+  liquidator: "0xDb94015Dd6304d86c637b218a867D15F49c3cC9b",
+  mergeLiquidator: "0xaCc7f056B0b9FEF713c5F317Bb65Fe660b3e1b2a",
+  convertLiquidator: "0x4d175bCCc5400Aca8b2d9E8c6c0aF179607fB935",
+  polymarketCtfAdapter: "0x3bd6570DB3f6D6965F78399817678950d6eC6e4C",
+  negRiskMergeAdapter: "0x424886B053D1eED5FE98A94988CFC8CA28c7C0A7",
+};
+

package/src/contracts.ts

@@ -11,7 +11,7 @@ import {
 } from "viem";
 
 import { abis, addresses } from "./generated.js";
-import type { AddressBook, ChainKey } from "./types.js";
+import type { AddressBook, ChainKey, DeployMode } from "./types.js";
 
 /**
  * A typed viem Contract instance.
@@ -53,15 +53,31 @@ export type VarlaContracts = {
 export type GetVarlaContractsParams = {
   chain: ChainKey;
   client: PublicClient;
+  /** Deployment mode. Defaults to `"immutable"`. */
+  mode?: DeployMode;
 };
 
-export function getAddressBook(chain: ChainKey): AddressBook {
-  if (chain === "polygon") return addresses.polygon;
-  if (chain === "bsc") return addresses.bsc;
-
-  // TypeScript should make this unreachable, but keep a runtime guard.
-  // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
-  throw new Error(`Unsupported chain key: ${chain as string}`);
+/**
+ * Resolve the address book for a chain + deployment mode.
+ *
+ * @param chain  - Chain key (`"polygon"` | `"bsc"`)
+ * @param mode   - `"immutable"` (default) or `"proxy"`
+ */
+export function getAddressBook(chain: ChainKey, mode?: DeployMode): AddressBook {
+  const m = mode ?? "immutable";
+
+  const key = m === "proxy" ? `${chain}Proxy` : chain;
+  const book = (addresses as Record<string, AddressBook | undefined>)[key];
+  if (!book) {
+    throw new Error(
+      m === "proxy"
+        ? `No proxy deployment found for chain '${chain}'. ` +
+            `Run the deploy with DEPLOY_MODE=proxy and regenerate SDK artifacts.`
+        : `No deployment found for chain '${chain}'. ` +
+            `Deploy the chain and run \`bun run prepack\` to regenerate SDK artifacts.`,
+    );
+  }
+  return book;
 }
 
 function mustAddress(book: AddressBook, key: keyof AddressBook): Address {
@@ -77,8 +93,12 @@ function mustAddress(book: AddressBook, key: keyof AddressBook): Address {
  *
  * Optional deployments are returned as `undefined`.
  */
-export function getVarlaContracts({ chain, client }: GetVarlaContractsParams): VarlaContracts {
-  const book = getAddressBook(chain);
+export function getVarlaContracts({
+  chain,
+  client,
+  mode,
+}: GetVarlaContractsParams): VarlaContracts {
+  const book = getAddressBook(chain, mode);
 
   const accessManager = getContract({
     address: mustAddress(book, "accessManager"),

package/src/generated.ts

@@ -24,6 +24,6 @@ export const abis = {
 
 export const addresses = {
   polygon: addresses_.polygon,
-  bsc: addresses_.bsc,
+  polygonProxy: addresses_.polygonProxy,
 } as const;
 

package/src/types.ts

@@ -1,5 +1,13 @@
 export type ChainKey = "polygon" | "bsc";
 
+/**
+ * Deployment mode.
+ *
+ * - `"immutable"` — contracts deployed directly (dev/testing, default)
+ * - `"proxy"`     — contracts behind TransparentUpgradeableProxy (production/TVL)
+ */
+export type DeployMode = "immutable" | "proxy";
+
 /**
  * Minimal address book for off-chain services.
  *

package/src/views/admin.ts

@@ -1,8 +1,9 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 
-import { type Address, getContract, type PublicClient } from "viem";
+import { type Address, getAddress, getContract, type PublicClient } from "viem";
 
 import { abis } from "../generated.js";
+import type { DeployMode } from "../types.js";
 
 type StrategyLike = {
   read: {
@@ -90,3 +91,85 @@ export async function readProxyAdminPaused(params: {
 }): Promise<boolean> {
   return params.proxyAdmin.read.paused();
 }
+
+// ---------------------------------------------------------------------------
+// Proxy detection — EIP-1967
+// ---------------------------------------------------------------------------
+
+/**
+ * EIP-1967 implementation storage slot.
+ * `bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1)`
+ */
+const EIP1967_IMPL_SLOT =
+  "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc" as const;
+
+/**
+ * EIP-1967 admin storage slot.
+ * `bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1)`
+ */
+const EIP1967_ADMIN_SLOT =
+  "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103" as const;
+
+function slotToAddress(raw: string | undefined): Address | undefined {
+  if (!raw || raw === "0x" || BigInt(raw) === 0n) return undefined;
+  // Slot value is 32 bytes, address is the lower 20 bytes.
+  return getAddress(`0x${raw.slice(-40)}`);
+}
+
+export type ProxyInfo = {
+  isProxy: boolean;
+  implementation?: Address;
+  proxyAdmin?: Address;
+};
+
+/**
+ * Detect whether a contract address is behind an EIP-1967 transparent proxy.
+ *
+ * Returns `"proxy"` if the EIP-1967 implementation slot is non-zero,
+ * `"immutable"` otherwise.
+ */
+// wraps: eth_getStorageAt (EIP-1967 implementation slot)
+export async function readDeploymentMode(params: {
+  client: PublicClient;
+  address: Address;
+}): Promise<DeployMode> {
+  const raw = await params.client.getStorageAt({
+    address: params.address,
+    slot: EIP1967_IMPL_SLOT,
+  });
+  const impl = slotToAddress(raw);
+  return impl ? "proxy" : "immutable";
+}
+
+/**
+ * Read EIP-1967 proxy details (implementation + admin addresses).
+ *
+ * If the address is not a proxy, returns `{ isProxy: false }`.
+ */
+// wraps: eth_getStorageAt (EIP-1967 implementation + admin slots)
+export async function readProxyInfo(params: {
+  client: PublicClient;
+  address: Address;
+}): Promise<ProxyInfo> {
+  const [implRaw, adminRaw] = await Promise.all([
+    params.client.getStorageAt({
+      address: params.address,
+      slot: EIP1967_IMPL_SLOT,
+    }),
+    params.client.getStorageAt({
+      address: params.address,
+      slot: EIP1967_ADMIN_SLOT,
+    }),
+  ]);
+
+  const implementation = slotToAddress(implRaw);
+  const proxyAdmin = slotToAddress(adminRaw);
+
+  if (!implementation) return { isProxy: false };
+
+  return {
+    isProxy: true,
+    implementation,
+    proxyAdmin,
+  };
+}