pmxtjs 2.26.2 → 2.27.1

package/dist/generated/src/models/index.d.ts

@@ -16,37 +16,18 @@ export * from './EventFetchParams';
 export * from './ExchangeCredentials';
 export * from './ExchangeCredentialsSignatureType';
 export * from './ExecutionPriceResult';
-export * from './FetchAllOrdersRequest';
 export * from './FetchBalance200Response';
-export * from './FetchBalanceRequest';
-export * from './FetchClosedOrdersRequest';
 export * from './FetchEvent200Response';
-export * from './FetchEventRequest';
 export * from './FetchEvents200Response';
-export * from './FetchEventsRequest';
 export * from './FetchMarket200Response';
-export * from './FetchMarketRequest';
 export * from './FetchMarkets200Response';
 export * from './FetchMarketsPaginated200Response';
-export * from './FetchMarketsPaginatedRequest';
-export * from './FetchMarketsPaginatedRequestArgsInner';
-export * from './FetchMarketsRequest';
 export * from './FetchMyTrades200Response';
-export * from './FetchMyTradesRequest';
 export * from './FetchOHLCV200Response';
-export * from './FetchOHLCVRequest';
-export * from './FetchOHLCVRequestArgsInner';
 export * from './FetchOpenOrders200Response';
-export * from './FetchOpenOrdersRequest';
 export * from './FetchOrderBook200Response';
-export * from './FetchOrderBookRequest';
-export * from './FetchOrderRequest';
 export * from './FetchPositions200Response';
-export * from './FetchPositionsRequest';
 export * from './FetchTrades200Response';
-export * from './FetchTradesRequest';
-export * from './FetchTradesRequestArgsInner';
-export * from './FetchTradesRequestArgsInnerOneOf';
 export * from './FilterEventsRequest';
 export * from './FilterEventsRequestArgsInner';
 export * from './FilterMarketsRequest';

package/dist/generated/src/models/index.js

@@ -34,37 +34,18 @@ __exportStar(require("./EventFetchParams"), exports);
 __exportStar(require("./ExchangeCredentials"), exports);
 __exportStar(require("./ExchangeCredentialsSignatureType"), exports);
 __exportStar(require("./ExecutionPriceResult"), exports);
-__exportStar(require("./FetchAllOrdersRequest"), exports);
 __exportStar(require("./FetchBalance200Response"), exports);
-__exportStar(require("./FetchBalanceRequest"), exports);
-__exportStar(require("./FetchClosedOrdersRequest"), exports);
 __exportStar(require("./FetchEvent200Response"), exports);
-__exportStar(require("./FetchEventRequest"), exports);
 __exportStar(require("./FetchEvents200Response"), exports);
-__exportStar(require("./FetchEventsRequest"), exports);
 __exportStar(require("./FetchMarket200Response"), exports);
-__exportStar(require("./FetchMarketRequest"), exports);
 __exportStar(require("./FetchMarkets200Response"), exports);
 __exportStar(require("./FetchMarketsPaginated200Response"), exports);
-__exportStar(require("./FetchMarketsPaginatedRequest"), exports);
-__exportStar(require("./FetchMarketsPaginatedRequestArgsInner"), exports);
-__exportStar(require("./FetchMarketsRequest"), exports);
 __exportStar(require("./FetchMyTrades200Response"), exports);
-__exportStar(require("./FetchMyTradesRequest"), exports);
 __exportStar(require("./FetchOHLCV200Response"), exports);
-__exportStar(require("./FetchOHLCVRequest"), exports);
-__exportStar(require("./FetchOHLCVRequestArgsInner"), exports);
 __exportStar(require("./FetchOpenOrders200Response"), exports);
-__exportStar(require("./FetchOpenOrdersRequest"), exports);
 __exportStar(require("./FetchOrderBook200Response"), exports);
-__exportStar(require("./FetchOrderBookRequest"), exports);
-__exportStar(require("./FetchOrderRequest"), exports);
 __exportStar(require("./FetchPositions200Response"), exports);
-__exportStar(require("./FetchPositionsRequest"), exports);
 __exportStar(require("./FetchTrades200Response"), exports);
-__exportStar(require("./FetchTradesRequest"), exports);
-__exportStar(require("./FetchTradesRequestArgsInner"), exports);
-__exportStar(require("./FetchTradesRequestArgsInnerOneOf"), exports);
 __exportStar(require("./FilterEventsRequest"), exports);
 __exportStar(require("./FilterEventsRequestArgsInner"), exports);
 __exportStar(require("./FilterMarketsRequest"), exports);

