@agg-build/hooks 4.4.0 → 4.7.0

package/README.md

@@ -358,7 +358,8 @@ Import from `@agg-build/hooks/deposit` to keep wallet-heavy hooks out of your ma
 
 - `enableLogs` / `enableWebsocketsLogs` — turn on debug logging
 - `general` — `locale`, `theme` (`"light" | "dark"`), `rootClassName`, `labels`
-- `features` — `showVenueLogo`, `enableAnimations`, `enableLiveUpdates`, `showFeesBreakdown`, `enableGradients`
+- `features` — UI behavior flags including `enableAnimations`, `enableLiveUpdates`,
+  `enableVenueEventDiscoveryFilters`, and `enableEventDiscoveryUrlPersistence`
 - `market` — `arbitrageThreshold`, `maxMidpointIdsPerRequest` for proxy/CDN-safe midpoint batching
 - `chart` — `defaultChartTimeRange`, `selectedChartTimeRange`
 - `search` — provider-owned search state + callbacks for host-app routing/analytics

package/dist/{chunk-LVOL27OZ.mjs → chunk-TVLLWCK7.mjs}

@@ -1400,6 +1400,7 @@ var defaultAggUiConfig = {
     showFeesBreakdown: false,
     enableGradients: false,
     enableVenueEventDiscoveryFilters: false,
+    enableEventDiscoveryUrlPersistence: false,
     enableNotifications: true,
     showLimitOrders: false,
     showSportsMarkets: false
@@ -1433,7 +1434,7 @@ var mergeAggUiSearchConfig = (config) => {
   };
 };
 var mergeAggUiConfig = (persisted, config) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca;
   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);
