@oydual31/more-vaults-sdk 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oydual31/more-vaults-sdk",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "TypeScript SDK for MoreVaults protocol — viem/wagmi and ethers.js",
   "type": "module",
   "exports": {

package/src/viem/chains.ts

@@ -261,6 +261,23 @@ export const LZ_TIMEOUTS = {
   FULL_SPOKE_REDEEM: 3_600_000, // 60 min
 } as const
 
+/**
+ * Uniswap V3 SwapRouter addresses per chain.
+ * Used by curator swap helpers to build calldata for on-chain swaps.
+ *
+ * Note on struct differences:
+ *   - SwapRouter (Eth/Arb/Op, 0xE592...): exactInputSingle struct includes `deadline`
+ *   - SwapRouter02 (Base, 0x2626...): exactInputSingle struct does NOT include `deadline`
+ *   - FlowSwap V3 (Flow EVM, 0xeEDC...): derived from original UniV3, includes `deadline`
+ */
+export const UNISWAP_V3_ROUTERS: Record<number, `0x${string}`> = {
+  [8453]:  '0x2626664c2603336E57B271c5C0b26F421741e481', // Base — SwapRouter02 (no deadline)
+  [1]:     '0xE592427A0AEce92De3Edee1F18E0157C05861564', // Ethereum — SwapRouter
+  [42161]: '0xE592427A0AEce92De3Edee1F18E0157C05861564', // Arbitrum — SwapRouter
+  [10]:    '0xE592427A0AEce92De3Edee1F18E0157C05861564', // Optimism — SwapRouter
+  [747]:   '0xeEDC6Ff75e1b10B903D9013c358e446a73d35341',  // Flow EVM — FlowSwap V3 SwapRouter
+}
+
 // ---------------------------------------------------------------------------
 // Legacy flat exports — kept for backwards compat, prefer OFT_ROUTES
 // ---------------------------------------------------------------------------

package/src/viem/crossChainFlows.ts

@@ -10,7 +10,7 @@ import {
 } from 'viem'
 import { OFT_ABI, BRIDGE_ABI, LZ_ENDPOINT_ABI } from './abis'
 import type { ComposeData, SpokeDepositResult } from './types'
-import { ensureAllowance } from './utils'
+import { ensureAllowance, detectStargateOft } from './utils'
 import { OFT_ROUTES, EID_TO_CHAIN_ID } from './chains'
 import { OMNI_FACTORY_ADDRESS } from './topology'
 import { createChainClient } from './spokeRoutes'
@@ -38,8 +38,6 @@ const COMPOSER_ABI = [
   },
 ] as const
 
