pmxtjs 2.48.5 → 2.49.0

package/pmxt/models.ts

@@ -223,6 +223,15 @@ export interface UserTrade {
 
     /** 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;
 }
 
 /**
@@ -301,6 +310,9 @@ export interface Order {
     /** Amount filled */
     filled: number;
 
+    /** Amount filled in shares/contracts (if different from USDC-denominated `filled`). */
+    filledShares?: number;
+
     /** Amount remaining */
     remaining: number;
 
@@ -312,6 +324,18 @@ export interface Order {
 
     /** 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;
 }
 
 /**
@@ -324,23 +348,32 @@ export interface Position {
     /** 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;
+    /** 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 */
-    currentPrice: 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 */
-    unrealizedPnL: 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;
 }
 
 /**
@@ -358,6 +391,15 @@ export interface Balance {
 
     /** 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;
 }
 
 // Parameter types
@@ -437,6 +479,9 @@ export interface EventFetchParams {
     /** Pagination offset */
     offset?: number;
 
+    /** Opaque venue pagination cursor, where supported. */
+    cursor?: string;
+
     /** Sort order */
     sort?: SortOption;
 
@@ -452,6 +497,9 @@ export interface EventFetchParams {
     /** 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;
 
@@ -503,6 +551,15 @@ export interface CreateOrderParams {
 
     /** 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. */

package/pmxt/server-manager.ts

@@ -121,6 +121,13 @@ export class ServerManager {
         }
     }
 
+    /**
+     * Backwards-compatible alias for `isServerRunning()`.
+     */
+    async isServerAlive(): Promise<boolean> {
+        return this.isServerRunning();
+    }
+
     /**
      * Wait for the server to be ready.
      * Requires a lock file to be present to avoid falsely matching an unrelated

package/pmxt/signers.ts

@@ -0,0 +1,86 @@
+/**
+ * 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>;
+}
+
+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.
+ */
+export class EthersSigner implements Signer {
+    private readonly _wallet: any; // ethers.Wallet
+    readonly address: string;
+
+    constructor(privateKey: string) {
+        let ethers: any;
+        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: TypedData): Promise<string> {
+        // 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: string = await this._wallet.signTypedData(
+            typedData.domain,
+            types,
+            typedData.message,
+        );
+        return sig.startsWith("0x") ? sig : "0x" + sig;
+    }
+}
+
+/**
+ * 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 async function signerFromPrivateKey(privateKey: string): Promise<Signer> {
+    return new EthersSigner(privateKey);
+}

package/pmxt/ws-client.ts

@@ -8,6 +8,7 @@
  */
 
 import { PmxtError } from "./errors.js";
+import { logger } from "./logger.js";
 
 const MAX_QUEUED_MESSAGES_PER_SUBSCRIPTION = 100_000;
 
@@ -144,7 +145,7 @@ export class SidecarWsClient {
                     this.dispatch(msg);
                 } catch (err) {
                     // Dispatch bug -- log and continue; don't kill the connection.
-                    console.error('[SidecarWsClient] dispatch error:', err);
+                    logger.error('[SidecarWsClient] dispatch error:', { err });
                 }
             };
         });