@0xmonaco/core 1.1.5-develop.129b2c6 → 1.1.5

package/dist/api/applications/api.d.ts

@@ -56,7 +56,7 @@ export declare class ApplicationsAPIImpl extends BaseAPI implements Applications
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of orders
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     listApplicationOrders(params: ListAppOrdersParams): Promise<ListAppOrdersResponse>;
     /**
@@ -74,7 +74,7 @@ export declare class ApplicationsAPIImpl extends BaseAPI implements Applications
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of users
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     listApplicationUsers(params: ListAppUsersParams): Promise<ListAppUsersResponse>;
     /**
@@ -92,7 +92,7 @@ export declare class ApplicationsAPIImpl extends BaseAPI implements Applications
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of movements
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     listApplicationMovements(params: ListAppMovementsParams): Promise<ListAppMovementsResponse>;
     /**
@@ -110,7 +110,7 @@ export declare class ApplicationsAPIImpl extends BaseAPI implements Applications
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of balances
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     listApplicationBalances(params: ListAppBalancesParams): Promise<ListAppBalancesResponse>;
     /**
@@ -121,7 +121,7 @@ export declare class ApplicationsAPIImpl extends BaseAPI implements Applications
      *
      * @param params - Optional `since` filter
      * @returns Promise resolving to the application stats
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     getApplicationStats(params: GetAppStatsParams): Promise<GetAppStatsResponse>;
 }

package/dist/api/applications/api.js

@@ -69,7 +69,7 @@ export class ApplicationsAPIImpl extends BaseAPI {
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of orders
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     async listApplicationOrders(params) {
         validate(ListAppOrdersSchema, params);
@@ -99,7 +99,7 @@ export class ApplicationsAPIImpl extends BaseAPI {
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of users
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     async listApplicationUsers(params) {
         validate(ListAppUsersSchema, params);
@@ -127,7 +127,7 @@ export class ApplicationsAPIImpl extends BaseAPI {
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of movements
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     async listApplicationMovements(params) {
         validate(ListAppMovementsSchema, params);
@@ -156,7 +156,7 @@ export class ApplicationsAPIImpl extends BaseAPI {
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of balances
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     async listApplicationBalances(params) {
         validate(ListAppBalancesSchema, params);
@@ -176,7 +176,7 @@ export class ApplicationsAPIImpl extends BaseAPI {
      *
      * @param params - Optional `since` filter
      * @returns Promise resolving to the application stats
-     * @throws {APIError} When the request fails (404 for an unknown, inactive or hidden client ID, 429 when rate limited)
+     * @throws {APIError} When the request fails (404 for an unknown client ID, 429 when rate limited)
      */
     async getApplicationStats(params) {
         return await this.makePublicRequest(perpRoutes.applications.stats({ clientId: params.clientId, since: params.since }));

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

@@ -14,7 +14,6 @@
  * const result = await sdk.buildercodes.claimBuildercodeRewards({
  *   token: "0x0000000000000000000000000000000000000002",
  *   amount: "1000000",
- *   idempotencyKey: crypto.randomUUID(), // keep it across retries of this claim
  * });
  * console.log(`Payout remaining: ${result.payoutBalance}`);
  * console.log(`Now tradeable: ${result.tradingBalance}`);
@@ -79,24 +78,18 @@ export declare class BuildercodesAPIImpl extends BaseAPI implements Buildercodes
      * Throws 503 when the matching engine is unreachable, restarting, or slow to
      * answer. Treat that as an UNKNOWN outcome rather than a rejection: the claim
      * is admitted to the sequencer before its reply is sent, so it may still
-     * commit.
+     * commit, and there is no idempotency key — a blind retry can claim twice.
+     * Do not retry automatically, and do not settle it with a balance read: an
+     * admitted claim can still be queued, so an unchanged balance does not prove
+     * it will not commit. Treat the claim as pending and reconcile first.
      *
-     * Pass `idempotencyKey` to make that retry safe: the same key and claim
-     * retried within 15 minutes returns the first claim's result without moving
-     * money again, so a keyed claim's 5xx keeps the SDK's usual `retryable`
-     * flag. The same key with a different claim throws 409
-     * `IDEMPOTENCY_KEY_CONFLICT`.
-     *
-     * Without a key a blind retry can claim twice. Do not retry automatically,
-     * and do not settle it with a balance read: an admitted claim can still be
-     * queued, so an unchanged balance does not prove it will not commit. Treat
-     * the claim as pending and reconcile first. Because that warning has to hold
-     * for code as well as readers, an unkeyed claim's ambiguous failure (any 5xx,
-     * or a network error with no response at all) is thrown with
-     * `retryable: false`, against the SDK's usual "every 5xx is retryable" rule.
-     * A pre-admission rejection is exempt and stays retryable: a maintenance
-     * block, and a sequencer overload (`code: "OVERLOADED"`), both of which are
-     * refused before the claim is queued and so committed nothing.
+     * Because that warning has to hold for code as well as readers, an ambiguous
+     * failure (any 5xx, or a network error with no response at all) is thrown
+     * with `retryable: false`, against the SDK's usual "every 5xx is retryable"
+     * rule, so a caller driving retries off that flag cannot claim twice. A
+     * pre-admission rejection is exempt and stays retryable: a maintenance block,
+     * and a sequencer overload (`code: "OVERLOADED"`), both of which are refused
+     * before the claim is queued and so committed nothing.
      */
     claimBuildercodeRewards(params: ClaimBuildercodeRewardsParams): Promise<ClaimBuildercodeRewardsResponse>;
 }