-const STARGATE_ASSETS = new Set(['stgUSDC', 'USDT', 'WETH'])
-
 /**
  * Build a LZ V2 TYPE_3 executor option that forwards native ETH to the lzCompose call.
  *
@@ -61,17 +59,6 @@ function buildLzComposeOption(gas: bigint, nativeValue: bigint): `0x${string}` {
   return `0x00030300220000${gasHex}${valueHex}` as `0x${string}`
 }
 
-/** Returns true if the OFT is a Stargate V2 pool (bus/taxi architecture). */
-function isStargateOft(oft: Address): boolean {
-  for (const [symbol, chainMap] of Object.entries(OFT_ROUTES)) {
-    if (!STARGATE_ASSETS.has(symbol)) continue
-    for (const entry of Object.values(chainMap as Record<number, { oft: string; token: string }>)) {
-      if (getAddress(entry.oft) === oft) return true
-    }
-  }
-  return false
-}
-
 /**
  * Resolve the native ETH value that MoreVaultsComposer needs to receive via lzCompose.
  *
@@ -263,7 +250,7 @@ export async function depositFromSpoke(
 
   // For Stargate OFTs: extraOptions must be '0x' (rejects LZCOMPOSE type-3 options).
   // For standard OFTs: inject LZCOMPOSE option with native ETH for readFee + share send.
-  const isStargate = isStargateOft(oft)
+  const isStargate = await detectStargateOft(publicClient, oft)
   let resolvedExtraOptions: `0x${string}`
   if (extraOptions !== '0x') {
     resolvedExtraOptions = extraOptions
@@ -377,7 +364,7 @@ export async function depositFromSpoke(
   // The compose message is NOT available yet — it's emitted as ComposeSent on the hub
   // after LZ delivers the message. The user must call waitForCompose() to get it,
   // then executeCompose() to execute it.
-  const stargate = isStargateOft(getAddress(spokeOFT))
+  const stargate = isStargate
   let composeData: ComposeData | undefined
   if (stargate) {
     // Snapshot current hub block BEFORE waiting — this is exactly where we start
@@ -454,7 +441,7 @@ export async function quoteDepositFromSpokeFee(
   const composerBytes32 = pad(composerAddress, { size: 32 })
 
   // Match depositFromSpoke: resolve extraOptions the same way
-  const isStargate = isStargateOft(oft)
+  const isStargate = await detectStargateOft(publicClient, oft)
   let resolvedExtraOptions: `0x${string}`
   if (extraOptions !== '0x') {
     resolvedExtraOptions = extraOptions
@@ -560,14 +547,17 @@ export async function waitForCompose(
   const receiverNeedle = getAddress(receiver).slice(2).toLowerCase()
   const startBlock = composeData.hubBlockStart
 
-  // Known Stargate pool addresses on hub for composeQueue checks
-  const knownFromAddresses: Address[] = []
+  // Collect all OFT addresses on the hub chain, then filter to Stargate pools on-chain
   const hubChainId = composeData.hubChainId
-  for (const [symbol, chainMap] of Object.entries(OFT_ROUTES)) {
-    if (!STARGATE_ASSETS.has(symbol)) continue
+  const candidateAddresses: Address[] = []
+  for (const chainMap of Object.values(OFT_ROUTES)) {
     const entry = (chainMap as Record<number, { oft: string; token: string }>)[hubChainId]
-    if (entry) knownFromAddresses.push(getAddress(entry.oft) as Address)
+    if (entry) candidateAddresses.push(getAddress(entry.oft) as Address)
   }
+  const stargateChecks = await Promise.all(
+    candidateAddresses.map(async (addr) => ({ addr, isSg: await detectStargateOft(hubPublicClient, addr) })),
+  )
+  const knownFromAddresses = stargateChecks.filter((c) => c.isSg).map((c) => c.addr)
 
   let attempt = 0
   // Track the highest block we've already scanned to avoid re-scanning

package/src/viem/curatorStatus.ts

@@ -6,8 +6,8 @@
  */
 
 import { type Address, type PublicClient, getAddress } from 'viem'
-import { MULTICALL_ABI, CURATOR_CONFIG_ABI, VAULT_ANALYSIS_ABI, REGISTRY_ABI, METADATA_ABI } from './abis.js'
-import type { CuratorVaultStatus, PendingAction, VaultAnalysis, AssetInfo } from './types.js'
+import { MULTICALL_ABI, CURATOR_CONFIG_ABI, VAULT_ANALYSIS_ABI, REGISTRY_ABI, METADATA_ABI, ERC20_ABI, VAULT_ABI } from './abis.js'
+import type { CuratorVaultStatus, PendingAction, VaultAnalysis, AssetInfo, AssetBalance, VaultAssetBreakdown } from './types.js'
 
 // ─────────────────────────────────────────────────────────────────────────────
 
