@agg-build/hooks 2.0.0 → 2.1.0

package/dist/deposit.mjs

@@ -1,15 +1,16 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-KXO3JOXF.mjs";
+} from "./chunk-QKVR32KC.mjs";
 import {
   __async,
   useAggAuthState,
   useAggBalanceState,
+  useAggClient,
   useAggUiConfig,
   useDepositAddresses,
   useSyncBalances
-} from "./chunk-VLYLQSDD.mjs";
+} from "./chunk-V7VCT62L.mjs";
 
 // src/deposit/normalize-wallet-error.ts
 function normalizeWalletError(error, supportedChains) {
@@ -33,13 +34,17 @@ function normalizeWalletError(error, supportedChains) {
 }
 
 // src/deposit/use-wallet-token-balance.ts
-import { Connection, PublicKey } from "@solana/web3.js";
+import { PublicKey } from "@solana/web3.js";
 import { useQuery } from "@tanstack/react-query";
 import { formatUnits } from "viem";
 import { useAccount, useReadContract } from "wagmi";
 
 // src/deposit/constants.ts
-var DEFAULT_SOLANA_RPC_ENDPOINT = "https://solana-rpc.publicnode.com";
+var DEFAULT_SOLANA_RPC_ENDPOINTS = [
+  "https://api.mainnet.solana.com",
+  "https://solana-rpc.publicnode.com"
+];
+var DEFAULT_SOLANA_RPC_ENDPOINT = DEFAULT_SOLANA_RPC_ENDPOINTS[0];
 var SVM_CHAIN_IDS = /* @__PURE__ */ new Set([792703809]);
 var MULTI_CHAIN_SOLANA_WALLET_NAMES = /* @__PURE__ */ new Set(["Phantom"]);
 
@@ -71,6 +76,45 @@ function useSvmAddress() {
   return (_a = adapterPublicKey == null ? void 0 : adapterPublicKey.toBase58()) != null ? _a : phantomAddress;
 }
 
+// src/deposit/svm-connections.ts
+import { Connection } from "@solana/web3.js";
+import { useMemo } from "react";
+function resolveSvmRpcEndpoints(partnerUrl) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  const candidates = partnerUrl ? [partnerUrl, ...DEFAULT_SOLANA_RPC_ENDPOINTS] : DEFAULT_SOLANA_RPC_ENDPOINTS;
+  for (const url of candidates) {
+    if (!seen.has(url)) {
+      seen.add(url);
+      out.push(url);
+    }
+  }
+  return out;
+}
+function useSvmConnections(commitment) {
+  const { solanaRpcUrl } = useAggUiConfig();
+  return useMemo(() => {
+    const endpoints = resolveSvmRpcEndpoints(solanaRpcUrl);
+    return endpoints.map((url) => new Connection(url, commitment));
+  }, [solanaRpcUrl, commitment]);
+}
+function withSvmFailover(connections, operation) {
+  return __async(this, null, function* () {
+    if (connections.length === 0) {
+      throw new Error("No Solana RPC connections configured");
+    }
+    let lastError;
+    for (const connection of connections) {
+      try {
+        return yield operation(connection);
+      } catch (err) {
+        lastError = err;
+      }
+    }
+    throw lastError instanceof Error ? lastError : new Error(typeof lastError === "string" ? lastError : "All Solana RPC endpoints failed");
+  });
+}
+
 // src/deposit/use-wallet-token-balance.ts
 var ERC20_BALANCE_OF_ABI = [
   {
@@ -104,22 +148,24 @@ function withTimeout(promise, timeoutMs) {
     );
   });
 }
