pmxtjs 2.48.5 → 2.49.0

package/dist/pmxt/models.d.ts

@@ -164,6 +164,12 @@ export interface UserTrade {
     outcomeId?: string;
     /** Market ID */
     marketId?: string;
+    /** On-chain transaction hash (populated in hosted mode when the trade was settled on-chain). */
+    txHash?: string;
+    /** Chain identifier (e.g. 'polygon'). Populated in hosted mode. */
+    chain?: string;
+    /** On-chain block number where this trade was included. Populated in hosted mode. */
+    blockNumber?: number;
 }
 /**
  * Result of a paginated market fetch.
@@ -222,6 +228,8 @@ export interface Order {
     status: string;
     /** Amount filled */
     filled: number;
+    /** Amount filled in shares/contracts (if different from USDC-denominated `filled`). */
+    filledShares?: number;
     /** Amount remaining */
     remaining: number;
     /** Unix timestamp (milliseconds) */
@@ -230,6 +238,14 @@ export interface Order {
     price?: number;
     /** Trading fee */
     fee?: number;
+    /** Fee rate in basis points applied to this order (e.g. 100 = 1%). */
+    feeRateBps?: number;
+    /** On-chain transaction hash (populated in hosted mode when the order was settled on-chain). */
+    txHash?: string;
+    /** Chain identifier (e.g. 'polygon'). Populated in hosted mode. */
+    chain?: string;
+    /** On-chain block number where this order was included. Populated in hosted mode. */
+    blockNumber?: number;
 }
 /**
  * A current position in a market.
@@ -239,18 +255,24 @@ export interface Position {
     marketId: string;
     /** Outcome ID */
     outcomeId: string;
-    /** Outcome label */
-    outcomeLabel: string;
+    /** Outcome label (populated in venue-direct mode; may be undefined in hosted mode when the server hasn't enriched). */
+    outcomeLabel?: string;
     /** Position size (positive for long, negative for short) */
     size: number;
-    /** Average entry price */
-    entryPrice: number;
-    /** Current market price */
-    currentPrice: number;
-    /** Unrealized profit/loss */
-    unrealizedPnL: number;
+    /** Average entry price (populated in venue-direct mode; may be undefined in hosted mode when the server hasn't enriched). */
+    entryPrice?: number;
+    /** Current market price (populated in venue-direct mode; may be undefined in hosted mode when the server hasn't enriched). */
+    currentPrice?: number;
+    /** Unrealized profit/loss (populated in venue-direct mode; may be undefined in hosted mode when the server hasn't enriched). */
+    unrealizedPnL?: number;
     /** Realized profit/loss */
     realizedPnL?: number;
+    /** On-chain transaction hash for the latest position update. Populated in hosted mode. */
+    txHash?: string;
+    /** Chain identifier (e.g. 'polygon'). Populated in hosted mode. */
+    chain?: string;
+    /** On-chain block number for the latest position update. Populated in hosted mode. */
+    blockNumber?: number;
 }
 /**
  * Account balance.
@@ -264,6 +286,12 @@ export interface Balance {
     available: number;
     /** Locked in open orders */
     locked: number;
+    /** On-chain transaction hash for the latest balance update. Populated in hosted mode. */
+    txHash?: string;
+    /** Chain identifier (e.g. 'polygon'). Populated in hosted mode. */
+    chain?: string;
+    /** On-chain block number for the latest balance update. Populated in hosted mode. */
+    blockNumber?: number;
 }
 /**
  * Candle interval for OHLCV data.
@@ -322,6 +350,8 @@ export interface EventFetchParams {
     limit?: number;
     /** Pagination offset */
     offset?: number;
+    /** Opaque venue pagination cursor, where supported. */
+    cursor?: string;
     /** Sort order */
     sort?: SortOption;
     /** Filter by event status */