@@ -253,3 +253,67 @@ export async function checkProtocolWhitelist(
   return out
 }
 
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Get the vault's per-asset balance breakdown on the hub chain.
+ *
+ * Returns the balance of every available asset held by the vault, plus
+ * totalAssets and totalSupply for context. Useful for portfolio views
+ * that need to show individual holdings rather than a single USD-denominated total.
+ *
+ * @param publicClient  Viem public client (must be on the vault's hub chain)
+ * @param vault         Vault address (diamond proxy)
+ * @returns             VaultAssetBreakdown with per-asset balances
+ */
+export async function getVaultAssetBreakdown(
+  publicClient: PublicClient,
+  vault: Address,
+): Promise<VaultAssetBreakdown> {
+  const v = getAddress(vault)
+
+  // Step 1: get available assets list
+  const availableRaw = await publicClient.readContract({
+    address: v,
+    abi: VAULT_ANALYSIS_ABI,
+    functionName: 'getAvailableAssets',
+  }) as Address[]
+
+  const addresses = availableRaw.map(getAddress)
+
+  // Step 2: multicall — balanceOf + metadata for each asset + totalAssets + totalSupply + vault decimals
+  const results = await publicClient.multicall({
+    contracts: [
+      // Per-asset: balanceOf, name, symbol, decimals
+      ...addresses.flatMap((addr) => [
+        { address: addr, abi: ERC20_ABI, functionName: 'balanceOf' as const, args: [v] as [Address] },
+        { address: addr, abi: METADATA_ABI, functionName: 'name' as const },
+        { address: addr, abi: METADATA_ABI, functionName: 'symbol' as const },
+        { address: addr, abi: METADATA_ABI, functionName: 'decimals' as const },
+      ]),
+      // Vault totals
+      { address: v, abi: VAULT_ABI, functionName: 'totalAssets' as const },
+      { address: v, abi: VAULT_ABI, functionName: 'totalSupply' as const },
+      { address: v, abi: METADATA_ABI, functionName: 'decimals' as const },
+    ],
+    allowFailure: true,
+  })
+
+  const perAssetFields = 4 // balanceOf, name, symbol, decimals
+  const assets: AssetBalance[] = addresses.map((addr, i) => {
+    const base = i * perAssetFields
+    const balance  = results[base]?.status === 'success'     ? (results[base].result as bigint)   : 0n
+    const name     = results[base + 1]?.status === 'success' ? (results[base + 1].result as string) : ''
+    const symbol   = results[base + 2]?.status === 'success' ? (results[base + 2].result as string) : ''
+    const decimals = results[base + 3]?.status === 'success' ? (results[base + 3].result as number) : 18
+
+    return { address: addr, name, symbol, decimals, balance }
+  })
+
+  const totalsBase = addresses.length * perAssetFields
+  const totalAssets      = results[totalsBase]?.status === 'success'     ? (results[totalsBase].result as bigint)   : 0n
+  const totalSupply      = results[totalsBase + 1]?.status === 'success' ? (results[totalsBase + 1].result as bigint) : 0n
+  const underlyingDecimals = results[totalsBase + 2]?.status === 'success' ? (results[totalsBase + 2].result as number) : 6
+
+  return { assets, totalAssets, totalSupply, underlyingDecimals }
+}

package/src/viem/curatorSwaps.ts

@@ -0,0 +1,239 @@
+/**
+ * Curator swap helpers for Uniswap V3-compatible DEXes.
+ *
+ * Provides typed helpers to build CuratorAction objects and raw calldata for
+ * Uniswap V3 exactInputSingle swaps, automatically resolving the correct router
+ * and ABI variant (SwapRouter vs SwapRouter02) per chain.
+ *
+ * Supported chains and routers:
+ *   - Base (8453):        SwapRouter02 0x2626...  — NO deadline field
+ *   - Ethereum (1):       SwapRouter   0xE592...  — HAS deadline field
+ *   - Arbitrum (42161):   SwapRouter   0xE592...  — HAS deadline field
+ *   - Optimism (10):      SwapRouter   0xE592...  — HAS deadline field
+ *   - Flow EVM (747):     FlowSwap V3  0xeEDC...  — HAS deadline field
+ *
+ * @module curatorSwaps
+ */
+
+import { type Address, encodeFunctionData } from 'viem'
+import { UNISWAP_V3_ROUTERS } from './chains.js'
+import type { CuratorAction } from './types.js'
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ABI constants
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Uniswap V3 SwapRouter exactInputSingle ABI.
+ * Used for: Ethereum (1), Arbitrum (42161), Optimism (10), Flow EVM (747).
+ * Struct includes `deadline` field.
+ */
+const UNISWAP_V3_SWAP_ROUTER_ABI = [
+  {
+    type: 'function',
+    name: 'exactInputSingle',
+    inputs: [
+      {
+        type: 'tuple',
+        name: 'params',
+        components: [
+          { name: 'tokenIn',           type: 'address' },
+          { name: 'tokenOut',          type: 'address' },
+          { name: 'fee',               type: 'uint24'  },
+          { name: 'recipient',         type: 'address' },
+          { name: 'deadline',          type: 'uint256' },
+          { name: 'amountIn',          type: 'uint256' },
+          { name: 'amountOutMinimum',  type: 'uint256' },
+          { name: 'sqrtPriceLimitX96', type: 'uint160' },
+        ],
+      },
+    ],
+    outputs: [{ name: 'amountOut', type: 'uint256' }],
+    stateMutability: 'payable',
+  },
+] as const
+
+/**
+ * Uniswap V3 SwapRouter02 exactInputSingle ABI.
+ * Used for: Base (8453).
+ * Struct does NOT include `deadline` field — SwapRouter02 removed it.
+ */
+const UNISWAP_V3_SWAP_ROUTER02_ABI = [
+  {
+    type: 'function',
+    name: 'exactInputSingle',
+    inputs: [
+      {
+        type: 'tuple',
+        name: 'params',
+        components: [
+          { name: 'tokenIn',           type: 'address' },
+          { name: 'tokenOut',          type: 'address' },
+          { name: 'fee',               type: 'uint24'  },
+          { name: 'recipient',         type: 'address' },
+          { name: 'amountIn',          type: 'uint256' },
+          { name: 'amountOutMinimum',  type: 'uint256' },
+          { name: 'sqrtPriceLimitX96', type: 'uint160' },
+        ],
+      },
+    ],
+    outputs: [{ name: 'amountOut', type: 'uint256' }],
+    stateMutability: 'payable',
+  },
+] as const
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Chain variant detection
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Chains that use SwapRouter02 (no deadline in struct).
+ * All other chains in UNISWAP_V3_ROUTERS use the original SwapRouter.
+ */
+const SWAP_ROUTER02_CHAINS = new Set([8453])
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Calldata encoding
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Encode Uniswap V3 exactInputSingle calldata directly.
+ * For curators who want raw calldata without the CuratorAction wrapper.
+ *
+ * Automatically selects the correct ABI variant (SwapRouter vs SwapRouter02)
+ * based on the chainId. The deadline (for SwapRouter chains) is set to
+ * `now + 20 minutes` to prevent stale transactions from executing.
+ *
+ * @param params.chainId       EVM chain ID — must be present in UNISWAP_V3_ROUTERS
+ * @param params.tokenIn       Input token address
+ * @param params.tokenOut      Output token address
+ * @param params.fee           Pool fee tier: 100, 500, 3000, or 10000
+ * @param params.amountIn      Exact input amount (in tokenIn units)
+ * @param params.minAmountOut  Minimum acceptable output (slippage protection)
+ * @param params.recipient     Address to receive the output tokens (usually the vault)
+ * @returns                    The router contract address and ABI-encoded calldata
+ * @throws                     If no router is configured for the given chainId
+ */
+export function encodeUniswapV3SwapCalldata(params: {
+  chainId: number
+  tokenIn: Address
+  tokenOut: Address
+  fee: number
+  amountIn: bigint
+  minAmountOut: bigint
+  recipient: Address
+}): { targetContract: Address; swapCallData: `0x${string}` } {
+  const { chainId, tokenIn, tokenOut, fee, amountIn, minAmountOut, recipient } = params
+
+  const router = UNISWAP_V3_ROUTERS[chainId]
+  if (!router) {
+    throw new Error(
+      `[MoreVaults] No Uniswap V3 router configured for chainId ${chainId}. ` +
+      `Supported chains: ${Object.keys(UNISWAP_V3_ROUTERS).join(', ')}`
+    )
+  }
+
+  let swapCallData: `0x${string}`
+
+  if (SWAP_ROUTER02_CHAINS.has(chainId)) {
+    // SwapRouter02 (Base) — no deadline field
+    swapCallData = encodeFunctionData({
+      abi: UNISWAP_V3_SWAP_ROUTER02_ABI,
+      functionName: 'exactInputSingle',
+      args: [
+        {
+          tokenIn,
+          tokenOut,
+          fee,
+          recipient,
+          amountIn,
+          amountOutMinimum: minAmountOut,
+          sqrtPriceLimitX96: 0n,
+        },
+      ],
+    })
+  } else {
+    // Original SwapRouter (Eth/Arb/Op/Flow EVM) — has deadline field
+    const deadline = BigInt(Math.floor(Date.now() / 1000) + 1200) // now + 20 minutes
+    swapCallData = encodeFunctionData({
+      abi: UNISWAP_V3_SWAP_ROUTER_ABI,
+      functionName: 'exactInputSingle',
+      args: [
+        {
+          tokenIn,
+          tokenOut,
+          fee,
+          recipient,
+          deadline,
+          amountIn,
+          amountOutMinimum: minAmountOut,
+          sqrtPriceLimitX96: 0n,
+        },
+      ],
+    })
+  }
+
+  return { targetContract: router, swapCallData }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// CuratorAction builder
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Build a CuratorAction for a Uniswap V3 exactInputSingle swap.
+ *
+ * Automatically resolves the router address from UNISWAP_V3_ROUTERS and
+ * selects the correct ABI struct (with or without deadline) based on chainId.
+ *
+ * The returned action is a `swap` variant ready to be passed to
+ * `buildCuratorBatch` and then `submitActions`.
+ *
+ * @param params.chainId       EVM chain ID — must be present in UNISWAP_V3_ROUTERS
+ * @param params.tokenIn       Input token address
+ * @param params.tokenOut      Output token address
+ * @param params.fee           Pool fee tier: 100, 500, 3000, or 10000
+ * @param params.amountIn      Exact input amount (in tokenIn units)
+ * @param params.minAmountOut  Minimum acceptable output (slippage protection)
+ * @param params.recipient     Address to receive output tokens (usually the vault)
+ * @returns                    A typed CuratorAction ready for buildCuratorBatch
+ * @throws                     If no router is configured for the given chainId
+ *
+ * @example
+ * ```typescript
+ * const action = buildUniswapV3Swap({
+ *   chainId: 8453,
+ *   tokenIn:  '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC
+ *   tokenOut: '0x4200000000000000000000000000000000000006', // WETH
+ *   fee: 500,           // 0.05% pool
+ *   amountIn: 150_000n, // 0.15 USDC (6 decimals)
+ *   minAmountOut: 1n,   // accept any amount (set properly in production)
+ *   recipient: VAULT,
+ * })
+ * const batch = buildCuratorBatch([action])
+ * await submitActions(walletClient, publicClient, vault, batch)
+ * ```
+ */
+export function buildUniswapV3Swap(params: {
+  chainId: number
+  tokenIn: Address
+  tokenOut: Address
+  fee: number
+  amountIn: bigint
+  minAmountOut: bigint
+  recipient: Address
+}): CuratorAction {
+  const { targetContract, swapCallData } = encodeUniswapV3SwapCalldata(params)
+
+  return {
+    type: 'swap',
+    params: {
+      targetContract,
+      tokenIn: params.tokenIn,
+      tokenOut: params.tokenOut,
+      maxAmountIn: params.amountIn,
+      minAmountOut: params.minAmountOut,
+      swapCallData,
+    },
+  }
+}

package/src/viem/index.ts

@@ -2,7 +2,7 @@
 // Provides typed helpers for all deposit, redeem, and cross-chain vault flows.
 
 // --- Chain constants ---
-export { CHAIN_IDS, LZ_EIDS, EID_TO_CHAIN_ID, CHAIN_ID_TO_EID, OFT_ROUTES, STARGATE_TAXI_CMD, USDC_STARGATE_OFT, USDC_TOKEN, LZ_TIMEOUTS } from './chains'
+export { CHAIN_IDS, LZ_EIDS, EID_TO_CHAIN_ID, CHAIN_ID_TO_EID, OFT_ROUTES, STARGATE_TAXI_CMD, USDC_STARGATE_OFT, USDC_TOKEN, LZ_TIMEOUTS, UNISWAP_V3_ROUTERS } from './chains'
 
 // --- ABIs ---
 export {
@@ -42,7 +42,9 @@ export type {
   CuratorAction,
   CuratorVaultStatus,
   AssetInfo,
+  AssetBalance,
   VaultAnalysis,
+  VaultAssetBreakdown,
 } from './types'
 export { ActionType } from './types'
 
@@ -104,6 +106,7 @@ export {
   getAsyncRequestStatus,
   waitForAsyncRequest,
   getVaultStatus,
+  detectStargateOft,
 } from './utils'
 export type { VaultStatus, VaultMode, AsyncRequestFinalResult } from './utils'
 
@@ -162,6 +165,7 @@ export {
   isCurator,
   getVaultAnalysis,
   checkProtocolWhitelist,
+  getVaultAssetBreakdown,
 } from './curatorStatus'
 export {
   encodeCuratorAction,
@@ -170,6 +174,10 @@ export {
   executeActions,
   vetoActions,
 } from './curatorMulticall'
+export {
+  buildUniswapV3Swap,
+  encodeUniswapV3SwapCalldata,
+} from './curatorSwaps'
 
 // --- wagmi compatibility ---
 // Re-export viem's PublicClient type for wagmi compatibility.

package/src/viem/preflight.ts

@@ -11,7 +11,8 @@ import { CONFIG_ABI, BRIDGE_ABI, VAULT_ABI, ERC20_ABI, OFT_ABI } from './abis'
 import { InsufficientLiquidityError } from './errors'
 import { quoteComposeFee } from './crossChainFlows'
 import { createChainClient } from './spokeRoutes'
-import { EID_TO_CHAIN_ID, OFT_ROUTES } from './chains'
+import { EID_TO_CHAIN_ID } from './chains'
+import { detectStargateOft } from './utils'
 
 /**
  * Pre-flight checks for async cross-chain flows (D4 / D5 / R5).
@@ -305,14 +306,7 @@ export async function preflightSpokeDeposit(
   }
 
   // 3. For Stargate OFTs: check ETH on hub for TX2 (compose retry)
-  const STARGATE_ASSETS = new Set(['stgUSDC', 'USDT', 'WETH'])
-  let isStargate = false
-  for (const [symbol, chainMap] of Object.entries(OFT_ROUTES)) {
-    if (!STARGATE_ASSETS.has(symbol)) continue
-    for (const entry of Object.values(chainMap as Record<number, { oft: string; token: string }>)) {
-      if (getAddress(entry.oft) === oft) isStargate = true
-    }
-  }
+  const isStargate = await detectStargateOft(spokePublicClient, oft)
 
   let hubNativeBalance = 0n
   let estimatedComposeFee = 0n

package/src/viem/redeemFlows.ts

@@ -15,7 +15,7 @@ import type {
   AsyncRequestResult,
 } from './types'
 import { ActionType } from './types'
-import { ensureAllowance, getVaultStatus, quoteLzFee } from './utils'
+import { ensureAllowance, getVaultStatus, quoteLzFee, detectStargateOft } from './utils'
 import { preflightAsync, preflightRedeemLiquidity } from './preflight'
 import { EscrowNotConfiguredError } from './errors'
 import { validateWalletChain } from './chainValidation'
@@ -581,8 +581,6 @@ export interface SpokeRedeemRoute {
   symbol: string
 }
 
-const STARGATE_ASSETS = new Set(['stgUSDC', 'USDT', 'WETH'])
-
 const FACTORY_COMPOSER_ABI = [
   {
     type: 'function' as const,
@@ -664,7 +662,6 @@ export async function resolveRedeemAddresses(
   // Find matching OFT route for the vault's asset on the hub chain
   let hubAssetOft: Address | null = null
   let spokeAsset: Address | null = null
-  let isStargate = false
   let symbol = ''
 
   for (const [sym, chainMap] of Object.entries(OFT_ROUTES)) {
@@ -675,7 +672,6 @@ export async function resolveRedeemAddresses(
     if (getAddress(hubEntry.token) === getAddress(hubAsset)) {
       hubAssetOft = getAddress(hubEntry.oft) as Address
       spokeAsset = getAddress(spokeEntry.token) as Address
-      isStargate = STARGATE_ASSETS.has(sym)
       symbol = sym
       break
     }
@@ -688,6 +684,9 @@ export async function resolveRedeemAddresses(
     )
   }
 
+  // On-chain detection: Stargate pools implement stargateType(), standard OFTs revert
+  const isStargate = await detectStargateOft(hubPublicClient, hubAssetOft)
+
   return {
     hubChainId,
     spokeChainId,

package/src/viem/types.ts

@@ -177,3 +177,19 @@ export interface VaultAnalysis {
   /** Registry address for global protocol whitelist checks */
   registryAddress: Address | null
 }
+
+export interface AssetBalance extends AssetInfo {
+  /** Raw balance held by the vault */
+  balance: bigint
+}
+
+export interface VaultAssetBreakdown {
+  /** Per-asset balances held by the vault on the hub chain */
+  assets: AssetBalance[]
+  /** totalAssets() as reported by the vault (all positions converted to underlying) */
+  totalAssets: bigint
+  /** totalSupply() of vault shares */
+  totalSupply: bigint
+  /** Vault underlying token decimals */
+  underlyingDecimals: number
+}

package/src/viem/utils.ts

@@ -522,3 +522,43 @@ export async function waitForAsyncRequest(
     `The request may still complete — check https://layerzeroscan.com/tx/${guid}`,
   )
 }
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Stargate detection — on-chain probe
+// ─────────────────────────────────────────────────────────────────────────────
+
+const STARGATE_TYPE_ABI = [
+  {
+    type: 'function' as const,
+    name: 'stargateType' as const,
+    inputs: [] as const,
+    outputs: [{ type: 'uint8' as const }] as const,
+    stateMutability: 'view' as const,
+  },
+] as const
+
+/**
+ * Detect whether an OFT address is a Stargate V2 pool by calling `stargateType()`.
+ *
+ * Stargate pools implement this function (returns 0=Pool, 1=OFT).
+ * Standard OFTs revert because they don't have it.
+ *
+ * @param publicClient  Viem public client on the OFT's chain
+ * @param oft           OFT contract address
+ * @returns             true if the contract is a Stargate V2 pool/OFT
+ */
+export async function detectStargateOft(
+  publicClient: PublicClient,
+  oft: Address,
+): Promise<boolean> {
+  try {
+    await publicClient.readContract({
+      address: getAddress(oft),
+      abi: STARGATE_TYPE_ABI,
+      functionName: 'stargateType',
+    })
+    return true
+  } catch {
+    return false
+  }
+}