package/dist/api/buildercodes/api.js

@@ -14,7 +14,6 @@
  * const result = await sdk.buildercodes.claimBuildercodeRewards({
  *   token: "0x0000000000000000000000000000000000000002",
  *   amount: "1000000",
- *   idempotencyKey: crypto.randomUUID(), // keep it across retries of this claim
  * });
  * console.log(`Payout remaining: ${result.payoutBalance}`);
  * console.log(`Now tradeable: ${result.tradingBalance}`);
@@ -37,9 +36,9 @@ const MAINTENANCE_BLOCK_ERROR = "OPERATIONS_BLOCKED";
  */
 const OVERLOADED_ENGINE_CODE = "OVERLOADED";
 /**
- * Clear `retryable` on an unkeyed claim failure whose outcome is UNKNOWN.
+ * Clear `retryable` on a claim failure whose outcome is UNKNOWN.
  *
- * An unkeyed claim is not idempotent and is admitted to the sequencer before its reply
+ * A claim is not idempotent and is admitted to the sequencer before its reply
  * is sent, so a 5xx or a dropped connection can arrive after the claim already
  * committed. `APIError` classifies every 5xx and every network failure as
  * `retryable: true`, and the documented consumer pattern retries whenever that
@@ -72,7 +71,7 @@ function markAmbiguousOutcomeNonRetryable(error) {
     }
     error.retryable = false;
     error.suggestion =
-        "The claim's outcome is unknown: it may have committed after this failure. Do not retry automatically, and do not rely on a balance read to decide — an admitted claim can still be queued, so an unchanged balance does not prove it will not commit. Treat the claim as pending and reconcile before issuing another; this claim carried no idempotencyKey, so a retry can claim a second time. Send one to make retries safe.";
+        "The claim's outcome is unknown: it may have committed after this failure. Do not retry automatically, and do not rely on a balance read to decide — an admitted claim can still be queued, so an unchanged balance does not prove it will not commit. Treat the claim as pending and reconcile before issuing another; this endpoint has no idempotency key, so a retry can claim a second time.";
     return error;
 }
 /**
@@ -193,43 +192,28 @@ export class BuildercodesAPIImpl extends BaseAPI {
      * Throws 503 when the matching engine is unreachable, restarting, or slow to
      * answer. Treat that as an UNKNOWN outcome rather than a rejection: the claim
      * is admitted to the sequencer before its reply is sent, so it may still
-     * commit.
+     * commit, and there is no idempotency key — a blind retry can claim twice.
+     * Do not retry automatically, and do not settle it with a balance read: an
+     * admitted claim can still be queued, so an unchanged balance does not prove
+     * it will not commit. Treat the claim as pending and reconcile first.
      *
-     * Pass `idempotencyKey` to make that retry safe: the same key and claim
-     * retried within 15 minutes returns the first claim's result without moving
-     * money again, so a keyed claim's 5xx keeps the SDK's usual `retryable`
-     * flag. The same key with a different claim throws 409
-     * `IDEMPOTENCY_KEY_CONFLICT`.
-     *
-     * Without a key a blind retry can claim twice. Do not retry automatically,
-     * and do not settle it with a balance read: an admitted claim can still be
-     * queued, so an unchanged balance does not prove it will not commit. Treat
-     * the claim as pending and reconcile first. Because that warning has to hold
-     * for code as well as readers, an unkeyed claim's ambiguous failure (any 5xx,
-     * or a network error with no response at all) is thrown with
-     * `retryable: false`, against the SDK's usual "every 5xx is retryable" rule.
-     * A pre-admission rejection is exempt and stays retryable: a maintenance
-     * block, and a sequencer overload (`code: "OVERLOADED"`), both of which are
-     * refused before the claim is queued and so committed nothing.
+     * Because that warning has to hold for code as well as readers, an ambiguous
+     * failure (any 5xx, or a network error with no response at all) is thrown
+     * with `retryable: false`, against the SDK's usual "every 5xx is retryable"
+     * rule, so a caller driving retries off that flag cannot claim twice. A
+     * pre-admission rejection is exempt and stays retryable: a maintenance block,
+     * and a sequencer overload (`code: "OVERLOADED"`), both of which are refused
+     * before the claim is queued and so committed nothing.
      */
     async claimBuildercodeRewards(params) {
         const validated = validate(ClaimBuildercodeRewardsParamsSchema, params);
-        const body = validated.idempotencyKey === undefined
-            ? { token: validated.token, amount: validated.amount }
-            : { token: validated.token, amount: validated.amount, idempotencyKey: validated.idempotencyKey };
         try {
             return await this.makeAuthenticatedRequest("/api/v1/buildercodes/rewards/claim", {
                 method: "POST",
-                body: JSON.stringify(body),
+                body: JSON.stringify({ token: validated.token, amount: validated.amount }),
             });
         }
         catch (error) {
-            // A keyed claim retried under the same key returns the first claim's
-            // result instead of claiming again, so its 5xx keeps the flag `APIError`
-            // gave it.
-            if (validated.idempotencyKey !== undefined) {
-                throw error;
-            }
             throw markAmbiguousOutcomeNonRetryable(error);
         }
     }

