@agg-build/hooks 4.7.4 → 4.9.0

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-DUZ3EJUK.mjs";
+} from "./chunk-PUI2EGWE.mjs";
 import {
   useWithdrawEstimate,
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-FPBMOHIA.mjs";
+} from "./chunk-5EXR5PKK.mjs";
 import {
   AggAuthContext,
   AggBalanceProvider,
@@ -28,6 +28,7 @@ import {
   __objRest,
   __spreadProps,
   __spreadValues,
+  appConfigQueryKey,
   applyOrderbookDepth,
   computeClosedPositionTotals,
   createMarketChartData,
@@ -71,7 +72,9 @@ import {
   useAggUiConfig,
   useAggWebSocket,
   useAggWebSocketConnectionState,
+  useAppConfig,
   useBalanceRefillPolicies,
+  useCachedAppConfig,
   useCancelManagedOrder,
   useDepositAddresses,
   useEventListState,
@@ -92,15 +95,16 @@ import {
   useRedeemEligibleCount,
   useRedeemLifecycle,
   useRedeemLifecycles,
+  useResolvedExecutionMode,
   useSdkLabels,
   useSdkUiConfig,
   useSyncBalances,
   useWithdrawManaged,
   userActivityQueryKeys
-} from "./chunk-HDPVTROR.mjs";
+} from "./chunk-25XGLYBT.mjs";
 
 // src/index.ts
-import { QueryClient as QueryClient4, QueryClientProvider, useQueryClient as useQueryClient3 } from "@tanstack/react-query";
+import { QueryClient as QueryClient4, QueryClientProvider, useQueryClient as useQueryClient2 } from "@tanstack/react-query";
 import { TurnstileChallengeError } from "@agg-build/sdk";
 
 // src/use-geo-block.ts
@@ -166,8 +170,42 @@ var useVenueKeyStatus = (venue, enabled = true) => {
   });
 };
 
-// src/use-agg-auth.ts
+// src/use-shared-kyc.ts
 import { useCallback } from "react";
