@liberfi.io/react-predict 0.1.20 → 0.1.22

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PredictClient, a as PredictWsClient, L as ListEventsParams, b as PredictPage, c as PredictEvent, d as ProviderSource, E as EventStatus, S as SimilarEventsParams, e as PredictMarket, O as Orderbook, f as ListMarketTradesParams, g as PredictTrade, h as PriceHistoryRange, i as PriceHistoryResponse, j as ListCandlesticksParams, C as Candlestick, k as PositionsResponse, B as BalanceResponse, l as ListOrdersParams, m as PredictOrder, n as CancelOrderResult, M as MatchesParams, o as MatchGroupPage, p as MatchGroup, q as ListTradesParams, D as DFlowQuoteRequest, r as DFlowQuoteResponse, s as DFlowSubmitResponse, t as DFlowSubmitRequest, u as DFlowKYCStatus, W as WsConnectionStatus, v as WsDataMessage, w as WsPriceEvent, x as WsOrderbookEvent, y as WsTradeEvent, z as CreateOrderInput } from './server-CiGfmztS.js';
-export { aD as BuildClobAuthMessageInput, aO as BuildOrderMessageInput, aQ as BuildSignedOrderInput, au as CLOB_AUTH_DOMAIN, av as CLOB_AUTH_TYPES, aE as CTF_EXCHANGE_ADDRESS, aJ as CTF_ORDER_TYPES, a0 as DFlowOrderContext, R as EventSortField, V as EventSummary, aA as HttpMethod, Q as MarketOutcome, N as MarketResult, K as MarketStatus, X as MarketSummary, a3 as MatchGroupEntry, a4 as MatchGroupMarket, a5 as MatchSortField, a2 as MatchStatus, a6 as MatchesStats, aF as NEG_RISK_CTF_EXCHANGE_ADDRESS, aK as ORDER_TYPE, aP as OrderMessage, $ as OrderSide, _ as OrderStatus, T as OrderbookLevel, aH as POLYGON_CHAIN_ID, aC as PolymarketL2Headers, aB as PolymarketL2HeadersInput, a1 as PolymarketOrderType, Z as PredictPosition, I as PredictTag, G as PredictWsClientConfig, Y as PricePoint, H as ProviderMeta, an as ResolveEventsParamsInput, aL as SIDE, J as SettlementSource, aR as SignedOrder, ao as TagSlugSelection, U as TradeType, aG as USDC_ADDRESS, a7 as WsChannel, a8 as WsChannelEvent, a9 as WsClientMessage, af as WsErrorCode, ag as WsErrorMessage, ab as WsPingMessage, ad as WsPongMessage, ac as WsServerMessage, aa as WsSubscribeMessage, ae as WsSubscribedMessage, aw as buildClobAuthMessage, aI as buildCtfExchangeDomain, aM as buildOrderMessage, ay as buildPolymarketL2Headers, aN as buildSignedOrder, A as createPredictClient, F as createPredictWsClient, az as derivePolymarketApiKey, ah as eventQueryKey, ai as fetchEvent, am as fetchEventsPage, aq as fetchMarket, at as fetchMatchesPage, ax as hmacSha256Base64, al as infiniteEventsQueryKey, ap as marketQueryKey, as as matchQueryKey, ar as matchesQueryKey, ak as resolveEventsParams, aj as resolveTagSlug } from './server-CiGfmztS.js';
+import { P as PredictClient, a as PredictWsClient, L as ListEventsParams, b as PredictPage, c as PredictEvent, d as ProviderSource, E as EventStatus, S as SimilarEventsParams, e as PredictMarket, O as Orderbook, f as ListMarketTradesParams, g as PredictTrade, h as PriceHistoryRange, i as PriceHistoryResponse, j as ListCandlesticksParams, C as Candlestick, k as PositionsResponse, B as BalanceResponse, l as ListOrdersParams, m as PredictOrder, n as CancelOrderResult, M as MatchesParams, o as MatchGroupPage, p as MatchGroup, q as MatchMarketParams, r as MatchMarketPage, s as ListTradesParams, D as DFlowQuoteRequest, t as DFlowQuoteResponse, u as DFlowSubmitResponse, v as DFlowSubmitRequest, w as DFlowKYCStatus, x as PolymarketSetupStatus, W as WithdrawBuildResponse, y as WithdrawBuildRequest, z as WithdrawSubmitResponse, A as WithdrawSubmitRequest, F as WithdrawStatusResponse, G as PolymarketDepositAddresses, H as PolymarketWithdrawResponse, I as PolymarketWithdrawRequest, J as WsConnectionStatus, K as WsDataMessage, N as WsPriceEvent, Q as WsOrderbookEvent, R as WsTradeEvent, T as CreateOrderInput } from './server-lP60FIU5.js';
+export { aY as BuildClobAuthMessageInput, b9 as BuildOrderMessageInput, aP as CLOB_AUTH_DOMAIN, aQ as CLOB_AUTH_TYPES, aZ as CTF_EXCHANGE_ADDRESS, b2 as CTF_ORDER_TYPES, b8 as ClobOrderPayload, ab as DFlowOrderContext, ad as DepositBuildRequest, ae as DepositBuildResponse, ah as DepositStatusResponse, af as DepositSubmitRequest, ag as DepositSubmitResponse, a2 as EventSortField, a5 as EventSummary, aV as HttpMethod, a1 as MarketOutcome, a0 as MarketResult, $ as MarketStatus, a6 as MarketSummary, ao as MatchConfidenceTier, ak as MatchGroupEntry, al as MatchGroupMarket, ap as MatchMarketFlat, am as MatchSortField, aj as MatchStatus, an as MatchesStats, a_ as NEG_RISK_CTF_EXCHANGE_ADDRESS, b3 as ORDER_TYPE, ba as OrderMessage, aa as OrderSide, a9 as OrderStatus, a3 as OrderbookLevel, b0 as POLYGON_CHAIN_ID, aX as PolymarketL2Headers, aW as PolymarketL2HeadersInput, ac as PolymarketOrderType, a8 as PredictPosition, Z as PredictTag, X as PredictWsClientConfig, a7 as PricePoint, Y as ProviderMeta, aG as ResolveEventsParamsInput, b4 as SIDE, _ as SettlementSource, bb as SignedOrder, aH as TagSlugSelection, a4 as TradeType, a$ as USDC_ADDRESS, ai as UnsignedTx, aq as WsChannel, ar as WsChannelEvent, as as WsClientMessage, ay as WsErrorCode, az as WsErrorMessage, au as WsPingMessage, aw as WsPongMessage, av as WsServerMessage, at as WsSubscribeMessage, ax as WsSubscribedMessage, aR as buildClobAuthMessage, b7 as buildClobPayload, b1 as buildCtfExchangeDomain, b5 as buildOrderMessage, aT as buildPolymarketL2Headers, b6 as buildSignedOrder, U as createPredictClient, V as createPredictWsClient, aU as derivePolymarketApiKey, aA as eventQueryKey, aB as fetchEvent, aF as fetchEventsPage, aJ as fetchMarket, aO as fetchMatchMarketsPage, aM as fetchMatchesPage, aS as hmacSha256Base64, aE as infiniteEventsQueryKey, aI as marketQueryKey, aN as matchMarketsQueryKey, aL as matchQueryKey, aK as matchesQueryKey, aD as resolveEventsParams, aC as resolveTagSlug } from './server-lP60FIU5.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { PropsWithChildren } from 'react';
@@ -114,11 +114,11 @@ interface PolymarketCredentials {
  * const signer: PolymarketSigner = {
  *   address: walletAddress,
  *   signatureType: 2, // EOA = 0, MAGIC_LINK = 1, POLY_PROXY = 2
- *   signTypedData: async (domain, types, value) => {
+ *   signTypedData: async (domain, types, primaryType, value) => {
  *     const provider = await evmWalletAdapter.getEip1193Provider();
  *     return provider.request({
  *       method: "eth_signTypedData_v4",
- *       params: [walletAddress, JSON.stringify({ domain, types, message: value })],
+ *       params: [walletAddress, JSON.stringify({ domain, types, primaryType, message: value })],
  *     });
  *   },
  * };
@@ -137,8 +137,22 @@ interface PolymarketSigner {
     /**
      * Sign EIP-712 typed data and return the hex signature.
      * The signature is used for L1 authentication with the Polymarket CLOB API.
+     *
+     * @param domain      - EIP-712 domain separator.
+     * @param types       - Type definitions (without EIP712Domain).
+     * @param primaryType - The primary type name (e.g. "ClobAuth", "Order").
+     * @param value       - The message/struct values to sign.
+     */
+    signTypedData: (domain: Record<string, unknown>, types: Record<string, unknown[]>, primaryType: string, value: Record<string, unknown>) => Promise<string>;
+    /**
+     * Sign a raw EVM transaction and return the signed transaction hex.
+     * Required for auto-deposit (native USDC → USDC.e via Uniswap V3).
+     * If not provided, auto-deposit will throw when a deposit is needed.
+     *
+     * @param txParams - Transaction parameters: `{ from, to, data, value, chainId, gas }`.
+     * @returns Signed raw transaction hex (0x-prefixed).
      */
-    signTypedData: (domain: Record<string, unknown>, types: Record<string, unknown[]>, value: Record<string, unknown>) => Promise<string>;
+    signTransaction?: (txParams: Record<string, string>) => Promise<string>;
 }
 interface PolymarketContextValue {
     /** In-memory credentials; `null` before the user authenticates. */
@@ -149,9 +163,11 @@ interface PolymarketContextValue {
     authError: Error | null;
     /**
      * Trigger L1 authentication using the provided signer.
-     * Derives L2 credentials with `nonce=0` and stores them in memory.
+     * Derives L2 credentials with `nonce=0`, stores them in memory,
+     * and returns them so the caller can use them immediately
+     * (without waiting for a re-render).
      */
-    authenticate: (signer: PolymarketSigner) => Promise<void>;
+    authenticate: (signer: PolymarketSigner) => Promise<PolymarketCredentials>;
     /** Clear all in-memory credentials (e.g. on wallet disconnect). */
     clearCredentials: () => void;
 }
@@ -206,7 +222,7 @@ interface UseEventParams {
  */
 declare function useEvent(params: UseEventParams, queryOptions?: Omit<UseQueryOptions<PredictEvent, Error, PredictEvent, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<PredictEvent, Error>;
 
-type InfiniteQueryOptions$1 = Omit<UseInfiniteQueryOptions<PredictPage<PredictEvent>, Error, InfiniteData<PredictPage<PredictEvent>>, unknown[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">;
+type InfiniteQueryOptions$2 = Omit<UseInfiniteQueryOptions<PredictPage<PredictEvent>, Error, InfiniteData<PredictPage<PredictEvent>>, unknown[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">;
 /**
  * TanStack Query infinite-query hook for `GET /api/v1/events` with cursor-based
  * pagination via the prediction-server client.
@@ -221,7 +237,7 @@ type InfiniteQueryOptions$1 = Omit<UseInfiniteQueryOptions<PredictPage<PredictEv
  * const { data, hasNextPage, fetchNextPage } = useInfiniteEvents(params);
  * ```
  */
-declare function useInfiniteEvents(params: ListEventsParams, queryOptions?: InfiniteQueryOptions$1): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<PredictPage<PredictEvent>, unknown>, Error>;
+declare function useInfiniteEvents(params: ListEventsParams, queryOptions?: InfiniteQueryOptions$2): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<PredictPage<PredictEvent>, unknown>, Error>;
 
 interface UseSearchEventsParams {
     /** Search keyword. */
@@ -337,12 +353,27 @@ interface UseCandlesticksParams {
 declare function useCandlesticks(params: UseCandlesticksParams, queryOptions?: Omit<UseQueryOptions<Candlestick[], Error, Candlestick[], unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<Candlestick[], Error>;
 
 declare function positionsQueryKey(user: string, source?: ProviderSource): unknown[];
+declare function positionsMultiQueryKey(wallets: {
+    kalshi_user?: string;
+    polymarket_user?: string;
+}): unknown[];
+/** Single-source params (backward-compatible). */
 interface UsePositionsParams {
-    /** Provider source. Omit to aggregate all providers. */
+    /** Provider source. Omit to aggregate all providers (same address). */
     source?: ProviderSource;
     user: string;
 }
+/** Multi-wallet params — each provider gets its own address. */
+interface UsePositionsMultiParams {
+    kalshi_user?: string;
+    polymarket_user?: string;
+}
 declare function usePositions(params: UsePositionsParams, queryOptions?: Omit<UseQueryOptions<PositionsResponse, Error, PositionsResponse, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<PositionsResponse, Error>;
+/**
+ * Fetch positions for multiple wallets in a single request.
+ * Each provider is queried with its own address.
+ */
+declare function usePositionsMulti(params: UsePositionsMultiParams, queryOptions?: Omit<UseQueryOptions<PositionsResponse, Error, PositionsResponse, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<PositionsResponse, Error>;
 
 declare function balanceQueryKey(source: ProviderSource, user: string): unknown[];
 interface UseBalanceParams {
@@ -352,11 +383,25 @@ interface UseBalanceParams {
 declare function useBalance(params: UseBalanceParams, queryOptions?: Omit<UseQueryOptions<BalanceResponse, Error, BalanceResponse, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<BalanceResponse, Error>;
 
 declare function ordersQueryKey(params: ListOrdersParams): unknown[];
-declare function useOrders(params: ListOrdersParams, queryOptions?: Omit<UseQueryOptions<PredictPage<PredictOrder>, Error, PredictPage<PredictOrder>, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<PredictPage<PredictOrder>, Error>;
+interface UseOrdersOptions {
+    /**
+     * Async callback invoked before each request to obtain extra headers.
+     * Used by Polymarket orders to attach POLY_* HMAC authentication headers.
+     */
+    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+}
+declare function useOrders(params: ListOrdersParams, options?: UseOrdersOptions, queryOptions?: Omit<UseQueryOptions<PredictPage<PredictOrder>, Error, PredictPage<PredictOrder>, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<PredictPage<PredictOrder>, Error>;
 
 type UseInfiniteOrdersParams = Omit<ListOrdersParams, "next_cursor">;
+interface UseInfiniteOrdersOptions {
+    /**
+     * Async callback invoked before each request to obtain extra headers.
+     * Used by Polymarket orders to attach POLY_* HMAC authentication headers.
+     */
+    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+}
 declare function infiniteOrdersQueryKey(params: UseInfiniteOrdersParams): unknown[];
-declare function useInfiniteOrders(params: UseInfiniteOrdersParams): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<PredictPage<PredictOrder>, unknown>, Error>;
+declare function useInfiniteOrders(params: UseInfiniteOrdersParams, options?: UseInfiniteOrdersOptions): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<PredictPage<PredictOrder>, unknown>, Error>;
 
 declare function orderQueryKey(id: string, source: ProviderSource): unknown[];
 interface UseOrderParams {
@@ -375,19 +420,27 @@ interface CancelOrderVariables {
 declare function useCancelOrder(mutationOptions?: Omit<UseMutationOptions<CancelOrderResult, Error, CancelOrderVariables>, "mutationFn">): _tanstack_react_query.UseMutationResult<CancelOrderResult, Error, CancelOrderVariables, unknown>;
 
 type UseInfiniteMatchesParams = Omit<MatchesParams, "cursor">;
-type InfiniteQueryOptions = Omit<UseInfiniteQueryOptions<MatchGroupPage, Error, InfiniteData<MatchGroupPage>, unknown[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">;
+type InfiniteQueryOptions$1 = Omit<UseInfiniteQueryOptions<MatchGroupPage, Error, InfiniteData<MatchGroupPage>, unknown[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">;
 /**
  * TanStack Query infinite-query hook for `GET /api/v1/matches` with
  * cursor-based pagination.
  *
  * Stats are available from the first page: `data.pages[0]?.stats`.
  */
-declare function useInfiniteMatches(params: UseInfiniteMatchesParams, queryOptions?: InfiniteQueryOptions): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<MatchGroupPage, unknown>, Error>;
+declare function useInfiniteMatches(params: UseInfiniteMatchesParams, queryOptions?: InfiniteQueryOptions$1): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<MatchGroupPage, unknown>, Error>;
 /**
  * TanStack Query hook for fetching a single match group by ID.
  */
 declare function useMatch(id: number, queryOptions?: Omit<UseQueryOptions<MatchGroup, Error, MatchGroup, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<MatchGroup, Error>;
 
+type UseInfiniteMatchMarketsParams = Omit<MatchMarketParams, "offset">;
+type InfiniteQueryOptions = Omit<UseInfiniteQueryOptions<MatchMarketPage, Error, InfiniteData<MatchMarketPage>, unknown[], number>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">;
+/**
+ * TanStack Query infinite-query hook for `GET /api/v1/matches/markets`
+ * with offset-based pagination.
+ */
+declare function useInfiniteMatchMarkets(params: UseInfiniteMatchMarketsParams, queryOptions?: InfiniteQueryOptions): _tanstack_react_query.UseInfiniteQueryResult<InfiniteData<MatchMarketPage, unknown>, Error>;
+
 declare function tradesQueryKey(params: ListTradesParams): unknown[];
 declare function useTrades(params: ListTradesParams, queryOptions?: Omit<UseQueryOptions<PredictPage<PredictTrade>, Error, PredictPage<PredictTrade>, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<PredictPage<PredictTrade>, Error>;
 
@@ -413,6 +466,89 @@ declare function dflowKYCQueryKey(walletAddress: string): unknown[];
  */
 declare function useDFlowKYC(walletAddress?: string, queryOptions?: Omit<UseQueryOptions<DFlowKYCStatus, Error, DFlowKYCStatus, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<DFlowKYCStatus, Error>;
 
+declare function polymarketSetupQueryKey(walletAddress: string): unknown[];
+/**
+ * Query hook that checks Polymarket wallet setup status
+ * (Safe deployed + USDC.e approved for CTF Exchange).
+ */
+declare function usePolymarketSetup(walletAddress?: string, queryOptions?: Omit<UseQueryOptions<PolymarketSetupStatus, Error, PolymarketSetupStatus, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<PolymarketSetupStatus, Error>;
+/**
+ * Mutation hook to run Polymarket wallet setup
+ * (deploy Safe + approve USDC.e via Relayer).
+ * Automatically invalidates the setup status query on success.
+ */
+declare function useRunPolymarketSetup(walletAddress?: string): _tanstack_react_query.UseMutationResult<PolymarketSetupStatus, Error, string, unknown>;
+
+declare function useWithdrawBuildMutation(mutationOptions?: Omit<UseMutationOptions<WithdrawBuildResponse, Error, WithdrawBuildRequest>, "mutationFn">): _tanstack_react_query.UseMutationResult<WithdrawBuildResponse, Error, WithdrawBuildRequest, unknown>;
+
+declare function useWithdrawSubmitMutation(mutationOptions?: Omit<UseMutationOptions<WithdrawSubmitResponse, Error, WithdrawSubmitRequest>, "mutationFn">): _tanstack_react_query.UseMutationResult<WithdrawSubmitResponse, Error, WithdrawSubmitRequest, unknown>;
+
+declare function withdrawStatusQueryKey(txHash: string, source: ProviderSource): unknown[];
+interface UseWithdrawStatusQueryParams {
+    txHash: string | undefined;
+    source: ProviderSource;
+}
+/**
+ * Polls the withdraw transaction status every 3 seconds.
+ * Automatically stops polling when status is "confirmed" or "failed".
+ * Only enabled when `txHash` is defined.
+ */
+declare function useWithdrawStatusQuery(params: UseWithdrawStatusQueryParams, queryOptions?: Omit<UseQueryOptions<WithdrawStatusResponse, Error, WithdrawStatusResponse, unknown[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<WithdrawStatusResponse, Error>;
+
+interface PolymarketDepositVariables {
+    from: string;
+    safeAddress: string;
+    /** Total USDC amount needed (human-readable, e.g. "50.0"). */
+    amount: string;
+    /** Signs a raw EVM transaction and returns the signed hex. */
+    signTransaction: (txParams: Record<string, string>) => Promise<string>;
+}
+interface PolymarketDepositResult {
+    /** Whether any deposit transactions were executed. */
+    deposited: boolean;
+    /** Number of transactions executed (0, 1 for swap-only, or 2 for approve+swap). */
+    txCount: number;
+    /** Shortfall that was swapped (human-readable). */
+    shortfall: string;
+    /** Safe balance before deposit. */
+    safeBalance: string;
+}
+/**
+ * Mutation hook for depositing native USDC into a Polymarket Safe wallet as USDC.e.
+ *
+ * Flow:
+ * 1. Calls `/deposit/polymarket/build` to check Safe USDC.e balance and get unsigned txs.
+ * 2. If shortfall > 0, signs and submits each tx (approve if needed, then swap).
+ * 3. Polls tx status until confirmed.
+ * 4. Returns the deposit result.
+ */
+declare function usePolymarketDeposit(mutationOptions?: Omit<UseMutationOptions<PolymarketDepositResult, Error, PolymarketDepositVariables>, "mutationFn">): _tanstack_react_query.UseMutationResult<PolymarketDepositResult, Error, PolymarketDepositVariables, unknown>;
+
+declare const polymarketDepositAddressesQueryKey: (safeAddress: string) => readonly ["polymarket", "deposit-addresses", string];
+/**
+ * Fetch multi-chain deposit addresses for a Polymarket Safe wallet.
+ *
+ * @param safeAddress - The Safe (proxy) wallet address. When empty/undefined the query is disabled.
+ */
+declare function usePolymarketDepositAddresses(safeAddress: string | undefined): _tanstack_react_query.UseQueryResult<PolymarketDepositAddresses, Error>;
+
+/**
+ * Mutation hook to execute a gasless USDC.e withdrawal from a Polymarket Safe
+ * wallet via the Relayer.
+ *
+ * @example
+ * ```ts
+ * const { mutateAsync: withdraw } = usePolymarketWithdraw();
+ * await withdraw({
+ *   wallet_address: "0xEOA...",
+ *   safe_address: "0xSafe...",
+ *   to: "0xRecipient...",
+ *   amount: "10.5",
+ * });
+ * ```
+ */
+declare function usePolymarketWithdraw(): _tanstack_react_query.UseMutationResult<PolymarketWithdrawResponse, Error, PolymarketWithdrawRequest, unknown>;
+
 interface UsePredictWsClientResult {
     /** The WebSocket client instance, or `null` if not provided via `PredictProvider`. */
     wsClient: PredictWsClient | null;
@@ -601,25 +737,37 @@ interface CreatePolymarketOrderVariables {
     /**
      * IoC signer — provided by the consuming app.
      * Used to sign the EIP-712 order struct on the CTF Exchange contract.
+     * If `signTransaction` is provided on the signer, auto-deposit is enabled:
+     * before placing the order, the hook checks whether the Safe wallet has
+     * enough USDC.e and swaps native USDC → USDC.e via Uniswap V3 if needed.
      */
     signer: PolymarketSigner;
 }
 /**
- * Mutation hook for creating a Polymarket limit order.
+ * Mutation hook for creating a Polymarket limit order with auto-deposit.
  *
  * Flow:
  * 1. If no L2 credentials exist, triggers L1 → L2 authentication automatically.
- * 2. Builds the EIP-712 `Order` typed data and prompts the wallet for a signature.
- * 3. Constructs HMAC L2 auth headers from the stored credentials.
- * 4. Submits the signed order via `POST /api/v1/orders/polymarket` (prediction-server proxy).
- * 5. Invalidates `orders` and `positions` queries on success.
+ * 2. **Auto-deposit** (when `signer.signTransaction` is provided):
+ *    - Calls `/deposit/polymarket/build` to check Safe USDC.e balance.
+ *    - If shortfall > 0, signs and submits approve + swap transactions.
+ *    - Polls until the swap is confirmed on-chain.
+ * 3. Builds the EIP-712 `Order` typed data and prompts the wallet for a signature.
+ * 4. Constructs HMAC L2 auth headers from the stored credentials.
+ * 5. Submits the signed order via `POST /api/v1/orders/polymarket`.
+ * 6. Invalidates `orders` and `positions` queries on success.
  *
  * @example
  * ```tsx
  * const { mutateAsync: createOrder, isPending } = useCreatePolymarketOrder();
  *
  * await createOrder({
- *   signer: myPolymarketSigner,
+ *   signer: {
+ *     address: walletAddress,
+ *     signatureType: 2,
+ *     signTypedData: async (domain, types, value) => { ... },
+ *     signTransaction: async (txParams) => { ... }, // enables auto-deposit
+ *   },
  *   input: {
  *     tokenId: "123456789",
  *     price: 0.55,
@@ -627,10 +775,11 @@ interface CreatePolymarketOrderVariables {
  *     side: "BUY",
  *     tickSize: "0.01",
  *     negRisk: false,
+ *     funderAddress: safeAddress,
  *   },
  * });
  * ```
  */
 declare function useCreatePolymarketOrder(mutationOptions?: Omit<UseMutationOptions<PredictOrder, Error, CreatePolymarketOrderVariables>, "mutationFn">): _tanstack_react_query.UseMutationResult<PredictOrder, Error, CreatePolymarketOrderVariables, unknown>;
 
-export { BalanceResponse, CancelOrderResult, type CancelOrderVariables, Candlestick, ChartRange, type ChartRangeType, CreateOrderInput, type CreatePolymarketOrderVariables, DFlowKYCStatus, DFlowQuoteRequest, DFlowQuoteResponse, DFlowSubmitRequest, DFlowSubmitResponse, EventStatus, ListCandlesticksParams, ListEventsParams, ListMarketTradesParams, ListOrdersParams, ListTradesParams, type MarketHistoryPoint, type MarketHistorySeries, MatchGroup, MatchGroupPage, MatchesParams, Orderbook, PolymarketContext, type PolymarketContextValue, type PolymarketCredentials, PolymarketProvider, type PolymarketProviderProps, type PolymarketSigner, PositionsResponse, PredictClient, PredictContext, type PredictContextValue, PredictEvent, PredictMarket, PredictOrder, PredictPage, PredictProvider, type PredictProviderProps, PredictTrade, PredictWsClient, PriceHistoryRange, PriceHistoryResponse, ProviderSource, SimilarEventsParams, type UseBalanceParams, type UseCandlesticksParams, type UseEventParams, type UseInfiniteMatchesParams, type UseInfiniteOrdersParams, type UseInfiniteTradesParams, type UseMarketHistoryResult, type UseMarketParams, type UseMarketTradesParams, type UseOrderParams, type UseOrderbookParams, type UseOrderbookSubscriptionParams, type UseOrderbookSubscriptionResult, type UsePositionsParams, type UsePredictWsClientResult, type UsePriceHistoryParams, type UsePricesSubscriptionParams, type UsePricesSubscriptionResult, type UseRealtimeOrderbookParams, type UseRealtimePricesParams, type UseRealtimeTradesParams, type UseRealtimeTradesResult, type UseSearchEventsParams, type UseSimilarEventsParams, type UseTradesSubscriptionParams, type UseTradesSubscriptionResult, WsConnectionStatus, WsDataMessage, WsOrderbookEvent, WsPriceEvent, WsTradeEvent, balanceQueryKey, candlesticksQueryKey, dflowKYCQueryKey, dflowQuoteQueryKey, eventsQueryKey, fetchEvents, infiniteOrdersQueryKey, infiniteTradesQueryKey, marketTradesQueryKey, orderQueryKey, orderbookQueryKey, ordersQueryKey, positionsQueryKey, priceHistoryQueryKey, similarEventsQueryKey, tradesQueryKey, useBalance, useCancelOrder, useCandlesticks, useCreatePolymarketOrder, useDFlowKYC, useDFlowQuote, useDFlowSubmit, useEvent, useEvents, useInfiniteEvents, useInfiniteMatches, useInfiniteOrders, useInfiniteTrades, useMarket, useMarketHistory, useMarketTrades, useMatch, useOrder, useOrderbook, useOrderbookSubscription, useOrders, usePolymarket, usePositions, usePredictClient, usePredictWsClient, usePriceHistory, usePricesSubscription, useRealtimeOrderbook, useRealtimePrices, useRealtimeTrades, useSearchEvents, useSimilarEvents, useTrades, useTradesSubscription };
+export { BalanceResponse, CancelOrderResult, type CancelOrderVariables, Candlestick, ChartRange, type ChartRangeType, CreateOrderInput, type CreatePolymarketOrderVariables, DFlowKYCStatus, DFlowQuoteRequest, DFlowQuoteResponse, DFlowSubmitRequest, DFlowSubmitResponse, EventStatus, ListCandlesticksParams, ListEventsParams, ListMarketTradesParams, ListOrdersParams, ListTradesParams, type MarketHistoryPoint, type MarketHistorySeries, MatchGroup, MatchGroupPage, MatchMarketPage, MatchMarketParams, MatchesParams, Orderbook, PolymarketContext, type PolymarketContextValue, type PolymarketCredentials, PolymarketDepositAddresses, type PolymarketDepositResult, type PolymarketDepositVariables, PolymarketProvider, type PolymarketProviderProps, type PolymarketSigner, PolymarketWithdrawRequest, PolymarketWithdrawResponse, PositionsResponse, PredictClient, PredictContext, type PredictContextValue, PredictEvent, PredictMarket, PredictOrder, PredictPage, PredictProvider, type PredictProviderProps, PredictTrade, PredictWsClient, PriceHistoryRange, PriceHistoryResponse, ProviderSource, SimilarEventsParams, type UseBalanceParams, type UseCandlesticksParams, type UseEventParams, type UseInfiniteMatchMarketsParams, type UseInfiniteMatchesParams, type UseInfiniteOrdersOptions, type UseInfiniteOrdersParams, type UseInfiniteTradesParams, type UseMarketHistoryResult, type UseMarketParams, type UseMarketTradesParams, type UseOrderParams, type UseOrderbookParams, type UseOrderbookSubscriptionParams, type UseOrderbookSubscriptionResult, type UseOrdersOptions, type UsePositionsMultiParams, type UsePositionsParams, type UsePredictWsClientResult, type UsePriceHistoryParams, type UsePricesSubscriptionParams, type UsePricesSubscriptionResult, type UseRealtimeOrderbookParams, type UseRealtimePricesParams, type UseRealtimeTradesParams, type UseRealtimeTradesResult, type UseSearchEventsParams, type UseSimilarEventsParams, type UseTradesSubscriptionParams, type UseTradesSubscriptionResult, type UseWithdrawStatusQueryParams, WithdrawBuildRequest, WithdrawBuildResponse, WithdrawStatusResponse, WithdrawSubmitRequest, WithdrawSubmitResponse, WsConnectionStatus, WsDataMessage, WsOrderbookEvent, WsPriceEvent, WsTradeEvent, balanceQueryKey, candlesticksQueryKey, dflowKYCQueryKey, dflowQuoteQueryKey, eventsQueryKey, fetchEvents, infiniteOrdersQueryKey, infiniteTradesQueryKey, marketTradesQueryKey, orderQueryKey, orderbookQueryKey, ordersQueryKey, polymarketDepositAddressesQueryKey, polymarketSetupQueryKey, positionsMultiQueryKey, positionsQueryKey, priceHistoryQueryKey, similarEventsQueryKey, tradesQueryKey, useBalance, useCancelOrder, useCandlesticks, useCreatePolymarketOrder, useDFlowKYC, useDFlowQuote, useDFlowSubmit, useEvent, useEvents, useInfiniteEvents, useInfiniteMatchMarkets, useInfiniteMatches, useInfiniteOrders, useInfiniteTrades, useMarket, useMarketHistory, useMarketTrades, useMatch, useOrder, useOrderbook, useOrderbookSubscription, useOrders, usePolymarket, usePolymarketDeposit, usePolymarketDepositAddresses, usePolymarketSetup, usePolymarketWithdraw, usePositions, usePositionsMulti, usePredictClient, usePredictWsClient, usePriceHistory, usePricesSubscription, useRealtimeOrderbook, useRealtimePrices, useRealtimeTrades, useRunPolymarketSetup, useSearchEvents, useSimilarEvents, useTrades, useTradesSubscription, useWithdrawBuildMutation, useWithdrawStatusQuery, useWithdrawSubmitMutation, withdrawStatusQueryKey };