package/dist/api/index.d.ts

@@ -3,7 +3,6 @@
  *
  * This module exports the new simplified APIs for the Monaco SDK.
  */
-export * from "./analytics";
 export * from "./applications/index";
 export * from "./base";
 export * from "./buildercodes";

package/dist/api/index.js

@@ -3,7 +3,6 @@
  *
  * This module exports the new simplified APIs for the Monaco SDK.
  */
-export * from "./analytics";
 export * from "./applications/index";
 export * from "./base";
 export * from "./buildercodes";

package/dist/api/orderbook/api.d.ts

@@ -1,10 +1,7 @@
 import type { OrderbookEvent, OrderbookQuotationMode, TradingMode } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export interface GetOrderbookOptions {
-    /**
-     * Number of price levels per side (max 1000). Defaults to 10. Above 100 the
-     * snapshot comes from the market-data book and carries `bookSeq`.
-     */
+    /** Number of price levels to return (max 100). Defaults to 10. */
     depth?: number;
     /** Trading mode: 'Spot' or 'Margin'. Defaults to 'Spot'. */
     tradingMode?: TradingMode;

package/dist/api/orderbook/api.js

@@ -33,8 +33,6 @@ export class OrderbookAPIImpl extends BaseAPI {
             quoteDecimals: response.quoteDecimals,
             timestamp: response.timestamp,
             sequence: response.sequenceNumber,
-            // Kept as the wire's decimal string: a u64 can exceed Number.MAX_SAFE_INTEGER.
-            ...(response.bookSeq != null ? { bookSeq: response.bookSeq } : {}),
         };
     }
 }

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

