@0xmonaco/core 1.0.75 → 1.0.77

package/dist/api/buildercodes/api.d.ts

@@ -62,10 +62,9 @@ export declare class BuildercodesAPIImpl extends BaseAPI implements Buildercodes
     /**
      * Claim accrued BuilderCodes payout balance into a trading balance.
      *
-     * Throws 403 when the caller is refused — either BuilderCodes is not
-     * enabled, or the session is a delegated agent. Delegated sessions are
-     * refused before the feature flag is read, so a 403 there is permanent for
-     * that session type rather than a rollout state.
+     * Throws 403 when the session is a delegated agent — permanent for that
+     * session type rather than a rollout state. No program switch gates the
+     * claim, so a balance already credited stays claimable.
      *
      * Throws 409 when the payout balance is insufficient for the requested
      * amount (including when the caller has never accrued a share).

package/dist/api/buildercodes/api.js

@@ -140,12 +140,12 @@ export class BuildercodesAPIImpl extends BaseAPI {
             validate(ListBuildercodePayoutsParamsSchema, params);
         }
         const searchParams = new URLSearchParams();
-        if (params?.page !== undefined) {
-            searchParams.append("page", params.page.toString());
-        }
         if (params?.pageSize !== undefined) {
             searchParams.append("pageSize", params.pageSize.toString());
         }
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
         if (params?.kind !== undefined) {
             searchParams.append("kind", params.kind);
         }
@@ -175,10 +175,9 @@ export class BuildercodesAPIImpl extends BaseAPI {
     /**
      * Claim accrued BuilderCodes payout balance into a trading balance.
      *
-     * Throws 403 when the caller is refused — either BuilderCodes is not
-     * enabled, or the session is a delegated agent. Delegated sessions are
-     * refused before the feature flag is read, so a 403 there is permanent for
-     * that session type rather than a rollout state.
+     * Throws 403 when the session is a delegated agent — permanent for that
+     * session type rather than a rollout state. No program switch gates the
+     * claim, so a balance already credited stays claimable.
      *
      * Throws 409 when the payout balance is insufficient for the requested
      * amount (including when the caller has never accrued a share).

package/dist/api/managed-markets/index.js

@@ -1,12 +1,14 @@
+import { ListManagedMarketAssignmentsSchema, validate } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 /** Managed quote intents use the existing wallet session and never move funding. */
 export class ManagedMarketsAPIImpl extends BaseAPI {
     async listAssignments(request = {}) {
+        validate(ListManagedMarketAssignmentsSchema, request);
         const query = new URLSearchParams();
-        if (request.page !== undefined)
-            query.set("page", String(request.page));
         if (request.pageSize !== undefined)
             query.set("pageSize", String(request.pageSize));
+        if (request.pageToken !== undefined)
+            query.set("pageToken", request.pageToken);
         return this.makeAuthenticatedRequest(`/api/v1/managed-markets/assignments${query.size ? `?${query}` : ""}`);
     }
     async claimLease(launchId, request) {

package/dist/api/perp/routes.d.ts

@@ -47,8 +47,8 @@ export declare const perpRoutes: {
         readonly initiate: () => string;
         readonly byIndex: (withdrawalIndex: number) => string;
         readonly list: (params?: {
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
         }) => string;
     };
     readonly market: {

package/dist/api/trades/api.d.ts

@@ -26,23 +26,54 @@ export declare function parseRawTradeEvent(raw: RawTradeEvent): TradeEvent;
  * Options for fetching trades
  */
 export interface GetTradesOptions {
-    /** Page number (starts from 1, default: 1) */
-    page?: number;
-    /** Maximum number of records to return (default: 25, max: 100) */
+    /** Maximum number of records to return (default: 25, max: 1000) */
     pageSize?: number;
+    /**
+     * Cursor from a previous response's `nextPageToken`. Omit (or pass "") to
+     * start at the most recent trade.
+     */
+    pageToken?: string;
+}
+/**
+ * One page of a pair's trade feed.
+ *
+ * `nextPageToken` is empty exactly when the walk is finished — the server
+ * over-fetches one row to prove it — so a caller can stop on the empty token
+ * without a confirming extra request.
+ */
+export interface GetTradesPage {
+    /** Trades in this page, newest first. */
+    trades: TradeEvent[];
+    /** Cursor to pass as `pageToken` for the next page; "" when exhausted. */
+    nextPageToken: string;
 }
 /**
  * Trades API for fetching historical trade data
  */
 export declare class TradesAPIImpl extends BaseAPI {
     /**
-     * Get historical trades for a trading pair
+     * Get one page of historical trades for a trading pair.
+     *
+     * Cursor paged (0XM-2821): the page number was removed because `trades` is
+     * appended to continuously, so an offset silently repeated the newest trades
+     * as fills landed mid-walk. Start with no `pageToken` and follow
+     * `nextPageToken` until it comes back empty.
      *
      * @param tradingPairId - The trading pair UUID
-     * @param options - Pagination options
-     * @returns Array of TradeEvent records sorted by executedAt descending (newest first)
+     * @param options - Cursor pagination options
+     * @returns One page of TradeEvent records sorted by executedAt descending (newest first), plus the next cursor
+     *
+     * @example
+     * ```typescript
+     * let pageToken: string | undefined;
+     * do {
+     *   const page = await sdk.trades.getTrades(pairId, { pageSize: 100, pageToken });
+     *   handle(page.trades);
+     *   pageToken = page.nextPageToken || undefined;
+     * } while (pageToken);
+     * ```
      */
-    getTrades(tradingPairId: string, options?: GetTradesOptions): Promise<TradeEvent[]>;
+    getTrades(tradingPairId: string, options?: GetTradesOptions): Promise<GetTradesPage>;
     /**
      * Get a single trade by its UUID.
      *

package/dist/api/trades/api.js

@@ -1,3 +1,4 @@
+import { GetTradesSchema, validate } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 import { perpRoutes } from "../perp";
 /**
@@ -22,23 +23,49 @@ export function parseRawTradeEvent(raw) {
  */
 export class TradesAPIImpl extends BaseAPI {
     /**
-     * Get historical trades for a trading pair
+     * Get one page of historical trades for a trading pair.
+     *
+     * Cursor paged (0XM-2821): the page number was removed because `trades` is
+     * appended to continuously, so an offset silently repeated the newest trades
+     * as fills landed mid-walk. Start with no `pageToken` and follow
+     * `nextPageToken` until it comes back empty.
      *
      * @param tradingPairId - The trading pair UUID
-     * @param options - Pagination options
-     * @returns Array of TradeEvent records sorted by executedAt descending (newest first)
+     * @param options - Cursor pagination options
+     * @returns One page of TradeEvent records sorted by executedAt descending (newest first), plus the next cursor
+     *
+     * @example
+     * ```typescript
+     * let pageToken: string | undefined;
+     * do {
+     *   const page = await sdk.trades.getTrades(pairId, { pageSize: 100, pageToken });
+     *   handle(page.trades);
+     *   pageToken = page.nextPageToken || undefined;
+     * } while (pageToken);
+     * ```
      */
     async getTrades(tradingPairId, options = {}) {
-        const { page = 1 } = options;
-        // Ensure pageSize is a positive number between 1 and 100, defaulting to 25
-        const pageSize = options.pageSize != null && options.pageSize > 0 ? Math.min(options.pageSize, 100) : 25;
+        validate(GetTradesSchema, options);
         const params = new URLSearchParams();
-        if (page > 1) {
-            params.set("page", String(page));
+        // Only send what the caller set: the server owns the 25 default, so
+        // restating it here would pin the SDK to a value the API can move.
+        if (options.pageSize != null) {
+            params.set("pageSize", String(options.pageSize));
+        }
+        if (options.pageToken != null && options.pageToken !== "") {
+            params.set("pageToken", options.pageToken);
         }
-        params.set("pageSize", String(pageSize));
-        const response = await this.makePublicRequest(`/api/v1/trades/${encodeURIComponent(tradingPairId)}?${params.toString()}`);
-        return response.trades.map(parseRawTradeEvent);
+        const query = params.toString();
+        const response = await this.makePublicRequest(`/api/v1/trades/${encodeURIComponent(tradingPairId)}${query === "" ? "" : `?${query}`}`);
+        return {
+            // `?? []` because an empty page omits `trades` entirely; without it the
+            // last page of a walk would throw instead of ending it.
+            trades: (response.trades ?? []).map(parseRawTradeEvent),
+            // Absent rather than "" on a wire that omits empty strings: either way the
+            // walk is finished, and a caller testing `nextPageToken || undefined`
+            // must not see `undefined` become a truthy string.
+            nextPageToken: response.nextPageToken ?? "",
+        };
     }
     /**
      * Get a single trade by its UUID.

package/dist/api/websocket/websocket.js

@@ -399,6 +399,7 @@ function parseMarketStatsData(raw) {
         bestAskPrice: readOptionalString(data, "bestAskPrice"),
         openInterest: readOptionalString(data, "openInterest"),
         openInterestLimit: readOptionalString(data, "openInterestLimit"),
+        openInterestHeadroom: readOptionalString(data, "openInterestHeadroom"),
         lastTradePrice: readOptionalString(data, "lastTradePrice"),
         dailyBaseTokenVolume: readOptionalString(data, "dailyBaseTokenVolume"),
         dailyQuoteTokenVolume: readOptionalString(data, "dailyQuoteTokenVolume"),
@@ -413,6 +414,11 @@ function parseMarketStatsData(raw) {
         baseInterestRate: readOptionalString(data, "baseInterestRate"),
         fundingClampSmall: readOptionalString(data, "fundingClampSmall"),
         fundingClampBig: readOptionalString(data, "fundingClampBig"),
+        // Lenient like the summary's marketStatus: an unrecognized value passes
+        // through rather than dropping the frame.
+        marketStatus: readOptionalString(data, "marketStatus"),
+        fundingIntervalSeconds: readOptionalNumber(data, "fundingIntervalSeconds"),
+        lastFundingTime: readOptionalNumber(data, "lastFundingTime"),
     };
 }
 function parseMarketStatsEvent(rawData) {
@@ -448,6 +454,10 @@ function parseMarketStatsSummary(raw) {
         // marketStatus stays lenient (read as string, not a strict enum) so an
         // unrecognized status value never drops an otherwise-valid summary row.
         marketStatus: readString(data, "marketStatus"),
+        indexPrice: readOptionalString(data, "indexPrice"),
+        fundingRate: readOptionalString(data, "fundingRate"),
+        premium: readOptionalString(data, "premium"),
+        openInterestNotional: readOptionalString(data, "openInterestNotional"),
     };
 }
 function parseMarketStatsAllEvent(rawData) {
@@ -490,6 +500,17 @@ function parseInstrumentEventData(raw) {
         // non-string value still throws.
         baseIconUrl: readOptionalString(data, "baseIconUrl") ?? null,
         quoteIconUrl: readOptionalString(data, "quoteIconUrl") ?? null,
+        // Asset identity and minLeverage: a server that predates them omits the
+        // keys, so absent reads as `undefined` and never as a made-up `0` or `""`.
+        baseAssetId: readOptionalString(data, "baseAssetId"),
+        quoteAssetId: readOptionalString(data, "quoteAssetId"),
+        baseToken: readOptionalString(data, "baseToken"),
+        quoteToken: readOptionalString(data, "quoteToken"),
+        baseAssetName: readOptionalString(data, "baseAssetName"),
+        quoteAssetName: readOptionalString(data, "quoteAssetName"),
+        baseDecimals: readOptionalNumber(data, "baseDecimals"),
+        quoteDecimals: readOptionalNumber(data, "quoteDecimals"),
+        minLeverage: readOptionalString(data, "minLeverage"),
         maxLeverage: readOptionalString(data, "maxLeverage"),
         initialMarginRate: readOptionalString(data, "initialMarginRate"),
         maintenanceMarginRate: readOptionalString(data, "maintenanceMarginRate"),
@@ -1700,8 +1721,9 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
      * markets, or pass one to filter. Every frame carries the market's FULL
      * current config as a terminal-state snapshot (never an additive delta);
      * `changedFields` names what the mutation touched. A subscribe-time snapshot
-     * of the current active-pair list arrives before the live diffs; a
-     * subscriber joining a channel this client already holds is replayed the
+     * of every listed market arrives before the live diffs, inactive markets
+     * included and flagged `isActive: false` (filter on `isActive` for the
+     * tradable set); a subscriber joining a channel this client already holds is replayed the
      * current baseline from a local cache instead (the server snapshots only
      * genuinely new wire subscriptions). Detected broadcast lag closes the connection
      * with 1013; a new wire subscription provides a fresh baseline.
@@ -1744,8 +1766,8 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
             }
         }, 
         // The subscribe-time baseline arrives as one Snapshot frame whose data is
-        // a flat InstrumentEventData[] (a `listing` per active market, no
-        // per-item envelope).
+        // a flat InstrumentEventData[] (a `listing` per market, inactive ones
+        // flagged `isActive: false`, no per-item envelope).
         //
         // Where it goes depends on whether the caller opted in. With
         // `onSnapshot`, the rows are handed over as one array and the event
@@ -1757,7 +1779,7 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
         // asked would be a silent behaviour break.
         //
         // Either way the local cache is replaced wholesale rather than upserted,
-        // so markets absent from the snapshot (delisted while disconnected) do
+        // so markets absent from the snapshot (no longer listed) do
         // not linger.
         snapshotFrameHandler("instrument", parseInstrumentEventData, (items) => {
             const events = items.map((item) => ({ tradingPairId: item.tradingPairId, data: item }));
@@ -1801,18 +1823,13 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
                     // follows the same delivery contract: one array to `onSnapshot`
                     // when opted in, per-market events otherwise.
                     //
-                    // The two forms carry deliberately different sets. The ARRAY is
-                    // filtered to active markets, because that is what a real snapshot
-                    // is — the server enumerates active pairs, while this cache also
-                    // holds the delistings it has seen live — and a consumer replaces
-                    // its market set from the array, so a delisted row there would
-                    // resurrect a market that is gone. The per-market EVENTS are not
-                    // filtered: a delisting is a legitimate event, it is what tells a
-                    // legacy subscriber the market went inactive, and dropping it would
-                    // change a caller that never opted into any of this.
+                    // Both forms carry the cache's full set, delistings it has seen live
+                    // included, because that is what a real snapshot is: the server
+                    // enumerates inactive markets too, each flagged `isActive: false`.
+                    // A consumer wanting the tradable set filters on `isActive`.
                     if (onSnapshot) {
                         try {
-                            onSnapshot(replay.filter((event) => event.data.isActive).map((event) => event.data));
+                            onSnapshot(replay.map((event) => event.data));
                         }
                         catch (err) {
                             console.error("WebSocket: Error processing instrument baseline replay", err);

package/dist/api/withdrawals/api.js

@@ -1,3 +1,4 @@
+import { ListPendingWithdrawalsSchema, validate } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 import { perpRoutes } from "../perp";
 /**
@@ -30,6 +31,7 @@ export class WithdrawalsAPIImpl extends BaseAPI {
     async listPendingWithdrawals(params) {
         // The gateway serves camelCase (the REST wire format), which matches the
         // public surface, so the response is returned directly with no remapping.
-        return this.makeAuthenticatedRequest(perpRoutes.withdrawals.list({ page: params?.page, pageSize: params?.pageSize }));
+        validate(ListPendingWithdrawalsSchema, params ?? {});
+        return this.makeAuthenticatedRequest(perpRoutes.withdrawals.list({ pageSize: params?.pageSize, pageToken: params?.pageToken }));
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.75",
+	"version": "1.0.77",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -19,8 +19,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.75",
-		"@0xmonaco/types": "1.0.75",
+		"@0xmonaco/contracts": "1.0.77",
+		"@0xmonaco/types": "1.0.77",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"