@@ -1455,32 +1456,33 @@ var mergeAggUiConfig = (persisted, config) => {
       showFeesBreakdown: (_v = (_u = config == null ? void 0 : config.features) == null ? void 0 : _u.showFeesBreakdown) != null ? _v : defaultAggUiConfig.features.showFeesBreakdown,
       enableGradients: (_x = (_w = config == null ? void 0 : config.features) == null ? void 0 : _w.enableGradients) != null ? _x : defaultAggUiConfig.features.enableGradients,
       enableVenueEventDiscoveryFilters: (_z = (_y = config == null ? void 0 : config.features) == null ? void 0 : _y.enableVenueEventDiscoveryFilters) != null ? _z : defaultAggUiConfig.features.enableVenueEventDiscoveryFilters,
-      enableNotifications: (_B = (_A = config == null ? void 0 : config.features) == null ? void 0 : _A.enableNotifications) != null ? _B : defaultAggUiConfig.features.enableNotifications,
-      showLimitOrders: (_D = (_C = config == null ? void 0 : config.features) == null ? void 0 : _C.showLimitOrders) != null ? _D : defaultAggUiConfig.features.showLimitOrders,
-      showSportsMarkets: (_F = (_E = config == null ? void 0 : config.features) == null ? void 0 : _E.showSportsMarkets) != null ? _F : defaultAggUiConfig.features.showSportsMarkets
+      enableEventDiscoveryUrlPersistence: (_B = (_A = config == null ? void 0 : config.features) == null ? void 0 : _A.enableEventDiscoveryUrlPersistence) != null ? _B : defaultAggUiConfig.features.enableEventDiscoveryUrlPersistence,
+      enableNotifications: (_D = (_C = config == null ? void 0 : config.features) == null ? void 0 : _C.enableNotifications) != null ? _D : defaultAggUiConfig.features.enableNotifications,
+      showLimitOrders: (_F = (_E = config == null ? void 0 : config.features) == null ? void 0 : _E.showLimitOrders) != null ? _F : defaultAggUiConfig.features.showLimitOrders,
+      showSportsMarkets: (_H = (_G = config == null ? void 0 : config.features) == null ? void 0 : _G.showSportsMarkets) != null ? _H : defaultAggUiConfig.features.showSportsMarkets
     },
     market: {
-      arbitrageThreshold: (_H = (_G = config == null ? void 0 : config.market) == null ? void 0 : _G.arbitrageThreshold) != null ? _H : defaultAggUiConfig.market.arbitrageThreshold,
-      maxMidpointIdsPerRequest: (_J = (_I = config == null ? void 0 : config.market) == null ? void 0 : _I.maxMidpointIdsPerRequest) != null ? _J : defaultAggUiConfig.market.maxMidpointIdsPerRequest
+      arbitrageThreshold: (_J = (_I = config == null ? void 0 : config.market) == null ? void 0 : _I.arbitrageThreshold) != null ? _J : defaultAggUiConfig.market.arbitrageThreshold,
+      maxMidpointIdsPerRequest: (_L = (_K = config == null ? void 0 : config.market) == null ? void 0 : _K.maxMidpointIdsPerRequest) != null ? _L : defaultAggUiConfig.market.maxMidpointIdsPerRequest
     },
     chart: {
-      defaultChartTimeRange: (_L = (_K = config == null ? void 0 : config.chart) == null ? void 0 : _K.defaultChartTimeRange) != null ? _L : defaultAggUiConfig.chart.defaultChartTimeRange,
-      selectedChartTimeRange: (_P = (_O = (_M = persisted.chart) == null ? void 0 : _M.selectedChartTimeRange) != null ? _O : (_N = config == null ? void 0 : config.chart) == null ? void 0 : _N.defaultChartTimeRange) != null ? _P : defaultAggUiConfig.chart.defaultChartTimeRange,
+      defaultChartTimeRange: (_N = (_M = config == null ? void 0 : config.chart) == null ? void 0 : _M.defaultChartTimeRange) != null ? _N : defaultAggUiConfig.chart.defaultChartTimeRange,
+      selectedChartTimeRange: (_R = (_Q = (_O = persisted.chart) == null ? void 0 : _O.selectedChartTimeRange) != null ? _Q : (_P = config == null ? void 0 : config.chart) == null ? void 0 : _P.defaultChartTimeRange) != null ? _R : defaultAggUiConfig.chart.defaultChartTimeRange,
       setSelectedChartTimeRange: defaultAggUiConfig.chart.setSelectedChartTimeRange
     },
     formatting: {
-      formatNumber: (_R = (_Q = config == null ? void 0 : config.formatting) == null ? void 0 : _Q.formatNumber) != null ? _R : formatters.formatNumber,
-      formatPercent: (_T = (_S = config == null ? void 0 : config.formatting) == null ? void 0 : _S.formatPercent) != null ? _T : formatters.formatPercent,
+      formatNumber: (_T = (_S = config == null ? void 0 : config.formatting) == null ? void 0 : _S.formatNumber) != null ? _T : formatters.formatNumber,
+      formatPercent: (_V = (_U = config == null ? void 0 : config.formatting) == null ? void 0 : _U.formatPercent) != null ? _V : formatters.formatPercent,
       // ponytail: no default here — each cents surface keeps its own rendering
       // when unset, so adding this knob changes nothing for existing partners.
-      formatPrice: (_U = config == null ? void 0 : config.formatting) == null ? void 0 : _U.formatPrice,
-      formatCurrency: (_W = (_V = config == null ? void 0 : config.formatting) == null ? void 0 : _V.formatCurrency) != null ? _W : formatters.formatCurrency,
-      formatCompactCurrency: (_Y = (_X = config == null ? void 0 : config.formatting) == null ? void 0 : _X.formatCompactCurrency) != null ? _Y : formatters.formatCompactCurrency,
-      formatDate: (__ = (_Z = config == null ? void 0 : config.formatting) == null ? void 0 : _Z.formatDate) != null ? __ : formatters.formatDate
+      formatPrice: (_W = config == null ? void 0 : config.formatting) == null ? void 0 : _W.formatPrice,
+      formatCurrency: (_Y = (_X = config == null ? void 0 : config.formatting) == null ? void 0 : _X.formatCurrency) != null ? _Y : formatters.formatCurrency,
+      formatCompactCurrency: (__ = (_Z = config == null ? void 0 : config.formatting) == null ? void 0 : _Z.formatCompactCurrency) != null ? __ : formatters.formatCompactCurrency,
+      formatDate: (_aa = (_$ = config == null ? void 0 : config.formatting) == null ? void 0 : _$.formatDate) != null ? _aa : formatters.formatDate
     },
     search: mergeAggUiSearchConfig(config == null ? void 0 : config.search),
     trading: {
-      executionMode: (_aa = (_$ = config == null ? void 0 : config.trading) == null ? void 0 : _$.executionMode) != null ? _aa : defaultAggUiConfig.trading.executionMode
+      executionMode: (_ca = (_ba = config == null ? void 0 : config.trading) == null ? void 0 : _ba.executionMode) != null ? _ca : defaultAggUiConfig.trading.executionMode
     },
     walletActions: config == null ? void 0 : config.walletActions,
     solanaRpcUrl: config == null ? void 0 : config.solanaRpcUrl