@@ -1,59 +1,4 @@
 export declare const perpRoutes: {
-    readonly analytics: {
-        readonly protocolTotals: (params?: {
-            window?: string;
-            startTime?: number;
-            endTime?: number;
-        }) => string;
-        readonly protocolSeries: (params?: {
-            window?: string;
-            startTime?: number;
-            endTime?: number;
-        }) => string;
-        readonly marketVolumes: (params?: {
-            window?: string;
-            startTime?: number;
-            endTime?: number;
-            limit?: number;
-        }) => string;
-        readonly treasuryNetFees: () => string;
-        readonly builders: () => string;
-        readonly builder: (builder: string) => string;
-        readonly builderTotals: (builder: string, params?: {
-            window?: string;
-            startTime?: number;
-            endTime?: number;
-        }) => string;
-        readonly builderSeries: (builder: string, params?: {
-            window?: string;
-            startTime?: number;
-            endTime?: number;
-        }) => string;
-        readonly builderLeaderboard: (params?: {
-            window?: string;
-            startTime?: number;
-            endTime?: number;
-            limit?: number;
-        }) => string;
-        readonly walletLeaderboard: (params?: {
-            limit?: number;
-        }) => string;
-        readonly walletSummary: (wallet: string) => string;
-        readonly walletLiquidations: (wallet: string, params?: {
-            pageSize?: number;
-            pageToken?: string;
-        }) => string;
-        readonly tokenCustody: () => string;
-        readonly tokenCustodyDetail: (token: string) => string;
-        readonly vaultDeposits: (params?: {
-            pageSize?: number;
-            pageToken?: string;
-        }) => string;
-        readonly vaultWithdrawals: (params?: {
-            pageSize?: number;
-            pageToken?: string;
-        }) => string;
-    };
     readonly orders: {
         readonly create: () => string;
         readonly list: (params?: {

package/dist/api/perp/routes.js

@@ -15,24 +15,6 @@ function withQuery(path, params) {
     return query ? `${path}?${query}` : path;
 }
 export const perpRoutes = {
-    analytics: {
-        protocolTotals: (params) => withQuery(`${API_V1}/analytics/protocol/totals`, params),
-        protocolSeries: (params) => withQuery(`${API_V1}/analytics/protocol/series`, params),
-        marketVolumes: (params) => withQuery(`${API_V1}/analytics/markets/volume`, params),
-        treasuryNetFees: () => `${API_V1}/analytics/treasury/net-fees`,
-        builders: () => `${API_V1}/analytics/builders`,
-        builder: (builder) => `${API_V1}/analytics/builders/${encodeURIComponent(builder)}`,
-        builderTotals: (builder, params) => withQuery(`${API_V1}/analytics/builders/${encodeURIComponent(builder)}/totals`, params),
-        builderSeries: (builder, params) => withQuery(`${API_V1}/analytics/builders/${encodeURIComponent(builder)}/series`, params),
-        builderLeaderboard: (params) => withQuery(`${API_V1}/analytics/builder-leaderboard`, params),
-        walletLeaderboard: (params) => withQuery(`${API_V1}/analytics/wallet-leaderboard`, params),
-        walletSummary: (wallet) => `${API_V1}/analytics/wallets/${encodeSegment(wallet)}`,
-        walletLiquidations: (wallet, params) => withQuery(`${API_V1}/analytics/wallets/${encodeSegment(wallet)}/liquidations`, params),
-        tokenCustody: () => `${API_V1}/analytics/tokens`,
-        tokenCustodyDetail: (token) => `${API_V1}/analytics/tokens/${encodeSegment(token)}`,
-        vaultDeposits: (params) => withQuery(`${API_V1}/analytics/deposits`, params),
-        vaultWithdrawals: (params) => withQuery(`${API_V1}/analytics/withdrawals`, params),
-    },
     orders: {
         create: () => `${API_V1}/orders`,
         list: (params) => withQuery(`${API_V1}/orders`, params),

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

@@ -41,7 +41,7 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * @param quantity - The order quantity as string
      * @param price - The limit price as string
      * @param options - Optional parameters for the limit order
-     * @param options.tradingMode - Trading mode ("SPOT" or "MARGIN"). Omit it to use the trading pair market type.
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
      * @param options.useMasterBalance - Whether to use master balance for sub-accounts
      * @param options.expirationDate - Optional expiration date for GTC orders (ISO 8601 format)
      * @param options.timeInForce - Time in force ("GTC", "IOC", or "FOK")
@@ -115,7 +115,7 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * @param side - The order side ("BUY" or "SELL")
      * @param quantity - The order quantity as string
      * @param options - Optional parameters for the market order
-     * @param options.tradingMode - Trading mode ("SPOT" or "MARGIN"). Omit it to use the trading pair market type.
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
      * @param options.slippageTolerance - Tightens the mandatory 1,000 bps price band, as a decimal (e.g., 0.01 for 1%; 0 for best price only). It can only tighten the band, never widen it; omitting it applies the full 1,000 bps band.
      * @returns Promise resolving to CreateOrderResponse with order details
      *

package/dist/api/trading/api.js

@@ -77,7 +77,7 @@ export class TradingAPIImpl extends BaseAPI {
      * @param quantity - The order quantity as string
      * @param price - The limit price as string
      * @param options - Optional parameters for the limit order
-     * @param options.tradingMode - Trading mode ("SPOT" or "MARGIN"). Omit it to use the trading pair market type.
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
      * @param options.useMasterBalance - Whether to use master balance for sub-accounts
      * @param options.expirationDate - Optional expiration date for GTC orders (ISO 8601 format)
      * @param options.timeInForce - Time in force ("GTC", "IOC", or "FOK")
@@ -131,7 +131,7 @@ export class TradingAPIImpl extends BaseAPI {
             side,
             price,
             quantity,
-            tradingMode: options?.tradingMode,
+            tradingMode: options?.tradingMode || "SPOT",
             useMasterBalance: options?.useMasterBalance,
             expirationDate: options?.expirationDate,
             timeInForce: options?.timeInForce,
@@ -165,7 +165,7 @@ export class TradingAPIImpl extends BaseAPI {
      * @param side - The order side ("BUY" or "SELL")
      * @param quantity - The order quantity as string
      * @param options - Optional parameters for the market order
-     * @param options.tradingMode - Trading mode ("SPOT" or "MARGIN"). Omit it to use the trading pair market type.
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
      * @param options.slippageTolerance - Tightens the mandatory 1,000 bps price band, as a decimal (e.g., 0.01 for 1%; 0 for best price only). It can only tighten the band, never widen it; omitting it applies the full 1,000 bps band.
      * @returns Promise resolving to CreateOrderResponse with order details
      *
@@ -211,7 +211,7 @@ export class TradingAPIImpl extends BaseAPI {
             slippageToleranceBps: options?.slippageTolerance !== undefined ? Math.round(options.slippageTolerance * 10000) : undefined,
             price: null, // Market orders don't need price
             quantity,
-            tradingMode: options?.tradingMode,
+            tradingMode: options?.tradingMode || "SPOT",
             marginAccountId: options?.marginAccountId,
             marginMode: options?.marginMode,
             riskBucketId: options?.riskBucketId,
@@ -460,7 +460,7 @@ export class TradingAPIImpl extends BaseAPI {
                 side: order.side,
                 price: order.price,
                 quantity: order.quantity,
-                tradingMode: order.tradingMode,
+                tradingMode: order.tradingMode || "SPOT",
                 slippageToleranceBps: order.slippageTolerance !== undefined ? Math.round(order.slippageTolerance * 10000) : undefined,
                 useMasterBalance: order.useMasterBalance,
                 expirationDate: order.expirationDate,
@@ -761,7 +761,7 @@ export class TradingAPIImpl extends BaseAPI {
             slippageToleranceBps: options.slippageToleranceBps,
             randomize: options.randomize,
             reduceOnly: options.reduceOnly,
-            tradingMode: options.tradingMode,
+            tradingMode: options.tradingMode || "SPOT",
             marginAccountId: options.marginAccountId,
             riskBucketId: options.riskBucketId,
             marginMode: options.marginMode,