@varla/sdk 2.3.1 → 2.5.0

package/src/abi/index.ts

@@ -11,7 +11,9 @@ export { VARLAPROXYADMIN_ABI } from "./full/VarlaProxyAdmin.js";
 export { VARLALIQUIDATOR_ABI } from "./full/VarlaLiquidator.js";
 export { VARLAMERGELIQUIDATOR_ABI } from "./full/VarlaMergeLiquidator.js";
 export { VARLACONVERTLIQUIDATOR_ABI } from "./full/VarlaConvertLiquidator.js";
+export { VARLASTAKING_ABI } from "./full/VarlaStaking.js";
 export { POLYMARKETCTFADAPTER_ABI } from "./full/PolymarketCtfAdapter.js";
+export { POLYMARKETNEGRISKMERGEADAPTER_ABI } from "./full/PolymarketNegRiskMergeAdapter.js";
 export { OPINIONCTFEXECUTIONENGINEADAPTER_ABI } from "./full/OpinionCtfExecutionEngineAdapter.js";
 export { VARLAORACLE_ABI_REGISTRY } from "./subsets/VarlaOracle.registry.js";
 

package/src/contracts.ts

@@ -41,8 +41,10 @@ export type VarlaContracts = {
   liquidator?: ReadonlyContract<typeof abis.VARLALIQUIDATOR_ABI>;
   mergeLiquidator?: ReadonlyContract<typeof abis.VARLAMERGELIQUIDATOR_ABI>;
   convertLiquidator?: ReadonlyContract<typeof abis.VARLACONVERTLIQUIDATOR_ABI>;
+  staking?: ReadonlyContract<typeof abis.VARLASTAKING_ABI>;
 
   polymarketCtfAdapter?: ReadonlyContract<typeof abis.POLYMARKETCTFADAPTER_ABI>;
+  negRiskMergeAdapter?: ReadonlyContract<typeof abis.POLYMARKETNEGRISKMERGEADAPTER_ABI>;
   opinionCtfExecutionEngineAdapter?: ReadonlyContract<
     typeof abis.OPINIONCTFEXECUTIONENGINEADAPTER_ABI
   >;
@@ -150,6 +152,14 @@ export function getVarlaContracts({ chain, client }: GetVarlaContractsParams): V
       })
     : undefined;
 
+  const staking = book.staking
+    ? getContract({
+        address: book.staking as Address,
+        abi: abis.VARLASTAKING_ABI,
+        client,
+      })
+    : undefined;
+
   const polymarketCtfAdapter = book.polymarketCtfAdapter
     ? getContract({
         address: book.polymarketCtfAdapter as Address,
@@ -158,6 +168,14 @@ export function getVarlaContracts({ chain, client }: GetVarlaContractsParams): V
       })
     : undefined;
 
+  const negRiskMergeAdapter = book.negRiskMergeAdapter
+    ? getContract({
+        address: book.negRiskMergeAdapter as Address,
+        abi: abis.POLYMARKETNEGRISKMERGEADAPTER_ABI,
+        client,
+      })
+    : undefined;
+
   const opinionCtfExecutionEngineAdapter = book.opinionCtfExecutionEngineAdapter
     ? getContract({
         address: book.opinionCtfExecutionEngineAdapter as Address,
@@ -179,7 +197,9 @@ export function getVarlaContracts({ chain, client }: GetVarlaContractsParams): V
     liquidator,
     mergeLiquidator,
     convertLiquidator,
+    staking,
     polymarketCtfAdapter,
+    negRiskMergeAdapter,
     opinionCtfExecutionEngineAdapter,
   };
 }
@@ -197,7 +217,9 @@ export function getRequiredVarlaContracts(
       | "liquidator"
       | "mergeLiquidator"
       | "convertLiquidator"
+      | "staking"
       | "polymarketCtfAdapter"
+      | "negRiskMergeAdapter"
       | "opinionCtfExecutionEngineAdapter"
     >;
   },

