pmxtjs 2.51.0 → 2.51.2

package/dist/pmxt/client.d.ts

@@ -105,6 +105,7 @@ export declare abstract class Exchange {
     private _wsClient;
     /** Sticky flag: true if the sidecar /ws endpoint is unavailable. */
     private _wsUnsupported;
+    private readonly _useSidecarLockBaseUrl;
     constructor(exchangeName: string, options?: ExchangeOptions);
     private initializeServer;
     protected handleResponse(response: any): any;
@@ -125,9 +126,9 @@ export declare abstract class Exchange {
     /**
      * Resolve the current sidecar base URL.
      *
-     * For hosted mode the configured basePath is returned as-is.
-     * For local mode the port is re-read from the lock file on every
-     * call so we pick up sidecar restarts that land on a different port.
+     * Hosted mode and explicit baseUrl clients keep the configured basePath.
+     * Default local clients re-read the lock-file port on every call so they
+     * pick up sidecar restarts that land on a different port.
      */
     private resolveBaseUrl;
     /**
@@ -576,6 +577,14 @@ export interface PolymarketOptions {
     proxyAddress?: string;
     /** Optional signature type */
     signatureType?: 'eoa' | 'poly-proxy' | 'gnosis-safe' | number;
+    /**
+     * EVM wallet address used for hosted reads/writes.
+     */
+    walletAddress?: string;
+    /**
+     * External signer used for hosted writes.
+     */
+    signer?: Signer;
 }
 export declare class Polymarket extends Exchange {
     constructor(options?: PolymarketOptions);
@@ -856,6 +865,15 @@ export declare const Suibets: typeof SuiBets;
 export declare class Rain extends Exchange {
     constructor(options?: ExchangeOptions);
 }
+/**
+ * Hunch exchange client.
+ *
+ * Hunch is a crypto-native prediction market. Reads are unauthenticated;
+ * trading requires an EVM private key.
+ */
+export declare class Hunch extends Exchange {
+    constructor(options?: ExchangeOptions);
+}
 /**
  * Mock exchange client.
  *

package/dist/pmxt/client.js

@@ -6,7 +6,7 @@
  * OpenAPI client, matching the Python API exactly.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Mock = exports.Rain = exports.Suibets = exports.SuiBets = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.KalshiDemo = exports.Limitless = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
+exports.Mock = exports.Hunch = exports.Rain = exports.Suibets = exports.SuiBets = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.KalshiDemo = exports.Limitless = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
 const index_js_1 = require("../generated/src/index.js");
 const models_js_1 = require("./models.js");
 const server_manager_js_1 = require("./server-manager.js");
@@ -193,6 +193,7 @@ class Exchange {
     _wsClient = null;
     /** Sticky flag: true if the sidecar /ws endpoint is unavailable. */
     _wsUnsupported = false;
+    _useSidecarLockBaseUrl;
     constructor(exchangeName, options = {}) {
         this.exchangeName = exchangeName.toLowerCase();
         this.apiKey = options.apiKey;
@@ -210,6 +211,9 @@ class Exchange {
         const baseUrl = resolved.baseUrl;
         this.pmxtApiKey = resolved.pmxtApiKey;
         this.isHosted = resolved.isHosted;
+        const hasBaseUrlOverride = Boolean(options.baseUrl ||
+            (typeof process !== "undefined" && process.env[constants_js_1.ENV.BASE_URL]));
+        this._useSidecarLockBaseUrl = !this.isHosted && !hasBaseUrlOverride;
         // Hosted trading bridge: if the caller passed a privateKey but no
         // explicit signer, lazily wrap it in an EthersSigner so that
         // `pmxt.Polymarket(pmxtApiKey, privateKey)` just works without the
@@ -250,15 +254,17 @@ class Exchange {
         if (autoStartServer) {
             try {
                 await this.serverManager.ensureServerRunning();
-                // Get the actual port the server is running on
-                // (may differ from default if default port was busy)
-                const actualPort = this.serverManager.getRunningPort();
-                const newBaseUrl = `http://localhost:${actualPort}`;
-                // Update API client with actual base URL
-                this.config = new index_js_1.Configuration({
-                    basePath: newBaseUrl,
-                });
-                this.api = new index_js_1.DefaultApi(this.config);
+                if (this._useSidecarLockBaseUrl) {
+                    // Get the actual port the server is running on
+                    // (may differ from default if default port was busy)
+                    const actualPort = this.serverManager.getRunningPort();
+                    const newBaseUrl = `http://localhost:${actualPort}`;
+                    // Update API client with actual base URL
+                    this.config = new index_js_1.Configuration({
+                        basePath: newBaseUrl,
+                    });
+                    this.api = new index_js_1.DefaultApi(this.config);
+                }
             }
             catch (error) {
                 const msg = `Failed to start PMXT server: ${error instanceof Error ? error.message : error}\n\n` +
@@ -332,12 +338,12 @@ class Exchange {
     /**
      * Resolve the current sidecar base URL.
      *
-     * For hosted mode the configured basePath is returned as-is.
-     * For local mode the port is re-read from the lock file on every
-     * call so we pick up sidecar restarts that land on a different port.
+     * Hosted mode and explicit baseUrl clients keep the configured basePath.
+     * Default local clients re-read the lock-file port on every call so they
+     * pick up sidecar restarts that land on a different port.
      */
     resolveBaseUrl() {
-        if (this.isHosted)
+        if (this.isHosted || !this._useSidecarLockBaseUrl)
             return this.config.basePath;
         const port = this.serverManager.getRunningPort();
         return `http://localhost:${port}`;
@@ -1021,7 +1027,10 @@ class Exchange {
             const route = hosted_routing_js_1.HOSTED_METHOD_ROUTES.get("fetchOrder");
             const path = (0, hosted_routing_js_1.formatRoutePath)(route, { order_id: orderId });
             const data = await (0, hosted_routing_js_1._tradingRequest)(this, { method: route.method, path });
-            return (0, hosted_mappers_js_1.orderFromV0)(data);
+            const payload = data && typeof data === "object" && "order" in data
+                ? data.order
+                : data;
+            return (0, hosted_mappers_js_1.orderFromV0)(payload);
         }
         try {
             const args = [];
@@ -1127,6 +1136,9 @@ class Exchange {
     }
     async fetchClosedOrders(params) {
         await this.initPromise;
+        if (this.isHosted) {
+            throw new errors_js_1.NotSupported("fetchClosedOrders is not available in hosted trading mode.");
+        }
         try {
             const args = [];
             if (params !== undefined)
@@ -1155,6 +1167,9 @@ class Exchange {
     }
     async fetchAllOrders(params) {
         await this.initPromise;
+        if (this.isHosted) {
+            throw new errors_js_1.NotSupported("fetchAllOrders is not available in hosted trading mode.");
+        }
         try {
             const args = [];
             if (params !== undefined)
@@ -1188,7 +1203,9 @@ class Exchange {
             const route = hosted_routing_js_1.HOSTED_METHOD_ROUTES.get("fetchPositions");
             const path = (0, hosted_routing_js_1.formatRoutePath)(route, { address: resolvedAddress });
             const data = await (0, hosted_routing_js_1._tradingRequest)(this, { method: route.method, path });
-            const list = Array.isArray(data) ? data : [];
+            const list = Array.isArray(data)
+                ? data
+                : (data && Array.isArray(data.positions) ? data.positions : []);
             return list.map((p) => (0, hosted_mappers_js_1.positionFromV0)(p));
         }
         try {
@@ -1224,7 +1241,9 @@ class Exchange {
             const route = hosted_routing_js_1.HOSTED_METHOD_ROUTES.get("fetchBalance");
             const path = (0, hosted_routing_js_1.formatRoutePath)(route, { address: resolvedAddress });
             const data = await (0, hosted_routing_js_1._tradingRequest)(this, { method: route.method, path });
-            const list = Array.isArray(data) ? data : [];
+            const list = Array.isArray(data)
+                ? data
+                : (data && Array.isArray(data.balances) ? data.balances : []);
             return list.map((b) => (0, hosted_mappers_js_1.balanceFromV0)(b));
         }
         try {
@@ -3053,6 +3072,18 @@ class Rain extends Exchange {
     }
 }
 exports.Rain = Rain;
+/**
+ * Hunch exchange client.
+ *
+ * Hunch is a crypto-native prediction market. Reads are unauthenticated;
+ * trading requires an EVM private key.
+ */
+class Hunch extends Exchange {
+    constructor(options = {}) {
+        super("hunch", options);
+    }
+}
+exports.Hunch = Hunch;
 /**
  * Mock exchange client.
  *

package/dist/pmxt/escrow.js

@@ -12,6 +12,80 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Escrow = void 0;
 const hosted_routing_1 = require("./hosted-routing");
+const errors_1 = require("./errors");
+const APPROVAL_TOKENS = new Set(["usdc", "ctf"]);
+const WITHDRAW_ACTIONS = new Set(["request", "claim", "cancel"]);
+const USDC_SCALE = 1000000n;
+function isDecimalTokenId(token) {
+    return /^[0-9]+$/.test(token);
+}
+function normalizeApprovalToken(token) {
+    if (typeof token !== "string") {
+        throw new errors_1.ValidationError("token must be 'usdc', 'ctf', or a decimal CTF token_id string", "token");
+    }
+    const candidate = token.trim();
+    const normalized = candidate.toLowerCase();
+    if (APPROVAL_TOKENS.has(normalized)) {
+        return normalized;
+    }
+    if (isDecimalTokenId(candidate)) {
+        return candidate;
+    }
+    throw new errors_1.ValidationError("token must be 'usdc', 'ctf', or a decimal CTF token_id string", "token");
+}
+function normalizeAmountWei(amountWei) {
+    if (amountWei === undefined) {
+        return undefined;
+    }
+    if (typeof amountWei !== "bigint") {
+        throw new errors_1.ValidationError("amount_wei must be a non-negative integer", "amount_wei");
+    }
+    if (amountWei < 0n) {
+        throw new errors_1.ValidationError("amount_wei must be non-negative", "amount_wei");
+    }
+    return amountWei.toString();
+}
+function validateUsdcDecimal(value, field) {
+    const match = /^([0-9]+)(?:\.([0-9]+))?$/.exec(value);
+    if (!match) {
+        throw new errors_1.ValidationError(`${field} must be a finite positive number`, field);
+    }
+    const fractional = match[2] ?? "";
+    if (fractional.length > 6) {
+        throw new errors_1.ValidationError(`${field} precision exceeds 6 decimals; max precision for USDC is 0.000001`, field);
+    }
+    const scaled = BigInt(match[1]) * USDC_SCALE + BigInt(fractional.padEnd(6, "0"));
+    if (scaled <= 0n) {
+        throw new errors_1.ValidationError(`${field} must be positive`, field);
+    }
+}
+function normalizeUsdcAmount(value, field = "amount") {
+    if (typeof value === "bigint") {
+        if (value <= 0n) {
+            throw new errors_1.ValidationError(`${field} must be positive`, field);
+        }
+        return value.toString();
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new errors_1.ValidationError(`${field} must be a finite positive number`, field);
+        }
+        validateUsdcDecimal(String(value), field);
+        return value;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        validateUsdcDecimal(trimmed, field);
+        return trimmed;
+    }
+    throw new errors_1.ValidationError(`${field} must be a finite positive number`, field);
+}
+function normalizeWithdrawAction(action) {
+    if (typeof action === "string" && WITHDRAW_ACTIONS.has(action)) {
+        return action;
+    }
+    throw new errors_1.ValidationError("action must be 'request', 'claim', or 'cancel'", "action");
+}
 class Escrow {
     client;
     constructor(client) {
@@ -22,13 +96,16 @@ class Escrow {
      * `amountWei` is omitted, the server returns an unlimited approval.
      */
     async approveTx(token, amountWei) {
+        const address = (0, hosted_routing_1.resolveWalletAddress)(this.client);
+        const approvalAmount = normalizeAmountWei(amountWei);
         const route = hosted_routing_1.HOSTED_METHOD_ROUTES.get("escrowApproveTx");
         return (0, hosted_routing_1._tradingRequest)(this.client, {
             method: route.method,
             path: route.path,
             body: {
-                token,
-                amount_wei: amountWei === undefined ? null : amountWei.toString(),
+                token: normalizeApprovalToken(token),
+                user_address: address,
+                ...(approvalAmount === undefined ? {} : { amount_wei: approvalAmount }),
             },
         });
     }
@@ -37,12 +114,15 @@ class Escrow {
      * grid). Accepts number, decimal string, or BigInt in micro-units.
      */
     async depositTx(amount) {
+        const address = (0, hosted_routing_1.resolveWalletAddress)(this.client);
         const route = hosted_routing_1.HOSTED_METHOD_ROUTES.get("escrowDepositTx");
         return (0, hosted_routing_1._tradingRequest)(this.client, {
             method: route.method,
             path: route.path,
             body: {
-                amount: typeof amount === "bigint" ? amount.toString() : amount,
+                token: "usdc",
+                amount: normalizeUsdcAmount(amount),
+                user_address: address,
             },
         });
     }
@@ -52,16 +132,31 @@ class Escrow {
      * the timelock, `cancel` aborts a pending request.
      */
     async withdrawTx(action, amount) {
+        const normalizedAction = normalizeWithdrawAction(action);
+        const address = (0, hosted_routing_1.resolveWalletAddress)(this.client);
         const route = hosted_routing_1.HOSTED_METHOD_ROUTES.get("escrowWithdrawTx");
-        const normalizedAmount = amount === undefined
-            ? null
-            : typeof amount === "bigint"
-                ? amount.toString()
-                : amount;
+        if (normalizedAction === "request") {
+            if (amount === undefined) {
+                throw new errors_1.ValidationError("amount is required when action='request'", "amount");
+            }
+            return (0, hosted_routing_1._tradingRequest)(this.client, {
+                method: route.method,
+                path: route.path,
+                body: {
+                    action: normalizedAction,
+                    token: "usdc",
+                    amount: normalizeUsdcAmount(amount),
+                    user_address: address,
+                },
+            });
+        }
+        if (amount !== undefined) {
+            throw new errors_1.ValidationError(`amount must be omitted when action='${normalizedAction}'`, "amount");
+        }
         return (0, hosted_routing_1._tradingRequest)(this.client, {
             method: route.method,
             path: route.path,
-            body: { action, amount: normalizedAmount },
+            body: { action: normalizedAction, token: "usdc", user_address: address },
         });
     }
     /**
@@ -70,12 +165,16 @@ class Escrow {
      */
     async withdrawals(opts = {}) {
         const address = (0, hosted_routing_1.resolveWalletAddress)(this.client, opts.address);
+        const include = (opts.include ?? "pending,events").trim();
+        if (!include) {
+            throw new errors_1.ValidationError("include must not be empty", "include");
+        }
         const route = hosted_routing_1.HOSTED_METHOD_ROUTES.get("escrowWithdrawals");
         const path = (0, hosted_routing_1.formatRoutePath)(route, { address });
         return (0, hosted_routing_1._tradingRequest)(this.client, {
             method: route.method,
             path,
-            params: { include: opts.include ?? "pending,events" },
+            params: { include },
         });
     }
 }

package/dist/pmxt/server-manager.js

@@ -117,12 +117,14 @@ class ServerManager {
      * Check if the server is running.
      */
     async isServerRunning() {
-        // Read lock file to get current port
-        const port = this.getRunningPort();
+        const info = this.getServerInfo();
+        if (!info?.port) {
+            return false;
+        }
         try {
             // Use native fetch to check health on the actual running port
             // This avoids issues where this.api is configured with the wrong port
-            const response = await fetch(`http://localhost:${port}/health`, {
+            const response = await fetch(`http://localhost:${info.port}/health`, {
                 signal: AbortSignal.timeout(5_000),
             });
             if (response.ok) {