package/dist/{chunk-IHMZHA2W.mjs → chunk-XYQDTF7M.mjs}

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

package/dist/{chunk-O4RM4KKO.mjs → chunk-ZHCJYQSA.mjs}

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

package/dist/deposit.js

@@ -1303,6 +1303,7 @@ var defaultAggUiConfig = {
     showFeesBreakdown: false,
     enableGradients: false,
     enableVenueEventDiscoveryFilters: false,
+    enableEventDiscoveryUrlPersistence: false,
     enableNotifications: true,
     showLimitOrders: false,
     showSportsMarkets: false

package/dist/deposit.mjs

@@ -1,7 +1,7 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-O4RM4KKO.mjs";
+} from "./chunk-ZHCJYQSA.mjs";
 import {
   __async,
   useAggAuthState,
@@ -11,7 +11,7 @@ import {
   useDepositAddresses,
   useOptionalAggClient,
   useSyncBalances
-} from "./chunk-LVOL27OZ.mjs";
+} from "./chunk-TVLLWCK7.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, 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 } 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';
@@ -1662,6 +1662,8 @@ interface AggUiFeatureFlagsConfig {
     enableGradients: boolean;
     /** Enable venue-events discovery filters UI and query wiring. */
     enableVenueEventDiscoveryFilters: boolean;
+    /** Persist the primary HomePage discovery filters in the browser URL. */
+    enableEventDiscoveryUrlPersistence: boolean;
     /**
      * Enable the global notification bridge that emits toasts for order /
      * deposit / withdrawal lifecycle events. Defaults to `true`. Set to
@@ -2869,16 +2871,20 @@ declare function useAggAuth(options?: UseAggAuthOptions): UseAggAuthReturn;
 
 interface UseLinkAccountReturn {
     startLink: (body: AggLinkAccountBody) => Promise<AggLinkAccountResult>;
-    confirmLink: (token: string) => Promise<AggLinkAccountConfirmResult>;
+    confirmLink: (input: string | AggLinkAccountWalletConfirmBody) => Promise<AggLinkAccountConfirmResult>;
     isLoading: boolean;
     error: Error | null;
 }
 /**
- * Hook for initiating and completing an account-link flow (OAuth / email).
+ * Hook for initiating and completing an account-link flow (OAuth / email / wallet).
  *
- * After a `startLink` call, the provider callback redirects the browser back to the
- * app's `redirectUrl` with a `link_confirm_token` query param. Read that param on
- * the redirect target route and pass it to `confirmLink`.
+ * After an OAuth/email `startLink` call, the provider callback redirects the browser
+ * back to the app's `redirectUrl` with a `link_confirm_token` query param. Read that
+ * param on the redirect target route and pass it to `confirmLink`.
+ *
+ * Wallet providers (`siwe`/`siws`) instead return `{ type: "wallet_challenge", message }`
+ * from `startLink`; sign that `message` verbatim and pass
+ * `{ kind: "wallet_signature", message, signature }` to `confirmLink`.
  */
 declare function useLinkAccount(): UseLinkAccountReturn;
 
@@ -5087,6 +5093,12 @@ interface UseVenueEventOptions {
     eventId: string;
     /** Enable/disable the query. Default true. */
     enabled?: boolean;
+    /**
+     * Scope `marketCount` and the rolled-up `volume` to the whole matched cluster
+     * (default) or to this one venue event (`false`). Pair it with the same value
+     * on `useVenueMarkets` so the count matches the market list you render.
+     */
+    cluster?: boolean;
 }
 /**
  * Fetch a single venue event by ID via the API.
@@ -6115,6 +6127,11 @@ interface UseVenueMarketsOptions {
     venue?: Venue;
     /** Filter by parent VenueEvent ID. */
     venueEventId?: string;
+    /**
+     * Scope `venueEventId` to the whole matched cluster (default) or to that one
+     * venue event (`false`). Ignored without `venueEventId`.
+     */
+    cluster?: boolean;
     /** Search by question text. */
     search?: string;
     /** Filter by market status. */

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, 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, 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 } 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.js';
@@ -1662,6 +1662,8 @@ interface AggUiFeatureFlagsConfig {
     enableGradients: boolean;
     /** Enable venue-events discovery filters UI and query wiring. */
     enableVenueEventDiscoveryFilters: boolean;
+    /** Persist the primary HomePage discovery filters in the browser URL. */
+    enableEventDiscoveryUrlPersistence: boolean;
     /**
      * Enable the global notification bridge that emits toasts for order /
      * deposit / withdrawal lifecycle events. Defaults to `true`. Set to
@@ -2869,16 +2871,20 @@ declare function useAggAuth(options?: UseAggAuthOptions): UseAggAuthReturn;
 
 interface UseLinkAccountReturn {
     startLink: (body: AggLinkAccountBody) => Promise<AggLinkAccountResult>;
-    confirmLink: (token: string) => Promise<AggLinkAccountConfirmResult>;
+    confirmLink: (input: string | AggLinkAccountWalletConfirmBody) => Promise<AggLinkAccountConfirmResult>;
     isLoading: boolean;
     error: Error | null;
 }
 /**
- * Hook for initiating and completing an account-link flow (OAuth / email).
+ * Hook for initiating and completing an account-link flow (OAuth / email / wallet).
  *
- * After a `startLink` call, the provider callback redirects the browser back to the
- * app's `redirectUrl` with a `link_confirm_token` query param. Read that param on
- * the redirect target route and pass it to `confirmLink`.
+ * After an OAuth/email `startLink` call, the provider callback redirects the browser
+ * back to the app's `redirectUrl` with a `link_confirm_token` query param. Read that
+ * param on the redirect target route and pass it to `confirmLink`.
+ *
+ * Wallet providers (`siwe`/`siws`) instead return `{ type: "wallet_challenge", message }`
+ * from `startLink`; sign that `message` verbatim and pass
+ * `{ kind: "wallet_signature", message, signature }` to `confirmLink`.
  */
 declare function useLinkAccount(): UseLinkAccountReturn;
 
@@ -5087,6 +5093,12 @@ interface UseVenueEventOptions {
     eventId: string;
     /** Enable/disable the query. Default true. */
     enabled?: boolean;
+    /**
+     * Scope `marketCount` and the rolled-up `volume` to the whole matched cluster
+     * (default) or to this one venue event (`false`). Pair it with the same value
+     * on `useVenueMarkets` so the count matches the market list you render.
+     */
+    cluster?: boolean;
 }
 /**
  * Fetch a single venue event by ID via the API.
@@ -6115,6 +6127,11 @@ interface UseVenueMarketsOptions {
     venue?: Venue;
     /** Filter by parent VenueEvent ID. */
     venueEventId?: string;
+    /**
+     * Scope `venueEventId` to the whole matched cluster (default) or to that one
+     * venue event (`false`). Ignored without `venueEventId`.
+     */
+    cluster?: boolean;
     /** Search by question text. */
     search?: string;
     /** Filter by market status. */

package/dist/index.js

@@ -1751,6 +1751,7 @@ var defaultAggUiConfig = {
     showFeesBreakdown: false,
     enableGradients: false,
     enableVenueEventDiscoveryFilters: false,
+    enableEventDiscoveryUrlPersistence: false,
     enableNotifications: true,
     showLimitOrders: false,
     showSportsMarkets: false
@@ -1784,7 +1785,7 @@ var mergeAggUiSearchConfig = (config) => {
   };
 };
 var mergeAggUiConfig = (persisted, config) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca;
   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);