-function fetchSvmTokenBalance(rpcUrl, owner, mint) {
+function fetchSvmTokenBalance(connections, owner, mint) {
   return __async(this, null, function* () {
-    var _a;
-    const connection = new Connection(rpcUrl);
-    const accounts = yield withTimeout(
-      connection.getTokenAccountsByOwner(owner, { mint }),
-      SVM_BALANCE_RPC_TIMEOUT_MS
-    );
-    if (accounts.value.length === 0) return 0;
-    const first = accounts.value[0];
-    if (!first) return 0;
-    const balance = yield withTimeout(
-      connection.getTokenAccountBalance(first.pubkey),
-      SVM_BALANCE_RPC_TIMEOUT_MS
+    var _a, _b, _c;
+    const accounts = yield withSvmFailover(
+      connections,
+      (connection) => withTimeout(
+        connection.getParsedTokenAccountsByOwner(owner, { mint }),
+        SVM_BALANCE_RPC_TIMEOUT_MS
+      )
     );
-    return (_a = balance.value.uiAmount) != null ? _a : 0;
+    let total = 0;
+    for (const entry of accounts.value) {
+      const uiAmount = (_c = (_b = (_a = entry.account.data.parsed) == null ? void 0 : _a.info) == null ? void 0 : _b.tokenAmount) == null ? void 0 : _c.uiAmount;
+      if (typeof uiAmount === "number" && Number.isFinite(uiAmount)) {
+        total += uiAmount;
+      }
+    }
+    return total;
   });
 }
 function useWalletTokenBalance({
@@ -130,8 +176,6 @@ function useWalletTokenBalance({
   svmAddress
 }) {
   var _a;
-  const { solanaRpcUrl } = useAggUiConfig();
-  const rpcEndpoint = solanaRpcUrl != null ? solanaRpcUrl : DEFAULT_SOLANA_RPC_ENDPOINT;
   const isSvm = chainId !== void 0 && SVM_CHAIN_IDS.has(chainId);
   const { address: evmAddress } = useAccount();
   const evmEnabled = isOpen && !isSvm && !!chainId && !!tokenAddress && !!evmAddress && decimals !== void 0;
@@ -146,6 +190,7 @@ function useWalletTokenBalance({
   const detectedSvmAddress = useSvmAddress();
   const resolvedSvmAddress = detectedSvmAddress != null ? detectedSvmAddress : svmAddress;
   const svmEnabled = isOpen && isSvm && !!resolvedSvmAddress && !!tokenAddress;
+  const svmConnections = useSvmConnections();
   const svmQuery = useQuery({
     queryKey: ["svm-token-balance", resolvedSvmAddress != null ? resolvedSvmAddress : null, tokenAddress != null ? tokenAddress : null, isOpen],
     enabled: svmEnabled,
@@ -157,7 +202,7 @@ function useWalletTokenBalance({
       if (!resolvedSvmAddress || !tokenAddress) return 0;
       const owner = new PublicKey(resolvedSvmAddress);
       const mint = new PublicKey(tokenAddress);
-      return yield fetchSvmTokenBalance(rpcEndpoint, owner, mint);
+      return yield fetchSvmTokenBalance(svmConnections, owner, mint);
     })
   });
   if (isSvm) {
@@ -178,7 +223,6 @@ import { parseUnits } from "viem";
 import { useWriteContract } from "wagmi";
 import { useWallet as useWallet2 } from "@solana/wallet-adapter-react";
 import {
-  Connection as Connection2,
   Keypair,
   PublicKey as PublicKey2,
   SystemProgram,
@@ -204,13 +248,11 @@ var ERC20_TRANSFER_ABI = [
   }
 ];
 function useWalletSendToken() {
-  const { solanaRpcUrl } = useAggUiConfig();
-  const rpcEndpoint = solanaRpcUrl != null ? solanaRpcUrl : DEFAULT_SOLANA_RPC_ENDPOINT;
+  const svmConnections = useSvmConnections("confirmed");
   const { writeContractAsync } = useWriteContract();
   const { publicKey, sendTransaction } = useWallet2();
   return useCallback(
     (params) => __async(null, null, function* () {
-      var _a, _b;
       const isSvm = SVM_CHAIN_IDS.has(params.chainId);
       if (!isSvm) {
         const tokenAddress = params.token.address;
@@ -245,7 +287,6 @@ function useWalletSendToken() {
       if (!ownerBase58) {
         throw new Error("No Solana wallet connected");
       }
-      const sendConnection = new Connection2(rpcEndpoint, "confirmed");
       const TOKEN_PROGRAM_ID = new PublicKey2("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
       const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey2(
         "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
@@ -262,126 +303,124 @@ function useWalletSendToken() {
       };
       const sourceAta = getAta(owner, mint);
       const destinationAta = getAta(destinationOwner, mint);
-      const tx = new Transaction();
-      let destinationTokenAccountSigner = null;
-      const destinationOwnerInfo = yield sendConnection.getAccountInfo(destinationOwner);
-      const destinationInfo = yield sendConnection.getAccountInfo(destinationAta);
-      let destinationTokenAccount = destinationAta;
-      if (!destinationInfo) {
-        const rentExemptLamports = yield sendConnection.getMinimumBalanceForRentExemption(165);
-        const payerLamports = yield sendConnection.getBalance(owner, "confirmed");
-        const feeBufferLamports = 1e4;
-        const requiredLamports = rentExemptLamports + feeBufferLamports;
-        if (payerLamports < requiredLamports) {
-          const requiredSol = (requiredLamports / 1e9).toFixed(6);
-          const currentSol = (payerLamports / 1e9).toFixed(6);
-          throw new Error(
-            `This Solana deposit needs about ${requiredSol} SOL to create the destination token account, but the connected wallet only has ${currentSol} SOL available.`
-          );
-        }
-        const canCreateAta = (_b = (_a = destinationOwnerInfo == null ? void 0 : destinationOwnerInfo.owner) == null ? void 0 : _a.equals(SystemProgram.programId)) != null ? _b : false;
-        if (canCreateAta) {
-          const createIx = new TransactionInstruction({
-            programId: ASSOCIATED_TOKEN_PROGRAM_ID,
-            keys: [
-              { pubkey: owner, isSigner: true, isWritable: true },
-              { pubkey: destinationAta, isSigner: false, isWritable: true },
-              { pubkey: destinationOwner, isSigner: false, isWritable: false },
-              { pubkey: mint, isSigner: false, isWritable: false },
-              { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
-              { pubkey: TOKEN_PROGRAM_ID, isSigner: false, isWritable: false }
-            ],
-            data: Buffer.alloc(0)
-          });
-          tx.add(createIx);
-        } else {
-          destinationTokenAccountSigner = Keypair.generate();
-          destinationTokenAccount = destinationTokenAccountSigner.publicKey;
-          tx.add(
-            SystemProgram.createAccount({
-              fromPubkey: owner,
-              newAccountPubkey: destinationTokenAccount,
-              lamports: rentExemptLamports,
-              space: 165,
-              programId: TOKEN_PROGRAM_ID
-            })
-          );
-          const initAccountData = Buffer.concat([
-            Buffer.from([18]),
-            // InitializeAccount3
-            destinationOwner.toBuffer()
-          ]);
-          tx.add(
-            new TransactionInstruction({
-              programId: TOKEN_PROGRAM_ID,
+      const signature = yield withSvmFailover(svmConnections, (sendConnection) => __async(null, null, function* () {
+        var _a, _b;
+        const tx = new Transaction();
+        let destinationTokenAccountSigner = null;
+        const destinationOwnerInfo = yield sendConnection.getAccountInfo(destinationOwner);
+        const destinationInfo = yield sendConnection.getAccountInfo(destinationAta);
+        let destinationTokenAccount = destinationAta;
+        if (!destinationInfo) {
+          const rentExemptLamports = yield sendConnection.getMinimumBalanceForRentExemption(165);
+          const payerLamports = yield sendConnection.getBalance(owner, "confirmed");
+          const feeBufferLamports = 1e4;
+          const requiredLamports = rentExemptLamports + feeBufferLamports;
+          if (payerLamports < requiredLamports) {
+            const requiredSol = (requiredLamports / 1e9).toFixed(6);
+            const currentSol = (payerLamports / 1e9).toFixed(6);
+            throw new Error(
+              `This Solana deposit needs about ${requiredSol} SOL to create the destination token account, but the connected wallet only has ${currentSol} SOL available.`
+            );
+          }
+          const canCreateAta = (_b = (_a = destinationOwnerInfo == null ? void 0 : destinationOwnerInfo.owner) == null ? void 0 : _a.equals(SystemProgram.programId)) != null ? _b : false;
+          if (canCreateAta) {
+            const createIx = new TransactionInstruction({
+              programId: ASSOCIATED_TOKEN_PROGRAM_ID,
               keys: [
-                { pubkey: destinationTokenAccount, isSigner: false, isWritable: true },
-                { pubkey: mint, isSigner: false, isWritable: false }
+                { pubkey: owner, isSigner: true, isWritable: true },
+                { pubkey: destinationAta, isSigner: false, isWritable: true },
+                { pubkey: destinationOwner, isSigner: false, isWritable: false },
+                { pubkey: mint, isSigner: false, isWritable: false },
+                { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+                { pubkey: TOKEN_PROGRAM_ID, isSigner: false, isWritable: false }
               ],
-              data: initAccountData
-            })
-          );
+              data: Buffer.alloc(0)
+            });
+            tx.add(createIx);
+          } else {
+            destinationTokenAccountSigner = Keypair.generate();
+            destinationTokenAccount = destinationTokenAccountSigner.publicKey;
+            tx.add(
+              SystemProgram.createAccount({
+                fromPubkey: owner,
+                newAccountPubkey: destinationTokenAccount,
+                lamports: rentExemptLamports,
+                space: 165,
+                programId: TOKEN_PROGRAM_ID
+              })
+            );
+            const initAccountData = Buffer.concat([
+              Buffer.from([18]),
+              // InitializeAccount3
+              destinationOwner.toBuffer()
+            ]);
+            tx.add(
+              new TransactionInstruction({
+                programId: TOKEN_PROGRAM_ID,
+                keys: [
+                  { pubkey: destinationTokenAccount, isSigner: false, isWritable: true },
+                  { pubkey: mint, isSigner: false, isWritable: false }
+                ],
+                data: initAccountData
+              })
+            );
+          }
+        }
+        let factor = BigInt(1);
+        for (let i = 0; i < params.token.decimals; i += 1) {
+          factor *= BigInt(10);
+        }
+        const amountRaw = BigInt(Math.trunc(Number(params.amount || "0") * Number(factor)));
+        const data = new Uint8Array(10);
+        data[0] = 12;
+        let remaining = amountRaw;
+        const mask = BigInt(255);
+        for (let i = 0; i < 8; i += 1) {
+          data[1 + i] = Number(remaining & mask);
+          remaining >>= BigInt(8);
+        }
+        data[9] = params.token.decimals;
+        const transferIx = new TransactionInstruction({
+          programId: TOKEN_PROGRAM_ID,
+          keys: [
+            { pubkey: sourceAta, isSigner: false, isWritable: true },
+            { pubkey: mint, isSigner: false, isWritable: false },
+            { pubkey: destinationTokenAccount, isSigner: false, isWritable: true },
+            { pubkey: owner, isSigner: true, isWritable: false }
+          ],
+          data: Buffer.from(data)
+        });
+        tx.add(transferIx);
+        tx.feePayer = owner;
+        const { blockhash } = yield sendConnection.getLatestBlockhash("confirmed");
+        tx.recentBlockhash = blockhash;
+        if (destinationTokenAccountSigner) {
+          tx.partialSign(destinationTokenAccountSigner);
+        }
+        if (publicKey && sendTransaction) {
+          return yield sendTransaction(tx, sendConnection);
+        }
+        if (phantom) {
+          const res = yield phantom.signAndSendTransaction(tx);
+          return res.signature;
         }
-      }
-      let factor = BigInt(1);
-      for (let i = 0; i < params.token.decimals; i += 1) {
-        factor *= BigInt(10);
-      }
-      const amountRaw = BigInt(Math.trunc(Number(params.amount || "0") * Number(factor)));
-      const data = new Uint8Array(10);
-      data[0] = 12;
-      let remaining = amountRaw;
-      const mask = BigInt(255);
-      for (let i = 0; i < 8; i += 1) {
-        data[1 + i] = Number(remaining & mask);
-        remaining >>= BigInt(8);
-      }
-      data[9] = params.token.decimals;
-      const transferIx = new TransactionInstruction({
-        programId: TOKEN_PROGRAM_ID,
-        keys: [
-          { pubkey: sourceAta, isSigner: false, isWritable: true },
-          { pubkey: mint, isSigner: false, isWritable: false },
-          { pubkey: destinationTokenAccount, isSigner: false, isWritable: true },
-          { pubkey: owner, isSigner: true, isWritable: false }
-        ],
-        data: Buffer.from(data)
-      });
-      tx.add(transferIx);
-      tx.feePayer = owner;
-      const { blockhash } = yield sendConnection.getLatestBlockhash("confirmed");
-      tx.recentBlockhash = blockhash;
-      if (destinationTokenAccountSigner) {
-        tx.partialSign(destinationTokenAccountSigner);
-      }
-      let signature;
-      if (publicKey && sendTransaction) {
-        signature = yield sendTransaction(tx, sendConnection);
-      } else if (phantom) {
-        const res = yield phantom.signAndSendTransaction(tx);
-        signature = res.signature;
-      } else {
         throw new Error("No Solana signer available");
-      }
+      }));
       return { txId: signature };
     }),
-    [publicKey, rpcEndpoint, sendTransaction, writeContractAsync]
+    [publicKey, sendTransaction, svmConnections, writeContractAsync]
   );
 }
 
 // src/deposit/use-wallet-transaction-status.ts
-import { useMemo } from "react";
 import { useQuery as useQuery2 } from "@tanstack/react-query";
 import { formatEther } from "viem";
-import { Connection as Connection3 } from "@solana/web3.js";
 import { useWaitForTransactionReceipt } from "wagmi";
 function useWalletTransactionStatus({
   chainId,
   txId
 }) {
   var _a;
-  const { solanaRpcUrl } = useAggUiConfig();
-  const rpcEndpoint = solanaRpcUrl != null ? solanaRpcUrl : DEFAULT_SOLANA_RPC_ENDPOINT;
   const isSvm = chainId !== void 0 && SVM_CHAIN_IDS.has(chainId);
   const evmHash = !isSvm && txId ? txId : void 0;
   const evmReceipt = useWaitForTransactionReceipt({
@@ -392,14 +431,17 @@ function useWalletTransactionStatus({
       refetchInterval: 2e3
     }
   });
-  const connection = useMemo(() => new Connection3(rpcEndpoint, "confirmed"), [rpcEndpoint]);
+  const svmConnections = useSvmConnections("confirmed");
   const svmQuery = useQuery2({
     queryKey: ["wallet-transaction-status", chainId != null ? chainId : null, txId != null ? txId : null],
     enabled: isSvm && !!txId,
     refetchInterval: (query) => query.state.data === "settled" || query.state.data === "error" ? false : 2e3,
     queryFn: () => __async(null, null, function* () {
       if (!txId) return "submitted";
-      const [status] = (yield connection.getSignatureStatuses([txId], { searchTransactionHistory: true })).value;
+      const [status] = (yield withSvmFailover(
+        svmConnections,
+        (connection) => connection.getSignatureStatuses([txId], { searchTransactionHistory: true })
+      )).value;
       if (!status) return "submitted";
       if (status.err) return "error";
       if (status.confirmationStatus === "confirmed" || status.confirmationStatus === "finalized") {
@@ -436,6 +478,7 @@ var DEFAULT_WALLET_TOKEN_SYMBOL = "USDC";
 function useDepositFlow(options) {
   var _a, _b, _c;
   const { open, onOpenChange } = options;
+  const client = useAggClient();
   const { user } = useAggAuthState();
   const { walletActions } = useAggUiConfig();
   const { totalBalance } = useAggBalanceState();
@@ -575,6 +618,8 @@ function useDepositFlow(options) {
           amount
         });
         setWalletTransaction({ chainId, txId });
+        void client.recordDepositIntent({ chainId, txHash: txId }).catch(() => {
+        });
       } catch (err) {
         setWalletTransaction(null);
         const normalizedError = normalizeWalletError(err, supportedChains);
@@ -583,7 +628,7 @@ function useDepositFlow(options) {
         throw err;
       }
     }),
-    [connectedChainId, sendToken, supportedChains, switchChainAsync]
+    [client, connectedChainId, sendToken, supportedChains, switchChainAsync]
   );
   const handleGetCardQuotes = useCallback2(
     (params) => __async(null, null, function* () {

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import * as _agg_build_sdk from '@agg-build/sdk';
 import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurrenceFilter, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
 export { TurnstileChallengeError } from '@agg-build/sdk';
 import React, { ReactNode } from 'react';
-export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawalLifecycle } from './withdraw.mjs';
+export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawPreviewParams, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawPreview, useWithdrawalLifecycle } from './withdraw.mjs';
 export { U as UseDepositAddressesOptions, g as getDepositAddress, u as useDepositAddresses } from './use-deposit-addresses-B9ICS-3U.mjs';
 export { U as UseSyncBalancesOptions, u as useSyncBalances } from './use-sync-balances-CeD8qZWP.mjs';
 
@@ -313,6 +313,8 @@ type VenueEvent = {
             displayName: string | null;
             parentId: string | null;
             eventCount: number;
+            volume24hr: number;
+            volume: number;
         };
     }[];
     status?: MarketStatus | undefined;
@@ -433,6 +435,8 @@ interface AggUiLabels {
         errorPrefix: string;
         tabsAria: string;
         hiddenTabsAria: string;
+        scrollTabsLeft: string;
+        scrollTabsRight: string;
         selectAria: string;
         lineChartAria: string;
         candlestickChartAria: string;
@@ -586,6 +590,7 @@ interface AggUiLabels {
             networkReserveTooltipLineTwo: string;
             youReceive: string;
             confirm: string;
+            calculatingFees: string;
             successTitle: string;
             successDescription: (tokenSymbol: string) => string;
             successTitleCompleted: string;
@@ -1041,6 +1046,9 @@ interface AggUiLabels {
         buyingOutcome: (label: string) => string;
         sellingOutcome: (label: string) => string;
         findingBestRoute: string;
+        findingBestOdds: string;
+        updatingRoute: string;
+        refreshingQuotes: string;
         checkingBalance: string;
         submittingOrderProgress: string;
         orderSubmittedProgress: (orderId: string) => string;
@@ -1321,6 +1329,11 @@ type AggUiFeatureFlagsConfigInput = Partial<AggUiFeatureFlagsConfig>;
 interface AggUiMarketConfig {
     /** Arbitrage threshold for the UI */
     arbitrageThreshold: number;
+    /**
+     * Maximum venue market IDs sent in each REST `/midpoints` request.
+     * Lower this when proxy/CDN URL limits are stricter than AGG's backend cap.
+     */
+    maxMidpointIdsPerRequest: number;
 }
 type AggUiMarketConfigInput = Partial<AggUiMarketConfig>;
 interface AggUiChartConfig {
@@ -3359,6 +3372,9 @@ declare function mergeBestPricesPreferringLive(rest: ReadonlyMap<string, {
  */
 declare function useLiveTrades(canonicalMarketId: string | null): WsTrade[];
 
+interface UseMidpointsOptions {
+    maxMidpointIdsPerRequest?: number;
+}
 interface UseMidpointsResult {
     /** Map of outcomeId → price. Empty while loading. */
     prices: Map<string, number>;
@@ -3419,7 +3435,7 @@ interface UseMidpointsResult {
  * sides because MVMO links same-side counterparts regardless of label
  * inversion. No label heuristics; no `1 - midpoint` flips.
  */
-declare function useMidpoints(venueMarkets: VenueMarket[] | null | undefined): UseMidpointsResult;
+declare function useMidpoints(venueMarkets: VenueMarket[] | null | undefined, options?: UseMidpointsOptions): UseMidpointsResult;
 
 interface UseTradableVenuesResult {
     /**
@@ -4056,12 +4072,21 @@ interface UseSmartRouteOptions {
     /** Cache freshness and polling interval in milliseconds. Defaults to SMART_ROUTE_STALE_TIME_MS. */
     staleTimeMs?: number;
 }
+/**
+ * Why the smart route query is currently loading.
+ * - `"finding-best-odds"` — first fetch, no prior data in cache
+ * - `"updating-route"`    — query key changed (e.g. amount changed), placeholder data shown
+ * - `"refreshing-quotes"` — background poll/revalidation with existing data
+ */
+type SmartRouteLoadingReason = "finding-best-odds" | "updating-route" | "refreshing-quotes";
 interface UseSmartRouteResult {
     data: SmartRouteResponse | null;
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
     refetch: () => Promise<unknown>;
+    /** Null when not loading. See {@link SmartRouteLoadingReason}. */
+    loadingReason: SmartRouteLoadingReason | null;
 }
 /**
  * Compute optimal order routing across venues via the MILP solver.
@@ -5176,6 +5201,7 @@ declare function useVenueMarkets(options?: UseVenueMarketsOptions): {
 interface UseVenueMarketMidpointsOptions {
     venueMarketIds: string[];
     enabled?: boolean;
+    maxMidpointIdsPerRequest?: number;
 }
 declare function useVenueMarketMidpoints(options: UseVenueMarketMidpointsOptions): {
     midpointRows: (MidpointRow & {
@@ -5405,7 +5431,10 @@ declare const computePriceGaps: ({ markets, midpointsByVenueMarketId, }: Compute
  * outcome — semantically correct for both Yes and No sides because MVMO
  * links same-side counterparts regardless of label inversion.
  */
-declare function useViewportMidpoints(visibleMarkets: VenueMarket[]): {
+interface UseViewportMidpointsOptions {
+    maxMidpointIdsPerRequest?: number;
+}
+declare function useViewportMidpoints(visibleMarkets: VenueMarket[], options?: UseViewportMidpointsOptions): {
     prices: Map<string, number>;
     /**
      * Map of outcomeId → venue name that provided the price in `prices`.
@@ -5458,4 +5487,4 @@ declare function useAppConfig(): UseAppConfigResult;
  */
 declare function useCachedAppConfig(): UseAppConfigResult;
 
-export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };
+export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };