@liberfi.io/react 0.3.12 → 0.3.14

package/README.md

@@ -33,12 +33,12 @@ The consumer must provide:
 
 Provides the Dex client instances and configuration to all descendant hooks.
 
-| Prop              | Type                   | Default     | Description                             |
-| ----------------- | ---------------------- | ----------- | --------------------------------------- |
-| `client`          | `API.IClient`          | (required)  | REST/HTTP client instance.              |
-| `subscribeClient` | `API.ISubscribeClient` | (required)  | WebSocket subscription client instance. |
-| `queryKeyPrefix`  | `string`               | `"liberfi"` | Prefix for all TanStack Query keys.     |
-| `children`        | `ReactNode`            | (required)  | Child components.                       |
+| Prop              | Type               | Default     | Description                             |
+| ----------------- | ------------------ | ----------- | --------------------------------------- |
+| `client`          | `IClient`          | (required)  | REST/HTTP client instance.              |
+| `subscribeClient` | `ISubscribeClient` | (required)  | WebSocket subscription client instance. |
+| `queryKeyPrefix`  | `string`           | `"liberfi"` | Prefix for all TanStack Query keys.     |
+| `children`        | `ReactNode`        | (required)  | Child components.                       |
 
 ### Hooks — Core
 
@@ -146,12 +146,12 @@ Each subscription hook manages WebSocket lifecycle automatically (subscribe on m
 
 Creates a `useQuery`-based hook, its `queryKey` builder, and a standalone `fetch` function from a single declarative config.
 
-| Config Field     | Type                                                       | Description                                    |
-| ---------------- | ---------------------------------------------------------- | ---------------------------------------------- |
-| `name`           | `string`                                                   | Key name segment (e.g. `"token"`).             |
-| `queryKey`       | `(params: TParams) => string[]`                            | Builds the variable segments of the query key. |
-| `fetch`          | `(client: API.IClient, params: TParams) => Promise<TData>` | Fetches data using the API client.             |
-| `defaultOptions` | `Partial<Omit<UseQueryOptions, "queryKey" \| "queryFn">>`  | Default options merged below caller options.   |
+| Config Field     | Type                                                      | Description                                    |
+| ---------------- | --------------------------------------------------------- | ---------------------------------------------- |
+| `name`           | `string`                                                  | Key name segment (e.g. `"token"`).             |
+| `queryKey`       | `(params: TParams) => string[]`                           | Builds the variable segments of the query key. |
+| `fetch`          | `(client: IClient, params: TParams) => Promise<TData>`    | Fetches data using the API client.             |
+| `defaultOptions` | `Partial<Omit<UseQueryOptions, "queryKey" \| "queryFn">>` | Default options merged below caller options.   |
 
 Returns `{ queryKey, fetch, useQuery }`.
 
@@ -159,11 +159,11 @@ Returns `{ queryKey, fetch, useQuery }`.
 
 Creates a `useInfiniteQuery`-based hook and its `queryKey` builder for cursor-paginated endpoints. `TData` must extend `{ hasNext?: boolean; endCursor?: string }`.
 
-| Config Field | Type                                                                                    | Description                                    |
-| ------------ | --------------------------------------------------------------------------------------- | ---------------------------------------------- |
-| `name`       | `string`                                                                                | Key name segment (e.g. `"walletPortfolios"`).  |
-| `queryKey`   | `(params: TParams) => string[]`                                                         | Builds the variable segments of the query key. |
-| `fetch`      | `(client: API.IClient, params: TParams, cursor: string \| undefined) => Promise<TData>` | Fetches a single page of data.                 |
+| Config Field | Type                                                                                | Description                                    |
+| ------------ | ----------------------------------------------------------------------------------- | ---------------------------------------------- |
+| `name`       | `string`                                                                            | Key name segment (e.g. `"walletPortfolios"`).  |
+| `queryKey`   | `(params: TParams) => string[]`                                                     | Builds the variable segments of the query key. |
+| `fetch`      | `(client: IClient, params: TParams, cursor: string \| undefined) => Promise<TData>` | Fetches a single page of data.                 |
 
 Returns `{ queryKey, useInfiniteQuery }`.
 
@@ -232,7 +232,7 @@ import { useTokenSubscription } from "@liberfi.io/react";
 import { Chain, API } from "@liberfi.io/types";
 
 function LiveTokenPrice({ address }: { address: string }) {
-  const handleUpdate = useCallback((updates: API.TokenSubscribed[]) => {
+  const handleUpdate = useCallback((updates: TokenSubscribed[]) => {
     for (const update of updates) {
       console.log("New price:", update.marketData?.priceInUsd);
     }
@@ -375,6 +375,5 @@ When the environment variables are not set, integration tests are automatically
 
 - Add a standalone `fetch` function to infinite query hooks for API consistency.
 - Add a mutation key to `useSendTxMutation` for cache introspection.
-- Consolidate `version.ts` global side effect into a shared utility.
 - Document subscription deps-stability best practices for consumers.
 - Type `useSubscriptionEffect` deps more strictly (currently `unknown[]`).

package/dist/index.d.mts

@@ -1,19 +1,11 @@
 import * as react from 'react';
 import { PropsWithChildren } from 'react';
 import * as _liberfi_io_types from '@liberfi.io/types';
-import { API, Chain, Token, TokenResolution, TokenCandle, TokenHolder, TokenMarketData, TokenSecurity, TokenStats, Trade, LimitOrder, WalletPnl, WalletPortfolioPnls, WalletPortfolios, Portfolio, PortfolioPnl, Activity } from '@liberfi.io/types';
+import { IClient, ISubscribeClient, GetTokenListOptions, Chain, Token, LatestBlockParams, BlockchainLatestBlock, SearchTokensOptions, SearchTokenCursorList, SendTxParams, SendTxResult, SwapParams, SwapRoute, GetTokenCandlesOptions, TokenResolution, TokenCandle, GetTokenHoldersOptions, CursorList, TokenHolder, TokenMarketData, TokenSecurity, GetTokensByCreatorOptions, TokenStats, TokenHoldersSortBy, GetTradesOptions, Trade, GetWalletLimitOrdersOptions, LimitOrder, WalletPnlResolution, WalletPnl, GetWalletPortfolioPnlsOptions, WalletPortfolioPnls, PositionState, WalletPnlSortBy, WalletPortfolios, Portfolio, PortfolioPnl, GetActivitiesOptions, Activity, TokenSubscribed, WalletPnlSubscribed, PortfolioSubscribed, PortfolioPnlSubscribed } from '@liberfi.io/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseQueryResult, UseInfiniteQueryOptions, InfiniteData, UseInfiniteQueryResult, QueryClient, UseMutationOptions } from '@tanstack/react-query';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
-declare global {
-    interface Window {
-        __LIBERFI_VERSION__?: {
-            [key: string]: string;
-        };
-    }
-}
-
 /**
  * Default prefix prepended to every TanStack Query key produced by hooks in
  * this package. Can be overridden via
@@ -25,10 +17,10 @@ declare const DEFAULT_QUERY_KEY_PREFIX = "liberfi";
  * `useDexClient`.
  */
 interface DexClientContextValue {
-    /** REST / HTTP client implementing `API.IClient`. */
-    client: API.IClient;
-    /** WebSocket subscription client implementing `API.ISubscribeClient`. */
-    subscribeClient: API.ISubscribeClient;
+    /** REST / HTTP client implementing `IClient`. */
+    client: IClient;
+    /** WebSocket subscription client implementing `ISubscribeClient`. */
+    subscribeClient: ISubscribeClient;
     /** Prefix used in all query keys produced by hooks. */
     queryKeyPrefix: string;
 }
@@ -51,7 +43,7 @@ interface QueryHookConfig<TParams, TData> {
     /** Builds the variable segments of the query key from `params`. */
     queryKey: (params: TParams) => string[];
     /** Fetches data using the API client. */
-    fetch: (client: API.IClient, params: TParams) => Promise<TData>;
+    fetch: (client: IClient, params: TParams) => Promise<TData>;
     /** Default options merged *below* caller-supplied options. */
     defaultOptions?: Partial<Omit<UseQueryOptions<TData, Error, TData, string[]>, "queryKey" | "queryFn">>;
 }
@@ -67,7 +59,7 @@ interface QueryHookReturn<TParams, TData> {
      */
     queryKey: (params: TParams, prefix?: string) => string[];
     /** Fetches data using the API client (for use outside React). */
-    fetch: (client: API.IClient, params: TParams) => Promise<TData>;
+    fetch: (client: IClient, params: TParams) => Promise<TData>;
     /** React hook that fetches and caches data via TanStack Query. */
     useQuery: (params: TParams, options?: Omit<UseQueryOptions<TData, Error, TData, string[]>, "queryKey" | "queryFn">) => UseQueryResult<TData, Error>;
 }
@@ -87,7 +79,7 @@ interface InfiniteQueryHookConfig<TParams, TData extends CursorPaginatedResult>
     /** Builds the variable segments of the query key from `params`. */
     queryKey: (params: TParams) => string[];
     /** Fetches a single page of data. */
-    fetch: (client: API.IClient, params: TParams, cursor: string | undefined) => Promise<TData>;
+    fetch: (client: IClient, params: TParams, cursor: string | undefined) => Promise<TData>;
 }
 interface InfiniteQueryHookReturn<TParams, TData extends CursorPaginatedResult> {
     /**
@@ -123,19 +115,19 @@ declare function toKeySegment(value: string | number | boolean | Date | undefine
 declare function toSortedKeySegment(value: unknown[] | undefined | null): string;
 
 /** Parameters for {@link useFinalStretchTokensQuery}. */
-interface UseFinalStretchTokensQueryParams extends API.GetTokenListOptions {
+interface UseFinalStretchTokensQueryParams extends GetTokenListOptions {
     chain: Chain;
 }
 declare const finalStretchTokensQueryKey: (params: UseFinalStretchTokensQueryParams, prefix?: string) => string[];
-declare const fetchFinalStretchTokens: (client: API.IClient, params: UseFinalStretchTokensQueryParams) => Promise<Token[]>;
+declare const fetchFinalStretchTokens: (client: _liberfi_io_types.IClient, params: UseFinalStretchTokensQueryParams) => Promise<Token[]>;
 declare const useFinalStretchTokensQuery: (params: UseFinalStretchTokensQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<Token[], Error, Token[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<Token[], Error>;
 
-type UseLatestBlockQueryParams = API.LatestBlockParams;
-declare const latestBlockQueryKey: (params: _liberfi_io_types.LatestBlockParams, prefix?: string) => string[];
-declare const fetchLatestBlock: (client: API.IClient, params: _liberfi_io_types.LatestBlockParams) => Promise<_liberfi_io_types.BlockchainLatestBlock>;
-declare const useLatestBlockQuery: (params: _liberfi_io_types.LatestBlockParams, options?: Omit<_tanstack_react_query.UseQueryOptions<_liberfi_io_types.BlockchainLatestBlock, Error, _liberfi_io_types.BlockchainLatestBlock, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<_liberfi_io_types.BlockchainLatestBlock, Error>;
+type UseLatestBlockQueryParams = LatestBlockParams;
+declare const latestBlockQueryKey: (params: LatestBlockParams, prefix?: string) => string[];
+declare const fetchLatestBlock: (client: _liberfi_io_types.IClient, params: LatestBlockParams) => Promise<BlockchainLatestBlock>;
+declare const useLatestBlockQuery: (params: LatestBlockParams, options?: Omit<_tanstack_react_query.UseQueryOptions<BlockchainLatestBlock, Error, BlockchainLatestBlock, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<BlockchainLatestBlock, Error>;
 interface LatestBlockCacheResult {
-    data?: API.BlockchainLatestBlock;
+    data?: BlockchainLatestBlock;
     dataUpdatedAt: number;
 }
 declare function getCachedLatestBlock(queryClient: QueryClient, params: UseLatestBlockQueryParams, prefix?: string): LatestBlockCacheResult;
@@ -143,19 +135,19 @@ declare function useCachedLatestBlock(params: UseLatestBlockQueryParams): Latest
 declare function useLatestBlockCacheReader(params: UseLatestBlockQueryParams): () => LatestBlockCacheResult;
 
 /** Parameters for {@link useMigratedTokensQuery}. */
-interface UseMigratedTokensQueryParams extends API.GetTokenListOptions {
+interface UseMigratedTokensQueryParams extends GetTokenListOptions {
     chain: Chain;
 }
 declare const migratedTokensQueryKey: (params: UseMigratedTokensQueryParams, prefix?: string) => string[];
-declare const fetchMigratedTokens: (client: API.IClient, params: UseMigratedTokensQueryParams) => Promise<Token[]>;
+declare const fetchMigratedTokens: (client: _liberfi_io_types.IClient, params: UseMigratedTokensQueryParams) => Promise<Token[]>;
 declare const useMigratedTokensQuery: (params: UseMigratedTokensQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<Token[], Error, Token[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<Token[], Error>;
 
 /** Parameters for {@link useNewTokensQuery}. */
-interface UseNewTokensQueryParams extends API.GetTokenListOptions {
+interface UseNewTokensQueryParams extends GetTokenListOptions {
     chain: Chain;
 }
 declare const newTokensQueryKey: (params: UseNewTokensQueryParams, prefix?: string) => string[];
-declare const fetchNewTokens: (client: API.IClient, params: UseNewTokensQueryParams) => Promise<Token[]>;
+declare const fetchNewTokens: (client: _liberfi_io_types.IClient, params: UseNewTokensQueryParams) => Promise<Token[]>;
 declare const useNewTokensQuery: (params: UseNewTokensQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<Token[], Error, Token[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<Token[], Error>;
 
 /**
@@ -165,57 +157,57 @@ declare const useNewTokensQuery: (params: UseNewTokensQueryParams, options?: Omi
  */
 declare function presignedUploadUrlQueryKey(prefix?: string): string[];
 /** Fetches a presigned upload URL (for use outside React). */
-declare function fetchPresignedUploadUrl(client: API.IClient): Promise<string>;
+declare function fetchPresignedUploadUrl(client: IClient): Promise<string>;
 /** Fetches a one-time presigned upload URL. `staleTime` defaults to `0`. */
 declare function usePresignedUploadUrlQuery(options?: Omit<UseQueryOptions<string, Error, string, string[]>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<string, Error>;
 
-type UseSearchTokensQueryParams = API.SearchTokensOptions;
-declare const searchTokensQueryKey: (params: _liberfi_io_types.SearchTokensOptions, prefix?: string) => string[];
-declare const fetchSearchTokens: (client: API.IClient, params: _liberfi_io_types.SearchTokensOptions) => Promise<_liberfi_io_types.SearchTokenCursorList>;
-declare const useSearchTokensQuery: (params: _liberfi_io_types.SearchTokensOptions, options?: Omit<_tanstack_react_query.UseQueryOptions<_liberfi_io_types.SearchTokenCursorList, Error, _liberfi_io_types.SearchTokenCursorList, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<_liberfi_io_types.SearchTokenCursorList, Error>;
+type UseSearchTokensQueryParams = SearchTokensOptions;
+declare const searchTokensQueryKey: (params: SearchTokensOptions, prefix?: string) => string[];
+declare const fetchSearchTokens: (client: _liberfi_io_types.IClient, params: SearchTokensOptions) => Promise<SearchTokenCursorList>;
+declare const useSearchTokensQuery: (params: SearchTokensOptions, options?: Omit<_tanstack_react_query.UseQueryOptions<SearchTokenCursorList, Error, SearchTokenCursorList, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<SearchTokenCursorList, Error>;
 
 /** Parameters for {@link useSearchTokensInfiniteQuery}. */
-type UseSearchTokensInfiniteQueryParams = Omit<API.SearchTokensOptions, "cursor" | "direction">;
+type UseSearchTokensInfiniteQueryParams = Omit<SearchTokensOptions, "cursor" | "direction">;
 declare const searchTokensInfiniteQueryKey: (params: UseSearchTokensInfiniteQueryParams, prefix?: string) => string[];
-declare const useSearchTokensInfiniteQuery: (params: UseSearchTokensInfiniteQueryParams, options?: Omit<_tanstack_react_query.UseInfiniteQueryOptions<_liberfi_io_types.SearchTokenCursorList, Error, _tanstack_react_query.InfiniteData<_liberfi_io_types.SearchTokenCursorList, unknown>, string[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam"> | undefined) => _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<_liberfi_io_types.SearchTokenCursorList, unknown>, Error>;
+declare const useSearchTokensInfiniteQuery: (params: UseSearchTokensInfiniteQueryParams, options?: Omit<_tanstack_react_query.UseInfiniteQueryOptions<SearchTokenCursorList, Error, _tanstack_react_query.InfiniteData<SearchTokenCursorList, unknown>, string[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam"> | undefined) => _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<SearchTokenCursorList, unknown>, Error>;
 
-type UseSendTxMutationParams = API.SendTxParams;
+type UseSendTxMutationParams = SendTxParams;
 /** Sends a transaction via the API client (for use outside React). */
-declare function sendTx(client: API.IClient, params: UseSendTxMutationParams): Promise<_liberfi_io_types.SendTxResult>;
+declare function sendTx(client: IClient, params: UseSendTxMutationParams): Promise<SendTxResult>;
 /** Mutation hook that sends a transaction. */
-declare function useSendTxMutation(options?: Omit<UseMutationOptions<API.SendTxResult, Error, UseSendTxMutationParams>, "mutationFn">): _tanstack_react_query.UseMutationResult<_liberfi_io_types.SendTxResult, Error, _liberfi_io_types.SendTxParams, unknown>;
+declare function useSendTxMutation(options?: Omit<UseMutationOptions<SendTxResult, Error, UseSendTxMutationParams>, "mutationFn">): _tanstack_react_query.UseMutationResult<SendTxResult, Error, SendTxParams, unknown>;
 
 /** Parameters for {@link useStockTokensQuery}. */
-interface UseStockTokensQueryParams extends API.GetTokenListOptions {
+interface UseStockTokensQueryParams extends GetTokenListOptions {
     chain: Chain;
 }
 declare const stockTokensQueryKey: (params: UseStockTokensQueryParams, prefix?: string) => string[];
-declare const fetchStockTokens: (client: API.IClient, params: UseStockTokensQueryParams) => Promise<Token[]>;
+declare const fetchStockTokens: (client: _liberfi_io_types.IClient, params: UseStockTokensQueryParams) => Promise<Token[]>;
 declare const useStockTokensQuery: (params: UseStockTokensQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<Token[], Error, Token[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<Token[], Error>;
 
-type UseSwapRouteQueryParams = API.SwapParams;
-declare const swapRouteQueryKey: (params: _liberfi_io_types.SwapParams, prefix?: string) => string[];
-declare const fetchSwapRoute: (client: API.IClient, params: _liberfi_io_types.SwapParams) => Promise<_liberfi_io_types.SwapRoute>;
-declare const useSwapRouteQuery: (params: _liberfi_io_types.SwapParams, options?: Omit<_tanstack_react_query.UseQueryOptions<_liberfi_io_types.SwapRoute, Error, _liberfi_io_types.SwapRoute, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<_liberfi_io_types.SwapRoute, Error>;
+type UseSwapRouteQueryParams = SwapParams;
+declare const swapRouteQueryKey: (params: SwapParams, prefix?: string) => string[];
+declare const fetchSwapRoute: (client: _liberfi_io_types.IClient, params: SwapParams) => Promise<SwapRoute>;
+declare const useSwapRouteQuery: (params: SwapParams, options?: Omit<_tanstack_react_query.UseQueryOptions<SwapRoute, Error, SwapRoute, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<SwapRoute, Error>;
 
 /** Parameters for {@link useTokenCandlesQuery}. */
-interface UseTokenCandlesQueryParams extends API.GetTokenCandlesOptions {
+interface UseTokenCandlesQueryParams extends GetTokenCandlesOptions {
     chain: Chain;
     address: string;
     resolution: TokenResolution;
 }
 declare const tokenCandlesQueryKey: (params: UseTokenCandlesQueryParams, prefix?: string) => string[];
-declare const fetchTokenCandles: (client: API.IClient, params: UseTokenCandlesQueryParams) => Promise<TokenCandle[]>;
+declare const fetchTokenCandles: (client: _liberfi_io_types.IClient, params: UseTokenCandlesQueryParams) => Promise<TokenCandle[]>;
 declare const useTokenCandlesQuery: (params: UseTokenCandlesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<TokenCandle[], Error, TokenCandle[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<TokenCandle[], Error>;
 
 /** Parameters for {@link useTokenHoldersQuery}. */
-interface UseTokenHoldersQueryParams extends API.GetTokenHoldersOptions {
+interface UseTokenHoldersQueryParams extends GetTokenHoldersOptions {
     chain: Chain;
     address: string;
 }
 declare const tokenHoldersQueryKey: (params: UseTokenHoldersQueryParams, prefix?: string) => string[];
-declare const fetchTokenHolders: (client: API.IClient, params: UseTokenHoldersQueryParams) => Promise<API.CursorList<TokenHolder>>;
-declare const useTokenHoldersQuery: (params: UseTokenHoldersQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<TokenHolder>, Error, API.CursorList<TokenHolder>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<TokenHolder>, Error>;
+declare const fetchTokenHolders: (client: _liberfi_io_types.IClient, params: UseTokenHoldersQueryParams) => Promise<CursorList<TokenHolder>>;
+declare const useTokenHoldersQuery: (params: UseTokenHoldersQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<TokenHolder>, Error, CursorList<TokenHolder>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<TokenHolder>, Error>;
 
 /** Parameters for {@link useTokenMarketDataQuery}. */
 interface UseTokenMarketDataQueryParams {
@@ -254,7 +246,7 @@ declare const fetchTokens: (client: _liberfi_io_types.IClient, params: UseTokens
 declare const useTokensQuery: (params: UseTokensQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<Token[], Error, Token[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<Token[], Error>;
 
 /** Parameters for {@link useTokensByCreatorQuery}. */
-interface UseTokensByCreatorQueryParams extends API.GetTokensByCreatorOptions {
+interface UseTokensByCreatorQueryParams extends GetTokensByCreatorOptions {
     chain: Chain;
     creator: string;
 }
@@ -267,8 +259,8 @@ interface UseTokensByCreatorQueryParams extends API.GetTokensByCreatorOptions {
  * `isNotImplementedError` to render an empty state.
  */
 declare const tokensByCreatorQueryKey: (params: UseTokensByCreatorQueryParams, prefix?: string) => string[];
-declare const fetchTokensByCreator: (client: API.IClient, params: UseTokensByCreatorQueryParams) => Promise<API.CursorList<Token>>;
-declare const useTokensByCreatorQuery: (params: UseTokensByCreatorQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<Token>, Error, API.CursorList<Token>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<Token>, Error>;
+declare const fetchTokensByCreator: (client: _liberfi_io_types.IClient, params: UseTokensByCreatorQueryParams) => Promise<CursorList<Token>>;
+declare const useTokensByCreatorQuery: (params: UseTokensByCreatorQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<Token>, Error, CursorList<Token>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<Token>, Error>;
 
 /** Parameters for {@link useTokenStatsQuery}. */
 interface UseTokenStatsQueryParams {
@@ -280,7 +272,7 @@ declare const fetchTokenStats: (client: _liberfi_io_types.IClient, params: UseTo
 declare const useTokenStatsQuery: (params: UseTokenStatsQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<TokenStats, Error, TokenStats, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<TokenStats, Error>;
 
 /** Parameters for {@link useTokenTopTradersQuery}. */
-interface UseTokenTopTradersQueryParams extends Omit<API.GetTokenHoldersOptions, "sortBy"> {
+interface UseTokenTopTradersQueryParams extends Omit<GetTokenHoldersOptions, "sortBy"> {
     chain: Chain;
     address: string;
     /**
@@ -289,7 +281,7 @@ interface UseTokenTopTradersQueryParams extends Omit<API.GetTokenHoldersOptions,
      * backend has not yet enabled realized-PnL sorting on the holders
      * endpoint.
      */
-    sortBy?: API.TokenHoldersSortBy;
+    sortBy?: TokenHoldersSortBy;
 }
 /**
  * Fetch the "Top Traders" list for a token.
@@ -301,25 +293,25 @@ interface UseTokenTopTradersQueryParams extends Omit<API.GetTokenHoldersOptions,
  * clear semantic name.
  */
 declare const tokenTopTradersQueryKey: (params: UseTokenTopTradersQueryParams, prefix?: string) => string[];
-declare const fetchTokenTopTraders: (client: API.IClient, params: UseTokenTopTradersQueryParams) => Promise<API.CursorList<TokenHolder>>;
-declare const useTokenTopTradersQuery: (params: UseTokenTopTradersQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<TokenHolder>, Error, API.CursorList<TokenHolder>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<TokenHolder>, Error>;
+declare const fetchTokenTopTraders: (client: _liberfi_io_types.IClient, params: UseTokenTopTradersQueryParams) => Promise<CursorList<TokenHolder>>;
+declare const useTokenTopTradersQuery: (params: UseTokenTopTradersQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<TokenHolder>, Error, CursorList<TokenHolder>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<TokenHolder>, Error>;
 
 /** Parameters for {@link useTokenTradesQuery}. */
-interface UseTokenTradesQueryParams extends API.GetTradesOptions {
+interface UseTokenTradesQueryParams extends GetTradesOptions {
     chain: Chain;
     address: string;
 }
 declare const tokenTradesQueryKey: (params: UseTokenTradesQueryParams, prefix?: string) => string[];
-declare const fetchTokenTrades: (client: API.IClient, params: UseTokenTradesQueryParams) => Promise<API.CursorList<Trade>>;
-declare const useTokenTradesQuery: (params: UseTokenTradesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<Trade>, Error, API.CursorList<Trade>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<Trade>, Error>;
+declare const fetchTokenTrades: (client: _liberfi_io_types.IClient, params: UseTokenTradesQueryParams) => Promise<CursorList<Trade>>;
+declare const useTokenTradesQuery: (params: UseTokenTradesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<Trade>, Error, CursorList<Trade>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<Trade>, Error>;
 
 /** Parameters for {@link useTrendingTokensQuery}. */
-interface UseTrendingTokensQueryParams extends API.GetTokenListOptions {
+interface UseTrendingTokensQueryParams extends GetTokenListOptions {
     chain: Chain;
     resolution: "1m" | "5m" | "1h" | "4h" | "24h";
 }
 declare const trendingTokensQueryKey: (params: UseTrendingTokensQueryParams, prefix?: string) => string[];
-declare const fetchTrendingTokens: (client: API.IClient, params: UseTrendingTokensQueryParams) => Promise<Token[]>;
+declare const fetchTrendingTokens: (client: _liberfi_io_types.IClient, params: UseTrendingTokensQueryParams) => Promise<Token[]>;
 declare const useTrendingTokensQuery: (params: UseTrendingTokensQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<Token[], Error, Token[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<Token[], Error>;
 
 /** Parameters for {@link useTxSuccessQuery}. */
@@ -333,7 +325,7 @@ declare const fetchTxSuccess: (client: _liberfi_io_types.IClient, params: UseTxS
 declare const useTxSuccessQuery: (params: UseTxSuccessQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<boolean, Error, boolean, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<boolean, Error>;
 
 /** Parameters for {@link useWalletLimitOrdersQuery}. */
-interface UseWalletLimitOrdersQueryParams extends API.GetWalletLimitOrdersOptions {
+interface UseWalletLimitOrdersQueryParams extends GetWalletLimitOrdersOptions {
     chain: Chain;
     address: string;
 }
@@ -346,26 +338,26 @@ interface UseWalletLimitOrdersQueryParams extends API.GetWalletLimitOrdersOption
  * `isNotImplementedError` to render an "Orders coming soon" empty state.
  */
 declare const walletLimitOrdersQueryKey: (params: UseWalletLimitOrdersQueryParams, prefix?: string) => string[];
-declare const fetchWalletLimitOrders: (client: API.IClient, params: UseWalletLimitOrdersQueryParams) => Promise<API.CursorList<LimitOrder>>;
-declare const useWalletLimitOrdersQuery: (params: UseWalletLimitOrdersQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<LimitOrder>, Error, API.CursorList<LimitOrder>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<LimitOrder>, Error>;
+declare const fetchWalletLimitOrders: (client: _liberfi_io_types.IClient, params: UseWalletLimitOrdersQueryParams) => Promise<CursorList<LimitOrder>>;
+declare const useWalletLimitOrdersQuery: (params: UseWalletLimitOrdersQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<LimitOrder>, Error, CursorList<LimitOrder>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<LimitOrder>, Error>;
 
 /** Parameters for {@link useWalletPnlQuery}. */
 interface UseWalletPnlQueryParams {
     chain: Chain;
     address: string;
-    resolution?: string;
+    resolution?: WalletPnlResolution;
 }
 declare const walletPnlQueryKey: (params: UseWalletPnlQueryParams, prefix?: string) => string[];
 declare const fetchWalletPnl: (client: _liberfi_io_types.IClient, params: UseWalletPnlQueryParams) => Promise<WalletPnl>;
 declare const useWalletPnlQuery: (params: UseWalletPnlQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<WalletPnl, Error, WalletPnl, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<WalletPnl, Error>;
 
 /** Parameters for {@link useWalletPortfolioPnlsQuery}. */
-interface UseWalletPortfolioPnlsQueryParams extends API.GetWalletPortfolioPnlsOptions {
+interface UseWalletPortfolioPnlsQueryParams extends GetWalletPortfolioPnlsOptions {
     chain: Chain;
     address: string;
 }
 declare const walletPortfolioPnlsQueryKey: (params: UseWalletPortfolioPnlsQueryParams, prefix?: string) => string[];
-declare const fetchWalletPortfolioPnls: (client: API.IClient, params: UseWalletPortfolioPnlsQueryParams) => Promise<WalletPortfolioPnls>;
+declare const fetchWalletPortfolioPnls: (client: _liberfi_io_types.IClient, params: UseWalletPortfolioPnlsQueryParams) => Promise<WalletPortfolioPnls>;
 declare const useWalletPortfolioPnlsQuery: (params: UseWalletPortfolioPnlsQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<WalletPortfolioPnls, Error, WalletPortfolioPnls, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<WalletPortfolioPnls, Error>;
 
 /** Parameters for {@link useWalletPortfolioPnlsInfiniteQuery}. */
@@ -374,11 +366,11 @@ interface UseWalletPortfolioPnlsInfiniteQueryParams {
     address: string;
     limit?: number;
     /** Phase 3 statistics window (default 30d). */
-    resolution?: API.WalletPnlResolution;
+    resolution?: WalletPnlResolution;
     /** Phase 3 position-state filter. */
-    positionState?: API.PositionState;
+    positionState?: PositionState;
     /** Phase 3 sort field. */
-    sortBy?: API.WalletPnlSortBy;
+    sortBy?: WalletPnlSortBy;
 }
 declare const walletPortfolioPnlsInfiniteQueryKey: (params: UseWalletPortfolioPnlsInfiniteQueryParams, prefix?: string) => string[];
 declare const useWalletPortfolioPnlsInfiniteQuery: (params: UseWalletPortfolioPnlsInfiniteQueryParams, options?: Omit<_tanstack_react_query.UseInfiniteQueryOptions<WalletPortfolioPnls, Error, _tanstack_react_query.InfiniteData<WalletPortfolioPnls, unknown>, string[], string | undefined>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam"> | undefined) => _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<WalletPortfolioPnls, unknown>, Error>;
@@ -424,11 +416,11 @@ declare const fetchWalletPortfolioPnlsByTokens: (client: _liberfi_io_types.IClie
 declare const useWalletPortfolioPnlsByTokensQuery: (params: UseWalletPortfolioPnlsByTokensQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<PortfolioPnl[], Error, PortfolioPnl[], string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<PortfolioPnl[], Error>;
 
 /** Parameters for {@link useWalletTokenPositionsQuery}. */
-interface UseWalletTokenPositionsQueryParams extends Omit<API.GetWalletPortfolioPnlsOptions, "positionState"> {
+interface UseWalletTokenPositionsQueryParams extends Omit<GetWalletPortfolioPnlsOptions, "positionState"> {
     chain: Chain;
     address: string;
     /** Position state filter. Defaults to `open`. Pass `all` or `closed` as needed. */
-    positionState?: API.PositionState;
+    positionState?: PositionState;
 }
 /**
  * A wallet's token positions (the "Positions" tab).
@@ -443,38 +435,38 @@ interface UseWalletTokenPositionsQueryParams extends Omit<API.GetWalletPortfolio
  * to the Positions view (`Bought / Sold / Remaining / PnL`).
  */
 declare const walletTokenPositionsQueryKey: (params: UseWalletTokenPositionsQueryParams, prefix?: string) => string[];
-declare const fetchWalletTokenPositions: (client: API.IClient, params: UseWalletTokenPositionsQueryParams) => Promise<WalletPortfolioPnls>;
+declare const fetchWalletTokenPositions: (client: _liberfi_io_types.IClient, params: UseWalletTokenPositionsQueryParams) => Promise<WalletPortfolioPnls>;
 declare const useWalletTokenPositionsQuery: (params: UseWalletTokenPositionsQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<WalletPortfolioPnls, Error, WalletPortfolioPnls, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<WalletPortfolioPnls, Error>;
 
 /** Alias for consumers that only want the rows (not the wallet-level summary). */
 type WalletTokenPosition = PortfolioPnl;
 
 /** Parameters for {@link useWalletTradesQuery}. */
-interface UseWalletTradesQueryParams extends API.GetTradesOptions {
+interface UseWalletTradesQueryParams extends GetTradesOptions {
     chain: Chain;
     address: string;
 }
 declare const walletTradesQueryKey: (params: UseWalletTradesQueryParams, prefix?: string) => string[];
-declare const fetchWalletTrades: (client: API.IClient, params: UseWalletTradesQueryParams) => Promise<API.CursorList<Trade>>;
-declare const useWalletTradesQuery: (params: UseWalletTradesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<Trade>, Error, API.CursorList<Trade>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<Trade>, Error>;
+declare const fetchWalletTrades: (client: _liberfi_io_types.IClient, params: UseWalletTradesQueryParams) => Promise<CursorList<Trade>>;
+declare const useWalletTradesQuery: (params: UseWalletTradesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<Trade>, Error, CursorList<Trade>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<Trade>, Error>;
 
 /** Parameters for {@link useTokenActivitiesQuery}. */
-interface UseTokenActivitiesQueryParams extends API.GetActivitiesOptions {
+interface UseTokenActivitiesQueryParams extends GetActivitiesOptions {
     chain: Chain;
     address: string;
 }
 declare const tokenActivitiesQueryKey: (params: UseTokenActivitiesQueryParams, prefix?: string) => string[];
-declare const fetchTokenActivities: (client: API.IClient, params: UseTokenActivitiesQueryParams) => Promise<API.CursorList<Activity>>;
-declare const useTokenActivitiesQuery: (params: UseTokenActivitiesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<Activity>, Error, API.CursorList<Activity>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<Activity>, Error>;
+declare const fetchTokenActivities: (client: _liberfi_io_types.IClient, params: UseTokenActivitiesQueryParams) => Promise<CursorList<Activity>>;
+declare const useTokenActivitiesQuery: (params: UseTokenActivitiesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<Activity>, Error, CursorList<Activity>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<Activity>, Error>;
 
 /** Parameters for {@link useWalletActivitiesQuery}. */
-interface UseWalletActivitiesQueryParams extends API.GetActivitiesOptions {
+interface UseWalletActivitiesQueryParams extends GetActivitiesOptions {
     chain: Chain;
     address: string;
 }
 declare const walletActivitiesQueryKey: (params: UseWalletActivitiesQueryParams, prefix?: string) => string[];
-declare const fetchWalletActivities: (client: API.IClient, params: UseWalletActivitiesQueryParams) => Promise<API.CursorList<Activity>>;
-declare const useWalletActivitiesQuery: (params: UseWalletActivitiesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<API.CursorList<Activity>, Error, API.CursorList<Activity>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<API.CursorList<Activity>, Error>;
+declare const fetchWalletActivities: (client: _liberfi_io_types.IClient, params: UseWalletActivitiesQueryParams) => Promise<CursorList<Activity>>;
+declare const useWalletActivitiesQuery: (params: UseWalletActivitiesQueryParams, options?: Omit<_tanstack_react_query.UseQueryOptions<CursorList<Activity>, Error, CursorList<Activity>, string[]>, "queryKey" | "queryFn"> | undefined) => _tanstack_react_query.UseQueryResult<CursorList<Activity>, Error>;
 
 /** Parameters for {@link useTokenSubscription}. */
 interface UseTokenSubscriptionParams {
@@ -482,7 +474,7 @@ interface UseTokenSubscriptionParams {
     address: string;
 }
 /** Subscribes to real-time updates for a single token. */
-declare function useTokenSubscription(params: UseTokenSubscriptionParams, callback: (data: Array<API.TokenSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useTokenSubscription(params: UseTokenSubscriptionParams, callback: (data: Array<TokenSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useTokenCandlesSubscription}. */
 interface UseTokenCandlesSubscriptionParams {
@@ -507,7 +499,7 @@ interface UseWalletPnlSubscriptionParams {
     address: string;
 }
 /** Subscribes to real-time wallet PnL updates. */
-declare function useWalletPnlSubscription(params: UseWalletPnlSubscriptionParams, callback: (pnls: Array<API.WalletPnlSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useWalletPnlSubscription(params: UseWalletPnlSubscriptionParams, callback: (pnls: Array<WalletPnlSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useWalletPortfoliosSubscription}. */
 interface UseWalletPortfoliosSubscriptionParams {
@@ -515,7 +507,7 @@ interface UseWalletPortfoliosSubscriptionParams {
     address: string;
 }
 /** Subscribes to real-time wallet portfolio updates. */
-declare function useWalletPortfoliosSubscription(params: UseWalletPortfoliosSubscriptionParams, callback: (portfolios: Array<API.PortfolioSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useWalletPortfoliosSubscription(params: UseWalletPortfoliosSubscriptionParams, callback: (portfolios: Array<PortfolioSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useWalletPortfolioPnlsSubscription}. */
 interface UseWalletPortfolioPnlsSubscriptionParams {
@@ -523,7 +515,7 @@ interface UseWalletPortfolioPnlsSubscriptionParams {
     address: string;
 }
 /** Subscribes to real-time wallet portfolio PnL updates. */
-declare function useWalletPortfolioPnlsSubscription(params: UseWalletPortfolioPnlsSubscriptionParams, callback: (portfolioPnls: Array<API.PortfolioPnlSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useWalletPortfolioPnlsSubscription(params: UseWalletPortfolioPnlsSubscriptionParams, callback: (portfolioPnls: Array<PortfolioPnlSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useWalletTradesSubscription}. */
 interface UseWalletTradesSubscriptionParams {
@@ -554,39 +546,39 @@ interface UseNewTokensSubscriptionParams {
     chain: Chain;
 }
 /** Subscribes to real-time new token listings. */
-declare function useNewTokensSubscription(params: UseNewTokensSubscriptionParams, callback: (tokens: Array<API.TokenSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useNewTokensSubscription(params: UseNewTokensSubscriptionParams, callback: (tokens: Array<TokenSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useTrendingTokensSubscription}. */
 interface UseTrendingTokensSubscriptionParams {
     chain: Chain;
 }
 /** Subscribes to real-time trending token updates. */
-declare function useTrendingTokensSubscription(params: UseTrendingTokensSubscriptionParams, callback: (data: Array<API.TokenSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useTrendingTokensSubscription(params: UseTrendingTokensSubscriptionParams, callback: (data: Array<TokenSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useMigratedTokensSubscription}. */
 interface UseMigratedTokensSubscriptionParams {
     chain: Chain;
 }
 /** Subscribes to real-time migrated token updates. */
-declare function useMigratedTokensSubscription(params: UseMigratedTokensSubscriptionParams, callback: (data: Array<API.TokenSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useMigratedTokensSubscription(params: UseMigratedTokensSubscriptionParams, callback: (data: Array<TokenSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useFinalStretchTokensSubscription}. */
 interface UseFinalStretchTokensSubscriptionParams {
     chain: Chain;
 }
 /** Subscribes to real-time final-stretch token updates. */
-declare function useFinalStretchTokensSubscription(params: UseFinalStretchTokensSubscriptionParams, callback: (data: Array<API.TokenSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useFinalStretchTokensSubscription(params: UseFinalStretchTokensSubscriptionParams, callback: (data: Array<TokenSubscribed>) => void, options?: SubscriptionOptions): void;
 
 /** Parameters for {@link useStockTokensSubscription}. */
 interface UseStockTokensSubscriptionParams {
     chain: Chain;
 }
 /** Subscribes to real-time stock token updates. */
-declare function useStockTokensSubscription(params: UseStockTokensSubscriptionParams, callback: (data: Array<API.TokenSubscribed>) => void, options?: SubscriptionOptions): void;
+declare function useStockTokensSubscription(params: UseStockTokensSubscriptionParams, callback: (data: Array<TokenSubscribed>) => void, options?: SubscriptionOptions): void;
 
 type DexClientProviderProps = PropsWithChildren<{
-    client: API.IClient;
-    subscribeClient: API.ISubscribeClient;
+    client: IClient;
+    subscribeClient: ISubscribeClient;
     /**
      * Prefix prepended to every TanStack Query key produced by hooks in this
      * package. Useful for avoiding collisions with other libraries.