@agg-build/hooks 2.1.0 → 2.1.1

package/dist/{chunk-DK4YDVPH.mjs → chunk-5P53A3NQ.mjs}

@@ -11,7 +11,7 @@ import {
   useOnWithdrawalLifecycle,
   useSyncBalances,
   useWithdrawManaged
-} from "./chunk-V7VCT62L.mjs";
+} from "./chunk-FYEPQHKO.mjs";
 
 // src/withdraw/use-withdraw-flow.ts
 import { useCallback, useEffect, useMemo, useState } from "react";

package/dist/{chunk-QKVR32KC.mjs → chunk-AFZD3GIQ.mjs}

@@ -1,7 +1,7 @@
 import {
   __async,
   useAggClient
-} from "./chunk-V7VCT62L.mjs";
+} from "./chunk-FYEPQHKO.mjs";
 
 // src/use-ramp-quotes.ts
 import { useMutation } from "@tanstack/react-query";

package/dist/{chunk-V7VCT62L.mjs → chunk-FYEPQHKO.mjs}

@@ -463,6 +463,13 @@ var enUsLabels = {
     categoryTabsAria: "Home page category tabs"
   },
   userProfile: {
+    balance: {
+      availableBalance: "Available Balance",
+      balanceByNetwork: "Balance by network",
+      paperModeNetwork: "Paper",
+      paperModeWarning: "Paper mode is enabled. These are simulated funds for paper trading.",
+      networkTooltipDescription: "Funds are stored across networks. We handle routing automatically, but keeping funds on the right network enables faster trades and lower fees. When depositing, you can choose your preferred network."
+    },
     activity: {
       depositType: "Deposit",
       redeemType: "Claim",
@@ -1147,7 +1154,10 @@ var defaultAggUiConfig = {
     }
   },
   formatting: defaultFormatters,
-  search: defaultAggUiSearchConfig
+  search: defaultAggUiSearchConfig,
+  trading: {
+    executionMode: "live"
+  }
 };
 var mergeAggUiSearchConfig = (config) => {
   var _a, _b, _c;
@@ -1162,7 +1172,7 @@ var mergeAggUiSearchConfig = (config) => {
   };
 };
 var mergeAggUiConfig = (persisted, config) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X;
   const locale = (_d = (_c = (_a = config == null ? void 0 : config.general) == null ? void 0 : _a.locale) != null ? _c : (_b = persisted.general) == null ? void 0 : _b.locale) != null ? _d : DEFAULT_LOCALE;
   const theme = (_h = (_g = (_e = config == null ? void 0 : config.general) == null ? void 0 : _e.theme) != null ? _g : (_f = persisted.general) == null ? void 0 : _f.theme) != null ? _h : defaultAggUiConfig.general.theme;
   const formatters = createFormatters(locale);
@@ -1203,6 +1213,9 @@ var mergeAggUiConfig = (persisted, config) => {
       formatDate: (_V = (_U = config == null ? void 0 : config.formatting) == null ? void 0 : _U.formatDate) != null ? _V : formatters.formatDate
     },
     search: mergeAggUiSearchConfig(config == null ? void 0 : config.search),
+    trading: {
+      executionMode: (_X = (_W = config == null ? void 0 : config.trading) == null ? void 0 : _W.executionMode) != null ? _X : defaultAggUiConfig.trading.executionMode
+    },
     walletActions: config == null ? void 0 : config.walletActions,
     solanaRpcUrl: config == null ? void 0 : config.solanaRpcUrl
   };
@@ -1232,7 +1245,7 @@ var balanceQueryKeys = {
   execution: () => executionKeys.balances(),
   // Kept as an alias for backward compatibility with existing callers.
   // The balance provider now uses the same canonical execution balances key.
-  provider: () => executionKeys.balances(),
+  provider: (mode) => executionKeys.balances(mode),
   venue: (venuesKey) => ["venue-balances", venuesKey],
   venuePrefix: () => ["venue-balances"]
 };
