pmxtjs 2.48.6 → 2.49.1

package/dist/esm/generated/src/models/UnifiedSeries.d.ts

@@ -41,13 +41,13 @@ export interface UnifiedSeries {
      */
     title: string;
     /**
-     *
+     * Long-form series description.
      * @type {string}
      * @memberof UnifiedSeries
      */
     description?: string | null;
     /**
-     *
+     * Recurrence cadence the venue reports ('daily', 'weekly', 'annual', ...).
      * @type {string}
      * @memberof UnifiedSeries
      */
@@ -59,13 +59,13 @@ export interface UnifiedSeries {
      */
     events?: Array<UnifiedEvent>;
     /**
-     *
+     * Canonical venue URL for the series.
      * @type {string}
      * @memberof UnifiedSeries
      */
     url?: string | null;
     /**
-     *
+     * Venue-hosted image.
      * @type {string}
      * @memberof UnifiedSeries
      */

package/dist/esm/generated/src/models/UserTrade.d.ts

@@ -57,6 +57,24 @@ export interface UserTrade {
      * @memberof UserTrade
      */
     orderId?: string;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof UserTrade
+     */
+    txHash?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof UserTrade
+     */
+    chain?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {number}
+     * @memberof UserTrade
+     */
+    blockNumber?: number | null;
 }
 /**
  * @export

package/dist/esm/generated/src/models/UserTrade.js

@@ -50,6 +50,9 @@ export function UserTradeFromJSONTyped(json, ignoreDiscriminator) {
         'side': json['side'],
         'outcomeId': json['outcomeId'] == null ? undefined : json['outcomeId'],
         'orderId': json['orderId'] == null ? undefined : json['orderId'],
+        'txHash': json['txHash'] == null ? undefined : json['txHash'],
+        'chain': json['chain'] == null ? undefined : json['chain'],
+        'blockNumber': json['blockNumber'] == null ? undefined : json['blockNumber'],
     };
 }
 export function UserTradeToJSON(json) {
@@ -67,5 +70,8 @@ export function UserTradeToJSONTyped(value, ignoreDiscriminator = false) {
         'side': value['side'],
         'outcomeId': value['outcomeId'],
         'orderId': value['orderId'],
+        'txHash': value['txHash'],
+        'chain': value['chain'],
+        'blockNumber': value['blockNumber'],
     };
 }

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

@@ -21,6 +21,7 @@ export * from './EventFilterCriteriaTotalVolume.js';
 export * from './EventMatchResult.js';
 export * from './ExchangeCredentials.js';
 export * from './ExchangeCredentialsSignatureType.js';
+export * from './ExchangeOptions.js';
 export * from './ExecutionPriceResult.js';
 export * from './FeedFetchHistoricalPrices200Response.js';
 export * from './FeedFetchOHLCV200Response.js';

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

@@ -23,6 +23,7 @@ export * from './EventFilterCriteriaTotalVolume.js';
 export * from './EventMatchResult.js';
 export * from './ExchangeCredentials.js';
 export * from './ExchangeCredentialsSignatureType.js';
+export * from './ExchangeOptions.js';
 export * from './ExecutionPriceResult.js';
 export * from './FeedFetchHistoricalPrices200Response.js';
 export * from './FeedFetchOHLCV200Response.js';

package/dist/esm/index.d.ts

@@ -33,6 +33,7 @@ export { MarketList } from "./pmxt/models.js";
 export type { UnifiedSeries } from "./pmxt/models.js";
 export type * from "./pmxt/models.js";
 export * from "./pmxt/errors.js";
+export * from "./pmxt/hosted-errors.js";
 declare function stopServer(): Promise<void>;
 declare function restartServer(): Promise<void>;
 /**
@@ -77,6 +78,7 @@ declare const pmxt: {
     ValidationError: typeof errors.ValidationError;
     NetworkError: typeof errors.NetworkError;
     ExchangeNotAvailable: typeof errors.ExchangeNotAvailable;
+    NotSupported: typeof errors.NotSupported;
     MarketList: typeof models.MarketList;
     Exchange: typeof Exchange;
     Polymarket: typeof Polymarket;

package/dist/esm/index.js

@@ -30,6 +30,7 @@ export { ServerManager } from "./pmxt/server-manager.js";
 export { HOSTED_URL, LOCAL_URL, ENV, resolvePmxtBaseUrl } from "./pmxt/constants.js";
 export { MarketList } from "./pmxt/models.js";
 export * from "./pmxt/errors.js";
+export * from "./pmxt/hosted-errors.js";
 const defaultManager = new ServerManager();
 // Flat aliases for the namespaced server commands. Kept as permanent,
 // fully-supported shorthand — `pmxt.server.stop()` and `pmxt.stopServer()`

package/dist/esm/pmxt/client.d.ts

@@ -7,6 +7,8 @@
 import { Configuration, DefaultApi, ExchangeCredentials } from "../generated/src/index.js";
 import { Balance, BuiltOrder, CreateOrderParams, EventFetchParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, FetchOrderBookParams, MarketFetchParams, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, MyTradesParams, Order, OrderBook, OrderHistoryParams, PaginatedMarketsResult, Position, SeriesFetchParams, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UnifiedSeries, UserTrade, FirehoseEvent } from "./models.js";
 import { ServerManager } from "./server-manager.js";
+import type { Signer } from "./signers.js";
+import { Escrow } from "./escrow.js";
 /**
  * Base exchange client options.
  */
@@ -49,6 +51,18 @@ export interface ExchangeOptions {
     proxyAddress?: string;
     /** Optional signature type (0=EOA, 1=Proxy) */
     signatureType?: number;
+    /**
+     * EVM wallet address used for hosted reads/writes. Required for hosted
+     * endpoints that operate on a wallet (balances, positions, trades, open
+     * orders). When omitted, hosted reads raise {@link MissingWalletAddress}.
+     */
+    walletAddress?: string;
+    /**
+     * External signer used for hosted writes. When `privateKey` is supplied
+     * without `signer` in hosted mode, an internal {@link EthersSigner} is
+     * built from it lazily.
+     */
+    signer?: Signer;
 }
 /**
  * Base class for prediction market exchanges.
@@ -58,10 +72,10 @@ export interface ExchangeOptions {
  */
 export declare abstract class Exchange {
     private static readonly OBDATA_WATCH_ALL_SOURCES;
-    protected exchangeName: string;
+    exchangeName: string;
+    pmxtApiKey?: string;
     protected apiKey?: string;
     protected privateKey?: string;
-    protected pmxtApiKey?: string;
     protected proxyAddress?: string;
     protected signatureType?: number;
     protected api: DefaultApi;
@@ -69,6 +83,12 @@ export declare abstract class Exchange {
     protected serverManager: ServerManager;
     protected initPromise: Promise<void>;
     protected isHosted: boolean;
+    /** Wallet address used for hosted endpoints that operate on a wallet. */
+    walletAddress?: string;
+    /** External signer used for hosted writes. */
+    signer?: Signer;
+    /** Escrow namespace — populated in hosted mode for trading-allowlisted venues. */
+    escrow?: Escrow;
     private _hostedAccount?;
     private _accountDiscoveryPromise?;
     /**
@@ -87,6 +107,18 @@ export declare abstract class Exchange {
     protected handleResponse(response: any): any;
     protected getCredentials(): ExchangeCredentials | undefined;
     protected getAuthHeaders(): Record<string, string>;
+    /**
+     * Returns true when this client should dispatch trading methods through
+     * the hosted PMXT trading API (`pmxtApiKey` set AND venue is on the
+     * hosted-trading allowlist). Used to gate every Group A method.
+     */
+    protected isHostedTradingMode(): boolean;
+    /**
+     * Require a configured signer for a hosted write. Returns the signer or
+     * throws {@link MissingWalletAddress} (consistent with the error class
+     * surfaced for missing wallet wiring on hosted writes).
+     */
+    protected requireHostedSigner(): Signer;
     /**
      * Resolve the current sidecar base URL.
      *
@@ -184,14 +216,37 @@ export declare abstract class Exchange {
     fetchOrderBook(outcomeId: string | MarketOutcome, limit?: number, params?: FetchOrderBookParams): Promise<OrderBook | OrderBook[]>;
     fetchOrderBooks(outcomeIds: (string | MarketOutcome)[]): Promise<Record<string, OrderBook>>;
     submitOrder(built: BuiltOrder): Promise<Order>;
+    /**
+     * Hosted-mode submitOrder: validate the stored build response, sign the
+     * typed_data (and pull_typed_data for Opinion cross-chain sells), then
+     * POST to `/v0/trade/submit-order`.
+     */
+    private _hostedSubmitOrder;
+    /**
+     * Resolve the per-(venue, side, pull) typed-data schema route used by
+     * `validateTypedData` / `validateEconomics`. Returns undefined for the
+     * pull leg when a venue/side combo doesn't have one.
+     */
+    private _hostedTypedDataRoute;
+    private _hostedCancelTypedDataRoute;
     cancelOrder(orderId: string): Promise<Order>;
+    /**
+     * Hosted-mode cancelOrder: build the cancel typed_data on the server,
+     * validate + sign (dual-sign for Opinion cross-chain), then submit.
+     */
+    private _hostedCancelOrder;
     fetchOrder(orderId: string): Promise<Order>;
+    private _hostedFetchOrder;
     fetchOpenOrders(marketId?: string): Promise<Order[]>;
+    private _hostedFetchOpenOrders;
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;
+    private _hostedFetchMyTrades;
     fetchClosedOrders(params?: OrderHistoryParams): Promise<Order[]>;
     fetchAllOrders(params?: OrderHistoryParams): Promise<Order[]>;
     fetchPositions(address?: string): Promise<Position[]>;
+    private _hostedFetchPositions;
     fetchBalance(address?: string): Promise<Balance[]>;
+    private _hostedFetchBalance;
     unwatchOrderBook(outcomeId: string | MarketOutcome): Promise<void>;
     unwatchAddress(address: string): Promise<void>;
     close(): Promise<void>;
@@ -388,6 +443,23 @@ export declare abstract class Exchange {
     }): Promise<BuiltOrder>;
     private _discoverHostedAccount;
     private _executeSorOrder;
+    /**
+     * Hosted-mode buildOrder: validate inputs locally, then POST to the
+     * trading service's `build-order` endpoint and return a BuiltOrder
+     * that carries the original build_request for Layer-2 economic checks
+     * at submit time.
+     */
+    private _hostedBuildOrder;
+    /**
+     * Hosted-mode createOrder: build → sign → submit single-call wrapper.
+     */
+    private _hostedCreateOrder;
+    /**
+     * Construct the hosted build-order request body and validate inputs
+     * locally per the v0 contract (denom/side compatibility, > 6-decimal
+     * precision rejected via {@link to6dec}).
+     */
+    private _hostedBuildOrderBody;
     /**
      * @example
      * ```typescript
@@ -401,7 +473,9 @@ export declare abstract class Exchange {
      * });
      * ```
      */
-    createOrder(params: any): Promise<Order>;
+    createOrder(params: CreateOrderParams & {
+        outcome?: MarketOutcome;
+    }): Promise<Order>;
     /**
      * Calculate the average execution price for a given amount by walking the order book.
      * Uses the sidecar server for calculation to ensure consistency.
@@ -721,17 +795,44 @@ export declare class GeminiTitan extends Exchange {
 export declare class Hyperliquid extends Exchange {
     constructor(options?: ExchangeOptions);
 }
+/**
+ * Options for the SuiBets exchange client.
+ */
+export interface SuiBetsOptions extends ExchangeOptions {
+    /**
+     * Sui wallet address (0x + 64 hex chars).
+     * Required for fetchPositions(). Can also be set via the
+     * SUIBETS_WALLET_ADDRESS environment variable on the sidecar.
+     */
+    walletAddress?: string;
+}
 /**
  * SuiBets exchange client.
  *
+ * SuiBets is a decentralised P2P sports betting exchange on Sui mainnet.
+ * No house edge. 2% platform fee.
+ * Contract: 0xd51fe151bec66a15b086a67c1cfce9b05759ddac1d73fcd3e14324ad202b2e59
+ *
  * @example
  * ```typescript
  * const suibets = new SuiBets();
- * const markets = await suibets.fetchMarkets();
+ * const markets = await suibets.fetchMarkets({ limit: 20 });
+ *
+ * // With wallet for fetchPositions()
+ * const me = new SuiBets({ walletAddress: '0xabc...' });
+ * const positions = await me.fetchPositions();
  * ```
  */
 export declare class SuiBets extends Exchange {
-    constructor(options?: ExchangeOptions);
+    private readonly _walletAddress?;
+    constructor(options?: SuiBetsOptions);
+    /**
+     * Includes walletAddress in the credentials sent to the sidecar so
+     * that fetchPositions() can reach the /api/p2p/my endpoint.
+     * Falls back to SUIBETS_WALLET_ADDRESS env var on the sidecar side
+     * when walletAddress is not set here.
+     */
+    protected getCredentials(): ExchangeCredentials | undefined;
 }
 /**
  * Mock exchange client.