@@ -332,6 +362,8 @@ export interface EventFetchParams {
     eventId?: string;
     /** Lookup by event slug */
     slug?: string;
+    /** Filter events by their parent series. Accepts the venue-native series id / ticker / slug. */
+    series?: string;
     /** Filter by event category (e.g. "sports", "politics", "crypto") */
     category?: string;
     /** Filter by tags attached to the event */
@@ -370,6 +402,12 @@ export interface CreateOrderParams {
     price?: number;
     /** Optional fee rate (e.g., 1000 for 0.1%) */
     fee?: number;
+    /** Optional override for Limitless/Polymarket */
+    tickSize?: number;
+    /** Optional override to skip neg-risk lookup (Polymarket) */
+    negRisk?: boolean;
+    /** Limitless delegated signing: profile ID to trade on behalf of */
+    onBehalfOf?: number;
 }
 /** Alias matching the core MarketFetchParams name. */
 export type MarketFetchParams = MarketFilterParams;

package/dist/pmxt/server-manager.d.ts

@@ -36,6 +36,10 @@ export declare class ServerManager {
      * Check if the server is running.
      */
     isServerRunning(): Promise<boolean>;
+    /**
+     * Backwards-compatible alias for `isServerRunning()`.
+     */
+    isServerAlive(): Promise<boolean>;
     /**
      * Wait for the server to be ready.
      * Requires a lock file to be present to avoid falsely matching an unrelated

package/dist/pmxt/server-manager.js

@@ -134,6 +134,12 @@ class ServerManager {
             return false;
         }
     }
+    /**
+     * Backwards-compatible alias for `isServerRunning()`.
+     */
+    async isServerAlive() {
+        return this.isServerRunning();
+    }
     /**
      * Wait for the server to be ready.
      * Requires a lock file to be present to avoid falsely matching an unrelated

package/dist/pmxt/signers.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Signer helpers for hosted PMXT trading.
+ *
+ * `ethers` is an optional peer dependency — read-only SDK users do not need it
+ * installed. Hosted-mode signing imports it lazily via `require()` and throws
+ * a clear install hint when it's missing.
+ *
+ * Mirrors `sdks/python/pmxt/signers.py`.
+ */
+/**
+ * EIP-712 typed data payload as accepted by ethers v6 / Web3 wallets.
+ * `EIP712Domain` is allowed inside `types` (and is the standard) but ethers
+ * strips it before signing — see {@link EthersSigner.signTypedData}.
+ */
+export interface TypedData {
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    primaryType: string;
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: string;
+    };
+    message: Record<string, unknown>;
+}
+/**
+ * Pluggable signer abstraction. Implement this to integrate hardware wallets
+ * or remote signing services. {@link EthersSigner} is the built-in
+ * private-key implementation.
+ */
+export interface Signer {
+    readonly address: string;
+    signTypedData(typedData: TypedData): Promise<string>;
+}
+/**
+ * Built-in signer backed by an ethers `Wallet`.
+ *
+ * `ethers` is imported lazily — a clear, install-hint-bearing error is thrown
+ * if the peer dependency is missing.
+ */
+export declare class EthersSigner implements Signer {
+    private readonly _wallet;
+    readonly address: string;
+    constructor(privateKey: string);
+    signTypedData(typedData: TypedData): Promise<string>;
+}
+/**
+ * Convenience factory: build a {@link Signer} from a raw private key.
+ *
+ * Currently always returns an {@link EthersSigner}. Async for forward
+ * compatibility with key-loaders that may need to await (e.g. keystore
+ * decryption).
+ */
+export declare function signerFromPrivateKey(privateKey: string): Promise<Signer>;

package/dist/pmxt/signers.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Signer helpers for hosted PMXT trading.
+ *
+ * `ethers` is an optional peer dependency — read-only SDK users do not need it
+ * installed. Hosted-mode signing imports it lazily via `require()` and throws
+ * a clear install hint when it's missing.
+ *
+ * Mirrors `sdks/python/pmxt/signers.py`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EthersSigner = void 0;
+exports.signerFromPrivateKey = signerFromPrivateKey;
+const ETHERS_INSTALL_HINT = "hosted trading requires the optional 'ethers' peer dependency. Install with: npm install ethers";
+/**
+ * Built-in signer backed by an ethers `Wallet`.
+ *
+ * `ethers` is imported lazily — a clear, install-hint-bearing error is thrown
+ * if the peer dependency is missing.
+ */
+class EthersSigner {
+    _wallet; // ethers.Wallet
+    address;
+    constructor(privateKey) {
+        let ethers;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            ethers = require("ethers");
+        }
+        catch {
+            throw new Error(ETHERS_INSTALL_HINT);
+        }
+        this._wallet = new ethers.Wallet(privateKey);
+        this.address = this._wallet.address;
+    }
+    async signTypedData(typedData) {
+        // ethers expects `types` WITHOUT the EIP712Domain entry — it derives
+        // the domain hash from the `domain` argument.
+        const types = { ...typedData.types };
+        delete types["EIP712Domain"];
+        const sig = await this._wallet.signTypedData(typedData.domain, types, typedData.message);
+        return sig.startsWith("0x") ? sig : "0x" + sig;
+    }
+}
+exports.EthersSigner = EthersSigner;
+/**
+ * Convenience factory: build a {@link Signer} from a raw private key.
+ *
+ * Currently always returns an {@link EthersSigner}. Async for forward
+ * compatibility with key-loaders that may need to await (e.g. keystore
+ * decryption).
+ */
+async function signerFromPrivateKey(privateKey) {
+    return new EthersSigner(privateKey);
+}

package/dist/pmxt/ws-client.js

@@ -10,6 +10,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SidecarWsClient = void 0;
 const errors_js_1 = require("./errors.js");