+import { useQuery as useQuery2 } from "@tanstack/react-query";
+var sharedKycQueryKeys = {
+  status: (userId) => ["agg", "shared-kyc", userId]
+};
+var useSharedKyc = () => {
+  var _a, _b;
+  const client = useAggClient();
+  const { isAuthenticated, user } = useAggAuthContext();
+  const userId = (_a = user == null ? void 0 : user.id) != null ? _a : null;
+  const query = useQuery2({
+    queryKey: sharedKycQueryKeys.status(userId),
+    queryFn: () => client.getSharedKycStatus(),
+    enabled: isAuthenticated && userId !== null,
+    staleTime: 15e3,
+    retry: false
+  });
+  const { refetch } = query;
+  const refreshStatus = useCallback(() => __async(null, null, function* () {
+    var _a2;
+    if (!isAuthenticated || !userId) return "unverified";
+    const result = yield refetch({ cancelRefetch: false });
+    if (result.error) throw result.error;
+    return ((_a2 = result.data) == null ? void 0 : _a2.verified) === true ? "verified" : "unverified";
+  }), [isAuthenticated, userId, refetch]);
+  const initiateVerification = useCallback(
+    ({ venue, redirectUri }) => client.initiateKyc(venue, redirectUri),
+    [client]
+  );
+  const status = !isAuthenticated ? "unverified" : !userId || query.isPending ? "loading" : ((_b = query.data) == null ? void 0 : _b.verified) === true ? "verified" : "unverified";
+  return { status, refreshStatus, initiateVerification };
+};
+
+// src/use-agg-auth.ts
+import { useCallback as useCallback2 } from "react";
 function useAggAuth(options = {}) {
   const {
     isAuthenticated,
@@ -177,7 +215,7 @@ function useAggAuth(options = {}) {
     signIn: signInWithProvider,
     signOut
   } = useAggAuthContext();
-  const signIn = useCallback(
+  const signIn = useCallback2(
     (statement) => __async(null, null, function* () {
       if (!options.signMessage) {
         throw new Error(
@@ -201,7 +239,7 @@ function useAggAuth(options = {}) {
 }
 
 // src/use-link-account.ts
-import { useCallback as useCallback2, useState } from "react";
+import { useCallback as useCallback3, useState } from "react";
 function useLinkAccount() {
   const client = useAggClient();
   const [isLoading, setIsLoading] = useState(false);
@@ -215,11 +253,11 @@ function useLinkAccount() {
       throw err;
     }).finally(() => setIsLoading(false));
   };
-  const startLink = useCallback2(
+  const startLink = useCallback3(
     (body) => run(() => client.linkAccount(body)),
     [client]
   );
-  const confirmLink = useCallback2(
+  const confirmLink = useCallback3(
     (input) => run(() => client.linkAccountConfirm(input)),
     [client]
   );
@@ -436,13 +474,13 @@ function useUserActivity(options = {}) {
 }
 
 // src/use-external-id.ts
-import { useCallback as useCallback3, useState as useState3 } from "react";
+import { useCallback as useCallback4, useState as useState3 } from "react";
 function useExternalId(options = {}) {
   const client = useAggClient();
   const { onSuccess, onError: onErrorCb } = options;
   const [isLoading, setIsLoading] = useState3(false);
   const [error, setError] = useState3(null);
-  const linkExternalId = useCallback3(
+  const linkExternalId = useCallback4(
     (assertion) => __async(null, null, function* () {
       setIsLoading(true);
       setError(null);
@@ -494,7 +532,7 @@ function useExecutionPositions(options = {}) {
 }
 
 // src/use-live-candle-overlay.ts
-import { useCallback as useCallback4, useMemo as useMemo4 } from "react";
+import { useCallback as useCallback5, useMemo as useMemo4 } from "react";
 
 // src/use-live-candles.ts
 import { useMemo as useMemo3 } from "react";
@@ -801,7 +839,7 @@ function useLiveCandleOverlay(options) {
     startTs,
     endTs
   });
-  const scaleCandle = useCallback4(
+  const scaleCandle = useCallback5(
     (candle) => ({
       time: candle.time,
       open: candle.o * scale,
@@ -864,7 +902,7 @@ function useEventOrderbookData(venueMarkets, selectedMarketId) {
 }
 
 // src/use-live-market.ts
-import { useQuery as useQuery2 } from "@tanstack/react-query";
+import { useQuery as useQuery3 } from "@tanstack/react-query";
 function outcomeOrderbookToState(response, marketId) {
   var _a, _b, _c, _d;
   const { venue, orderbook, midpoint, spread, seq, checksum, timestamp, venueMarketOutcomeId } = response;
@@ -914,7 +952,7 @@ function useLiveMarket(canonicalMarketId) {
     enabled: isLiveSubscriptionEnabled,
     orderbook: true
   });
-  const query = useQuery2({
+  const query = useQuery3({
     queryKey: marketDataKeys.live(canonicalMarketId != null ? canonicalMarketId : "__disabled__"),
     queryFn: () => __async(null, null, function* () {
       return createMarketLiveState(canonicalMarketId != null ? canonicalMarketId : "__disabled__");
@@ -926,7 +964,7 @@ function useLiveMarket(canonicalMarketId) {
       isConnected: Boolean(isLiveSubscriptionEnabled && isConnected)
     })
   });
-  const seedQuery = useQuery2({
+  const seedQuery = useQuery3({
     queryKey: ["live-market-seed", canonicalMarketId],
     queryFn: ({ signal }) => canonicalMarketId ? client.getOutcomeOrderbook(canonicalMarketId, { signal }) : Promise.resolve(null),
     enabled: Boolean(canonicalMarketId),
@@ -1325,7 +1363,7 @@ function useLiveTrades(canonicalMarketId) {
 }
 
 // src/use-midpoints.ts
-import { useQuery as useQuery3 } from "@tanstack/react-query";
+import { useQuery as useQuery4 } from "@tanstack/react-query";
 import { useMemo as useMemo8 } from "react";
 var normalizeVenueMarketIds = (venueMarkets) => {
   var _a;
@@ -1504,7 +1542,7 @@ function useMidpoints(venueMarkets, options) {
     () => resolveBestMidpointCandidateOutcomeIds(venueMarkets),
     [venueMarkets]
   );
-  const { data, isLoading } = useQuery3({
+  const { data, isLoading } = useQuery4({
     queryKey: ["midpoints", ids, maxMidpointIdsPerRequest],
     queryFn: () => client.getMidpoints(ids, { bestPrice: true, maxMidpointIdsPerRequest }),
     enabled: ids.length > 0,
@@ -1798,7 +1836,7 @@ function useArbFeed() {
 }
 
 // src/use-order-book.ts
-import { keepPreviousData as keepPreviousData3, useQuery as useQuery4 } from "@tanstack/react-query";
+import { keepPreviousData as keepPreviousData3, useQuery as useQuery5 } from "@tanstack/react-query";
 function useOrderBook(options) {
   const client = useAggClient();
   const { orderbooks, enabled = true, canonicalMarketId } = options;
@@ -1811,7 +1849,7 @@ function useOrderBook(options) {
       venueMarketOutcomeId: outcome.id
     })) : void 0
   });
-  const batchedResult = useQuery4({
+  const batchedResult = useQuery5({
     queryKey: requestedVenueMarketIds.length ? ["orderbooks", requestedVenueMarketIds, null] : ["orderbooks", "__disabled__", null],
     queryFn: ({ signal }) => client.getOrderbooks(
       {
@@ -1879,7 +1917,7 @@ function useOrderBook(options) {
 }
 
 // src/use-orderbook-quote.ts
-import { keepPreviousData as keepPreviousData4, useQuery as useQuery5 } from "@tanstack/react-query";
+import { keepPreviousData as keepPreviousData4, useQuery as useQuery6 } from "@tanstack/react-query";
 var QUOTE_DEBOUNCE_MS = 300;
 var createUnavailableOrderbookError = (message, code, retryable) => {
   const error = new Error(message);
@@ -1941,7 +1979,7 @@ function useOrderbookQuote(options) {
   const { marketId, side, size, enabled = true } = options;
   const debouncedSize = useDebouncedValue(size, QUOTE_DEBOUNCE_MS);
   const shouldFetch = enabled && !!marketId && debouncedSize > 0;
-  const query = useQuery5({
+  const query = useQuery6({
     queryKey: marketId ? marketDataKeys.orderbookQuote(marketId, side, debouncedSize) : ["market-data", "orderbook-quote", "__disabled__"],
     queryFn: () => __async(null, null, function* () {
       var _a2, _b, _c, _d;
@@ -1983,12 +2021,12 @@ function useOrderbookQuote(options) {
 }
 
 // src/use-orders.ts
-import { useQuery as useQuery6 } from "@tanstack/react-query";
+import { useQuery as useQuery7 } from "@tanstack/react-query";
 function useOrders(options = {}) {
   var _a, _b, _c, _d;
   const client = useAggClient();
   const { userId, status, limit = 50, offset = 0, enabled = true } = options;
-  const query = useQuery6({
+  const query = useQuery7({
     queryKey: ["orders", userId != null ? userId : "me", status != null ? status : "all", limit, offset],
     queryFn: () => client.getOrders({
       userId,
@@ -2082,7 +2120,7 @@ function useSearch(options) {
 }
 
 // src/use-market-search.ts
-import { useCallback as useCallback5, useState as useState7 } from "react";
+import { useCallback as useCallback6, useState as useState7 } from "react";
 function useMarketSearch(options) {
   var _a;
   const {
@@ -2118,10 +2156,10 @@ function useMarketSearch(options) {
     enabled: submittedQ.length > 0,
     deep: true
   });
-  const setQuery = useCallback5((value) => {
+  const setQuery = useCallback6((value) => {
     setQueryState(value);
   }, []);
-  const submit = useCallback5(
+  const submit = useCallback6(
     (q) => {
       const target = (q != null ? q : query).trim();
       if (target.length === 0) return;
@@ -2129,7 +2167,7 @@ function useMarketSearch(options) {
     },
     [query]
   );
-  const clear = useCallback5(() => {
+  const clear = useCallback6(() => {
     setQueryState("");
     setSubmittedQuery(null);
   }, []);
@@ -2171,7 +2209,7 @@ function useMarketSearch(options) {
 }
 
 // src/use-smart-route.ts
-import { keepPreviousData as keepPreviousData6, useQuery as useQuery7 } from "@tanstack/react-query";
+import { keepPreviousData as keepPreviousData6, useQuery as useQuery8 } from "@tanstack/react-query";
 
 // src/smart-route-refresh-policy.ts
 var THIN_SMART_ROUTE_REFETCH_INTERVAL_MS = 5e3;
@@ -2321,7 +2359,7 @@ function useSmartRoute(options) {
   const resolvedVenueMarketOutcomeId = (_a = venueMarketOutcomeId != null ? venueMarketOutcomeId : venueMarketId) != null ? _a : outcomeId;
   const hasValidInput = (maxSpend != null ? maxSpend : 0) > 0 || (sellShares != null ? sellShares : 0) > 0;
   const queryEnabled = enabled && !!resolvedVenueMarketOutcomeId && hasValidInput;
-  const query = useQuery7({
+  const query = useQuery8({
     queryKey: [
       "smart-route",
       resolvedVenueMarketOutcomeId,
@@ -2402,7 +2440,7 @@ function useSmartRoute(options) {
 }
 
 // src/use-limit-order-venue-quotes.ts
-import { keepPreviousData as keepPreviousData7, useQueries as useQueries6, useQuery as useQuery8 } from "@tanstack/react-query";
+import { keepPreviousData as keepPreviousData7, useQueries as useQueries6, useQuery as useQuery9 } from "@tanstack/react-query";
 var getIsDocumentVisible2 = () => {
   if (typeof document === "undefined") return true;
   return document.visibilityState !== "hidden";
@@ -2457,7 +2495,7 @@ var useLimitOrderVenueQuotes = (options) => {
   const hasRequiredAccount = tradeSide === "buy" || Boolean(accountId);
   const queryEnabled = enabled && hasValidInput && hasRequiredAccount;
   const serializedChainBalances = chainBalances ? JSON.stringify(chainBalances) : null;
-  const tickMetadataQuery = useQuery8({
+  const tickMetadataQuery = useQuery9({
     queryKey: ["orderbooks", marketId != null ? marketId : "__disabled__", "limit-order-ticks"],
     queryFn: ({ signal }) => client.getOrderbooks({ venueMarketIds: [marketId] }, { signal }),
     enabled: enabled && Boolean(marketId),
@@ -2696,10 +2734,10 @@ function useUserHoldings(options) {
 import { useMemo as useMemo10 } from "react";
 
 // src/use-venue-event.ts
-import { useQuery as useQuery10 } from "@tanstack/react-query";
+import { useQuery as useQuery11 } from "@tanstack/react-query";
 
 // src/use-recurring-crypto-markets.ts
-import { useQuery as useQuery9 } from "@tanstack/react-query";
+import { useQuery as useQuery10 } from "@tanstack/react-query";
 var RESOLVING_POLL_INTERVAL_MS = 15e3;
 var FALLBACK_VENUE_EVENT_PAGE_LIMIT = 100;
 var FALLBACK_VENUE_EVENT_MAX_PAGES = 5;
@@ -3193,7 +3231,7 @@ var useRecurringCryptoMarkets = ({
   const client = useAggClient();
   const identity = event ? resolveRecurringCryptoIdentity(event) : null;
   const isEnabled = enabled && event != null && identity != null;
-  const query = useQuery9({
+  const query = useQuery10({
     queryKey: [
       "recurring-crypto-markets",
       event == null ? void 0 : event.id,
@@ -3255,7 +3293,7 @@ function useVenueEvent(options) {
   var _a;
   const client = useAggClient();
   const { eventId, enabled = true, cluster } = options;
-  const query = useQuery10({
+  const query = useQuery11({
     queryKey: ["venue-event", eventId, cluster === false ? "no-cluster" : ""],
     queryFn: (_0) => __async(null, [_0], function* ({ signal }) {
       return client.getVenueEventById(eventId, { signal, cluster });
@@ -3561,7 +3599,7 @@ function useVenueEvents(options) {
 }
 
 // src/use-sports-live.ts
-import { useQuery as useQuery11 } from "@tanstack/react-query";
+import { useQuery as useQuery12 } from "@tanstack/react-query";
 var SPORTS_LIVE_POLL_INTERVAL_MS = 5e3;
 var SPORTS_SCHEDULED_POLL_INTERVAL_MS = 3e4;
 var sportsLiveQueryKey = (sortedEventIds) => ["sports-live", ...sortedEventIds];
@@ -3581,7 +3619,7 @@ var useSportsLive = (eventIds, enabled = true) => {
   const sortedEventIds = [
     ...new Set(eventIds.map((eventId) => eventId.trim()).filter(Boolean))
   ].sort();
-  const query = useQuery11({
+  const query = useQuery12({
     queryKey: sportsLiveQueryKey(sortedEventIds),
     queryFn: ({ signal }) => client.getSportsLive(sortedEventIds, { signal }),
     enabled: enabled && sortedEventIds.length > 0,
@@ -3601,7 +3639,7 @@ var useSportsLive = (eventIds, enabled = true) => {
 };
 
 // src/use-venue-market-midpoints.ts
-import { keepPreviousData as keepPreviousData9, useQuery as useQuery12 } from "@tanstack/react-query";
+import { keepPreviousData as keepPreviousData9, useQuery as useQuery13 } from "@tanstack/react-query";
 var normalizeVenueMarketIds2 = (venueMarketIds) => {
   return [
     ...new Set(venueMarketIds.map((venueMarketId) => venueMarketId.trim()).filter(Boolean))
@@ -3640,7 +3678,7 @@ function useVenueMarketMidpoints(options) {
   const enabled = (_a = options.enabled) != null ? _a : true;
   const requestedVenueMarketIds = normalizeVenueMarketIds2(options.venueMarketIds);
   const maxMidpointIdsPerRequest = (_b = options.maxMidpointIdsPerRequest) != null ? _b : configuredMaxMidpointIdsPerRequest;
-  const query = useQuery12({
+  const query = useQuery13({
     queryKey: requestedVenueMarketIds.length ? ["venue-market-midpoints", requestedVenueMarketIds, maxMidpointIdsPerRequest] : ["venue-market-midpoints", "__disabled__"],
     queryFn: (_0) => __async(null, [_0], function* ({ signal }) {
       if (requestedVenueMarketIds.length === 0) {
@@ -3834,7 +3872,7 @@ function useViewportMidpoints(visibleMarkets, options) {
 }
 
 // src/use-visible-ids.ts
-import { useCallback as useCallback6, useEffect as useEffect11, useRef as useRef7, useState as useState11 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect11, useRef as useRef7, useState as useState11 } from "react";
 function useVisibleIds(options = {}) {
   const { rootMargin = "0px", threshold = 0 } = options;
   const [visibleIds, setVisibleIds] = useState11(() => /* @__PURE__ */ new Set());
@@ -3874,7 +3912,7 @@ function useVisibleIds(options = {}) {
       observerRef.current = null;
     };
   }, [rootMargin, threshold]);
-  const register = useCallback6((id) => {
+  const register = useCallback7((id) => {
     const existing = callbackRefsRef.current.get(id);
     if (existing) return existing;
     const callback = (el) => {
@@ -3906,48 +3944,49 @@ function useVisibleIds(options = {}) {
   return { visibleIds, register };
 }
 
-// src/use-app-config.ts
-import { useQuery as useQuery13, useQueryClient as useQueryClient2 } from "@tanstack/react-query";
-var FIVE_MINUTES = 5 * 60 * 1e3;
-var APP_CONFIG_QUERY_KEY = ["agg", "app-config"];
-function useAppConfig() {
-  const client = useAggClient();
-  const query = useQuery13({
-    queryKey: APP_CONFIG_QUERY_KEY,
-    queryFn: () => client.getAppConfig(),
-    staleTime: FIVE_MINUTES
-  });
-  return toAppConfigResult({
-    data: query.data,
-    isLoading: query.isLoading,
-    error: query.error
-  });
-}
-function useCachedAppConfig() {
-  const queryClient = useQueryClient2();
-  const query = useQuery13({
-    queryKey: APP_CONFIG_QUERY_KEY,
-    enabled: false,
-    initialData: () => queryClient.getQueryData(APP_CONFIG_QUERY_KEY),
-    staleTime: FIVE_MINUTES
-  });
-  return toAppConfigResult({
-    data: query.data,
-    isLoading: query.isLoading,
-    error: query.error
-  });
-}
-var toAppConfigResult = (query) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
-  return {
-    disabledVenues: (_b = (_a = query.data) == null ? void 0 : _a.disabledVenues) != null ? _b : [],
-    disabledCategoryPresets: (_d = (_c = query.data) == null ? void 0 : _c.disabledCategoryPresets) != null ? _d : [],
-    earlyAccessEnabled: (_f = (_e = query.data) == null ? void 0 : _e.earlyAccessEnabled) != null ? _f : false,
-    authOptions: (_h = (_g = query.data) == null ? void 0 : _g.authOptions) != null ? _h : [],
-    isLoading: query.isLoading,
-    error: query.error
-  };
+// src/use-paper-onboarding.ts
+import { useCallback as useCallback8, useEffect as useEffect12, useState as useState12 } from "react";
+var STORAGE_KEY = "agg_paper_onboarding_seen";
+var isBrowser = () => typeof window !== "undefined" && "localStorage" in window;
+var seenKey = (userId) => `${STORAGE_KEY}:${userId}`;
+var hasSeen = (userId) => {
+  if (!isBrowser()) return false;
+  try {
+    return window.localStorage.getItem(seenKey(userId)) === "1";
+  } catch (e) {
+    return true;
+  }
+};
+var markSeen = (userId) => {
+  if (!isBrowser()) return;
+  try {
+    window.localStorage.setItem(seenKey(userId), "1");
+  } catch (e) {
+  }
 };
+function usePaperOnboarding() {
+  const { isPaperMode, isResolving } = useResolvedExecutionMode();
+  const { isAuthenticated, user } = useAggAuthContext();
+  const userId = user == null ? void 0 : user.id;
+  const [dismissed, setDismissed] = useState12(false);
+  const [seen, setSeen] = useState12(null);
+  useEffect12(() => {
+    if (!userId) {
+      setSeen(null);
+      return;
+    }
+    setSeen(hasSeen(userId));
+  }, [userId]);
+  useEffect12(() => {
+    setDismissed(false);
+  }, [userId]);
+  const dismiss = useCallback8(() => {
+    setDismissed(true);
+    if (userId) markSeen(userId);
+  }, [userId]);
+  const isOpen = isPaperMode && !isResolving && isAuthenticated && Boolean(userId) && seen === false && !dismissed;
+  return { isOpen, dismiss };
+}
 export {
   AUTH_CHOOSER_OPEN_EVENT,
   AggBalanceProvider,
@@ -3971,6 +4010,7 @@ export {
   TradeSide,
   TurnstileChallengeError,
   Venue,
+  appConfigQueryKey,
   buildLiveBestPriceCandidates,
   computeClosedPositionTotals,
   computePriceGaps,
@@ -4012,6 +4052,7 @@ export {
   resolveRecurringCryptoTimeline,
   resolveRollingWindow,
   resolveTradingStateKind,
+  sharedKycQueryKeys,
   sortVenues,
   sportsLiveQueryKey,
   sportsLiveRefetchInterval,
@@ -4072,9 +4113,10 @@ export {
   useOrderBook,
   useOrderbookQuote,
   useOrders,
+  usePaperOnboarding,
   usePlaceLimitOrder,
   usePositions,
-  useQueryClient3 as useQueryClient,
+  useQueryClient2 as useQueryClient,
   useRampQuotes,
   useRampSession,
   useRecurringCryptoMarkets,
@@ -4082,10 +4124,12 @@ export {
   useRedeemEligibleCount,
   useRedeemLifecycle,
   useRedeemLifecycles,
+  useResolvedExecutionMode,
   useRollingChartWindow,
   useSdkLabels,
   useSdkUiConfig,
   useSearch,
+  useSharedKyc,
   useSmartRoute,
   useSportsLive,
   useSyncBalances,

package/dist/withdraw.js

@@ -727,7 +727,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.",
@@ -771,6 +771,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",
@@ -815,9 +834,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",
@@ -1092,6 +1115,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",
@@ -1259,6 +1311,7 @@ var defaultAggUiConfig = {
 // src/core/providers/contexts.ts
 var AggClientContext = (0, import_react.createContext)(null);
 var AggUiContext = (0, import_react.createContext)(defaultAggUiConfig);
+var AggExecutionModeContext = (0, import_react.createContext)(null);
 var AggLabelsContext = (0, import_react.createContext)(defaultAggUiConfig.general.labels);
 var AggAuthContext = (0, import_react.createContext)(null);
 var AggBalanceContext = (0, import_react.createContext)(null);
@@ -1416,6 +1469,10 @@ function useManagedBalances(options) {
     queryFn: () => client.getManagedBalances(mode ? { mode } : void 0),
     enabled,
     staleTime: 1e4,
+    // A matched fill can precede settlement and the API's next balance snapshot.
+    // Keep visible clients converging even if that first invalidation reads old cash.
+    refetchInterval: mode === "paper" ? false : 5e3,
+    refetchIntervalInBackground: false,
     gcTime: 5 * 6e4,
     retry: 1
   });

package/dist/withdraw.mjs

@@ -3,12 +3,12 @@ import {
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-FPBMOHIA.mjs";
+} from "./chunk-5EXR5PKK.mjs";
 import {
   useDepositAddresses,
   useManagedBalances,
   useWithdrawManaged
-} from "./chunk-HDPVTROR.mjs";
+} from "./chunk-25XGLYBT.mjs";
 export {
   useDepositAddresses,
   useManagedBalances,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/hooks",
-  "version": "4.7.4",
+  "version": "4.9.0",
   "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",
@@ -83,7 +83,7 @@
     "react": "^18.0.0 || ^19.0.0",
     "viem": "^2.0.0",
     "wagmi": "^3.0.0 || ^2.0.0",
-    "@agg-build/sdk": "^4.7.4"
+    "@agg-build/sdk": "^4.9.0"
   },
   "peerDependenciesMeta": {
     "@solana/wallet-adapter-react": {