@agg-build/hooks 1.2.11 → 1.2.12

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 export { QueryClient, QueryClientProvider, useQueryClient } from '@tanstack/react-query';
 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, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, SmartRouteResponse, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } 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, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, SmartRouteResponse, 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.js';
@@ -730,6 +730,15 @@ interface AggUiLabels {
     eventList: {
         matchedTab: string;
         allTab: string;
+        sortByLabel: string;
+        sortBy24hVolume: string;
+        sortByTopArbitrage: string;
+        sortByTotalVolume: string;
+        sortByEndingSoon: string;
+        subcategoriesLabel: string;
+        subcategoriesAll: string;
+        subcategoriesOpenAria: string;
+        subcategoriesCloseAria: string;
         loading: (title: string) => string;
         tabsAria: (title: string) => string;
         emptyAria: string;
@@ -911,6 +920,60 @@ interface AggUiLabels {
         noOrderbooks: string;
         quoteUnavailable: string;
         quoteBalanceMismatch: string;
+        serviceTemporarilyUnavailable: string;
+        orderDeadlineExpiredBeforeSubmission: string;
+        /**
+         * Venue rejected a SELL because the user's on-chain position is
+         * zero (VMP overstated, prior sell/redeem, transfer out, etc.).
+         * Default: "You don't currently hold any on-chain shares of this
+         * outcome. If you just sold or redeemed elsewhere, your position
+         * display will refresh shortly — try again after that."
+         */
+        sellNoOnchainPosition: string;
+        /**
+         * Venue couldn't fill at the quoted price (Limitless simulation
+         * failed, Myriad walk produced no in-tolerance levels, Hyperliquid
+         * `could not immediately match`, etc.).
+         */
+        venueQuoteUnfillable: string;
+        /**
+         * Bare-minimum venue order-size violation (Limitless 0.01-share
+         * floor, Polymarket post-fee dust, Hyperliquid min-notional).
+         */
+        venueMinOrderSize: string;
+        /**
+         * Source-chain balance changed between quote and submit. Covers
+         * Limitless Base USDC, Polymarket pUSD, Solana SPL InsufficientFunds,
+         * BNB BEP20 transfer-exceeds-balance.
+         */
+        sourceBalanceChanged: string;
+        /**
+         * Venue market resolved / closed between quote and submit.
+         */
+        venueMarketResolved: string;
+        /**
+         * dFlow wallet KYC required (verify at dflow.net/proof).
+         */
+        dflowWalletUnverified: string;
+        /**
+         * No active quote path on the matcher right now (dFlow
+         * route_not_found, etc.).
+         */
+        venueNoQuotePath: string;
+        /**
+         * Solana blockhash expired before the tx landed — re-quote needed.
+         */
+        solanaBlockhashExpired: string;
+        /**
+         * Venue / aggregator API is rate-limited; retry shortly.
+         */
+        venueRateLimited: string;
+        /**
+         * Service-side bug surfaced at admission time (DagValidationError,
+         * Duplicate step ID, etc.). Retrying the same quote will hit the
+         * same bug; user should contact support.
+         */
+        serviceBlockedOrder: string;
         selectedVenueUnavailable: string;
         engineUnavailable: string;
         insufficientInputAmount: string;
@@ -924,6 +987,7 @@ interface AggUiLabels {
         deposit: string;
         kycRequired: string;
         kycNotVerifiedTooltip: string;
+        kycVerify: string;
         kycVerifyModalTitle: string;
         kycVerifyModalDescription: string;
         kycStartVerification: string;
@@ -937,6 +1001,7 @@ interface AggUiLabels {
         splitOrderDescription: string;
         viewAllRoutes: (count: number) => string;
         venueUnavailableInRegion: string;
+        verified: string;
         platformFee: string;
         estimatedFees: string;
         estimatedFeesTooltipAria: string;
@@ -1115,6 +1180,58 @@ interface AggUiLabels {
         bannerAria: string;
         logoAria: string;
     };
+    /**
+     * Copy for the global notification bridge (`AggNotificationEventsProvider`).
+     * Each leaf is read from a websocket / activity-feed lifecycle event and
+     * rendered into the existing toast primitive. Keep these terse — the toast
+     * footprint is small and detail lines wrap awkwardly past two lines.
+     */
+    notifications: {
+        order: {
+            filledTitle: string;
+            filledMessage: (params: {
+                venueLabel?: string;
+                sideLabel?: string;
+                amountLabel?: string;
+                priceLabel?: string;
+            }) => string;
+            partialFilledTitle: string;
+            partialFilledMessage: (params: {
+                venueLabel?: string;
+                sideLabel?: string;
+                amountLabel?: string;
+                priceLabel?: string;
+            }) => string;
+            failedTitle: string;
+            failedMessage: (errorReason?: string) => string;
+        };
+        deposit: {
+            completedTitle: string;
+            completedMessage: (params: {
+                amountLabel?: string;
+                tokenLabel?: string;
+            }) => string;
+            failedTitle: string;
+            failedMessage: (params: {
+                amountLabel?: string;
+                tokenLabel?: string;
+            }) => string;
+        };
+        withdrawal: {
+            completedTitle: string;
+            completedMessage: (params: {
+                amountLabel?: string;
+                tokenLabel?: string;
+            }) => string;
+            partialTitle: string;
+            partialMessage: (params: {
+                amountLabel?: string;
+                tokenLabel?: string;
+            }) => string;
+            failedTitle: string;
+            failedMessage: (errorReason?: string) => string;
+        };
+    };
 }
 type DeepPartial<TValue> = {
     [TKey in keyof TValue]?: TValue[TKey] extends (...args: infer TArgs) => infer TReturn ? (...args: TArgs) => TReturn : TValue[TKey] extends object ? DeepPartial<TValue[TKey]> : TValue[TKey];
@@ -1147,6 +1264,15 @@ interface AggUiFeatureFlagsConfig {
     showFeesBreakdown: boolean;
     /** Enable gradients */
     enableGradients: boolean;
+    /** Enable venue-events discovery filters UI and query wiring. */
+    enableVenueEventDiscoveryFilters: boolean;
+    /**
+     * Enable the global notification bridge that emits toasts for order /
+     * deposit / withdrawal lifecycle events. Defaults to `true`. Set to
+     * `false` to suppress those toasts (the toast surface itself stays mounted
+     * for ad-hoc partner-fired toasts).
+     */
+    enableNotifications: boolean;
 }
 type AggUiFeatureFlagsConfigInput = Partial<AggUiFeatureFlagsConfig>;
 interface AggUiMarketConfig {
@@ -1387,6 +1513,8 @@ declare const DEFAULT_AGG_ROOT_CLASS_NAME = "agg-root";
 declare const CHART_TIME_RANGES: ChartTimeRange[];
 
 declare const useAggClient: () => AggClient;
+/** Like {@link useAggClient}, but returns `null` when no `<AggProvider>` is mounted. */
+declare const useOptionalAggClient: () => AggClient | null;
 declare const useAggUiConfig: () => AggUiConfig;
 declare const useAggLabels: () => AggUiLabels;
 declare const useAggAuthContext: () => AggAuthContextValue;
@@ -1950,6 +2078,7 @@ declare function useRedeemLifecycle(input: UseRedeemLifecycleInput | null): Rede
 declare function useAggWebSocket(): AggWebSocket | null;
 declare function useOnOrderSubmitted(callback: ((msg: WsOrderSubmitted) => void) | null): void;
 declare function useOnBalanceUpdate(callback: ((msg: WsBalanceUpdate) => void) | null): void;
+declare function useOnOrderEvent(callback: ((msg: WsOrderEvent) => void) | null): void;
 declare function useOnWithdrawalLifecycle(callback: ((msg: WsWithdrawalLifecycleEvent) => void) | null): void;
 
 interface MarketChartCandle {
@@ -2061,6 +2190,10 @@ declare const AUTH_CHOOSER_OPEN_EVENT = "agg-auth:open-chooser";
 declare const requestAggAuthChooserOpen: () => void;
 
 interface UseCategoriesOptions {
+    /** Optional query-key scope to isolate caches across different surfaces. */
+    queryKeyScope?: string;
+    /** Fetch child categories for a parent category id. Omit for top-level categories. */
+    parentId?: string | null;
     enabled?: boolean;
     /** Page size when using cursor pagination. Default 20. */
     limit?: number;
@@ -4408,6 +4541,8 @@ interface UseVenueEventsOptions {
     sortBy?: string;
     /** Sort direction: "asc" or "desc". */
     sortDir?: string;
+    /** Recurrence filter (for venue events that support recurrence dimensions). */
+    recurrence?: string;
     /** If provided, enable the query. */
     enabled?: boolean;
     /** Page size when using cursor pagination. Default 20. */
@@ -5189,4 +5324,4 @@ interface UseAppConfigResult {
  */
 declare function useAppConfig(): 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 ComputePriceGapsInput, 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, 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 PriceGapMarket, 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 UseCategoriesOptions, 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 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 VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserMoneyState, mergeBestPricesPreferringLive, 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, useCategories, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, 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 ComputePriceGapsInput, 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, 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 PriceGapMarket, 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 UseCategoriesOptions, 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 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 VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserMoneyState, mergeBestPricesPreferringLive, 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, useCategories, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, 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

@@ -158,9 +158,11 @@ __export(src_exports, {
   useMarketSearch: () => useMarketSearch,
   useMidpoints: () => useMidpoints,
   useOnBalanceUpdate: () => useOnBalanceUpdate,
+  useOnOrderEvent: () => useOnOrderEvent,
   useOnOrderSubmitted: () => useOnOrderSubmitted,
   useOnRedeemEvent: () => useOnRedeemEvent2,
   useOnWithdrawalLifecycle: () => useOnWithdrawalLifecycle,
+  useOptionalAggClient: () => useOptionalAggClient,
   useOrderBook: () => useOrderBook,
   useOrderbookQuote: () => useOrderbookQuote,
   useOrders: () => useOrders,
@@ -830,6 +832,15 @@ var enUsLabels = {
   eventList: {
     matchedTab: "Matched",
     allTab: "All",
+    sortByLabel: "Sort by",
+    sortBy24hVolume: "24h volume",
+    sortByTopArbitrage: "Top arbitrage",
+    sortByTotalVolume: "Total volume",
+    sortByEndingSoon: "Ending soon",
+    subcategoriesLabel: "Subcategories",
+    subcategoriesAll: "All",
+    subcategoriesOpenAria: "Open subcategories",
+    subcategoriesCloseAria: "Close subcategories",
     loading: (title) => `Loading ${title}`,
     tabsAria: (title) => `${title} tabs`,
     emptyAria: "No events found",
@@ -1017,6 +1028,18 @@ var enUsLabels = {
     noOrderbooks: "No live orderbooks are available for this market right now.",
     quoteUnavailable: "Quote temporarily unavailable. Please try again.",
     quoteBalanceMismatch: "Quote balance mismatch. Try a different amount.",
+    serviceTemporarilyUnavailable: "Service temporarily unavailable. Please try again in a moment.",
+    orderDeadlineExpiredBeforeSubmission: "Order deadline expired before submission. Please try again.",
+    sellNoOnchainPosition: "You don't currently hold any on-chain shares of this outcome. If you just sold or redeemed elsewhere, your position display will refresh shortly \u2014 try again after that.",
+    venueQuoteUnfillable: "The venue couldn't fill this order at the quoted price right now. Try a smaller size, a higher slippage tolerance, or wait a moment and re-quote.",
+    venueMinOrderSize: "Order size is below the venue minimum. Try a larger amount.",
+    sourceBalanceChanged: "Your balance changed since the quote. Refresh and try again, or pick a smaller amount.",
+    venueMarketResolved: "This market just resolved. Pick a different market or wait for the next round.",
+    dflowWalletUnverified: "Your Solana wallet needs to be verified with dFlow before you can trade Kalshi markets. Verify at https://dflow.net/proof, then try again.",
+    venueNoQuotePath: "No active quote path for this market right now. Try a different size, or wait a moment and re-quote.",
+    solanaBlockhashExpired: "Solana transaction expired before submission. Please re-quote and try again.",
+    venueRateLimited: "The venue is rate-limiting requests right now. Please wait a moment and try again.",
+    serviceBlockedOrder: "Something on our side blocked this order. Please contact support if it keeps happening \u2014 retrying with the same quote will hit the same issue.",
     selectedVenueUnavailable: "The venue you selected is no longer available on this route. Review the updated options and try again.",
     engineUnavailable: "The routing engine is temporarily unavailable. Please try again in a moment.",
     insufficientInputAmount: "Trade amount is too small to cover bridging and execution costs. Increase your spend or deposit funds on the destination chain.",
@@ -1030,6 +1053,7 @@ var enUsLabels = {
     deposit: "Deposit",
     kycRequired: "Verify to trade Kalshi",
     kycNotVerifiedTooltip: "You have not been verified yet",
+    kycVerify: "Verify Identity",
     kycVerifyModalTitle: "Verify Your Identity",
     kycVerifyModalDescription: "To start trading on Kalshi, you'll need to complete identity verification through dFlow. It only takes a few minutes and helps us stay compliant with regulations.",
     kycStartVerification: "Start Verification",
@@ -1043,6 +1067,7 @@ var enUsLabels = {
     splitOrderDescription: "We split your order for the best price:",
     viewAllRoutes: (count) => `View all (${count})`,
     venueUnavailableInRegion: "Unavailable in your region",
+    verified: "Verified",
     platformFee: "0% platform fees",
     estimatedFees: "Estimated fees",
     estimatedFeesTooltipAria: "Estimated fees breakdown",
@@ -1234,6 +1259,57 @@ var enUsLabels = {
   header: {
     bannerAria: "Site header",
     logoAria: "Home"
+  },
+  notifications: {
+    order: {
+      filledTitle: "Order filled",
+      filledMessage: ({ venueLabel, sideLabel, amountLabel, priceLabel }) => {
+        const action = sideLabel ? `${sideLabel} filled` : "Filled";
+        const amount = amountLabel ? ` ${amountLabel}` : "";
+        const price = priceLabel ? ` at ${priceLabel}` : "";
+        const venue = venueLabel ? ` on ${venueLabel}` : "";
+        return `${action}${amount}${price}${venue}`.trim();
+      },
+      partialFilledTitle: "Order partially filled",
+      partialFilledMessage: ({ venueLabel, sideLabel, amountLabel, priceLabel }) => {
+        const action = sideLabel ? `${sideLabel} partially filled` : "Partially filled";
+        const amount = amountLabel ? ` ${amountLabel}` : "";
+        const price = priceLabel ? ` at ${priceLabel}` : "";
+        const venue = venueLabel ? ` on ${venueLabel}` : "";
+        return `${action}${amount}${price}${venue}`.trim();
+      },
+      failedTitle: "Order failed",
+      failedMessage: (errorReason) => errorReason && errorReason.length > 0 ? errorReason : "Your order could not be completed. Please try again."
+    },
+    deposit: {
+      completedTitle: "Deposit complete",
+      completedMessage: ({ amountLabel, tokenLabel }) => {
+        if (amountLabel && tokenLabel) return `${amountLabel} ${tokenLabel} added to your balance.`;
+        if (tokenLabel) return `Your ${tokenLabel} has been added to your balance.`;
+        return "Your funds have been added to your balance.";
+      },
+      failedTitle: "Deposit failed",
+      failedMessage: ({ amountLabel, tokenLabel }) => {
+        const what = amountLabel && tokenLabel ? `${amountLabel} ${tokenLabel}` : "deposit";
+        return `We couldn't complete your ${what}.`;
+      }
+    },
+    withdrawal: {
+      completedTitle: "Withdrawal complete",
+      completedMessage: ({ amountLabel, tokenLabel }) => {
+        if (amountLabel && tokenLabel) return `${amountLabel} ${tokenLabel} sent to your wallet.`;
+        if (tokenLabel) return `Your ${tokenLabel} has been sent to your wallet.`;
+        return "Your withdrawal has been sent to your wallet.";
+      },
+      partialTitle: "Withdrawal partially completed",
+      partialMessage: ({ amountLabel, tokenLabel }) => {
+        if (amountLabel && tokenLabel)
+          return `Part of your ${tokenLabel} was sent. The remainder was returned to your balance.`;
+        return "Part of your withdrawal was sent. The remainder was returned to your balance.";
+      },
+      failedTitle: "Withdrawal failed",
+      failedMessage: (errorReason) => errorReason && errorReason.length > 0 ? errorReason : "Your funds have been returned to your balance."
+    }
   }
 };
 var defaultAggUiLabelsByLocale = {
@@ -1324,7 +1400,9 @@ var defaultAggUiConfig = {
     enableAnimations: true,
     enableLiveUpdates: true,
     showFeesBreakdown: false,
-    enableGradients: false
+    enableGradients: false,
+    enableVenueEventDiscoveryFilters: false,
+    enableNotifications: true
   },
   market: {
     arbitrageThreshold: 0
@@ -1351,7 +1429,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;
+  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;
   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);
@@ -1370,22 +1448,24 @@ var mergeAggUiConfig = (persisted, config) => {
       enableAnimations: (_p = (_o = config == null ? void 0 : config.features) == null ? void 0 : _o.enableAnimations) != null ? _p : defaultAggUiConfig.features.enableAnimations,
       enableLiveUpdates: (_r = (_q = config == null ? void 0 : config.features) == null ? void 0 : _q.enableLiveUpdates) != null ? _r : defaultAggUiConfig.features.enableLiveUpdates,
       showFeesBreakdown: (_t = (_s = config == null ? void 0 : config.features) == null ? void 0 : _s.showFeesBreakdown) != null ? _t : defaultAggUiConfig.features.showFeesBreakdown,
-      enableGradients: (_v = (_u = config == null ? void 0 : config.features) == null ? void 0 : _u.enableGradients) != null ? _v : defaultAggUiConfig.features.enableGradients
+      enableGradients: (_v = (_u = config == null ? void 0 : config.features) == null ? void 0 : _u.enableGradients) != null ? _v : defaultAggUiConfig.features.enableGradients,
+      enableVenueEventDiscoveryFilters: (_x = (_w = config == null ? void 0 : config.features) == null ? void 0 : _w.enableVenueEventDiscoveryFilters) != null ? _x : defaultAggUiConfig.features.enableVenueEventDiscoveryFilters,
+      enableNotifications: (_z = (_y = config == null ? void 0 : config.features) == null ? void 0 : _y.enableNotifications) != null ? _z : defaultAggUiConfig.features.enableNotifications
     },
     market: {
-      arbitrageThreshold: (_x = (_w = config == null ? void 0 : config.market) == null ? void 0 : _w.arbitrageThreshold) != null ? _x : defaultAggUiConfig.market.arbitrageThreshold
+      arbitrageThreshold: (_B = (_A = config == null ? void 0 : config.market) == null ? void 0 : _A.arbitrageThreshold) != null ? _B : defaultAggUiConfig.market.arbitrageThreshold
     },
     chart: {
-      defaultChartTimeRange: (_z = (_y = config == null ? void 0 : config.chart) == null ? void 0 : _y.defaultChartTimeRange) != null ? _z : defaultAggUiConfig.chart.defaultChartTimeRange,
-      selectedChartTimeRange: (_D = (_C = (_A = persisted.chart) == null ? void 0 : _A.selectedChartTimeRange) != null ? _C : (_B = config == null ? void 0 : config.chart) == null ? void 0 : _B.defaultChartTimeRange) != null ? _D : defaultAggUiConfig.chart.defaultChartTimeRange,
+      defaultChartTimeRange: (_D = (_C = config == null ? void 0 : config.chart) == null ? void 0 : _C.defaultChartTimeRange) != null ? _D : defaultAggUiConfig.chart.defaultChartTimeRange,
+      selectedChartTimeRange: (_H = (_G = (_E = persisted.chart) == null ? void 0 : _E.selectedChartTimeRange) != null ? _G : (_F = config == null ? void 0 : config.chart) == null ? void 0 : _F.defaultChartTimeRange) != null ? _H : defaultAggUiConfig.chart.defaultChartTimeRange,
       setSelectedChartTimeRange: defaultAggUiConfig.chart.setSelectedChartTimeRange
     },
     formatting: {
-      formatNumber: (_F = (_E = config == null ? void 0 : config.formatting) == null ? void 0 : _E.formatNumber) != null ? _F : formatters.formatNumber,
-      formatPercent: (_H = (_G = config == null ? void 0 : config.formatting) == null ? void 0 : _G.formatPercent) != null ? _H : formatters.formatPercent,
-      formatCurrency: (_J = (_I = config == null ? void 0 : config.formatting) == null ? void 0 : _I.formatCurrency) != null ? _J : formatters.formatCurrency,
-      formatCompactCurrency: (_L = (_K = config == null ? void 0 : config.formatting) == null ? void 0 : _K.formatCompactCurrency) != null ? _L : formatters.formatCompactCurrency,
-      formatDate: (_N = (_M = config == null ? void 0 : config.formatting) == null ? void 0 : _M.formatDate) != null ? _N : formatters.formatDate
+      formatNumber: (_J = (_I = config == null ? void 0 : config.formatting) == null ? void 0 : _I.formatNumber) != null ? _J : formatters.formatNumber,
+      formatPercent: (_L = (_K = config == null ? void 0 : config.formatting) == null ? void 0 : _K.formatPercent) != null ? _L : formatters.formatPercent,
+      formatCurrency: (_N = (_M = config == null ? void 0 : config.formatting) == null ? void 0 : _M.formatCurrency) != null ? _N : formatters.formatCurrency,
+      formatCompactCurrency: (_P = (_O = config == null ? void 0 : config.formatting) == null ? void 0 : _O.formatCompactCurrency) != null ? _P : formatters.formatCompactCurrency,
+      formatDate: (_R = (_Q = config == null ? void 0 : config.formatting) == null ? void 0 : _Q.formatDate) != null ? _R : formatters.formatDate
     },
     search: mergeAggUiSearchConfig(config == null ? void 0 : config.search),
     walletActions: config == null ? void 0 : config.walletActions,
@@ -2372,6 +2452,9 @@ var useAggClient = () => {
   }
   return client;
 };
+var useOptionalAggClient = () => {
+  return (0, import_react5.useContext)(AggClientContext);
+};
 var useAggUiConfig = () => {
   return (0, import_react5.useContext)(AggUiContext);
 };
@@ -3695,12 +3778,18 @@ function useSyncBalances(options) {
 
 // src/execution/use-execution-progress.ts
 var import_react10 = require("react");
-var TERMINAL_ORDER_STATUSES = /* @__PURE__ */ new Set(["filled", "partial_fill", "failed", "cancelled"]);
+var TERMINAL_ORDER_STATUSES = /* @__PURE__ */ new Set([
+  "filled",
+  "partial_fill",
+  "failed",
+  "cancelled",
+  "expired"
+]);
 var ORDER_POLL_INTERVAL_MS = 5e3;
 function mapOrderStatusToTerminalEvent(status) {
   if (status === "filled") return "filled";
   if (status === "partial_fill") return "partial_fill";
-  if (status === "failed" || status === "cancelled") return "failed";
+  if (status === "failed" || status === "cancelled" || status === "expired") return "failed";
   return null;
 }
 function useExecutionProgress({
@@ -3756,12 +3845,13 @@ function useExecutionProgress({
       submittedOrderVenueByIdRef.current.set(msg.orderId, trimmedVenue);
     }
     const { event } = msg;
-    if (event === "filled" || event === "partial_fill" || event === "failed" || event === "bridge_ws_subscribe_failed") {
-      const mappedEvent = event === "bridge_ws_subscribe_failed" ? "failed" : event;
+    if (event === "filled" || event === "partial_fill" || event === "failed" || event === "bridge_ws_subscribe_failed" || event === "expired" || event === "dag_cancelled") {
+      const mappedEvent = event === "filled" || event === "partial_fill" ? event : "failed";
       const resolvedVenue = trimmedVenue || submittedOrderVenueByIdRef.current.get(msg.orderId) || "";
       if (resolvedVenue) {
         submittedOrderVenueByIdRef.current.set(msg.orderId, resolvedVenue);
       }
+      const fallbackErrorReason = event === "bridge_ws_subscribe_failed" ? "Bridge event subscription failed." : event === "expired" ? "Order expired before it could be submitted." : event === "dag_cancelled" ? "Order was cancelled before submission." : void 0;
       const nextTerminalEvent = {
         orderId: msg.orderId,
         venue: resolvedVenue,
@@ -3774,7 +3864,7 @@ function useExecutionProgress({
         quotedToWinRaw: msg.quotedToWinRaw,
         executionPriceRaw: msg.executionPriceRaw,
         quotedPriceRaw: msg.quotedPriceRaw,
-        errorReason: event === "bridge_ws_subscribe_failed" ? (_a = msg.errorReason) != null ? _a : "Bridge event subscription failed." : msg.errorReason,
+        errorReason: (_a = msg.errorReason) != null ? _a : fallbackErrorReason,
         timestamp: msg.timestamp
       };
       setTerminalOrderEvents((prev) => {
@@ -4743,17 +4833,19 @@ var requestAggAuthChooserOpen = () => {
 // src/use-categories.ts
 var import_react_query16 = require("@tanstack/react-query");
 function useCategories(options) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e, _f;
   const client = useAggClient();
-  const enabled = (_a = options == null ? void 0 : options.enabled) != null ? _a : true;
-  const limit = (_b = options == null ? void 0 : options.limit) != null ? _b : 20;
+  const queryKeyScope = (_a = options == null ? void 0 : options.queryKeyScope) != null ? _a : "categories";
+  const parentId = (_b = options == null ? void 0 : options.parentId) != null ? _b : null;
+  const enabled = (_c = options == null ? void 0 : options.enabled) != null ? _c : true;
+  const limit = (_d = options == null ? void 0 : options.limit) != null ? _d : 20;
   const query = (0, import_react_query16.useInfiniteQuery)({
-    queryKey: ["categories", limit],
+    queryKey: [queryKeyScope, "parent", parentId != null ? parentId : "__root__", limit],
     queryFn: (_0) => __async(null, [_0], function* ({ pageParam }) {
-      const res = yield client.getCategories({
+      const res = yield client.getCategories(__spreadValues({
         limit,
         cursor: pageParam
-      });
+      }, parentId != null ? { parentId } : {}));
       return res;
     }),
     initialPageParam: void 0,
@@ -4763,7 +4855,7 @@ function useCategories(options) {
     },
     enabled
   });
-  const categories = (_d = (_c = query.data) == null ? void 0 : _c.pages.flatMap((p) => p.data)) != null ? _d : [];
+  const categories = (_f = (_e = query.data) == null ? void 0 : _e.pages.flatMap((p) => p.data)) != null ? _f : [];
   const hasNextPage = !!query.hasNextPage;
   return __spreadProps(__spreadValues({}, query), {
     categories,
@@ -6602,6 +6694,7 @@ function useVenueEvents(options) {
   const status = options == null ? void 0 : options.status;
   const sortBy = options == null ? void 0 : options.sortBy;
   const sortDir = options == null ? void 0 : options.sortDir;
+  const recurrence = options == null ? void 0 : options.recurrence;
   const queryKeyScope = (_d = options == null ? void 0 : options.queryKeyScope) != null ? _d : "events";
   const minYesPrice = options == null ? void 0 : options.minYesPrice;
   const maxYesPrice = options == null ? void 0 : options.maxYesPrice;
@@ -6628,6 +6721,7 @@ function useVenueEvents(options) {
         (_g = status == null ? void 0 : status.join(",")) != null ? _g : "",
         sortBy != null ? sortBy : "",
         sortDir != null ? sortDir : "",
+        recurrence != null ? recurrence : "",
         minYesPrice != null ? minYesPrice : "",
         maxYesPrice != null ? maxYesPrice : "",
         endDateFrom != null ? endDateFrom : "",
@@ -6645,6 +6739,7 @@ function useVenueEvents(options) {
           status,
           sortBy,
           sortDir,
+          recurrence,
           limit,
           minYesPrice,
           maxYesPrice,
@@ -7087,9 +7182,11 @@ function useAppConfig() {
   useMarketSearch,
   useMidpoints,
   useOnBalanceUpdate,
+  useOnOrderEvent,
   useOnOrderSubmitted,
   useOnRedeemEvent,
   useOnWithdrawalLifecycle,
+  useOptionalAggClient,
   useOrderBook,
   useOrderbookQuote,
   useOrders,

package/dist/index.mjs

@@ -1,12 +1,12 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-JWPZNCGY.mjs";
+} from "./chunk-R6VANZRA.mjs";
 import {
   useWithdrawEstimate,
   useWithdrawFlow,
   useWithdrawalLifecycle
-} from "./chunk-CWEJLBYY.mjs";
+} from "./chunk-V34QGQBO.mjs";
 import {
   AggAuthContext,
   AggBalanceProvider,
@@ -77,9 +77,11 @@ import {
   useLabels,
   useManagedBalances,
   useOnBalanceUpdate,
+  useOnOrderEvent,
   useOnOrderSubmitted,
   useOnRedeemEvent,
   useOnWithdrawalLifecycle,
+  useOptionalAggClient,
   usePositions,
   useQuoteManaged,
   useRedeem,
@@ -91,7 +93,7 @@ import {
   useSyncBalances,
   useWithdrawManaged,
   userActivityQueryKeys
-} from "./chunk-553OI6M2.mjs";
+} from "./chunk-2C7JR5OH.mjs";
 
 // src/index.ts
 import { QueryClient as QueryClient4, QueryClientProvider, useQueryClient as useQueryClient2 } from "@tanstack/react-query";
@@ -187,17 +189,19 @@ var requestAggAuthChooserOpen = () => {
 // src/use-categories.ts
 import { useInfiniteQuery } from "@tanstack/react-query";
 function useCategories(options) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e, _f;
   const client = useAggClient();
-  const enabled = (_a = options == null ? void 0 : options.enabled) != null ? _a : true;
-  const limit = (_b = options == null ? void 0 : options.limit) != null ? _b : 20;
+  const queryKeyScope = (_a = options == null ? void 0 : options.queryKeyScope) != null ? _a : "categories";
+  const parentId = (_b = options == null ? void 0 : options.parentId) != null ? _b : null;
+  const enabled = (_c = options == null ? void 0 : options.enabled) != null ? _c : true;
+  const limit = (_d = options == null ? void 0 : options.limit) != null ? _d : 20;
   const query = useInfiniteQuery({
-    queryKey: ["categories", limit],
+    queryKey: [queryKeyScope, "parent", parentId != null ? parentId : "__root__", limit],
     queryFn: (_0) => __async(null, [_0], function* ({ pageParam }) {
-      const res = yield client.getCategories({
+      const res = yield client.getCategories(__spreadValues({
         limit,
         cursor: pageParam
-      });
+      }, parentId != null ? { parentId } : {}));
       return res;
     }),
     initialPageParam: void 0,
@@ -207,7 +211,7 @@ function useCategories(options) {
     },
     enabled
   });
-  const categories = (_d = (_c = query.data) == null ? void 0 : _c.pages.flatMap((p) => p.data)) != null ? _d : [];
+  const categories = (_f = (_e = query.data) == null ? void 0 : _e.pages.flatMap((p) => p.data)) != null ? _f : [];
   const hasNextPage = !!query.hasNextPage;
   return __spreadProps(__spreadValues({}, query), {
     categories,
@@ -2056,6 +2060,7 @@ function useVenueEvents(options) {
   const status = options == null ? void 0 : options.status;
   const sortBy = options == null ? void 0 : options.sortBy;
   const sortDir = options == null ? void 0 : options.sortDir;
+  const recurrence = options == null ? void 0 : options.recurrence;
   const queryKeyScope = (_d = options == null ? void 0 : options.queryKeyScope) != null ? _d : "events";
   const minYesPrice = options == null ? void 0 : options.minYesPrice;
   const maxYesPrice = options == null ? void 0 : options.maxYesPrice;
@@ -2082,6 +2087,7 @@ function useVenueEvents(options) {
         (_g = status == null ? void 0 : status.join(",")) != null ? _g : "",
         sortBy != null ? sortBy : "",
         sortDir != null ? sortDir : "",
+        recurrence != null ? recurrence : "",
         minYesPrice != null ? minYesPrice : "",
         maxYesPrice != null ? maxYesPrice : "",
         endDateFrom != null ? endDateFrom : "",
@@ -2099,6 +2105,7 @@ function useVenueEvents(options) {
           status,
           sortBy,
           sortDir,
+          recurrence,
           limit,
           minYesPrice,
           maxYesPrice,
@@ -2540,9 +2547,11 @@ export {
   useMarketSearch,
   useMidpoints,
   useOnBalanceUpdate,
+  useOnOrderEvent,
   useOnOrderSubmitted,
   useOnRedeemEvent,
   useOnWithdrawalLifecycle,
+  useOptionalAggClient,
   useOrderBook,
   useOrderbookQuote,
   useOrders,