@@ -1806,32 +1807,33 @@ var mergeAggUiConfig = (persisted, config) => {
       showFeesBreakdown: (_v = (_u = config == null ? void 0 : config.features) == null ? void 0 : _u.showFeesBreakdown) != null ? _v : defaultAggUiConfig.features.showFeesBreakdown,
       enableGradients: (_x = (_w = config == null ? void 0 : config.features) == null ? void 0 : _w.enableGradients) != null ? _x : defaultAggUiConfig.features.enableGradients,
       enableVenueEventDiscoveryFilters: (_z = (_y = config == null ? void 0 : config.features) == null ? void 0 : _y.enableVenueEventDiscoveryFilters) != null ? _z : defaultAggUiConfig.features.enableVenueEventDiscoveryFilters,
-      enableNotifications: (_B = (_A = config == null ? void 0 : config.features) == null ? void 0 : _A.enableNotifications) != null ? _B : defaultAggUiConfig.features.enableNotifications,
-      showLimitOrders: (_D = (_C = config == null ? void 0 : config.features) == null ? void 0 : _C.showLimitOrders) != null ? _D : defaultAggUiConfig.features.showLimitOrders,
-      showSportsMarkets: (_F = (_E = config == null ? void 0 : config.features) == null ? void 0 : _E.showSportsMarkets) != null ? _F : defaultAggUiConfig.features.showSportsMarkets
+      enableEventDiscoveryUrlPersistence: (_B = (_A = config == null ? void 0 : config.features) == null ? void 0 : _A.enableEventDiscoveryUrlPersistence) != null ? _B : defaultAggUiConfig.features.enableEventDiscoveryUrlPersistence,
+      enableNotifications: (_D = (_C = config == null ? void 0 : config.features) == null ? void 0 : _C.enableNotifications) != null ? _D : defaultAggUiConfig.features.enableNotifications,
+      showLimitOrders: (_F = (_E = config == null ? void 0 : config.features) == null ? void 0 : _E.showLimitOrders) != null ? _F : defaultAggUiConfig.features.showLimitOrders,
+      showSportsMarkets: (_H = (_G = config == null ? void 0 : config.features) == null ? void 0 : _G.showSportsMarkets) != null ? _H : defaultAggUiConfig.features.showSportsMarkets
     },
     market: {
-      arbitrageThreshold: (_H = (_G = config == null ? void 0 : config.market) == null ? void 0 : _G.arbitrageThreshold) != null ? _H : defaultAggUiConfig.market.arbitrageThreshold,
-      maxMidpointIdsPerRequest: (_J = (_I = config == null ? void 0 : config.market) == null ? void 0 : _I.maxMidpointIdsPerRequest) != null ? _J : defaultAggUiConfig.market.maxMidpointIdsPerRequest
+      arbitrageThreshold: (_J = (_I = config == null ? void 0 : config.market) == null ? void 0 : _I.arbitrageThreshold) != null ? _J : defaultAggUiConfig.market.arbitrageThreshold,
+      maxMidpointIdsPerRequest: (_L = (_K = config == null ? void 0 : config.market) == null ? void 0 : _K.maxMidpointIdsPerRequest) != null ? _L : defaultAggUiConfig.market.maxMidpointIdsPerRequest
     },
     chart: {
-      defaultChartTimeRange: (_L = (_K = config == null ? void 0 : config.chart) == null ? void 0 : _K.defaultChartTimeRange) != null ? _L : defaultAggUiConfig.chart.defaultChartTimeRange,
-      selectedChartTimeRange: (_P = (_O = (_M = persisted.chart) == null ? void 0 : _M.selectedChartTimeRange) != null ? _O : (_N = config == null ? void 0 : config.chart) == null ? void 0 : _N.defaultChartTimeRange) != null ? _P : defaultAggUiConfig.chart.defaultChartTimeRange,
+      defaultChartTimeRange: (_N = (_M = config == null ? void 0 : config.chart) == null ? void 0 : _M.defaultChartTimeRange) != null ? _N : defaultAggUiConfig.chart.defaultChartTimeRange,
+      selectedChartTimeRange: (_R = (_Q = (_O = persisted.chart) == null ? void 0 : _O.selectedChartTimeRange) != null ? _Q : (_P = config == null ? void 0 : config.chart) == null ? void 0 : _P.defaultChartTimeRange) != null ? _R : defaultAggUiConfig.chart.defaultChartTimeRange,
       setSelectedChartTimeRange: defaultAggUiConfig.chart.setSelectedChartTimeRange
     },
     formatting: {
-      formatNumber: (_R = (_Q = config == null ? void 0 : config.formatting) == null ? void 0 : _Q.formatNumber) != null ? _R : formatters.formatNumber,
-      formatPercent: (_T = (_S = config == null ? void 0 : config.formatting) == null ? void 0 : _S.formatPercent) != null ? _T : formatters.formatPercent,
+      formatNumber: (_T = (_S = config == null ? void 0 : config.formatting) == null ? void 0 : _S.formatNumber) != null ? _T : formatters.formatNumber,
+      formatPercent: (_V = (_U = config == null ? void 0 : config.formatting) == null ? void 0 : _U.formatPercent) != null ? _V : formatters.formatPercent,
       // ponytail: no default here — each cents surface keeps its own rendering
       // when unset, so adding this knob changes nothing for existing partners.
-      formatPrice: (_U = config == null ? void 0 : config.formatting) == null ? void 0 : _U.formatPrice,
-      formatCurrency: (_W = (_V = config == null ? void 0 : config.formatting) == null ? void 0 : _V.formatCurrency) != null ? _W : formatters.formatCurrency,
-      formatCompactCurrency: (_Y = (_X = config == null ? void 0 : config.formatting) == null ? void 0 : _X.formatCompactCurrency) != null ? _Y : formatters.formatCompactCurrency,
-      formatDate: (__ = (_Z = config == null ? void 0 : config.formatting) == null ? void 0 : _Z.formatDate) != null ? __ : formatters.formatDate
+      formatPrice: (_W = config == null ? void 0 : config.formatting) == null ? void 0 : _W.formatPrice,
+      formatCurrency: (_Y = (_X = config == null ? void 0 : config.formatting) == null ? void 0 : _X.formatCurrency) != null ? _Y : formatters.formatCurrency,
+      formatCompactCurrency: (__ = (_Z = config == null ? void 0 : config.formatting) == null ? void 0 : _Z.formatCompactCurrency) != null ? __ : formatters.formatCompactCurrency,
+      formatDate: (_aa = (_$ = config == null ? void 0 : config.formatting) == null ? void 0 : _$.formatDate) != null ? _aa : formatters.formatDate
     },
     search: mergeAggUiSearchConfig(config == null ? void 0 : config.search),
     trading: {
-      executionMode: (_aa = (_$ = config == null ? void 0 : config.trading) == null ? void 0 : _$.executionMode) != null ? _aa : defaultAggUiConfig.trading.executionMode
+      executionMode: (_ca = (_ba = config == null ? void 0 : config.trading) == null ? void 0 : _ba.executionMode) != null ? _ca : defaultAggUiConfig.trading.executionMode
     },
     walletActions: config == null ? void 0 : config.walletActions,
     solanaRpcUrl: config == null ? void 0 : config.solanaRpcUrl
