@agg-build/hooks 4.7.4 → 4.10.0

package/dist/deposit.js

@@ -168,6 +168,7 @@ var enUsLabels = {
     kalshi: "Kalshi",
     opinion: "Opinion",
     predict: "Predict",
+    pred: "PRED",
     limitless: "Limitless",
     probable: "Probable",
     myriad: "Myriad",
@@ -797,7 +798,7 @@ var enUsLabels = {
     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.",
+    dflowWalletUnverified: "This route is unavailable for your wallet. Check your account connection and 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.",
@@ -841,6 +842,25 @@ var enUsLabels = {
     kycSuccessTitle: "Verification successful",
     kycSuccessDescription: "Your identity has been confirmed and you now have full access to trade on Kalshi markets.",
     kycSuccessDone: "Done",
+    sharedKyc: {
+      required: "KYC required",
+      completeToTrade: "Complete KYC to trade",
+      checkingStatus: "Checking verification status",
+      modal: {
+        ariaLabel: "Identity verification",
+        title: "Verify Your Identity",
+        freeDescription: "Complete a one-time identity verification to trade all KYC-required venues.",
+        pendingTitle: "Verification pending",
+        pendingDescription: "Your verification is being reviewed. Check back for approval before trading.",
+        checkStatus: "Check verification status",
+        startVerification: "Start verification",
+        doItLater: "Do it later",
+        successTitle: "Verification successful",
+        successDescription: "Your identity has been verified. You can now trade on all KYC-required venues.",
+        done: "Done",
+        error: "We couldn't confirm your verification."
+      }
+    },
     connectKalshi: "Connect to trade Kalshi",
     tradingAccessVenues: "Venues",
     tradingAccessAvailable: "Available",
@@ -885,9 +905,13 @@ var enUsLabels = {
     insufficientVenueInventory: (sharesLabel, priceLabel) => `Only ${sharesLabel} \xB7 ${priceLabel}`,
     viewAllRoutes: (count) => `View all (${count})`,
     venueUnavailableInRegion: "Unavailable in your region",
+    venueTemporarilyUnavailable: "Temporarily unavailable",
     verified: "Verified",
     platformFee: "0% platform fees",
     estimatedFees: "Estimated fees",
+    executionReserve: "Execution reserve",
+    executionReserveTooltipAria: "Why funds are reserved",
+    executionReserveDescription: "Held for price movement or possible venue charges, not a confirmed fee. Unused funds are returned after execution.",
     estimatedFeesTooltipAria: "Estimated fees breakdown",
     feeBreakdownVenueFees: "Venue",
     feeBreakdownBridgeFees: "Bridging",
@@ -918,6 +942,7 @@ var enUsLabels = {
     depositingFunds: (amount, tokenSymbol, destinationChain) => `Depositing ${amount} ${tokenSymbol} to ${destinationChain}...`,
     fundsDeposited: (amount, tokenSymbol, destinationChain) => `Deposited ${amount} ${tokenSymbol} to ${destinationChain}`,
     fillingOnVenue: (venueLabel) => `Filling on ${venueLabel}...`,
+    orderStillSettling: "Still settling. This can take a bit \u2014 check your activity feed. You can keep trading.",
     venueFilledAtPriceWithAmount: (venueLabel, amountLabel, priceLabel) => `${venueLabel} filled ${amountLabel} at ${priceLabel}`,
     executionShares: (value) => `${value} shares`,
     confirmTransactionInWallet: "Confirm the transaction in your wallet",
@@ -1162,6 +1187,35 @@ var enUsLabels = {
     bannerAria: "Site header",
     logoAria: "Home"
   },
+  paperTrading: {
+    badge: "Paper trading",
+    badgeTooltip: "Trade real prediction markets with simulated funds. No real money at risk.",
+    profile: {
+      buyingPower: "Paper Buying Power",
+      earnings: "Paper Earnings",
+      earningsCaption: "Keep what you earn"
+    },
+    onboarding: {
+      stepEyebrow: ({ current, total }) => `STEP ${current} OF ${total}`,
+      skip: "Skip",
+      back: "Back",
+      next: "Next",
+      // Figma reads "Get Strated" (node 4772:31236) — a typo, not copy.
+      done: "Get started",
+      realMarkets: {
+        title: "Real markets, real prices",
+        body: "Follow live prediction markets and trade using real-time market prices from leading venues."
+      },
+      zeroRisk: {
+        title: "Paper trading, zero risk",
+        body: ({ amount }) => `Start with ${amount} in simulated funds. No deposit, no real money, and no risk.`
+      },
+      readyToTrade: {
+        title: "You're ready to trade",
+        body: "Pick a market, make your prediction, and track your performance."
+      }
+    }
+  },
   notifications: {
     order: {
       filledTitle: "Order filled",
@@ -1329,6 +1383,7 @@ var defaultAggUiConfig = {
 // src/core/providers/contexts.ts
 var AggClientContext = (0, import_react2.createContext)(null);
 var AggUiContext = (0, import_react2.createContext)(defaultAggUiConfig);
+var AggExecutionModeContext = (0, import_react2.createContext)(null);
 var AggLabelsContext = (0, import_react2.createContext)(defaultAggUiConfig.general.labels);
 var AggAuthContext = (0, import_react2.createContext)(null);
 var AggBalanceContext = (0, import_react2.createContext)(null);

package/dist/deposit.mjs

@@ -1,7 +1,7 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-DUZ3EJUK.mjs";
+} from "./chunk-MIWXPZNP.mjs";
 import {
   __async,
   useAggAuthState,
@@ -11,7 +11,7 @@ import {
   useDepositAddresses,
   useOptionalAggClient,
   useSyncBalances
-} from "./chunk-HDPVTROR.mjs";
+} from "./chunk-SFSGE25P.mjs";
 
 // src/deposit/normalize-wallet-error.ts
 function normalizeWalletError(error, supportedChains) {

package/dist/index.d.mts

@@ -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, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, ExecutionStatusStep, WsOrderSubmitted, WsBalanceUpdate, ExecutionStatusOrder, CreateBalanceRefillPolicyParams, UpdateBalanceRefillPolicyParams, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, Venue as Venue$1, VenueKeyStatus, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountWalletConfirmBody, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurringCryptoDuration, RecurringCryptoVenueMarket, RecurringCryptoWindowMarket, RecurrenceFilter, SportsLiveResponse, SportsLiveState, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
+import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, ExecutionStatusStep, WsOrderSubmitted, WsBalanceUpdate, ExecutionStatusOrder, CreateBalanceRefillPolicyParams, UpdateBalanceRefillPolicyParams, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, Venue as Venue$1, VenueKeyStatus, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountWalletConfirmBody, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurringCryptoDuration, RecurringCryptoVenueMarket, RecurringCryptoWindowMarket, RecurrenceFilter, SportsLiveResponse, SportsLiveState, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse, AppTradingMode } from '@agg-build/sdk';
 export { SportsGameStatus, SportsLiveParticipant, SportsLiveResponse, SportsLiveState, TurnstileChallengeError } from '@agg-build/sdk';
 import React, { ReactNode } from 'react';
 export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawPreviewParams, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawPreview, useWithdrawalLifecycle } from './withdraw.mjs';
@@ -16,6 +16,7 @@ declare enum Venue {
     limitless = "limitless",
     opinion = "opinion",
     predict = "predict",
+    pred = "pred",
     probable = "probable",
     myriad = "myriad",
     hyperliquid = "hyperliquid",
@@ -160,6 +161,21 @@ type UnifiedBalanceResponse = {
         portfolioValueCents?: number | undefined;
         updatedAt: string;
     }[];
+    /**
+     * Paper-account summary. Present only when the request resolved to paper
+     * mode; absent in a live response. Mirrors `UnifiedBalanceResponseSchemaTB`
+     * in `typebox/schemas/trading.ts` — keep the two in sync. All dollars.
+     */
+    paper?: {
+        startingBalance: number;
+        cashBalance: number;
+        positionsValue: number;
+        /** Banked P&L from closed trades — account-level, not summable from positions. */
+        realizedPnl: number;
+        unrealizedPnl: number;
+        /** realized + unrealized. */
+        earnings: number;
+    };
 };
 type GetOrdersQuery = {
     status?: OrderStatus | undefined;
@@ -1196,7 +1212,7 @@ interface AggUiLabels {
          */
         venueMarketResolved: string;
         /**
-         * dFlow wallet KYC required (verify at dflow.net/proof).
+         * Legacy dFlow wallet eligibility error; Kalshi v2 does not initiate KYC.
          */
         dflowWalletUnverified: string;
         /**
@@ -1253,6 +1269,25 @@ interface AggUiLabels {
         kycSuccessTitle: string;
         kycSuccessDescription: string;
         kycSuccessDone: string;
+        sharedKyc: {
+            required: string;
+            completeToTrade: string;
+            checkingStatus: string;
+            modal: {
+                ariaLabel: string;
+                title: string;
+                freeDescription: string;
+                pendingTitle: string;
+                pendingDescription: string;
+                checkStatus: string;
+                startVerification: string;
+                doItLater: string;
+                successTitle: string;
+                successDescription: string;
+                done: string;
+                error: string;
+            };
+        };
         connectKalshi: string;
         tradingAccessVenues: string;
         tradingAccessAvailable: string;
@@ -1292,9 +1327,13 @@ interface AggUiLabels {
         insufficientVenueInventory: (sharesLabel: string, priceLabel: string) => string;
         viewAllRoutes: (count: number) => string;
         venueUnavailableInRegion: string;
+        venueTemporarilyUnavailable: string;
         verified: string;
         platformFee: string;
         estimatedFees: string;
+        executionReserve: string;
+        executionReserveTooltipAria: string;
+        executionReserveDescription: string;
         estimatedFeesTooltipAria: string;
         feeBreakdownVenueFees: string;
         feeBreakdownBridgeFees: string;
@@ -1325,6 +1364,7 @@ interface AggUiLabels {
         depositingFunds: (amount: string, tokenSymbol: string, destinationChain: string) => string;
         fundsDeposited: (amount: string, tokenSymbol: string, destinationChain: string) => string;
         fillingOnVenue: (venueLabel: string) => string;
+        orderStillSettling: string;
         venueFilledAtPriceWithAmount: (venueLabel: string, amountLabel: string, priceLabel: string) => string;
         executionShares: (value: string) => string;
         confirmTransactionInWallet: string;
@@ -1555,6 +1595,62 @@ interface AggUiLabels {
         bannerAria: string;
         logoAria: string;
     };
+    /**
+     * Copy for app-level paper trading mode (SNA-2964). Every paper string in
+     * the UI resolves through here — components must not render literals, and
+     * tests should assert against these keys rather than their values. The
+     * wording below is placeholder: the design was drawn against an earlier
+     * daily-allowance model and copy is still being revised, so treat these as
+     * defaults to be overridden, not as spec.
+     *
+     * Money figures are passed in already formatted by the caller, sourced from
+     * the server's `paperStartingBalance`, so no amount is ever hardcoded here.
+     */
+    paperTrading: {
+        /** Header pill marking the whole app as simulated. */
+        badge: string;
+        /** Tooltip shown on the header pill. */
+        badgeTooltip: string;
+        profile: {
+            /** Card title for simulated cash available to trade. */
+            buyingPower: string;
+            /** Card title for cumulative simulated P&L. */
+            earnings: string;
+            /**
+             * Small caption beside the earnings figure. There is deliberately no
+             * matching caption for buying power: Figma's "Resets daily" describes
+             * the daily-allowance model, which the one-time grant replaced.
+             */
+            earningsCaption: string;
+        };
+        onboarding: {
+            /** e.g. "STEP 1 OF 3". Derived, never a literal per card. */
+            stepEyebrow: (params: {
+                current: number;
+                total: number;
+            }) => string;
+            /** Secondary action on step 1, where there is nothing to go back to. */
+            skip: string;
+            back: string;
+            next: string;
+            done: string;
+            realMarkets: {
+                title: string;
+                body: string;
+            };
+            zeroRisk: {
+                title: string;
+                /** `amount` arrives pre-formatted, e.g. "$10,000". */
+                body: (params: {
+                    amount: string;
+                }) => string;
+            };
+            readyToTrade: {
+                title: string;
+                body: string;
+            };
+        };
+    };
     /**
      * Copy for the global notification bridge (`AggNotificationEventsProvider`).
      * Each leaf is read from a websocket / activity-feed lifecycle event and
@@ -2853,6 +2949,22 @@ declare const venueKeyQueryKeys: {
 };
 declare const useVenueKeyStatus: (venue: Venue$1, enabled?: boolean) => _tanstack_react_query.UseQueryResult<VenueKeyStatus, Error>;
 
+declare const sharedKycQueryKeys: {
+    status: (userId: string | null) => readonly ["agg", "shared-kyc", string | null];
+};
+/** Shared CH-backed identity state; legacy venue flags and callback query strings are not approval. */
+declare const useSharedKyc: () => {
+    status: "verified" | "loading" | "unverified";
+    refreshStatus: () => Promise<"verified" | "unverified">;
+    initiateVerification: ({ venue, redirectUri }: {
+        venue: string;
+        redirectUri: string;
+    }) => Promise<{
+        status: string;
+        kycUrl?: string;
+    }>;
+};
+
 interface UseAggAuthOptions {
     signMessage?: (message: string) => Promise<string>;
     address?: string;
@@ -4277,12 +4389,11 @@ interface UseMarketOrderbookResult {
 /**
  * Subscribe to a live orderbook for the selected outcome(s).
  *
- * Entirely WS-driven — subscribes to outcome IDs, receives snapshots +
- * deltas via the gateway, reads from the React Query live cache that
- * the ws-provider maintains. No REST fetch needed.
+ * WS-driven in steady state: subscribes to outcome IDs, receives snapshots
+ * + deltas via the gateway, reads from the React Query live cache.
  *
- * When switching outcomes, the subscription changes and a new snapshot
- * arrives for the selected outcome.
+ * REST-seeds `GET /orderbook/outcome/:id` so the book still renders when the
+ * websocket is down or the snapshot never arrives. WS overwrites the seed.
  */
 declare function useMarketOrderbook(options: UseMarketOrderbookOptions): UseMarketOrderbookResult;
 
@@ -6705,17 +6816,49 @@ interface UseVisibleIdsResult {
  */
 declare function useVisibleIds(options?: UseVisibleIdsOptions): UseVisibleIdsResult;
 
+/**
+ * App config is per-App data, and `tradingMode` on it is the client-side
+ * trading authority (SNA-2964). Two `AggClient`s for different Apps under one
+ * `QueryClient` — a partner switching Apps, an admin previewing one — must not
+ * read each other's entry, or a live app paints paper chrome and vice versa.
+ */
+declare const appConfigQueryKey: (appId: string | undefined) => readonly ["agg", "app-config", string];
 interface UseAppConfigResult {
     disabledVenues: AppClientConfigResponse["disabledVenues"];
     disabledCategoryPresets: AppClientConfigResponse["disabledCategoryPresets"];
     earlyAccessEnabled: AppClientConfigResponse["earlyAccessEnabled"];
     authOptions: AppClientConfigResponse["authOptions"];
+    /**
+     * Server-owned paper/live mode. `undefined` until `/app/config` resolves —
+     * deliberately NOT defaulted here, so callers can tell "not loaded yet"
+     * apart from "the server said live". Resolve it via
+     * `useResolvedExecutionMode`, not by reading this directly.
+     */
+    tradingMode: AppClientConfigResponse["tradingMode"] | undefined;
+    /** One-time paper grant in dollars; `undefined` until config resolves. */
+    paperStartingBalance: number | undefined;
     isLoading: boolean;
     error: unknown;
 }
 /**
- * Fetch the current App's UI config (disabled venues + category presets).
- * Cached for 5 minutes — config rarely changes at runtime.
+ * Fetch the current App's UI config (disabled venues, category presets, and
+ * the server-owned paper/live mode).
+ *
+ * Cadence is deliberately the 5 minutes this hook has always used. The only
+ * field here that changes at runtime is `tradingMode`, and a stale one is
+ * COSMETIC: the API resolves mode from the App on every request
+ * (`resolveTradingMode`), so a client that still believes the old value
+ * renders the wrong chrome but cannot execute in the wrong mode or spend real
+ * funds. That does not justify polling a partner's app every minute.
+ *
+ * A bounded `refetchInterval` is still worth having — without one, a tab left
+ * open on a single screen never learns about a flip at all — but it matches
+ * `staleTime` rather than undercutting it.
+ *
+ * `refetchOnWindowFocus`/`refetchOnReconnect` are deliberately left at the
+ * host's defaults. Forcing `"always"` here would override a partner's own
+ * `QueryClient` settings (the demo sets `refetchOnWindowFocus: false`), which
+ * is not this hook's call to make.
  */
 declare function useAppConfig(): UseAppConfigResult;
 /**
@@ -6724,4 +6867,62 @@ 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, 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 ExecutionRawStepProgress, type ExecutionStepProgress, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LimitOrderVenueQuoteRequest, type LimitOrderVenueQuoteResult, type LiveBestPriceCandidate, type LiveBestPriceCandidates, 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 RecurringCryptoIdentity, type RecurringCryptoMarketInstance, type RecurringCryptoTimeline, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, SPORTS_LIVE_POLL_INTERVAL_MS, SPORTS_SCHEDULED_POLL_INTERVAL_MS, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SettlementDiff, type SettlementDifference, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCancelManagedOrderOptions, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLimitOrderVenueQuotesOptions, type UseLimitOrderVenueQuotesResult, 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 UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseRecurringCryptoMarketsOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVenueSellQuotesOptions, type UseVenueSellQuotesResult, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type VenueSellQuoteRequest, type VenueSellQuoteResult, type WalletActionSendTokenParams, type WalletActions, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, fetchRecurringCryptoMarkets, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, mergeRecurringCryptoWindows, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, recurringCryptoTransitionPollInterval, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRecurringCryptoIdentity, resolveRecurringCryptoTimeline, resolveRollingWindow, resolveTradingStateKind, sortVenues, sportsLiveQueryKey, sportsLiveRefetchInterval, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useBalanceRefillPolicies, useCachedAppConfig, useCancelManagedOrder, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLimitOrderVenueQuotes, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePlaceLimitOrder, usePositions, useRampQuotes, useRampSession, useRecurringCryptoMarkets, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useSportsLive, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueKeyStatus, useVenueMarketMidpoints, useVenueMarkets, useVenueSellQuotes, useViewportMidpoints, useVisibleIds, userActivityQueryKeys, venueKeyQueryKeys };
+interface UsePaperOnboardingResult {
+    /** Whether the intro should be on screen right now. */
+    isOpen: boolean;
+    /** Dismiss and never show again for this user. Idempotent. */
+    dismiss: () => void;
+}
+/**
+ * Decides whether to show the paper-trading intro.
+ *
+ * Shown once per user, and only in a paper app. All four conditions must hold:
+ *
+ * 1. the app resolved to paper mode (never in a live app),
+ * 2. mode resolution has finished (otherwise a live app flashes the intro
+ *    before `/app/config` answers),
+ * 3. the user is signed in and we know who they are (the flag is per-user),
+ * 4. that user has not dismissed it before.
+ */
+declare function usePaperOnboarding(): UsePaperOnboardingResult;
+
+interface UseResolvedExecutionModeResult {
+    /**
+     * The mode every execution surface must trade against. Once `/app/config`
+     * resolves this is the server's value, unconditionally.
+     */
+    executionMode: AppTradingMode;
+    /** Convenience for the common branch. */
+    isPaperMode: boolean;
+    /**
+     * True while `/app/config` is still in flight, so the value above is a
+     * locally-configured guess rather than the server's answer. Surfaces that
+     * render mode-specific chrome (a paper badge, a hidden Limit tab, hidden
+     * deposit controls) should hold or skeleton until this is false — otherwise
+     * a paper app briefly paints live chrome, and vice versa.
+     */
+    isResolving: boolean;
+}
+/**
+ * Resolve the app's execution mode with the server as the source of truth.
+ *
+ * Paper/live is an app-level setting owned by the partner admin (SNA-2964);
+ * end users cannot change it, and a partner's own `trading.executionMode`
+ * provider config cannot override it. That local value survives only as the
+ * pre-resolution guess and as the answer for callers running without a
+ * reachable `/app/config`.
+ *
+ * The API enforces the same decision independently — a client that ignores
+ * this hook still cannot place a live order against a paper app.
+ */
+declare function useResolvedExecutionMode(
+/**
+ * Per-surface `executionMode` prop, where one exists (`EventMarketPage`,
+ * `UserProfilePage`, `PlaceOrder`, …). Kept for source compatibility and
+ * honoured only BEFORE the server answers — an app-level mode cannot be
+ * overridden per surface, so the documented "live panel inside a paper app"
+ * pattern no longer applies.
+ */
+override?: AppTradingMode): UseResolvedExecutionModeResult;
+
+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 ExecutionRawStepProgress, type ExecutionStepProgress, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LimitOrderVenueQuoteRequest, type LimitOrderVenueQuoteResult, type LiveBestPriceCandidate, type LiveBestPriceCandidates, 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 RecurringCryptoIdentity, type RecurringCryptoMarketInstance, type RecurringCryptoTimeline, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, SPORTS_LIVE_POLL_INTERVAL_MS, SPORTS_SCHEDULED_POLL_INTERVAL_MS, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SettlementDiff, type SettlementDifference, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCancelManagedOrderOptions, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLimitOrderVenueQuotesOptions, type UseLimitOrderVenueQuotesResult, 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 UsePaperOnboardingResult, type UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseRecurringCryptoMarketsOptions, type UseRedeemLifecycleInput, type UseResolvedExecutionModeResult, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVenueSellQuotesOptions, type UseVenueSellQuotesResult, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type VenueSellQuoteRequest, type VenueSellQuoteResult, type WalletActionSendTokenParams, type WalletActions, appConfigQueryKey, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, fetchRecurringCryptoMarkets, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, mergeRecurringCryptoWindows, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, recurringCryptoTransitionPollInterval, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRecurringCryptoIdentity, resolveRecurringCryptoTimeline, resolveRollingWindow, resolveTradingStateKind, sharedKycQueryKeys, sortVenues, sportsLiveQueryKey, sportsLiveRefetchInterval, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useBalanceRefillPolicies, useCachedAppConfig, useCancelManagedOrder, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLimitOrderVenueQuotes, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePaperOnboarding, usePlaceLimitOrder, usePositions, useRampQuotes, useRampSession, useRecurringCryptoMarkets, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useResolvedExecutionMode, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSharedKyc, useSmartRoute, useSportsLive, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueKeyStatus, useVenueMarketMidpoints, useVenueMarkets, useVenueSellQuotes, useViewportMidpoints, useVisibleIds, userActivityQueryKeys, venueKeyQueryKeys };