@limitless-exchange/sdk 1.0.2 → 1.0.4

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AxiosRequestConfig } from 'axios';
+import { AxiosRequestConfig, RawAxiosResponseHeaders, AxiosResponseHeaders } from 'axios';
 import { ethers } from 'ethers';
 
 /**
@@ -167,63 +167,113 @@ interface UserData {
 }
 
 /**
- * Logger interface for SDK integration.
- * Allows users to inject their own logging implementation.
- *
+ * API token, HMAC auth, and partner capability types.
  * @public
  */
-interface ILogger {
-    /**
-     * Log debug information (verbose, development only)
-     */
-    debug(message: string, meta?: Record<string, any>): void;
-    /**
-     * Log informational messages
-     */
-    info(message: string, meta?: Record<string, any>): void;
-    /**
-     * Log warning messages
-     */
-    warn(message: string, meta?: Record<string, any>): void;
-    /**
-     * Log error messages
-     */
-    error(message: string, error?: Error, meta?: Record<string, any>): void;
+/**
+ * HMAC credentials for scoped API-token authentication.
+ * @public
+ */
+interface HMACCredentials {
+    tokenId: string;
+    secret: string;
 }
 /**
- * No-op logger (default) - does nothing.
- * Zero performance overhead when logging is not needed.
- *
- * @internal
+ * Profile reference embedded in API-token responses.
+ * @public
  */
-declare class NoOpLogger implements ILogger {
-    debug(): void;
-    info(): void;
-    warn(): void;
-    error(): void;
+interface ApiTokenProfile {
+    id: number;
+    account: string;
 }
 /**
- * Simple console logger for development.
- * Can be used as a starting point or for debugging.
- *
- * @example
- * ```typescript
- * import { ConsoleLogger } from '@limitless-exchange/sdk';
- *
- * const logger = new ConsoleLogger('debug');
- * const authenticator = new Authenticator(httpClient, signer, logger);
- * ```
- *
+ * Request payload for self-service token derivation.
+ * `label` is token metadata only and does not affect any profile display name.
  * @public
  */
-declare class ConsoleLogger implements ILogger {
-    private level;
-    constructor(level?: 'debug' | 'info' | 'warn' | 'error');
-    private shouldLog;
-    debug(message: string, meta?: Record<string, any>): void;
-    info(message: string, meta?: Record<string, any>): void;
-    warn(message: string, meta?: Record<string, any>): void;
-    error(message: string, error?: Error, meta?: Record<string, any>): void;
+interface DeriveApiTokenInput {
+    label?: string;
+    scopes?: string[];
+}
+/**
+ * One-time token derivation response.
+ * @public
+ */
+interface DeriveApiTokenResponse {
+    apiKey: string;
+    secret: string;
+    tokenId: string;
+    createdAt: string;
+    scopes: string[];
+    profile: ApiTokenProfile;
+}
+/**
+ * Active token list item.
+ * @public
+ */
+interface ApiToken {
+    tokenId: string;
+    label: string | null;
+    scopes: string[];
+    createdAt: string;
+    lastUsedAt: string | null;
+}
+/**
+ * Partner self-service capability config.
+ * @public
+ */
+interface PartnerCapabilities {
+    partnerProfileId: number;
+    tokenManagementEnabled: boolean;
+    allowedScopes: string[];
+}
+/**
+ * Update partner capabilities request.
+ * @public
+ */
+interface UpdatePartnerCapabilitiesInput {
+    tokenManagementEnabled: boolean;
+    allowedScopes: string[];
+}
+/**
+ * Scope constants.
+ * @public
+ */
+declare const ScopeTrading = "trading";
+declare const ScopeAccountCreation = "account_creation";
+declare const ScopeDelegatedSigning = "delegated_signing";
+
+/**
+ * Partner-account creation types.
+ * @public
+ */
+/**
+ * Partner-owned profile creation payload.
+ * `displayName` is the public profile name for the created partner account.
+ * If omitted, the backend defaults it to the created or verified account address.
+ * The backend currently enforces a maximum length of 44 characters.
+ * @public
+ */
+interface CreatePartnerAccountInput {
+    displayName?: string;
+    createServerWallet?: boolean;
+}
+/**
+ * EOA verification headers for partner-account creation.
+ * @public
+ */
+interface CreatePartnerAccountEOAHeaders {
+    account: string;
+    signingMessage: string;
+    signature: string;
+}
+/**
+ * Partner-account creation response.
+ * @public
+ */
+interface PartnerAccountResponse {
+    profileId: number;
+    account: string;
 }
 
 /**
@@ -506,8 +556,11 @@ interface CreatedOrder {
     signatureType: number;
     /**
      * Unique salt for order identification
+     *
+     * @remarks
+     * May be returned as a string when value exceeds JavaScript safe integer range.
      */
-    salt: number;
+    salt: number | string;
     /**
      * Maker address
      */
@@ -615,6 +668,121 @@ interface OrderSigningConfig {
     contractAddress: string;
 }
 
+/**
+ * Delegated-order creation parameters.
+ * @public
+ */
+interface CreateDelegatedOrderParams {
+    marketSlug: string;
+    orderType: OrderType;
+    onBehalfOf: number;
+    feeRateBps?: number;
+    args: OrderArgs;
+}
+/**
+ * Order submission payload where signature may be omitted.
+ * @public
+ */
+interface DelegatedOrderSubmission {
+    salt: number;
+    maker: string;
+    signer: string;
+    taker: string;
+    tokenId: string;
+    makerAmount: number;
+    takerAmount: number;
+    expiration: string;
+    nonce: number;
+    feeRateBps: number;
+    side: Side;
+    signatureType: SignatureType;
+    price?: number;
+    signature?: string;
+}
+/**
+ * POST /orders payload for delegated flows.
+ * @public
+ */
+interface CreateDelegatedOrderRequest {
+    order: DelegatedOrderSubmission;
+    orderType: OrderType;
+    marketSlug: string;
+    ownerId: number;
+    onBehalfOf?: number;
+}
+/**
+ * Cancel endpoint response.
+ * @public
+ */
+interface CancelResponse {
+    message: string;
+}
+/**
+ * Re-export of the normal order response for delegated-create helpers.
+ * @public
+ */
+type DelegatedOrderResponse = OrderResponse;
+
+/**
+ * Logger interface for SDK integration.
+ * Allows users to inject their own logging implementation.
+ *
+ * @public
+ */
+interface ILogger {
+    /**
+     * Log debug information (verbose, development only)
+     */
+    debug(message: string, meta?: Record<string, any>): void;
+    /**
+     * Log informational messages
+     */
+    info(message: string, meta?: Record<string, any>): void;
+    /**
+     * Log warning messages
+     */
+    warn(message: string, meta?: Record<string, any>): void;
+    /**
+     * Log error messages
+     */
+    error(message: string, error?: Error, meta?: Record<string, any>): void;
+}
+/**
+ * No-op logger (default) - does nothing.
+ * Zero performance overhead when logging is not needed.
+ *
+ * @internal
+ */
+declare class NoOpLogger implements ILogger {
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+}
+/**
+ * Simple console logger for development.
+ * Can be used as a starting point or for debugging.
+ *
+ * @example
+ * ```typescript
+ * import { ConsoleLogger } from '@limitless-exchange/sdk';
+ *
+ * const logger = new ConsoleLogger('debug');
+ * const authenticator = new Authenticator(httpClient, signer, logger);
+ * ```
+ *
+ * @public
+ */
+declare class ConsoleLogger implements ILogger {
+    private level;
+    constructor(level?: 'debug' | 'info' | 'warn' | 'error');
+    private shouldLog;
+    debug(message: string, meta?: Record<string, any>): void;
+    info(message: string, meta?: Record<string, any>): void;
+    warn(message: string, meta?: Record<string, any>): void;
+    error(message: string, error?: Error, meta?: Record<string, any>): void;
+}
+
 /**
  * Portfolio and position types for Limitless Exchange.
  * @module types/portfolio
@@ -1096,11 +1264,15 @@ interface MarketSettings {
     /**
      * Rewards epoch duration
      */
-    rewardsEpoch: string;
+    rewardsEpoch: string | number;
     /**
      * Constant parameter
      */
-    c: string;
+    c: string | number;
+    /**
+     * Market maker rebate rate.
+     */
+    rebateRate?: number;
 }
 /**
  * Trade prices for different order types.
@@ -1257,7 +1429,7 @@ interface Venue {
      * Required for NegRisk/Grouped markets only.
      * SELL orders on NegRisk markets require CT approval to both exchange AND adapter.
      */
-    adapter: string;
+    adapter: string | null;
 }
 /**
  * Market token IDs for CLOB markets.
@@ -1358,6 +1530,38 @@ interface Market$1 {
      * Formatted trading volume
      */
     volumeFormatted?: string;
+    /**
+     * Market automation type.
+     */
+    automationType?: 'manual' | 'lumy' | 'sports';
+    /**
+     * Primary market image URL.
+     */
+    imageUrl?: string | null;
+    /**
+     * Price trend data.
+     */
+    trends?: Record<string, unknown>;
+    /**
+     * Open interest (AMM markets).
+     */
+    openInterest?: string;
+    /**
+     * Formatted open interest (AMM markets).
+     */
+    openInterestFormatted?: string;
+    /**
+     * Liquidity (AMM markets).
+     */
+    liquidity?: string;
+    /**
+     * Formatted liquidity (AMM markets).
+     */
+    liquidityFormatted?: string;
+    /**
+     * Position IDs (AMM markets).
+     */
+    positionIds?: string[];
     /**
      * Condition ID (CLOB only)
      */
@@ -1546,6 +1750,13 @@ interface WebSocketConfig {
      * and the LIMITLESS_API_KEY environment variable.
      */
     apiKey?: string;
+    /**
+     * HMAC credentials for authenticated subscriptions.
+     *
+     * @remarks
+     * When configured alongside `apiKey`, this client uses HMAC headers for authenticated subscriptions.
+     */
+    hmacCredentials?: HMACCredentials;
     /**
      * Auto-reconnect on connection loss (default: true)
      */
@@ -1733,6 +1944,42 @@ interface TransactionEvent {
     /** Trade side (optional) */
     side?: 'BUY' | 'SELL';
 }
+/**
+ * Market-created websocket event payload.
+ *
+ * @public
+ */
+interface MarketCreatedEvent {
+    /** Market slug identifier */
+    slug: string;
+    /** Human-readable market title */
+    title: string;
+    /** Market venue type */
+    type: 'AMM' | 'CLOB';
+    /** Group market slug when this market belongs to a group */
+    groupSlug?: string;
+    /** Category identifiers when provided by the backend */
+    categoryIds?: number[];
+    /** Market creation timestamp */
+    createdAt: Date | number | string;
+}
+/**
+ * Market-resolved websocket event payload.
+ *
+ * @public
+ */
+interface MarketResolvedEvent {
+    /** Market slug identifier */
+    slug: string;
+    /** Market venue type */
+    type: 'AMM' | 'CLOB';
+    /** Winning outcome label */
+    winningOutcome: 'YES' | 'NO';
+    /** Winning outcome index */
+    winningIndex: 0 | 1;
+    /** Resolution timestamp */
+    resolutionDate: Date | number | string;
+}
 /**
  * WebSocket event types.
  * @public
@@ -1778,6 +2025,14 @@ interface WebSocketEvents {
      * Market updates
      */
     market: (data: MarketUpdate) => void;
+    /**
+     * Market-created lifecycle events.
+     */
+    marketCreated: (data: MarketCreatedEvent) => void;
+    /**
+     * Market-resolved lifecycle events.
+     */
+    marketResolved: (data: MarketResolvedEvent) => void;
     /**
      * Position updates
      */
@@ -1843,6 +2098,13 @@ interface HttpClientConfig {
      * Required for authenticated endpoints (portfolio, orders, etc.)
      */
     apiKey?: string;
+    /**
+     * HMAC credentials for scoped API-token authentication.
+     *
+     * @remarks
+     * When configured alongside `apiKey`, this client uses HMAC headers for authenticated requests.
+     */
+    hmacCredentials?: HMACCredentials;
     /**
      * Optional logger for debugging
      * @defaultValue NoOpLogger (no logging)
@@ -1897,6 +2159,28 @@ interface HttpClientConfig {
      */
     additionalHeaders?: Record<string, string>;
 }
+/**
+ * Raw HTTP response with status and headers.
+ *
+ * @remarks
+ * Useful for endpoints where response metadata matters (for example redirect handling).
+ *
+ * @public
+ */
+interface HttpRawResponse<T = any> {
+    /**
+     * HTTP status code.
+     */
+    status: number;
+    /**
+     * Response headers.
+     */
+    headers: RawAxiosResponseHeaders | AxiosResponseHeaders;
+    /**
+     * Response body.
+     */
+    data: T;
+}
 /**
  * HTTP client wrapper for Limitless Exchange API.
  *
@@ -1909,6 +2193,7 @@ interface HttpClientConfig {
 declare class HttpClient {
     private client;
     private apiKey?;
+    private hmacCredentials?;
     private logger;
     /**
      * Creates a new HTTP client instance.
@@ -1921,16 +2206,55 @@ declare class HttpClient {
      * @internal
      */
     private setupInterceptors;
+    /**
+     * Extracts a human-readable error message from API response payload.
+     * @internal
+     */
+    private extractErrorMessage;
+    /**
+     * Creates a typed API error class from status code.
+     * @internal
+     */
+    private createTypedApiError;
     /**
      * Sets the API key for authenticated requests.
      *
      * @param apiKey - API key value
      */
     setApiKey(apiKey: string): void;
+    /**
+     * Returns the configured API key, if any.
+     */
+    getApiKey(): string | undefined;
     /**
      * Clears the API key.
      */
     clearApiKey(): void;
+    /**
+     * Sets HMAC credentials for scoped API-token authentication.
+     */
+    setHMACCredentials(credentials: HMACCredentials): void;
+    /**
+     * Clears HMAC credentials.
+     */
+    clearHMACCredentials(): void;
+    /**
+     * Returns a copy of the configured HMAC credentials, if any.
+     */
+    getHMACCredentials(): HMACCredentials | undefined;
+    /**
+     * Returns the logger attached to this HTTP client.
+     */
+    getLogger(): ILogger;
+    /**
+     * Returns true when cookie/header-based auth is configured on the underlying client.
+     * This is primarily used for custom authenticated flows that don't use API keys or HMAC.
+     */
+    private hasConfiguredHeaderAuth;
+    /**
+     * Ensures the client has some authenticated transport configured.
+     */
+    requireAuth(operation: string): void;
     /**
      * Performs a GET request.
      *
@@ -1939,6 +2263,21 @@ declare class HttpClient {
      * @returns Promise resolving to the response data
      */
     get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Performs a GET request with identity-token authentication.
+     */
+    getWithIdentity<T = any>(url: string, identityToken: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Performs a GET request and returns raw response metadata.
+     *
+     * @remarks
+     * Use this when callers need access to status code or headers (e.g. redirect `Location`).
+     *
+     * @param url - Request URL
+     * @param config - Additional request configuration
+     * @returns Promise resolving to status, headers, and response data
+     */
+    getRaw<T = any>(url: string, config?: AxiosRequestConfig): Promise<HttpRawResponse<T>>;
     /**
      * Performs a POST request.
      *
@@ -1948,6 +2287,18 @@ declare class HttpClient {
      * @returns Promise resolving to the response data
      */
     post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Performs a POST request with identity-token authentication.
+     */
+    postWithIdentity<T = any>(url: string, identityToken: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Performs a POST request with additional per-request headers.
+     */
+    postWithHeaders<T = any>(url: string, data?: any, headers?: Record<string, string>, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Performs a PATCH request.
+     */
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
     /**
      * Performs a DELETE request.
      *
@@ -1960,6 +2311,9 @@ declare class HttpClient {
      * @returns Promise resolving to the response data
      */
     delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    private getRequestPath;
+    private getRequestBodyForSignature;
+    private maskSensitiveHeaders;
 }
 
 /**
@@ -1998,6 +2352,14 @@ declare class Market {
     metadata: MarketMetadata;
     volume?: string;
     volumeFormatted?: string;
+    automationType?: 'manual' | 'lumy' | 'sports';
+    imageUrl?: string | null;
+    trends?: Record<string, unknown>;
+    openInterest?: string;
+    openInterestFormatted?: string;
+    liquidity?: string;
+    liquidityFormatted?: string;
+    positionIds?: string[];
     conditionId?: string;
     negRiskRequestId?: string | null;
     tokens?: MarketTokens;
@@ -2048,6 +2410,159 @@ declare class Market {
     getUserOrders(): Promise<any[]>;
 }
 
+/**
+ * Navigation node returned by /navigation endpoint.
+ * @public
+ */
+interface NavigationNode {
+    id: string;
+    name: string;
+    slug: string;
+    path: string;
+    icon?: string;
+    children: NavigationNode[];
+}
+/**
+ * Filter group option for market pages.
+ * @public
+ */
+interface FilterGroupOption {
+    label: string;
+    value: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Filter group for market pages.
+ * @public
+ */
+interface FilterGroup {
+    name?: string;
+    slug?: string;
+    allowMultiple?: boolean;
+    presentation?: string;
+    options?: FilterGroupOption[];
+    source?: Record<string, unknown>;
+}
+/**
+ * Breadcrumb item returned by /market-pages/by-path endpoint.
+ * @public
+ */
+interface BreadcrumbItem {
+    name: string;
+    slug: string;
+    path: string;
+}
+/**
+ * Market page data resolved by path.
+ * @public
+ */
+interface MarketPage {
+    id: string;
+    name: string;
+    slug: string;
+    fullPath: string;
+    description: string | null;
+    baseFilter: Record<string, unknown>;
+    filterGroups: FilterGroup[];
+    metadata: Record<string, unknown>;
+    breadcrumb: BreadcrumbItem[];
+}
+/**
+ * Property option returned by property-keys endpoints.
+ * @public
+ */
+interface PropertyOption {
+    id: string;
+    propertyKeyId: string;
+    value: string;
+    label: string;
+    sortOrder: number;
+    parentOptionId: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Property key returned by property-keys endpoints.
+ * @public
+ */
+interface PropertyKey {
+    id: string;
+    name: string;
+    slug: string;
+    type: 'select' | 'multi-select';
+    metadata: Record<string, unknown>;
+    isSystem: boolean;
+    options?: PropertyOption[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Offset pagination metadata.
+ * @public
+ */
+interface OffsetPagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+}
+/**
+ * Cursor pagination metadata.
+ * @public
+ */
+interface CursorPagination {
+    nextCursor: string | null;
+}
+/**
+ * Sort field for market-pages market listing.
+ * @public
+ */
+type MarketPageSortField = 'createdAt' | 'updatedAt' | 'deadline' | 'id';
+/**
+ * Sort value for market-pages market listing.
+ * @public
+ */
+type MarketPageSort = MarketPageSortField | `-${MarketPageSortField}`;
+/**
+ * Query params for /market-pages/:id/markets endpoint.
+ * @public
+ */
+type MarketPageFilterPrimitive = string | number | boolean;
+type MarketPageFilterValue = MarketPageFilterPrimitive | MarketPageFilterPrimitive[];
+/**
+ * Query params for /market-pages/:id/markets endpoint.
+ * @public
+ */
+interface MarketPageMarketsParams {
+    page?: number;
+    limit?: number;
+    sort?: MarketPageSort;
+    cursor?: string;
+    filters?: Record<string, MarketPageFilterValue>;
+}
+/**
+ * Offset response for /market-pages/:id/markets endpoint.
+ * @public
+ */
+interface MarketPageMarketsOffsetResponse {
+    data: Market[];
+    pagination: OffsetPagination;
+}
+/**
+ * Cursor response for /market-pages/:id/markets endpoint.
+ * @public
+ */
+interface MarketPageMarketsCursorResponse {
+    data: Market[];
+    cursor: CursorPagination;
+}
+/**
+ * Union response for /market-pages/:id/markets endpoint.
+ * @public
+ */
+type MarketPageMarketsResponse = MarketPageMarketsOffsetResponse | MarketPageMarketsCursorResponse;
+
 /**
  * API error types for Limitless Exchange SDK.
  * @module api/errors
@@ -2406,6 +2921,58 @@ declare class RetryableClient {
     [key: string]: any;
 }
 
+/**
+ * Builds the canonical HMAC message used by the API-token auth flow.
+ * @public
+ */
+declare function buildHMACMessage(timestamp: string, method: string, path: string, body: string): string;
+/**
+ * Computes a base64 HMAC-SHA256 request signature from a base64 secret.
+ * @public
+ */
+declare function computeHMACSignature(secret: string, timestamp: string, method: string, path: string, body: string): string;
+
+/**
+ * Partner self-service API-token operations.
+ * @public
+ */
+declare class ApiTokenService {
+    private readonly httpClient;
+    private readonly logger;
+    constructor(httpClient: HttpClient, logger?: ILogger);
+    deriveToken(identityToken: string, input: DeriveApiTokenInput): Promise<DeriveApiTokenResponse>;
+    listTokens(): Promise<ApiToken[]>;
+    getCapabilities(identityToken: string): Promise<PartnerCapabilities>;
+    revokeToken(tokenId: string): Promise<string>;
+}
+
+/**
+ * Partner-owned profile creation API.
+ * @public
+ */
+declare class PartnerAccountService {
+    private static readonly DISPLAY_NAME_MAX_LENGTH;
+    private readonly httpClient;
+    private readonly logger;
+    constructor(httpClient: HttpClient, logger?: ILogger);
+    createAccount(input: CreatePartnerAccountInput, eoaHeaders?: CreatePartnerAccountEOAHeaders): Promise<PartnerAccountResponse>;
+}
+
+/**
+ * Delegated partner-order operations.
+ * @public
+ */
+declare class DelegatedOrderService {
+    private readonly httpClient;
+    private readonly logger;
+    constructor(httpClient: HttpClient, logger?: ILogger);
+    createOrder(params: CreateDelegatedOrderParams): Promise<DelegatedOrderResponse>;
+    cancel(orderId: string): Promise<string>;
+    cancelOnBehalfOf(orderId: string, onBehalfOf: number): Promise<string>;
+    cancelAll(marketSlug: string): Promise<string>;
+    cancelAllOnBehalfOf(marketSlug: string, onBehalfOf: number): Promise<string>;
+}
+
 /**
  * Default API endpoints and configuration constants.
  * @public
@@ -2479,6 +3046,20 @@ declare const CONTRACT_ADDRESSES: {
  */
 declare function getContractAddress(contractType: 'USDC' | 'CTF', chainId?: number): string;
 
+/**
+ * Numeric parsing helpers for API payloads that may return numbers as strings.
+ */
+/**
+ * Converts number-like values to finite numbers.
+ * Returns undefined when value is not numeric.
+ */
+declare function toFiniteNumber(value: unknown): number | undefined;
+/**
+ * Converts number-like values to finite integers.
+ * Returns undefined when value is not a safe integer.
+ */
+declare function toFiniteInteger(value: unknown): number | undefined;
+
 /**
  * Order builder for constructing unsigned order payloads.
  * @module orders/builder
@@ -3187,6 +3768,57 @@ declare class OrderClient {
     get ownerId(): number | undefined;
 }
 
+/**
+ * Fetcher for market-pages and property-keys APIs.
+ *
+ * @remarks
+ * This class provides access to the new navigation-driven market discovery API.
+ *
+ * @public
+ */
+declare class MarketPageFetcher {
+    private httpClient;
+    private logger;
+    /**
+     * Creates a new market-pages fetcher.
+     *
+     * @param httpClient - HTTP client for API calls
+     * @param logger - Optional logger
+     */
+    constructor(httpClient: HttpClient, logger?: ILogger);
+    /**
+     * Gets the navigation tree.
+     */
+    getNavigation(): Promise<NavigationNode[]>;
+    /**
+     * Resolves a market page by path.
+     *
+     * @remarks
+     * Handles 301 redirects manually by re-requesting `/market-pages/by-path` with the
+     * redirected path value from `Location` header.
+     */
+    getMarketPageByPath(path: string): Promise<MarketPage>;
+    private getMarketPageByPathInternal;
+    private extractRedirectPath;
+    /**
+     * Gets markets for a market page with optional filtering and pagination.
+     */
+    getMarkets(pageId: string, params?: MarketPageMarketsParams): Promise<MarketPageMarketsResponse>;
+    /**
+     * Lists all property keys with options.
+     */
+    getPropertyKeys(): Promise<PropertyKey[]>;
+    /**
+     * Gets a single property key by ID.
+     */
+    getPropertyKey(id: string): Promise<PropertyKey>;
+    /**
+     * Lists options for a property key, optionally filtered by parent option ID.
+     */
+    getPropertyOptions(keyId: string, parentId?: string): Promise<PropertyOption[]>;
+    private stringifyFilterValue;
+}
+
 /**
  * Portfolio data fetcher for Limitless Exchange.
  * @module portfolio/fetcher
@@ -3398,6 +4030,17 @@ declare class WebSocketClient {
      * If already connected, this will trigger a reconnection with the new API key.
      */
     setApiKey(apiKey: string): void;
+    /**
+     * Sets HMAC credentials for authenticated subscriptions.
+     *
+     * @remarks
+     * When configured alongside `apiKey`, this client uses HMAC headers for authenticated subscriptions.
+     */
+    setHMACCredentials(hmacCredentials: NonNullable<WebSocketConfig['hmacCredentials']>): void;
+    /**
+     * Clears HMAC credentials.
+     */
+    clearHMACCredentials(): void;
     /**
      * Reconnects with new authentication credentials.
      * @internal
@@ -3530,4 +4173,35 @@ declare class WebSocketClient {
     private getChannelFromKey;
 }
 
-export { type AMMPosition, APIError, type ActiveMarketsParams, type ActiveMarketsResponse, type ActiveMarketsSortBy, type AmmPriceEntry, AuthenticationError, BASE_SEPOLIA_CHAIN_ID, type BaseOrderArgs, type CLOBPosition, CONTRACT_ADDRESSES, type CollateralToken, ConsoleLogger, type CreatedOrder, DEFAULT_API_URL, DEFAULT_CHAIN_ID, DEFAULT_WS_URL, type FOKOrderArgs, type FillEvent, type GTCOrderArgs, type HistoryEntry, type HistoryResponse, HttpClient, type HttpClientConfig, type ILogger, type LatestTrade, Market, type MarketCreator, MarketFetcher, type Market$1 as MarketInterface, type MarketMetadata, type MarketOutcome, type MarketSettings, type MarketTokens, type MarketUpdate, type MarketsResponse, type ModeInfo, type NewOrderPayload, type NewPriceData, NoOpLogger, type OrderArgs, type OrderBook, OrderBuilder, OrderClient, type OrderClientConfig, type OrderMatch, type OrderResponse, OrderSigner, type OrderSigningConfig, OrderType, type OrderUpdate, OrderValidationError, type OrderbookData, type OrderbookEntry, type OrderbookUpdate, PortfolioFetcher, type PortfolioPositionsResponse, type PortfolioSummary, type Position, type PositionMarket, type PositionSide, type PriceOracleMetadata, type PriceUpdate, RateLimitError, type ReferralData, RetryConfig, type RetryConfigOptions, RetryableClient, SIGNING_MESSAGE_TEMPLATE, Side, SignatureType, type SignedOrder, type SubscriptionChannel, type SubscriptionOptions, type TokenBalance, type TradeEvent, type TradePrices, type TradingMode, type TransactionEvent, type UnsignedOrder, type UserData, type UserProfile, type UserRank, ValidationError, type Venue, WebSocketClient, type WebSocketConfig, type WebSocketEvents, WebSocketState, ZERO_ADDRESS, getContractAddress, retryOnErrors, validateOrderArgs, validateSignedOrder, validateUnsignedOrder, withRetry };
+/**
+ * Root OOP entrypoint for the SDK.
+ *
+ * @remarks
+ * This mirrors the Go SDK shape: one shared transport plus composed domain services.
+ *
+ * @public
+ */
+declare class Client {
+    http: HttpClient;
+    markets: MarketFetcher;
+    portfolio: PortfolioFetcher;
+    pages: MarketPageFetcher;
+    apiTokens: ApiTokenService;
+    partnerAccounts: PartnerAccountService;
+    delegatedOrders: DelegatedOrderService;
+    constructor(config?: HttpClientConfig);
+    /**
+     * Creates a root client around an existing shared HTTP client.
+     */
+    static fromHttpClient(httpClient: HttpClient): Client;
+    /**
+     * Creates a regular EIP-712 order client reusing the shared transport and market cache.
+     */
+    newOrderClient(walletOrPrivateKey: ethers.Wallet | string, config?: Omit<OrderClientConfig, 'httpClient' | 'wallet'>): OrderClient;
+    /**
+     * Creates a WebSocket client reusing shared auth where possible.
+     */
+    newWebSocketClient(config?: WebSocketConfig): WebSocketClient;
+}
+
+export { type AMMPosition, APIError, type ActiveMarketsParams, type ActiveMarketsResponse, type ActiveMarketsSortBy, type AmmPriceEntry, type ApiToken, type ApiTokenProfile, ApiTokenService, AuthenticationError, BASE_SEPOLIA_CHAIN_ID, type BaseOrderArgs, type BreadcrumbItem, type CLOBPosition, CONTRACT_ADDRESSES, type CancelResponse, Client, type CollateralToken, ConsoleLogger, type CreateDelegatedOrderParams, type CreateDelegatedOrderRequest, type CreatePartnerAccountEOAHeaders, type CreatePartnerAccountInput, type CreatedOrder, type CursorPagination, DEFAULT_API_URL, DEFAULT_CHAIN_ID, DEFAULT_WS_URL, type DelegatedOrderResponse, DelegatedOrderService, type DelegatedOrderSubmission, type DeriveApiTokenInput, type DeriveApiTokenResponse, type FOKOrderArgs, type FillEvent, type FilterGroup, type FilterGroupOption, type GTCOrderArgs, type HMACCredentials, type HistoryEntry, type HistoryResponse, HttpClient, type HttpClientConfig, type HttpRawResponse, type ILogger, type LatestTrade, Market, type MarketCreatedEvent, type MarketCreator, MarketFetcher, type Market$1 as MarketInterface, type MarketMetadata, type MarketOutcome, type MarketPage, MarketPageFetcher, type MarketPageFilterPrimitive, type MarketPageFilterValue, type MarketPageMarketsCursorResponse, type MarketPageMarketsOffsetResponse, type MarketPageMarketsParams, type MarketPageMarketsResponse, type MarketPageSort, type MarketPageSortField, type MarketResolvedEvent, type MarketSettings, type MarketTokens, type MarketUpdate, type MarketsResponse, type ModeInfo, type NavigationNode, type NewOrderPayload, type NewPriceData, NoOpLogger, type OffsetPagination, type OrderArgs, type OrderBook, OrderBuilder, OrderClient, type OrderClientConfig, type OrderMatch, type OrderResponse, OrderSigner, type OrderSigningConfig, OrderType, type OrderUpdate, OrderValidationError, type OrderbookData, type OrderbookEntry, type OrderbookUpdate, type PartnerAccountResponse, PartnerAccountService, type PartnerCapabilities, PortfolioFetcher, type PortfolioPositionsResponse, type PortfolioSummary, type Position, type PositionMarket, type PositionSide, type PriceOracleMetadata, type PriceUpdate, type PropertyKey, type PropertyOption, RateLimitError, type ReferralData, RetryConfig, type RetryConfigOptions, RetryableClient, SIGNING_MESSAGE_TEMPLATE, ScopeAccountCreation, ScopeDelegatedSigning, ScopeTrading, Side, SignatureType, type SignedOrder, type SubscriptionChannel, type SubscriptionOptions, type TokenBalance, type TradeEvent, type TradePrices, type TradingMode, type TransactionEvent, type UnsignedOrder, type UpdatePartnerCapabilitiesInput, type UserData, type UserProfile, type UserRank, ValidationError, type Venue, WebSocketClient, type WebSocketConfig, type WebSocketEvents, WebSocketState, ZERO_ADDRESS, buildHMACMessage, computeHMACSignature, getContractAddress, retryOnErrors, toFiniteInteger, toFiniteNumber, validateOrderArgs, validateSignedOrder, validateUnsignedOrder, withRetry };