@@ -1318,6 +1331,7 @@ var AggBalanceContext = createContext(null);
 // src/core/providers/balance-provider.tsx
 import { jsx } from "react/jsx-runtime";
 var CHAIN_LABELS = {
+  0: "Paper",
   1: "Ethereum",
   10: "Optimism",
   56: "BNB",
@@ -1349,17 +1363,23 @@ var EMPTY_MANAGED_BALANCES = {
 function AggBalanceProvider({ children }) {
   const client = useContext(AggClientContext);
   const authContext = useContext(AggAuthContext);
+  const {
+    trading: { executionMode }
+  } = useContext(AggUiContext);
   if (!authContext) {
     throw new Error("AggBalanceProvider must be used within an <AggAuthProvider>");
   }
   const { isAuthenticated } = authContext;
+  const queryExecutionMode = executionMode === "paper" ? "paper" : void 0;
   const balancesQuery = useQuery({
-    queryKey: balanceQueryKeys.provider(),
+    queryKey: balanceQueryKeys.provider(queryExecutionMode),
     queryFn: () => __async(null, null, function* () {
       if (!client || !isAuthenticated) {
         return EMPTY_MANAGED_BALANCES;
       }
-      return client.getManagedBalances();
+      return client.getManagedBalances(
+        queryExecutionMode ? { mode: queryExecutionMode } : void 0
+      );
     }),
     enabled: Boolean(client && isAuthenticated),
     staleTime: 60 * 1e3,

package/dist/deposit.js

@@ -397,6 +397,13 @@ var enUsLabels = {
     categoryTabsAria: "Home page category tabs"
   },
   userProfile: {
+    balance: {
+      availableBalance: "Available Balance",
+      balanceByNetwork: "Balance by network",
+      paperModeNetwork: "Paper",
+      paperModeWarning: "Paper mode is enabled. These are simulated funds for paper trading.",
+      networkTooltipDescription: "Funds are stored across networks. We handle routing automatically, but keeping funds on the right network enables faster trades and lower fees. When depositing, you can choose your preferred network."
+    },
     activity: {
       depositType: "Deposit",
       redeemType: "Claim",
@@ -1061,7 +1068,10 @@ var defaultAggUiConfig = {
     }
   },
   formatting: defaultFormatters,
-  search: defaultAggUiSearchConfig
+  search: defaultAggUiSearchConfig,
+  trading: {
+    executionMode: "live"
+  }
 };
 
 // src/core/providers/contexts.ts
@@ -1095,7 +1105,7 @@ var balanceQueryKeys = {
   execution: () => executionKeys.balances(),
   // Kept as an alias for backward compatibility with existing callers.
   // The balance provider now uses the same canonical execution balances key.
-  provider: () => executionKeys.balances(),
+  provider: (mode) => executionKeys.balances(mode),
   venue: (venuesKey) => ["venue-balances", venuesKey],
   venuePrefix: () => ["venue-balances"]
 };

package/dist/deposit.mjs

@@ -1,7 +1,7 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-QKVR32KC.mjs";
+} from "./chunk-AFZD3GIQ.mjs";
 import {
   __async,
   useAggAuthState,
@@ -10,7 +10,7 @@ import {
   useAggUiConfig,
   useDepositAddresses,
   useSyncBalances
-} from "./chunk-V7VCT62L.mjs";
+} from "./chunk-FYEPQHKO.mjs";
 
 // src/deposit/normalize-wallet-error.ts
 function normalizeWalletError(error, supportedChains) {

package/dist/index.d.mts

@@ -676,6 +676,13 @@ interface AggUiLabels {
         categoryTabsAria: string;
     };
     userProfile: {
+        balance: {
+            availableBalance: string;
+            balanceByNetwork: string;
+            paperModeNetwork: string;
+            paperModeWarning: string;
+            networkTooltipDescription: string;
+        };
         activity: {
             depositType: string;
             redeemType: string;
@@ -1290,6 +1297,7 @@ declare const resolveAggUiLabels: (locale: string) => AggUiLabels;
 
 type ThemeMode = "light" | "dark";
 type ChartTimeRange = "1H" | "6H" | "1D" | "1W" | "1M" | "ALL";
+type AggUiTradingExecutionMode = "live" | "paper";
 interface AggUiGeneralConfig {
     /** Locale for number and date formatting */
     locale: string;
@@ -1376,6 +1384,11 @@ interface AggUiSearchConfig {
     isShowingAllResults: boolean;
 }
 type AggUiSearchConfigInput = Partial<AggUiSearchConfig>;
+interface AggUiTradingConfig {
+    /** Default execution mode used by trading surfaces unless a component prop overrides it. */
+    executionMode: AggUiTradingExecutionMode;
+}
+type AggUiTradingConfigInput = Partial<AggUiTradingConfig>;
 interface AggUiConfig {
     /** Enable AGG development logs */
     enableLogs: boolean;
@@ -1399,6 +1412,8 @@ interface AggUiConfig {
     formatting: AggUiFormattingConfig;
     /** Search configuration */
     search: AggUiSearchConfig;
+    /** Trading configuration */
+    trading: AggUiTradingConfig;
     /**
      * Optional wallet action implementations.
      * When walletActions.sendToken is provided, DepositModal uses it for the
@@ -1432,6 +1447,8 @@ interface AggUiConfigInput {
     formatting?: AggUiFormattingConfigInput;
     /** Search config overrides */
     search?: AggUiSearchConfigInput;
+    /** Trading config overrides */
+    trading?: AggUiTradingConfigInput;
     /**
      * Optional wallet action implementations for deposit flows.
      * Provide this once at the provider level for plug-and-play deposit UX.
@@ -5487,4 +5504,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 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 };
+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, type AggUiTradingExecutionMode, 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 };

package/dist/index.d.ts

@@ -676,6 +676,13 @@ interface AggUiLabels {
         categoryTabsAria: string;
     };
     userProfile: {
+        balance: {
+            availableBalance: string;
+            balanceByNetwork: string;
+            paperModeNetwork: string;
+            paperModeWarning: string;
+            networkTooltipDescription: string;
+        };
         activity: {
             depositType: string;
             redeemType: string;
@@ -1290,6 +1297,7 @@ declare const resolveAggUiLabels: (locale: string) => AggUiLabels;
 
 type ThemeMode = "light" | "dark";
 type ChartTimeRange = "1H" | "6H" | "1D" | "1W" | "1M" | "ALL";
+type AggUiTradingExecutionMode = "live" | "paper";
 interface AggUiGeneralConfig {
     /** Locale for number and date formatting */
     locale: string;
@@ -1376,6 +1384,11 @@ interface AggUiSearchConfig {
     isShowingAllResults: boolean;
 }
 type AggUiSearchConfigInput = Partial<AggUiSearchConfig>;
+interface AggUiTradingConfig {
+    /** Default execution mode used by trading surfaces unless a component prop overrides it. */
+    executionMode: AggUiTradingExecutionMode;
+}
+type AggUiTradingConfigInput = Partial<AggUiTradingConfig>;
 interface AggUiConfig {
     /** Enable AGG development logs */
     enableLogs: boolean;
@@ -1399,6 +1412,8 @@ interface AggUiConfig {
     formatting: AggUiFormattingConfig;
     /** Search configuration */
     search: AggUiSearchConfig;
+    /** Trading configuration */
+    trading: AggUiTradingConfig;
     /**
      * Optional wallet action implementations.
      * When walletActions.sendToken is provided, DepositModal uses it for the
@@ -1432,6 +1447,8 @@ interface AggUiConfigInput {
     formatting?: AggUiFormattingConfigInput;
     /** Search config overrides */
     search?: AggUiSearchConfigInput;
+    /** Trading config overrides */
+    trading?: AggUiTradingConfigInput;
     /**
      * Optional wallet action implementations for deposit flows.
      * Provide this once at the provider level for plug-and-play deposit UX.
@@ -5487,4 +5504,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 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 };
+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, type AggUiTradingExecutionMode, 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 };

package/dist/index.js

@@ -783,6 +783,13 @@ var enUsLabels = {
     categoryTabsAria: "Home page category tabs"
   },
   userProfile: {
+    balance: {
+      availableBalance: "Available Balance",
+      balanceByNetwork: "Balance by network",
+      paperModeNetwork: "Paper",
+      paperModeWarning: "Paper mode is enabled. These are simulated funds for paper trading.",
+      networkTooltipDescription: "Funds are stored across networks. We handle routing automatically, but keeping funds on the right network enables faster trades and lower fees. When depositing, you can choose your preferred network."
+    },
     activity: {
       depositType: "Deposit",
       redeemType: "Claim",
@@ -1467,7 +1474,10 @@ var defaultAggUiConfig = {
     }
   },
   formatting: defaultFormatters,
-  search: defaultAggUiSearchConfig
+  search: defaultAggUiSearchConfig,
+  trading: {
+    executionMode: "live"
+  }
 };
 var mergeAggUiSearchConfig = (config) => {
   var _a, _b, _c;
@@ -1482,7 +1492,7 @@ var mergeAggUiSearchConfig = (config) => {
   };
 };
 var mergeAggUiConfig = (persisted, config) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X;
   const locale = (_d = (_c = (_a = config == null ? void 0 : config.general) == null ? void 0 : _a.locale) != null ? _c : (_b = persisted.general) == null ? void 0 : _b.locale) != null ? _d : DEFAULT_LOCALE;
   const theme = (_h = (_g = (_e = config == null ? void 0 : config.general) == null ? void 0 : _e.theme) != null ? _g : (_f = persisted.general) == null ? void 0 : _f.theme) != null ? _h : defaultAggUiConfig.general.theme;
   const formatters = createFormatters(locale);
@@ -1523,6 +1533,9 @@ var mergeAggUiConfig = (persisted, config) => {
       formatDate: (_V = (_U = config == null ? void 0 : config.formatting) == null ? void 0 : _U.formatDate) != null ? _V : formatters.formatDate
     },
     search: mergeAggUiSearchConfig(config == null ? void 0 : config.search),
+    trading: {
+      executionMode: (_X = (_W = config == null ? void 0 : config.trading) == null ? void 0 : _W.executionMode) != null ? _X : defaultAggUiConfig.trading.executionMode
+    },
     walletActions: config == null ? void 0 : config.walletActions,
     solanaRpcUrl: config == null ? void 0 : config.solanaRpcUrl
   };
@@ -1797,7 +1810,7 @@ var balanceQueryKeys = {
   execution: () => executionKeys.balances(),
   // Kept as an alias for backward compatibility with existing callers.
   // The balance provider now uses the same canonical execution balances key.
-  provider: () => executionKeys.balances(),
+  provider: (mode) => executionKeys.balances(mode),
   venue: (venuesKey) => ["venue-balances", venuesKey],
   venuePrefix: () => ["venue-balances"]
 };
@@ -1871,6 +1884,7 @@ var invalidateUserClaimState = (queryClient, options) => {
 // src/core/providers/balance-provider.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var CHAIN_LABELS = {
+  0: "Paper",
   1: "Ethereum",
   10: "Optimism",
   56: "BNB",
@@ -1902,17 +1916,23 @@ var EMPTY_MANAGED_BALANCES = {
 function AggBalanceProvider({ children }) {
   const client = (0, import_react3.useContext)(AggClientContext);
   const authContext = (0, import_react3.useContext)(AggAuthContext);
+  const {
+    trading: { executionMode }
+  } = (0, import_react3.useContext)(AggUiContext);
   if (!authContext) {
     throw new Error("AggBalanceProvider must be used within an <AggAuthProvider>");
   }
   const { isAuthenticated } = authContext;
+  const queryExecutionMode = executionMode === "paper" ? "paper" : void 0;
   const balancesQuery = (0, import_react_query2.useQuery)({
-    queryKey: balanceQueryKeys.provider(),
+    queryKey: balanceQueryKeys.provider(queryExecutionMode),
     queryFn: () => __async(null, null, function* () {
       if (!client || !isAuthenticated) {
         return EMPTY_MANAGED_BALANCES;
       }
-      return client.getManagedBalances();
+      return client.getManagedBalances(
+        queryExecutionMode ? { mode: queryExecutionMode } : void 0
+      );
     }),
     enabled: Boolean(client && isAuthenticated),
     staleTime: 60 * 1e3,

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-QKVR32KC.mjs";
+} from "./chunk-AFZD3GIQ.mjs";
 import {
   useWithdrawEstimate,
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-DK4YDVPH.mjs";
+} from "./chunk-5P53A3NQ.mjs";
 import {
   AggAuthContext,
   AggBalanceProvider,
@@ -95,7 +95,7 @@ import {
   useSyncBalances,
   useWithdrawManaged,
   userActivityQueryKeys
-} from "./chunk-V7VCT62L.mjs";
+} from "./chunk-FYEPQHKO.mjs";
 
 // src/index.ts
 import { QueryClient as QueryClient4, QueryClientProvider, useQueryClient as useQueryClient3 } from "@tanstack/react-query";

package/dist/withdraw.js

@@ -330,6 +330,13 @@ var enUsLabels = {
     categoryTabsAria: "Home page category tabs"
   },
   userProfile: {
+    balance: {
+      availableBalance: "Available Balance",
+      balanceByNetwork: "Balance by network",
+      paperModeNetwork: "Paper",
+      paperModeWarning: "Paper mode is enabled. These are simulated funds for paper trading.",
+      networkTooltipDescription: "Funds are stored across networks. We handle routing automatically, but keeping funds on the right network enables faster trades and lower fees. When depositing, you can choose your preferred network."
+    },
     activity: {
       depositType: "Deposit",
       redeemType: "Claim",
@@ -994,7 +1001,10 @@ var defaultAggUiConfig = {
     }
   },
   formatting: defaultFormatters,
-  search: defaultAggUiSearchConfig
+  search: defaultAggUiSearchConfig,
+  trading: {
+    executionMode: "live"
+  }
 };
 
 // src/core/providers/contexts.ts
@@ -1028,7 +1038,7 @@ var balanceQueryKeys = {
   execution: () => executionKeys.balances(),
   // Kept as an alias for backward compatibility with existing callers.
   // The balance provider now uses the same canonical execution balances key.
-  provider: () => executionKeys.balances(),
+  provider: (mode) => executionKeys.balances(mode),
   venue: (venuesKey) => ["venue-balances", venuesKey],
   venuePrefix: () => ["venue-balances"]
 };

package/dist/withdraw.mjs

@@ -3,12 +3,12 @@ import {
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-DK4YDVPH.mjs";
+} from "./chunk-5P53A3NQ.mjs";
 import {
   useDepositAddresses,
   useManagedBalances,
   useWithdrawManaged
-} from "./chunk-V7VCT62L.mjs";
+} from "./chunk-FYEPQHKO.mjs";
 export {
   useDepositAddresses,
   useManagedBalances,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/hooks",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "React hooks and providers for the AGG prediction market aggregator. Wraps @agg-build/sdk with TanStack Query, shared session state, and live WebSocket data.",
   "sideEffects": false,
   "license": "MIT",