package/src/generated.ts

@@ -15,7 +15,9 @@ export const abis = {
   VARLALIQUIDATOR_ABI: abi_.VARLALIQUIDATOR_ABI,
   VARLAMERGELIQUIDATOR_ABI: abi_.VARLAMERGELIQUIDATOR_ABI,
   VARLACONVERTLIQUIDATOR_ABI: abi_.VARLACONVERTLIQUIDATOR_ABI,
+  VARLASTAKING_ABI: abi_.VARLASTAKING_ABI,
   POLYMARKETCTFADAPTER_ABI: abi_.POLYMARKETCTFADAPTER_ABI,
+  POLYMARKETNEGRISKMERGEADAPTER_ABI: abi_.POLYMARKETNEGRISKMERGEADAPTER_ABI,
   OPINIONCTFEXECUTIONENGINEADAPTER_ABI: abi_.OPINIONCTFEXECUTIONENGINEADAPTER_ABI,
   VARLAORACLE_ABI_REGISTRY: abi_.VARLAORACLE_ABI_REGISTRY,
 } as const;

package/src/types.ts

@@ -19,7 +19,9 @@ export type AddressBook = {
   liquidator?: `0x${string}`;
   mergeLiquidator?: `0x${string}`;
   convertLiquidator?: `0x${string}`;
+  staking?: `0x${string}`;
 
   polymarketCtfAdapter?: `0x${string}`;
+  negRiskMergeAdapter?: `0x${string}`;
   opinionCtfExecutionEngineAdapter?: `0x${string}`;
 };

package/src/views/core.ts

@@ -893,6 +893,78 @@ export type ReadBorrowLimits = {
   canBeLiquidated: boolean;
 };
 