+const logger_js_1 = require("./logger.js");
 const MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION = 100_000;
 /**
  * Multiplexed WebSocket client for the pmxt sidecar.
@@ -120,7 +121,7 @@ class SidecarWsClient {
                 }
                 catch (err) {
                     // Dispatch bug -- log and continue; don't kill the connection.
-                    console.error('[SidecarWsClient] dispatch error:', err);
+                    logger_js_1.logger.error('[SidecarWsClient] dispatch error:', { err });
                 }
             };
         });

package/generated/docs/OrderLevel.md

@@ -8,6 +8,7 @@ Name | Type
 ------------ | -------------
 `price` | number
 `size` | number
+`orderCount` | number
 
 ## Example
 
@@ -18,6 +19,7 @@ import type { OrderLevel } from 'pmxtjs'
 const example = {
   "price": null,
   "size": null,
+  "orderCount": null,
 } satisfies OrderLevel
 
 console.log(example)

package/generated/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.48.5",
+  "version": "2.49.0",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {

package/generated/src/models/OrderLevel.ts

@@ -31,6 +31,12 @@ export interface OrderLevel {
      * @memberof OrderLevel
      */
     size: number;
+    /**
+     * 
+     * @type {number}
+     * @memberof OrderLevel
+     */
+    orderCount?: number;
 }
 
 /**
@@ -54,6 +60,7 @@ export function OrderLevelFromJSONTyped(json: any, ignoreDiscriminator: boolean)
         
         'price': json['price'],
         'size': json['size'],
+        'orderCount': json['orderCount'] == null ? undefined : json['orderCount'],
     };
 }
 
@@ -70,6 +77,7 @@ export function OrderLevelToJSONTyped(value?: OrderLevel | null, ignoreDiscrimin
         
         'price': value['price'],
         'size': value['size'],
+        'orderCount': value['orderCount'],
     };
 }
 

package/generated/src/models/UnifiedMarket.ts

@@ -64,11 +64,11 @@ export interface UnifiedMarket {
      */
     outcomes: Array<MarketOutcome>;
     /**
-     * When the market is scheduled to resolve.
+     * When the market is scheduled to resolve. Optional because some venues do not publish a cutoff for every market (e.g. Opinion categorical children) — emit `undefined` rather than coercing to epoch.
      * @type {Date}
      * @memberof UnifiedMarket
      */
-    resolutionDate: Date;
+    resolutionDate?: Date;
     /**
      * Trading volume over the past 24 hours (USD).
      * @type {number}
@@ -181,7 +181,6 @@ export function instanceOfUnifiedMarket(value: object): value is UnifiedMarket {
     if (!('title' in value) || value['title'] === undefined) return false;
     if (!('description' in value) || value['description'] === undefined) return false;
     if (!('outcomes' in value) || value['outcomes'] === undefined) return false;
-    if (!('resolutionDate' in value) || value['resolutionDate'] === undefined) return false;
     if (!('volume24h' in value) || value['volume24h'] === undefined) return false;
     if (!('liquidity' in value) || value['liquidity'] === undefined) return false;
     if (!('url' in value) || value['url'] === undefined) return false;
@@ -204,7 +203,7 @@ export function UnifiedMarketFromJSONTyped(json: any, ignoreDiscriminator: boole
         'description': json['description'],
         'slug': json['slug'] == null ? undefined : json['slug'],
         'outcomes': ((json['outcomes'] as Array<any>).map(MarketOutcomeFromJSON)),
-        'resolutionDate': (new Date(json['resolutionDate'])),
+        'resolutionDate': json['resolutionDate'] == null ? undefined : (new Date(json['resolutionDate'])),
         'volume24h': json['volume24h'],
         'volume': json['volume'] == null ? undefined : json['volume'],
         'liquidity': json['liquidity'],
@@ -242,7 +241,7 @@ export function UnifiedMarketToJSONTyped(value?: UnifiedMarket | null, ignoreDis
         'description': value['description'],
         'slug': value['slug'],
         'outcomes': ((value['outcomes'] as Array<any>).map(MarketOutcomeToJSON)),
-        'resolutionDate': value['resolutionDate'].toISOString(),
+        'resolutionDate': value['resolutionDate'] == null ? value['resolutionDate'] : value['resolutionDate'].toISOString(),
         'volume24h': value['volume24h'],
         'volume': value['volume'],
         'liquidity': value['liquidity'],

package/index.ts

@@ -36,6 +36,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";
 
 
 const defaultManager = new ServerManager();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.48.5",
+  "version": "2.49.0",
   "description": "Unified prediction market data API - The ccxt for prediction markets",
   "author": "PMXT Contributors",
   "repository": {
@@ -43,12 +43,21 @@
     "unified"
   ],
   "dependencies": {
-    "pmxt-core": "2.48.5",
+    "pmxt-core": "2.49.0",
     "ws": "^8.18.0"
   },
+  "peerDependencies": {
+    "ethers": ">=6.0.0 <7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ethers": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "@types/node": "^20.0.0",
+    "ethers": "^6.16.0",
     "jest": "^30.4.2",
     "ts-jest": "^29.4.11",
     "typescript": "^5.0.0"