@0xmonaco/core 1.0.81 → 1.0.82

package/dist/api/index.d.ts

@@ -22,6 +22,7 @@ export * from "./profile";
 export * from "./pulse";
 export * from "./sub-accounts";
 export * from "./sweeper";
+export * from "./tradercodes";
 export * from "./trades";
 export * from "./trading";
 export * from "./vault";

package/dist/api/index.js

@@ -22,6 +22,7 @@ export * from "./profile";
 export * from "./pulse";
 export * from "./sub-accounts";
 export * from "./sweeper";
+export * from "./tradercodes";
 export * from "./trades";
 export * from "./trading";
 export * from "./vault";

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

@@ -35,6 +35,11 @@ export declare const perpRoutes: {
         }) => string;
         readonly getTwap: (twapOrderId: string) => string;
         readonly getTwapTca: (twapOrderId: string) => string;
+        readonly listTwapSlices: (twapOrderId: string, params?: {
+            orderBy?: string;
+            pageSize?: number;
+            pageToken?: string;
+        }) => string;
         readonly cancelTwap: (twapOrderId: string) => string;
     };
     readonly delegatedAgents: {

package/dist/api/perp/routes.js

@@ -33,6 +33,7 @@ export const perpRoutes = {
         listTwap: (params) => withQuery(`${API_V1}/orders/twap`, params),
         getTwap: (twapOrderId) => `${API_V1}/orders/twap/${encodeSegment(twapOrderId)}`,
         getTwapTca: (twapOrderId) => `${API_V1}/orders/twap/${encodeSegment(twapOrderId)}/tca`,
+        listTwapSlices: (twapOrderId, params) => withQuery(`${API_V1}/orders/twap/${encodeSegment(twapOrderId)}/slices`, params),
         cancelTwap: (twapOrderId) => `${API_V1}/orders/twap/${encodeSegment(twapOrderId)}/cancel`,
     },
     delegatedAgents: {

package/dist/api/pitpass/index.d.ts

@@ -1,6 +1,13 @@
 /**
- * TraderCodes API Module (`sdk.pitpass`)
+ * Deprecated PitPass name for the TraderCodes API implementation (`sdk.pitpass`).
  *
- * Exports the TraderCodes API implementation.
+ * PitPass is the umbrella over TraderCodes and BuilderCodes; this surface only
+ * ever covered TraderCodes. Use `TraderCodesAPIImpl` (`sdk.tradercodes`).
  */
-export { PitpassAPIImpl } from "./api";
+import { TraderCodesAPIImpl } from "../tradercodes";
+/**
+ * @deprecated Use {@link TraderCodesAPIImpl}. It calls the same
+ * `/api/v1/tradercodes/...` endpoints; removed after at least two SDK releases.
+ */
+export declare class PitpassAPIImpl extends TraderCodesAPIImpl {
+}

package/dist/api/pitpass/index.js

@@ -1,6 +1,13 @@
 /**
- * TraderCodes API Module (`sdk.pitpass`)
+ * Deprecated PitPass name for the TraderCodes API implementation (`sdk.pitpass`).
  *
- * Exports the TraderCodes API implementation.
+ * PitPass is the umbrella over TraderCodes and BuilderCodes; this surface only
+ * ever covered TraderCodes. Use `TraderCodesAPIImpl` (`sdk.tradercodes`).
  */
-export { PitpassAPIImpl } from "./api";
+import { TraderCodesAPIImpl } from "../tradercodes";
+/**
+ * @deprecated Use {@link TraderCodesAPIImpl}. It calls the same
+ * `/api/v1/tradercodes/...` endpoints; removed after at least two SDK releases.
+ */
+export class PitpassAPIImpl extends TraderCodesAPIImpl {
+}

package/dist/api/positions/api.js

@@ -48,6 +48,8 @@ export class PositionsAPIImpl extends BaseAPI {
             method: "POST",
             body: JSON.stringify({
                 tradingPairId: request?.tradingPairId,
+                tradingPairIds: request?.tradingPairIds,
+                side: request?.side,
                 slippageToleranceBps: request?.slippageToleranceBps,
             }),
         });

package/dist/api/profile/api.d.ts

@@ -193,10 +193,17 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * Fetches the user's executed trades from the /api/v1/accounts/trades endpoint.
      * Requires a valid access token to be set.
      *
-     * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
-     * pagination: it starts a cursor walk from the newest row and the response's
-     * `nextPageToken` resumes it. Responses carry no item count: the `trades`
-     * table is too large to count behind a filter.
+     * Cursor-paginated: omitting `pageToken` starts a walk from the newest row, and
+     * the response's `nextPageToken` resumes it. There is no page-number mode: a
+     * `page` param is rejected with a `ValidationError` before the request is sent
+     * (the REST endpoint itself answers `400`).
+     *
+     * An unfiltered response carries `total` and `totalPages`, bounded by the
+     * server count ceiling; `totalCapped` is `true` when more than that matched,
+     * so `total` is a lower bound. A response filtered by `tradingPairId` carries
+     * neither (counting one pair would read the user's whole trade history), nor
+     * does one whose count ran out of its server time budget: treat absent as
+     * unknown. Do not drive a paging loop off `total`; follow `nextPageToken`.
      *
      * @param params - Optional query parameters for pagination and filtering
      * @param params.pageSize - Number of items per page (default: 20; up to 1000)

package/dist/api/profile/api.js

@@ -254,10 +254,17 @@ export class ProfileAPIImpl extends BaseAPI {
      * Fetches the user's executed trades from the /api/v1/accounts/trades endpoint.
      * Requires a valid access token to be set.
      *
-     * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
-     * pagination: it starts a cursor walk from the newest row and the response's
-     * `nextPageToken` resumes it. Responses carry no item count: the `trades`
-     * table is too large to count behind a filter.
+     * Cursor-paginated: omitting `pageToken` starts a walk from the newest row, and
+     * the response's `nextPageToken` resumes it. There is no page-number mode: a
+     * `page` param is rejected with a `ValidationError` before the request is sent
+     * (the REST endpoint itself answers `400`).
+     *
+     * An unfiltered response carries `total` and `totalPages`, bounded by the
+     * server count ceiling; `totalCapped` is `true` when more than that matched,
+     * so `total` is a lower bound. A response filtered by `tradingPairId` carries
+     * neither (counting one pair would read the user's whole trade history), nor
+     * does one whose count ran out of its server time budget: treat absent as
+     * unknown. Do not drive a paging loop off `total`; follow `nextPageToken`.
      *
      * @param params - Optional query parameters for pagination and filtering
      * @param params.pageSize - Number of items per page (default: 20; up to 1000)

package/dist/api/{pitpass → tradercodes}/api.d.ts

@@ -1,5 +1,5 @@
 /**
- * TraderCodes API Implementation (`sdk.pitpass`)
+ * TraderCodes API Implementation (`sdk.tradercodes`)
  *
  * Provides methods for the TraderCodes referral program: reading your wallet-derived
  * TraderCode, a public lookup to validate a referral code at sign-up, reading
@@ -12,30 +12,30 @@
  * @example
  * ```typescript
  * // Read your own code (authenticated)
- * const { code } = await sdk.pitpass.getMyTraderCode();
+ * const { code } = await sdk.tradercodes.getMyTraderCode();
  * console.log(`Share code: Monaco - ${code}`);
  *
  * // Validate a referral code at sign-up (public)
- * const info = await sdk.pitpass.getTraderCodeInfo("0xabc...");
+ * const info = await sdk.tradercodes.getTraderCodeInfo("0xabc...");
  * console.log(`Referrer code: ${info.code}`);
  *
  * // Read accrued rewards balance (authenticated)
- * const { balances } = await sdk.pitpass.getRewardsBalance();
+ * const { balances } = await sdk.tradercodes.getRewardsBalance();
  * for (const b of balances) {
  *   console.log(`${b.token}: ${b.available}`);
  * }
  *
  * // Transfer rewards into trading balance (authenticated)
- * const result = await sdk.pitpass.transferRewards({
+ * const result = await sdk.tradercodes.transferRewards({
  *   token: "0xusdc...",
  *   amount: "1000000",
  * });
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import type { GetMyReferralDownlineParams, GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
+import type { GetMyReferralDownlineParams, GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TraderCodesAPI, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
-export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
+export declare class TraderCodesAPIImpl extends BaseAPI implements TraderCodesAPI {
     /**
      * Return the authenticated caller's TraderCode.
      *

package/dist/api/{pitpass → tradercodes}/api.js

@@ -1,5 +1,5 @@
 /**
- * TraderCodes API Implementation (`sdk.pitpass`)
+ * TraderCodes API Implementation (`sdk.tradercodes`)
  *
  * Provides methods for the TraderCodes referral program: reading your wallet-derived
  * TraderCode, a public lookup to validate a referral code at sign-up, reading
@@ -12,21 +12,21 @@
  * @example
  * ```typescript
  * // Read your own code (authenticated)
- * const { code } = await sdk.pitpass.getMyTraderCode();
+ * const { code } = await sdk.tradercodes.getMyTraderCode();
  * console.log(`Share code: Monaco - ${code}`);
  *
  * // Validate a referral code at sign-up (public)
- * const info = await sdk.pitpass.getTraderCodeInfo("0xabc...");
+ * const info = await sdk.tradercodes.getTraderCodeInfo("0xabc...");
  * console.log(`Referrer code: ${info.code}`);
  *
  * // Read accrued rewards balance (authenticated)
- * const { balances } = await sdk.pitpass.getRewardsBalance();
+ * const { balances } = await sdk.tradercodes.getRewardsBalance();
  * for (const b of balances) {
  *   console.log(`${b.token}: ${b.available}`);
  * }
  *
  * // Transfer rewards into trading balance (authenticated)
- * const result = await sdk.pitpass.transferRewards({
+ * const result = await sdk.tradercodes.transferRewards({
  *   token: "0xusdc...",
  *   amount: "1000000",
  * });
@@ -35,7 +35,7 @@
  */
 import { GetMyReferralDownlineParamsSchema, GetMyReferralTreeParamsSchema, SetTraderCodeParamsSchema, TransferRewardsParamsSchema, validate, } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
-export class PitpassAPIImpl extends BaseAPI {
+export class TraderCodesAPIImpl extends BaseAPI {
     /**
      * Return the authenticated caller's TraderCode.
      *
@@ -43,7 +43,7 @@ export class PitpassAPIImpl extends BaseAPI {
      * custom-handle fields (`customCode`, `isCustom`, `display`).
      */
     async getMyTraderCode() {
-        return await this.makeAuthenticatedRequest("/api/v1/pitpass/codes/me", { method: "GET" });
+        return await this.makeAuthenticatedRequest("/api/v1/tradercodes/codes/me", { method: "GET" });
     }
     /**
      * Claim or edit the caller's custom (vanity) TraderCode handle.
@@ -54,7 +54,7 @@ export class PitpassAPIImpl extends BaseAPI {
      */
     async setTraderCode(code) {
         const validated = validate(SetTraderCodeParamsSchema, { code });
-        return await this.makeAuthenticatedRequest("/api/v1/pitpass/codes/me/custom", {
+        return await this.makeAuthenticatedRequest("/api/v1/tradercodes/codes/me/custom", {
             method: "PUT",
             body: JSON.stringify({ code: validated.code }),
         });
@@ -64,7 +64,7 @@ export class PitpassAPIImpl extends BaseAPI {
      * default. The freed handle enters a cooldown before it can be reclaimed.
      */
     async clearTraderCode() {
-        return await this.makeAuthenticatedRequest("/api/v1/pitpass/codes/me/custom", { method: "DELETE" });
+        return await this.makeAuthenticatedRequest("/api/v1/tradercodes/codes/me/custom", { method: "DELETE" });
     }
     /**
      * Public advisory check of whether a custom TraderCode handle is available.
@@ -76,7 +76,7 @@ export class PitpassAPIImpl extends BaseAPI {
         // Trim to mirror the claim path (setTraderCode validates a trimmed handle),
         // so the advisory check and the eventual claim agree on padded input.
         const query = new URLSearchParams({ code: code.trim() }).toString();
-        const raw = await this.makePublicRequest(`/api/v1/pitpass/codes/available?${query}`, {
+        const raw = await this.makePublicRequest(`/api/v1/tradercodes/codes/available?${query}`, {
             method: "GET",
         });
         // The API always serializes `reason`, sending "" (proto3 string default)
@@ -90,20 +90,20 @@ export class PitpassAPIImpl extends BaseAPI {
      */
     async getTraderCodeInfo(code) {
         const encoded = encodeURIComponent(code.trim());
-        return await this.makePublicRequest(`/api/v1/pitpass/codes/${encoded}`, { method: "GET" });
+        return await this.makePublicRequest(`/api/v1/tradercodes/codes/${encoded}`, { method: "GET" });
     }
     /**
      * Return the caller's current TraderCodes rewards-bucket balances.
      */
     async getRewardsBalance() {
-        return await this.makeAuthenticatedRequest("/api/v1/pitpass/rewards/balance", { method: "GET" });
+        return await this.makeAuthenticatedRequest("/api/v1/tradercodes/rewards/balance", { method: "GET" });
     }
     /**
      * Transfer earned TraderCodes rewards into a trading balance.
      */
     async transferRewards(params) {
         const validated = validate(TransferRewardsParamsSchema, params);
-        return await this.makeAuthenticatedRequest("/api/v1/pitpass/rewards/transfer", {
+        return await this.makeAuthenticatedRequest("/api/v1/tradercodes/rewards/transfer", {
             method: "POST",
             body: JSON.stringify({ token: validated.token, amount: validated.amount }),
         });
@@ -117,7 +117,7 @@ export class PitpassAPIImpl extends BaseAPI {
      * referral levels.
      */
     async getMyReferralPosition() {
-        return await this.makeAuthenticatedRequest("/api/v1/pitpass/referrals/me", {
+        return await this.makeAuthenticatedRequest("/api/v1/tradercodes/referrals/me", {
             method: "GET",
         });
     }
@@ -141,7 +141,7 @@ export class PitpassAPIImpl extends BaseAPI {
             searchParams.append("pageToken", params.pageToken);
         }
         const query = searchParams.toString();
-        const path = query ? `/api/v1/pitpass/referrals/me/downline?${query}` : "/api/v1/pitpass/referrals/me/downline";
+        const path = query ? `/api/v1/tradercodes/referrals/me/downline?${query}` : "/api/v1/tradercodes/referrals/me/downline";
         return await this.makeAuthenticatedRequest(path, { method: "GET" });
     }
     /**
@@ -166,7 +166,7 @@ export class PitpassAPIImpl extends BaseAPI {
             searchParams.append("pageToken", params.pageToken);
         }
         const query = searchParams.toString();
-        const path = query ? `/api/v1/pitpass/referrals/me/tree?${query}` : "/api/v1/pitpass/referrals/me/tree";
+        const path = query ? `/api/v1/tradercodes/referrals/me/tree?${query}` : "/api/v1/tradercodes/referrals/me/tree";
         return await this.makeAuthenticatedRequest(path, { method: "GET" });
     }
 }

package/dist/api/tradercodes/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * TraderCodes API Module (`sdk.tradercodes`)
+ *
+ * Exports the TraderCodes API implementation.
+ */
+export { TraderCodesAPIImpl } from "./api";

package/dist/api/tradercodes/index.js

@@ -0,0 +1,6 @@
+/**
+ * TraderCodes API Module (`sdk.tradercodes`)
+ *
+ * Exports the TraderCodes API implementation.
+ */
+export { TraderCodesAPIImpl } from "./api";

package/dist/api/trading/api.d.ts

@@ -21,7 +21,7 @@
  * );
  * ```
  */
-import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrdersParams, ListTwapOrdersResponse, MarginMode, OrderSide, ParentTpSlLegParams, ParentTrailingStopLegParams, PositionSide, ReplaceOrderResponse, SelfTradePreventionMode, TimeInForce, TradingAPI, TradingMode, TwapOrder } from "@0xmonaco/types";
+import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrderSlicesParams, ListTwapOrderSlicesResponse, ListTwapOrdersParams, ListTwapOrdersResponse, MarginMode, OrderSide, ParentTpSlLegParams, ParentTrailingStopLegParams, PositionSide, ReplaceOrderResponse, SelfTradePreventionMode, TimeInForce, TradingAPI, TradingMode, TwapOrder } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
     /**
@@ -536,4 +536,30 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * ```
      */
     listTwapOrders(params?: ListTwapOrdersParams): Promise<ListTwapOrdersResponse>;
+    /**
+     * Lists one TWAP parent's slices: the child orders it placed, each as
+     * `getOrder` returns it and carrying the parent's id in `parentOrderId`.
+     *
+     * Resting and finished slices are both listed, oldest first unless
+     * `orderBy: "DESC"`. A `PASSIVE` parent's reprices and deadline sweeps are
+     * child orders too, so a parent can have more slices than `slicesPlaced`.
+     * Cursor (pageToken) pagination is the only mode: follow `nextPageToken`
+     * until it comes back empty. Users can only access their own TWAP orders.
+     *
+     * @param twapOrderId - The TWAP parent order UUID
+     * @param params - Optional sort direction, page size (up to 1000) and cursor
+     * @returns Promise resolving to one page of slices
+     * @throws {APIError} When API communication fails or the TWAP order is not found
+     *
+     * @example
+     * ```typescript
+     * let pageToken = "";
+     * do {
+     *   const page = await tradingAPI.listTwapOrderSlices(twapOrderId, { pageSize: 100, pageToken });
+     *   for (const slice of page.slices) console.log(slice.id, slice.status, slice.filledQuantity);
+     *   pageToken = page.nextPageToken;
+     * } while (pageToken);
+     * ```
+     */
+    listTwapOrderSlices(twapOrderId: string, params?: ListTwapOrderSlicesParams): Promise<ListTwapOrderSlicesResponse>;
 }

package/dist/api/trading/api.js

@@ -21,7 +21,7 @@
  * );
  * ```
  */
-import { BatchCreateOrdersSchema, BatchReplaceOrdersSchema, CancelConditionalOrderSchema, CancelOrderSchema, CancelTwapOrderSchema, CreateTwapOrderSchema, GetPaginatedOrdersSchema, ListConditionalOrdersSchema, ListTwapOrdersSchema, PlaceLimitOrderSchema, PlaceMarketOrderSchema, ReplaceOrderSchema, validate, } from "@0xmonaco/types";
+import { BatchCreateOrdersSchema, BatchReplaceOrdersSchema, CancelConditionalOrderSchema, CancelOrderSchema, CancelTwapOrderSchema, CreateTwapOrderSchema, GetPaginatedOrdersSchema, ListConditionalOrdersSchema, ListTwapOrderSlicesSchema, ListTwapOrdersSchema, PlaceLimitOrderSchema, PlaceMarketOrderSchema, ReplaceOrderSchema, validate, } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 import { perpRoutes } from "../perp";
 function parentTpSlLegToRequest(leg) {
@@ -839,4 +839,43 @@ export class TradingAPIImpl extends BaseAPI {
             pageToken: pageToken ?? "",
         }), { method: "GET" });
     }
+    /**
+     * Lists one TWAP parent's slices: the child orders it placed, each as
+     * `getOrder` returns it and carrying the parent's id in `parentOrderId`.
+     *
+     * Resting and finished slices are both listed, oldest first unless
+     * `orderBy: "DESC"`. A `PASSIVE` parent's reprices and deadline sweeps are
+     * child orders too, so a parent can have more slices than `slicesPlaced`.
+     * Cursor (pageToken) pagination is the only mode: follow `nextPageToken`
+     * until it comes back empty. Users can only access their own TWAP orders.
+     *
+     * @param twapOrderId - The TWAP parent order UUID
+     * @param params - Optional sort direction, page size (up to 1000) and cursor
+     * @returns Promise resolving to one page of slices
+     * @throws {APIError} When API communication fails or the TWAP order is not found
+     *
+     * @example
+     * ```typescript
+     * let pageToken = "";
+     * do {
+     *   const page = await tradingAPI.listTwapOrderSlices(twapOrderId, { pageSize: 100, pageToken });
+     *   for (const slice of page.slices) console.log(slice.id, slice.status, slice.filledQuantity);
+     *   pageToken = page.nextPageToken;
+     * } while (pageToken);
+     * ```
+     */
+    async listTwapOrderSlices(twapOrderId, params) {
+        // The positional id is what the path is built from, so it is what gets
+        // validated: a `twapOrderId` smuggled in through `params` must not stand
+        // in for it.
+        validate(ListTwapOrderSlicesSchema, { ...params, twapOrderId });
+        const { orderBy, pageSize = 20, pageToken } = params || {};
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.listTwapSlices(twapOrderId, {
+            orderBy,
+            pageSize,
+            // Sent even as the empty string: the server starts a walk on the
+            // token's PRESENCE, not its value.
+            pageToken: pageToken ?? "",
+        }), { method: "GET" });
+    }
 }

package/dist/api/websocket/websocket.js

@@ -16,6 +16,11 @@ const RECONNECT_BASE_DELAY = 1000;
  */
 const MAX_SKEW_AUTH_RETRIES = 3;
 const SKEW_REJECTION = /timestamp outside allowed skew/i;
+// The server's INVALID_MESSAGE texts when it refuses a whole Subscribe /
+// Unsubscribe for listing too many channels, after parsing it (ws-api
+// `oversized_channel_list_message`) or before (`too_many_elements_message`).
+// No ack follows either.
+const OVERSIZED_REQUEST = /^(?:(?:Subscribe|Unsubscribe) lists \d+ channels; at most \d+ per request|Message lists too many elements; at most \d+ channels per request)$/;
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -965,6 +970,20 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
     // subscriber unsubscribes — the next first subscriber triggers a fresh wire
     // Subscribe whose snapshot is authoritative, never the stale cache.
     const instrumentBaseline = new Map();
+    // `handlers` holds what the caller WANTS; this tracks what the server has
+    // acknowledged on the current socket. The server handles one connection's
+    // messages strictly in order and answers every Subscribe / Unsubscribe with
+    // an ack naming only the channels that request changed (a rejected or
+    // already-held channel is omitted), or, for an over-long one, with an
+    // INVALID_MESSAGE and no ack. So the oldest outstanding request is always
+    // the one being answered. All of it is per socket: a new connection starts
+    // with nothing confirmed and re-requests what is wanted.
+    const confirmedChannels = new Set();
+    let pendingRequests = [];
+    // Wanted channels the server rejected with AUTH_REQUIRED on this socket,
+    // re-requested once when the connection next authenticates.
+    const authRejectedChannels = new Set();
+    const subscriptionListeners = new Set();
     const getStatus = () => {
         if (!ws)
             return reconnectTimer ? "reconnecting" : "disconnected";
@@ -1104,16 +1123,74 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
             ws.send(JSON.stringify(data));
         }
     };
+    const sendSubscribe = (channels) => {
+        if (channels.length === 0 || ws?.readyState !== WebSocket.OPEN)
+            return;
+        pendingRequests.push({ kind: "subscribe", channels });
+        send({ type: "Subscribe", channels });
+    };
+    const sendUnsubscribe = (channels) => {
+        if (channels.length === 0 || ws?.readyState !== WebSocket.OPEN)
+            return;
+        pendingRequests.push({ kind: "unsubscribe", channels });
+        send({ type: "Unsubscribe", channels });
+    };
+    /** Forget everything the server confirmed or was asked on the old socket. */
+    const resetSubscriptionAcks = () => {
+        confirmedChannels.clear();
+        pendingRequests = [];
+        authRejectedChannels.clear();
+    };
+    const isRequested = (kind, channel) => pendingRequests.some((request) => request.kind === kind && request.channels.includes(channel));
+    const getSubscriptionState = (channel) => {
+        if (handlers.has(channel)) {
+            if (isRequested("subscribe", channel))
+                return "pending";
+            return confirmedChannels.has(channel) ? "subscribed" : "unconfirmed";
+        }
+        // Released: the server can still hold it only if it confirmed it, or if
+        // its Subscribe is still unanswered. An Unsubscribe alone proves nothing
+        // (the channel may have been rejected), so it does not count here.
+        if (confirmedChannels.has(channel) || isRequested("subscribe", channel))
+            return "unsubscribing";
+        return "idle";
+    };
+    /**
+     * Report a server-confirmed change. A listener's error is logged, never
+     * propagated: it must not stop the ack bookkeeping or other listeners.
+     */
+    const emitSubscriptionChange = (change) => {
+        const logListenerError = (err) => console.error("WebSocket: onSubscriptionChange listener threw", err);
+        for (const listener of subscriptionListeners) {
+            try {
+                const result = listener(change);
+                // An async listener is assignable to the void-returning type; log its
+                // rejection rather than leave it unhandled (any thenable, as in
+                // emitStatus).
+                if (typeof result?.then === "function") {
+                    Promise.resolve(result).catch(logListenerError);
+                }
+            }
+            catch (err) {
+                logListenerError(err);
+            }
+        }
+    };
+    const onSubscriptionChange = (listener) => {
+        subscriptionListeners.add(listener);
+        return () => {
+            subscriptionListeners.delete(listener);
+        };
+    };
+    /** Channel strings of an ack frame; anything malformed reads as none. */
+    const ackChannels = (raw) => (Array.isArray(raw) ? raw.filter((channel) => typeof channel === "string") : []);
     const resubscribeAll = () => {
         // Every re-sent Subscribe is genuinely new to the server (new
         // connection), so fresh authoritative snapshots are inbound: the
         // pre-outage instrument cache is stale — markets may have been delisted
         // during the gap — and must not be replayed to late subscribers.
         instrumentBaseline.clear();
-        const channels = Array.from(handlers.keys());
-        if (channels.length > 0) {
-            send({ type: "Subscribe", channels });
-        }
+        sendSubscribe(Array.from(handlers.keys()));
     };
     // A subscription channel matches a frame when it is identical, is a prefix of
     // the frame's dotted-by-colon path, or ends in a `:*` wildcard segment whose
@@ -1154,6 +1231,18 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
                 // frame just before the close; the close event decides from it.
                 // Recorded before any application code runs, so a throwing onError
                 // cannot make the close look transient.
+                // A wanted channel the server refused for want of authentication is
+                // retried once the connection authenticates.
+                if (msg.code === "AUTH_REQUIRED" && typeof msg.channel === "string" && handlers.has(msg.channel)) {
+                    authRejectedChannels.add(msg.channel);
+                }
+                // A Subscribe / Unsubscribe whose channel list is too long is refused
+                // whole with a connection-wide INVALID_MESSAGE and no ack. It is the
+                // oldest outstanding request: retire it, or every later ack would
+                // pair with the wrong request.
+                if (msg.code === "INVALID_MESSAGE" && OVERSIZED_REQUEST.test(msg.message)) {
+                    pendingRequests.shift();
+                }
                 if (msg.code === "AUTH_FAILED") {
                     lastAuthError = { code: msg.code, message: msg.message, session: pendingAuthSessions.shift() };
                 }
@@ -1174,6 +1263,42 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
         if (msg.type === "Authenticated") {
             confirmedSession = pendingAuthSessions.shift();
             skewAuthRetries = 0;
+            // Retry, once, each channel refused for want of authentication that is
+            // still wanted and neither held nor already re-requested.
+            const retry = Array.from(authRejectedChannels).filter((channel) => handlers.has(channel) && !confirmedChannels.has(channel) && !isRequested("subscribe", channel));
+            authRejectedChannels.clear();
+            sendSubscribe(retry);
+            return;
+        }
+        if (msg.type === "Subscribed") {
+            // It answers the oldest outstanding request; with none, or another
+            // kind, it is a duplicate or stray ack and changes nothing.
+            if (pendingRequests[0]?.kind !== "subscribe")
+                return;
+            const request = pendingRequests.shift()?.channels ?? [];
+            for (const channel of ackChannels(msg.channels)) {
+                if (!request.includes(channel))
+                    continue;
+                // The server holds it now, wanted or not; a channel released while
+                // its Subscribe was in flight is held until its Unsubscribe lands,
+                // and is never reported as subscribed.
+                confirmedChannels.add(channel);
+                if (handlers.has(channel)) {
+                    emitSubscriptionChange({ channel, state: "subscribed" });
+                }
+            }
+            return;
+        }
+        if (msg.type === "Unsubscribed") {
+            if (pendingRequests[0]?.kind !== "unsubscribe")
+                return;
+            const request = pendingRequests.shift()?.channels ?? [];
+            for (const channel of ackChannels(msg.channels)) {
+                if (!request.includes(channel))
+                    continue;
+                confirmedChannels.delete(channel);
+                emitSubscriptionChange({ channel, state: "unsubscribed" });
+            }
             return;
         }
         if (!msg.channel)
@@ -1210,6 +1335,7 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
                 lastAuthError = null;
                 pendingAuthSessions = [];
                 confirmedSession = undefined;
+                resetSubscriptionAcks();
                 const timeout = setTimeout(() => {
                     if (ws !== socket) {
                         resolve();
@@ -1282,6 +1408,8 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
                     }
                     ws = null;
                     stopHeartbeat();
+                    // The server dropped every subscription with the connection.
+                    resetSubscriptionAcks();
                     // Terminal authentication loss: the server revoked the session
                     // (SESSION_INVALID, then 1008) or rejected this connection's
                     // handshake (AUTH_FAILED, then a close). Reconnecting would replay
@@ -1375,6 +1503,7 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
         handlers.clear();
         snapshotHandlers.clear();
         instrumentBaseline.clear();
+        resetSubscriptionAcks();
         ws?.close(1000, "Client disconnect");
         ws = null;
         hasConnected = false;
@@ -1394,8 +1523,8 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
             snapshotHandlers.get(channel)?.add(snapshotHandler);
         }
         // Only send Subscribe message on first subscriber for this channel
-        if (isFirstSubscriber && ws?.readyState === WebSocket.OPEN) {
-            send({ type: "Subscribe", channels: [channel] });
+        if (isFirstSubscriber) {
+            sendSubscribe([channel]);
         }
         // Return unsubscribe function
         return () => {
@@ -1412,9 +1541,7 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
                 // Only send Unsubscribe on last subscriber for this channel
                 if (channelHandlers.size === 0) {
                     handlers.delete(channel);
-                    if (ws?.readyState === WebSocket.OPEN) {
-                        send({ type: "Unsubscribe", channels: [channel] });
-                    }
+                    sendUnsubscribe([channel]);
                 }
             }
         };
@@ -1997,6 +2124,8 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
         disconnect,
         isConnected: () => ws?.readyState === WebSocket.OPEN,
         getStatus,
+        getSubscriptionState,
+        onSubscriptionChange,
         setSessionKeypair: (credentials) => {
             session = credentials ?? undefined;
             skewAuthRetries = 0;

package/dist/coverage.d.ts

@@ -31,6 +31,7 @@ export declare const COVERED: {
     get_twap_order: string;
     get_twap_order_tca: string;
     list_twap_orders: string;
+    list_twap_order_slices: string;
     close_position: string;
     create_challenge: string;
     create_delegated_session: string;
@@ -149,4 +150,14 @@ export declare const COVERED: {
 /** operationId → reason it is intentionally not covered by @0xmonaco/core. */
 export declare const INTENTIONALLY_EXCLUDED: {
     health_check: string;
+    pitpass_get_my_trader_code: string;
+    pitpass_set_trader_code: string;
+    pitpass_clear_trader_code: string;
+    pitpass_check_trader_code_availability: string;
+    pitpass_get_trader_code_info: string;
+    pitpass_get_rewards_balance: string;
+    pitpass_transfer_rewards: string;
+    pitpass_get_my_referral_position: string;
+    pitpass_get_my_referral_downline: string;
+    pitpass_get_my_referral_tree: string;
 };

package/dist/coverage.js

@@ -31,6 +31,7 @@ export const COVERED = {
     get_twap_order: "getTwapOrder",
     get_twap_order_tca: "getTwapOrderTca",
     list_twap_orders: "listTwapOrders",
+    list_twap_order_slices: "listTwapOrderSlices",
     close_position: "closePosition",
     create_challenge: "createChallenge",
     create_delegated_session: "createDelegatedSession",
@@ -58,17 +59,17 @@ export const COVERED = {
     claim_managed_market_lease: "managedMarkets.claimLease",
     refresh_managed_market_quotes: "managedMarkets.refreshQuotes",
     get_sweeper_chains: "sweeper.getChains",
-    get_my_trader_code: "pitpass.getMyTraderCode",
-    get_rewards_balance: "pitpass.getRewardsBalance",
-    get_my_referral_position: "pitpass.getMyReferralPosition",
-    get_my_referral_downline: "pitpass.getMyReferralDownline",
-    get_my_referral_tree: "pitpass.getMyReferralTree",
+    get_my_trader_code: "tradercodes.getMyTraderCode",
+    get_rewards_balance: "tradercodes.getRewardsBalance",
+    get_my_referral_position: "tradercodes.getMyReferralPosition",
+    get_my_referral_downline: "tradercodes.getMyReferralDownline",
+    get_my_referral_tree: "tradercodes.getMyReferralTree",
     get_self_trade_prevention_default: "profile.getSelfTradePreventionDefault",
-    get_trader_code_info: "pitpass.getTraderCodeInfo",
+    get_trader_code_info: "tradercodes.getTraderCodeInfo",
     set_self_trade_prevention_default: "profile.setSelfTradePreventionDefault",
-    set_trader_code: "pitpass.setTraderCode",
-    clear_trader_code: "pitpass.clearTraderCode",
-    check_trader_code_availability: "pitpass.checkTraderCodeAvailability",
+    set_trader_code: "tradercodes.setTraderCode",
+    clear_trader_code: "tradercodes.clearTraderCode",
+    check_trader_code_availability: "tradercodes.checkTraderCodeAvailability",
     get_open_interest: "getOpenInterest",
     get_order_by_id: "getOrder",
     get_orderbook_snapshot: "getOrderbook",
@@ -141,7 +142,7 @@ export const COVERED = {
     transfer_collateral_from_sub_account: "transferCollateralFromSubAccount",
     claim_buildercode_rewards: "buildercodes.claimBuildercodeRewards",
     set_builder_fee: "buildercodes.setBuilderFee",
-    transfer_rewards: "pitpass.transferRewards",
+    transfer_rewards: "tradercodes.transferRewards",
     update_sub_account_limit: "subAccounts.updateLimit",
     upsert_delegated_agent: "upsertDelegatedAgent",
     verify_signature: "verifySignature",
@@ -149,4 +150,14 @@ export const COVERED = {
 /** operationId → reason it is intentionally not covered by @0xmonaco/core. */
 export const INTENTIONALLY_EXCLUDED = {
     health_check: "Infrastructure liveness probe (GET /health); not part of the data SDK surface.",
+    pitpass_get_my_trader_code: "Deprecated /api/v1/pitpass alias of get_my_trader_code; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_set_trader_code: "Deprecated /api/v1/pitpass alias of set_trader_code; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_clear_trader_code: "Deprecated /api/v1/pitpass alias of clear_trader_code; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_check_trader_code_availability: "Deprecated /api/v1/pitpass alias of check_trader_code_availability; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_get_trader_code_info: "Deprecated /api/v1/pitpass alias of get_trader_code_info; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_get_rewards_balance: "Deprecated /api/v1/pitpass alias of get_rewards_balance; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_transfer_rewards: "Deprecated /api/v1/pitpass alias of transfer_rewards; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_get_my_referral_position: "Deprecated /api/v1/pitpass alias of get_my_referral_position; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_get_my_referral_downline: "Deprecated /api/v1/pitpass alias of get_my_referral_downline; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
+    pitpass_get_my_referral_tree: "Deprecated /api/v1/pitpass alias of get_my_referral_tree; the client calls the canonical /api/v1/tradercodes path via tradercodes.",
 };

package/dist/sdk.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationsAPI, AuthAPI, AuthState, BuildercodesAPI, CopyTradingAPI, DelegatedAgentsAPI, FaucetAPI, FeesAPI, ManagedMarketsAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PortfolioAPI, PositionsAPI, ProfileAPI, PulseAPI, SDKConfig, SubAccountsAPI, SweeperAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
+import type { ApplicationsAPI, AuthAPI, AuthState, BuildercodesAPI, CopyTradingAPI, DelegatedAgentsAPI, FaucetAPI, FeesAPI, ManagedMarketsAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PortfolioAPI, PositionsAPI, ProfileAPI, PulseAPI, SDKConfig, SubAccountsAPI, SweeperAPI, TraderCodesAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
 import { type Address, type PublicClient, type TransactionReceipt, type WalletClient } from "viem";
 import { type MonacoWebSocket, OrderbookAPIImpl, TradesAPIImpl } from "./api";
 export declare class MonacoSDKImpl implements MonacoSDK {
@@ -8,6 +8,12 @@ export declare class MonacoSDKImpl implements MonacoSDK {
     fees: FeesAPI;
     buildercodes: BuildercodesAPI;
     copyTrading: CopyTradingAPI;
+    tradercodes: TraderCodesAPI;
+    /**
+     * The same instance as {@link tradercodes}.
+     *
+     * @deprecated Use `tradercodes`. Removed after at least two SDK releases.
+     */
     pitpass: PitpassAPI;
     vault: VaultAPI;
     withdrawals: WithdrawalsAPI;

package/dist/sdk.js

@@ -11,13 +11,13 @@ import { FeesAPIImpl } from "./api/fees";
 import { ManagedMarketsAPIImpl } from "./api/managed-markets";
 import { MarginAccountsAPIImpl } from "./api/margin-accounts";
 import { MarketAPIImpl } from "./api/market";
-import { PitpassAPIImpl } from "./api/pitpass";
 import { PortfolioAPIImpl } from "./api/portfolio";
 import { PositionsAPIImpl } from "./api/positions";
 import { ProfileAPIImpl } from "./api/profile";
 import { PulseAPIImpl } from "./api/pulse";
 import { SubAccountsAPIImpl } from "./api/sub-accounts";
 import { SweeperAPIImpl } from "./api/sweeper";
+import { TraderCodesAPIImpl } from "./api/tradercodes";
 import { TradingAPIImpl } from "./api/trading";
 import { VaultAPIImpl } from "./api/vault";
 import { WhitelistAPIImpl } from "./api/whitelist";
@@ -50,6 +50,12 @@ export class MonacoSDKImpl {
     fees;
     buildercodes;
     copyTrading;
+    tradercodes;
+    /**
+     * The same instance as {@link tradercodes}.
+     *
+     * @deprecated Use `tradercodes`. Removed after at least two SDK releases.
+     */
     pitpass;
     vault;
     withdrawals;
@@ -84,7 +90,7 @@ export class MonacoSDKImpl {
         this.fees.setSessionKeypair(credentials);
         this.buildercodes.setSessionKeypair(credentials);
         this.copyTrading.setSessionKeypair(credentials);
-        this.pitpass.setSessionKeypair(credentials);
+        this.tradercodes.setSessionKeypair(credentials);
         this.vault.setSessionKeypair(credentials);
         this.withdrawals.setSessionKeypair(credentials);
         this.trading.setSessionKeypair(credentials);
@@ -174,7 +180,9 @@ export class MonacoSDKImpl {
         this.fees = configureSigning(new FeesAPIImpl(apiUrl));
         this.buildercodes = configureSigning(new BuildercodesAPIImpl(apiUrl));
         this.copyTrading = configureSigning(new CopyTradingAPIImpl(apiUrl));
-        this.pitpass = configureSigning(new PitpassAPIImpl(apiUrl));
+        this.tradercodes = configureSigning(new TraderCodesAPIImpl(apiUrl));
+        // Deprecated alias: the same instance, so session and signing state are shared.
+        this.pitpass = this.tradercodes;
         this.profile = configureSigning(new ProfileAPIImpl(apiUrl));
         this.vault = configureSigning(new VaultAPIImpl(this.publicClient, this.walletClient, this.chain, this.applications, this.profile, apiUrl));
         this.withdrawals = configureSigning(new WithdrawalsAPIImpl(apiUrl));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.81",
+	"version": "1.0.82",
 	"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.81",
-		"@0xmonaco/types": "1.0.81",
+		"@0xmonaco/contracts": "1.0.82",
+		"@0xmonaco/types": "1.0.82",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"