+export type ReadWalletPositionIds = {
+  user: Address;
+  /** Total oracle-configured position IDs that were checked. */
+  candidateCount: number;
+  /** Wallet positionIds where ERC1155 balance > 0. */
+  positionIds: bigint[];
+  /** Balances aligned to positionIds. */
+  balances: bigint[];
+};
+
+/**
+ * Discovers which Varla-configured ERC1155 positions a wallet holds.
+ *
+ * Strategy: reads ALL configured positionIds from the oracle registry, then
+ * batch-checks `ERC1155.balanceOf(user, pid)` via multicall, filtering to
+ * those with balance > 0.
+ *
+ * This is the canonical way to find "what Varla positions does this wallet have?"
+ * without an indexer — ERC1155 has no `tokenIdsOf(owner)` in the standard.
+ */
+export async function readWalletPositionIds(params: {
+  oracle: {
+    read: {
+      getConfiguredPositions: () => Promise<readonly bigint[]>;
+    };
+  };
+  positionsToken: { address: Address };
+  client: { multicall: (args: any) => Promise<any> };
+  user: Address;
+  chunkSize?: number;
+}): Promise<ReadWalletPositionIds> {
+  const chunkSize = params.chunkSize ?? 256;
+
+  // 1. Get all oracle-configured position IDs (the canonical candidate set).
+  const allIds = await params.oracle.read.getConfiguredPositions();
+  if (allIds.length === 0) {
+    return { user: params.user, candidateCount: 0, positionIds: [], balances: [] };
+  }
+
+  // 2. Batch ERC1155.balanceOf(user, pid) for every candidate.
+  const balCalls = allIds.map((pid) => ({
+    address: params.positionsToken.address,
+    abi: erc1155Abi,
+    functionName: "balanceOf" as const,
+    args: [params.user, pid] as const,
+  }));
+
+  const balRes = await multicallChunks({
+    client: params.client as any,
+    contracts: balCalls as any,
+    chunkSize,
+  });
+
+  // 3. Filter to balance > 0.
+  const positionIds: bigint[] = [];
+  const balances: bigint[] = [];
+  for (let i = 0; i < balRes.length; i++) {
+    const r: any = (balRes as any[])[i];
+    if (r.status !== "success") {
+      throw new Error(`ERC1155 balanceOf multicall failed: ${String(r.error ?? "unknown")}`);
+    }
+    const bal = r.result as bigint;
+    if (typeof bal !== "bigint") throw new Error("Unexpected ERC1155 balanceOf return type");
+    if (bal > 0n) {
+      positionIds.push(allIds[i]!);
+      balances.push(bal);
+    }
+  }
+
+  return { user: params.user, candidateCount: allIds.length, positionIds, balances };
+}
+
 export type ReadHypotheticalBorrowCapacity = {
   user: Address;
   /** Current on-chain account snapshot (deposited positions only). */
@@ -1221,22 +1293,53 @@ export async function readHypotheticalBorrowCapacity(params: {
       getDefaultLtvConfig: () => Promise<unknown>;
     };
   };
-  oracle: { address: Address };
+  oracle: {
+    address: Address;
+    /** Required when `walletPositionIds` is omitted (auto-discovery mode). */
+    read?: {
+      getConfiguredPositions?: () => Promise<readonly bigint[]>;
+    };
+  };
   positionsToken: { address: Address };
   client: { multicall: (args: any) => Promise<any> };
   user: Address;
-  walletPositionIds: readonly bigint[];
+  /**
+   * Position IDs to check in the user's wallet.
+   *
+   * When omitted, auto-discovers by reading ALL oracle-configured position IDs
+   * and checking ERC1155.balanceOf for each (requires `oracle.read.getConfiguredPositions`).
+   */
+  walletPositionIds?: readonly bigint[];
   chunkSize?: number;
 }): Promise<ReadHypotheticalBorrowCapacity> {
   const chunkSize = params.chunkSize ?? 256;
 
+  // Auto-discover wallet position IDs if not provided.
+  let walletPositionIds = params.walletPositionIds;
+  if (!walletPositionIds) {
+    if (!params.oracle.read?.getConfiguredPositions) {
+      throw new Error(
+        "readHypotheticalBorrowCapacity: walletPositionIds not provided and " +
+          "oracle.read.getConfiguredPositions not available for auto-discovery",
+      );
+    }
+    const discovered = await readWalletPositionIds({
+      oracle: { read: { getConfiguredPositions: params.oracle.read.getConfiguredPositions } },
+      positionsToken: params.positionsToken,
+      client: params.client,
+      user: params.user,
+      chunkSize,
+    });
+    walletPositionIds = discovered.positionIds;
+  }
+
   const [current, defaultLtv] = await Promise.all([
     readAccountSnapshot({ core: params.core as any, user: params.user }),
     readDefaultLtvConfig({ core: params.core as any }),
   ]);
 
   // Fast path: no wallet ids.
-  if (params.walletPositionIds.length === 0) {
+  if (walletPositionIds.length === 0) {
     const potentialMaxBorrow =
       current.collateralValue > current.debt ? current.collateralValue - current.debt : 0n;
     return {
@@ -1248,7 +1351,7 @@ export async function readHypotheticalBorrowCapacity(params: {
   }
 
   // 1) Wallet balances (ERC1155 balanceOf)
-  const balCalls = params.walletPositionIds.map((pid) => ({
+  const balCalls = walletPositionIds.map((pid) => ({
     address: params.positionsToken.address,
     abi: erc1155Abi,
     functionName: "balanceOf" as const,
@@ -1271,7 +1374,7 @@ export async function readHypotheticalBorrowCapacity(params: {
     const bal = r.result as bigint;
     if (typeof bal !== "bigint") throw new Error("Unexpected ERC1155 balanceOf return type");
     if (bal > 0n) {
-      heldIds.push(params.walletPositionIds[i]!);
+      heldIds.push(walletPositionIds[i]!);
       heldBals.push(bal);
     }
   }