@@ -6048,7 +6050,7 @@ function useLinkAccount() {
     [client]
   );
   const confirmLink = (0, import_react18.useCallback)(
-    (token) => run(() => client.linkAccountConfirm(token)),
+    (input) => run(() => client.linkAccountConfirm(input)),
     [client]
   );
   return { startLink, confirmLink, isLoading, error };
@@ -9077,11 +9079,11 @@ function resolutionPollInterval(event) {
 function useVenueEvent(options) {
   var _a;
   const client = useAggClient();
-  const { eventId, enabled = true } = options;
+  const { eventId, enabled = true, cluster } = options;
   const query = (0, import_react_query40.useQuery)({
-    queryKey: ["venue-event", eventId],
+    queryKey: ["venue-event", eventId, cluster === false ? "no-cluster" : ""],
     queryFn: (_0) => __async(null, [_0], function* ({ signal }) {
-      return client.getVenueEventById(eventId, { signal });
+      return client.getVenueEventById(eventId, { signal, cluster });
     }),
     enabled: enabled && !!eventId,
     staleTime: 5 * 6e4,
@@ -9107,6 +9109,7 @@ function useVenueMarkets(options) {
   const [fallbackQueryClient] = (0, import_react33.useState)(() => new import_react_query41.QueryClient());
   const venue = options == null ? void 0 : options.venue;
   const venueEventId = options == null ? void 0 : options.venueEventId;
+  const cluster = options == null ? void 0 : options.cluster;
   const search = options == null ? void 0 : options.search;
   const matchStatus = options == null ? void 0 : options.matchStatus;
   const status = options == null ? void 0 : options.status;
@@ -9137,6 +9140,7 @@ function useVenueMarkets(options) {
         "venue-markets",
         venue != null ? venue : "",
         venueEventId != null ? venueEventId : "",
+        cluster === false ? "no-cluster" : "",
         search != null ? search : "",
         matchStatus != null ? matchStatus : "",
         status != null ? status : "",
@@ -9158,6 +9162,7 @@ function useVenueMarkets(options) {
         const res = yield client.getVenueMarkets({
           venue,
           venueEventId,
+          cluster,
           search,
           matchStatus,
           status,
@@ -9217,6 +9222,7 @@ function useEnrichedVenueEvent(options) {
   const shouldFetchOnlyOpenMarkets = eventEndedAt == null || eventEndedAt >= Date.now();
   const { markets: openMarkets, isLoading: isEnrichingOpenMarkets } = useVenueMarkets({
     venueEventId: options.eventId,
+    cluster: options.cluster,
     enabled: ((_b = options.enabled) != null ? _b : true) && !!event,
     status: shouldFetchOnlyOpenMarkets ? "open" /* open */ : void 0,
     // No explicit sortBy: event-scoped /venue-markets sorts by the event's
@@ -9229,6 +9235,7 @@ function useEnrichedVenueEvent(options) {
   const shouldFetchAllMarketsFallback = ((_c = options.enabled) != null ? _c : true) && !!event && shouldFetchOnlyOpenMarkets && !isEnrichingOpenMarkets && openMarkets.length === 0;
   const { markets: fallbackMarkets, isLoading: isEnrichingFallbackMarkets } = useVenueMarkets({
     venueEventId: options.eventId,
+    cluster: options.cluster,
     enabled: shouldFetchAllMarketsFallback,
     // No status filter on fallback: if an active event temporarily has only
     // closed/resolved markets, still render the event page instead of the

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-O4RM4KKO.mjs";
+} from "./chunk-ZHCJYQSA.mjs";
 import {
   useWithdrawEstimate,
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-IHMZHA2W.mjs";
+} from "./chunk-XYQDTF7M.mjs";
 import {
   AggAuthContext,
   AggBalanceProvider,
@@ -97,7 +97,7 @@ import {
   useSyncBalances,
   useWithdrawManaged,
   userActivityQueryKeys
-} from "./chunk-LVOL27OZ.mjs";
+} from "./chunk-TVLLWCK7.mjs";
 
 // src/index.ts
 import { QueryClient as QueryClient4, QueryClientProvider, useQueryClient as useQueryClient3 } from "@tanstack/react-query";
@@ -220,7 +220,7 @@ function useLinkAccount() {
     [client]
   );
   const confirmLink = useCallback2(
-    (token) => run(() => client.linkAccountConfirm(token)),
+    (input) => run(() => client.linkAccountConfirm(input)),
     [client]
   );
   return { startLink, confirmLink, isLoading, error };
@@ -3254,11 +3254,11 @@ function resolutionPollInterval(event) {
 function useVenueEvent(options) {
   var _a;
   const client = useAggClient();
-  const { eventId, enabled = true } = options;
+  const { eventId, enabled = true, cluster } = options;
   const query = useQuery10({
-    queryKey: ["venue-event", eventId],
+    queryKey: ["venue-event", eventId, cluster === false ? "no-cluster" : ""],
     queryFn: (_0) => __async(null, [_0], function* ({ signal }) {
-      return client.getVenueEventById(eventId, { signal });
+      return client.getVenueEventById(eventId, { signal, cluster });
     }),
     enabled: enabled && !!eventId,
     staleTime: 5 * 6e4,
@@ -3284,6 +3284,7 @@ function useVenueMarkets(options) {
   const [fallbackQueryClient] = useState8(() => new QueryClient2());
   const venue = options == null ? void 0 : options.venue;
   const venueEventId = options == null ? void 0 : options.venueEventId;
+  const cluster = options == null ? void 0 : options.cluster;
   const search = options == null ? void 0 : options.search;
   const matchStatus = options == null ? void 0 : options.matchStatus;
   const status = options == null ? void 0 : options.status;
@@ -3314,6 +3315,7 @@ function useVenueMarkets(options) {
         "venue-markets",
         venue != null ? venue : "",
         venueEventId != null ? venueEventId : "",
+        cluster === false ? "no-cluster" : "",
         search != null ? search : "",
         matchStatus != null ? matchStatus : "",
         status != null ? status : "",
@@ -3335,6 +3337,7 @@ function useVenueMarkets(options) {
         const res = yield client.getVenueMarkets({
           venue,
           venueEventId,
+          cluster,
           search,
           matchStatus,
           status,
@@ -3394,6 +3397,7 @@ function useEnrichedVenueEvent(options) {
   const shouldFetchOnlyOpenMarkets = eventEndedAt == null || eventEndedAt >= Date.now();
   const { markets: openMarkets, isLoading: isEnrichingOpenMarkets } = useVenueMarkets({
     venueEventId: options.eventId,
+    cluster: options.cluster,
     enabled: ((_b = options.enabled) != null ? _b : true) && !!event,
     status: shouldFetchOnlyOpenMarkets ? "open" /* open */ : void 0,
     // No explicit sortBy: event-scoped /venue-markets sorts by the event's
@@ -3406,6 +3410,7 @@ function useEnrichedVenueEvent(options) {
   const shouldFetchAllMarketsFallback = ((_c = options.enabled) != null ? _c : true) && !!event && shouldFetchOnlyOpenMarkets && !isEnrichingOpenMarkets && openMarkets.length === 0;
   const { markets: fallbackMarkets, isLoading: isEnrichingFallbackMarkets } = useVenueMarkets({
     venueEventId: options.eventId,
+    cluster: options.cluster,
     enabled: shouldFetchAllMarketsFallback,
     // No status filter on fallback: if an active event temporarily has only
     // closed/resolved markets, still render the event page instead of the

package/dist/withdraw.js

@@ -1233,6 +1233,7 @@ var defaultAggUiConfig = {
     showFeesBreakdown: false,
     enableGradients: false,
     enableVenueEventDiscoveryFilters: false,
+    enableEventDiscoveryUrlPersistence: false,
     enableNotifications: true,
     showLimitOrders: false,
     showSportsMarkets: false

package/dist/withdraw.mjs

@@ -3,12 +3,12 @@ import {
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-IHMZHA2W.mjs";
+} from "./chunk-XYQDTF7M.mjs";
 import {
   useDepositAddresses,
   useManagedBalances,
   useWithdrawManaged
-} from "./chunk-LVOL27OZ.mjs";
+} from "./chunk-TVLLWCK7.mjs";
 export {
   useDepositAddresses,
   useManagedBalances,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/hooks",
-  "version": "4.4.0",
+  "version": "4.7.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.3.0"
+    "@agg-build/sdk": "^4.7.0"
   },
   "peerDependenciesMeta": {
     "@solana/wallet-adapter-react": {