package/dist/pmxt/client.d.ts

@@ -11,13 +11,39 @@ import { ServerManager } from "./server-manager.js";
  * Base exchange client options.
  */
 export interface ExchangeOptions {
-    /** API key for authentication (optional) */
+    /** Venue-specific API key (e.g. Polymarket CLOB key). Optional. */
     apiKey?: string;
-    /** Private key for authentication (optional) */
+    /** Venue-specific private key. Optional. */
     privateKey?: string;
-    /** Base URL of the PMXT sidecar server */
+    /**
+     * Hosted pmxt API key.
+     *
+     * When set (either as this kwarg or via the `PMXT_API_KEY` env
+     * variable), and no explicit `baseUrl` / `PMXT_BASE_URL` is set,
+     * the Exchange will default to the hosted pmxt endpoint
+     * (`https://api.pmxt.dev`) instead of the local sidecar, and send
+     * `Authorization: Bearer <pmxtApiKey>` on every request.
+     *
+     * The local sidecar ignores this header, so it is safe to set in
+     * both local and hosted modes.
+     */
+    pmxtApiKey?: string;
+    /**
+     * Base URL of the pmxt server.
+     *
+     * Resolution precedence:
+     *   1. Explicit `baseUrl` kwarg.
+     *   2. `PMXT_BASE_URL` environment variable.
+     *   3. `HOSTED_URL` when `pmxtApiKey` (kwarg or env) is present.
+     *   4. Local sidecar (`http://localhost:3847`).
+     */
     baseUrl?: string;
-    /** Automatically start server if not running (default: true) */
+    /**
+     * Automatically start the local sidecar if it is not running.
+     *
+     * Default: `true` when the resolved base URL is the local sidecar,
+     * `false` otherwise. Explicit `true` / `false` always wins.
+     */
     autoStartServer?: boolean;
     /** Optional Polymarket Proxy/Smart Wallet address */
     proxyAddress?: string;
@@ -34,12 +60,21 @@ export declare abstract class Exchange {
     protected exchangeName: string;
     protected apiKey?: string;
     protected privateKey?: string;
+    protected pmxtApiKey?: string;
     protected proxyAddress?: string;
     protected signatureType?: number;
     protected api: DefaultApi;
     protected config: Configuration;
     protected serverManager: ServerManager;
     protected initPromise: Promise<void>;
+    protected isHosted: boolean;
+    /**
+     * Sticky flag: set to `true` the first time a GET read is rejected by
+     * the sidecar with 404/405 (i.e. an older pmxt-core that only supports
+     * POST). While false, read methods try GET first; once flipped they
+     * POST directly and skip the GET probe for the lifetime of this client.
+     */
+    private _getReadsUnsupported;
     constructor(exchangeName: string, options?: ExchangeOptions);
     private initializeServer;
     protected handleResponse(response: any): any;
@@ -61,6 +96,26 @@ export declare abstract class Exchange {
      * ```
      */
     callApi(operationId: string, params?: Record<string, any>): Promise<any>;
+    /**
+     * Dispatch a sidecar read method, preferring GET but transparently
+     * falling back to POST for full backward compatibility.
+     *
+     * GET is used when:
+     *   - the client has no per-instance credentials (the sidecar's GET
+     *     handler intentionally drops credentials to avoid leaking them
+     *     through query strings and access logs), and
+     *   - the sidecar hasn't already returned 404/405 for a previous GET
+     *     in this client's lifetime (`_getReadsUnsupported`), and
+     *   - the query has no nested objects (query strings can't round-trip
+     *     arbitrary JSON).
+     *
+     * Otherwise (or if the GET attempt is rejected with 404/405) the call
+     * is sent as POST with the original `{args, credentials}` body so that
+     * SDK users talking to an older pmxt-core continue to work unchanged.
+     *
+     * @internal — shared transport used by every generated read method.
+     */
+    protected sidecarReadRequest(methodName: string, query: Record<string, unknown>, args: unknown[]): Promise<any>;
     loadMarkets(reload?: boolean): Promise<Record<string, UnifiedMarket>>;
     fetchMarkets(params?: any): Promise<UnifiedMarket[]>;
     fetchMarketsPaginated(params?: any): Promise<PaginatedMarketsResult>;