@0xmonaco/core 1.0.57 → 1.0.58

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

@@ -17,7 +17,7 @@
  * console.log(`User: ${profile.username} (${profile.address})`);
  * ```
  */
-import type { AccountBalance, GetPaginatedUserMovementsResponse, GetUserBalancesParams, GetUserBalancesResponse, GetUserMovementsParams, GetUserTradesParams, GetUserTradesResponse, ListFundingPaymentsParams, ListFundingPaymentsResponse, PortfolioChartResponse, PortfolioMetric, PortfolioPeriod, PortfolioStats, ProfileAPI, UserProfile } from "@0xmonaco/types";
+import type { AccountBalance, GetPaginatedUserMovementsResponse, GetUserBalancesParams, GetUserBalancesResponse, GetUserMovementsParams, GetUserTradesParams, GetUserTradesResponse, ListFundingPaymentsParams, ListFundingPaymentsResponse, PortfolioChartResponse, PortfolioMetric, PortfolioPeriod, PortfolioStats, ProfileAPI, SelfTradePreventionDefault, SelfTradePreventionMode, UserProfile } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
     /**
@@ -245,4 +245,42 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * ```
      */
     listFundingPayments(params?: ListFundingPaymentsParams): Promise<ListFundingPaymentsResponse>;
+    /**
+     * Get the wallet's self-trade-prevention default.
+     *
+     * Fetches the setting from the /api/v1/accounts/self-trade-prevention endpoint.
+     * Requires a valid access token to be set. The default is wallet-scoped: it
+     * covers every application and account sharing the wallet address, and a
+     * per-order mode always overrides it.
+     *
+     * @returns Promise resolving to the effective mode plus whether it was explicitly set
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const stp = await profileAPI.getSelfTradePreventionDefault();
+     * console.log(`Mode: ${stp.mode} (explicitly set: ${stp.isCustom})`);
+     * ```
+     */
+    getSelfTradePreventionDefault(): Promise<SelfTradePreventionDefault>;
+    /**
+     * Set the wallet's self-trade-prevention default.
+     *
+     * Sends a PUT to the /api/v1/accounts/self-trade-prevention endpoint. The
+     * write is sequenced through the matching engine; on success the wallet
+     * family's next order already resolves the new mode. Delegated-agent
+     * sessions cannot change it (403).
+     *
+     * @param mode - One of "CANCEL_MAKER", "CANCEL_TAKER", "CANCEL_BOTH", "SKIP"
+     * @returns Promise resolving to the setting now in force
+     * @throws ValidationError If mode is not a known token; this occurs before any network request.
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const stp = await profileAPI.setSelfTradePreventionDefault("SKIP");
+     * console.log(`Mode is now ${stp.mode}`);
+     * ```
+     */
+    setSelfTradePreventionDefault(mode: SelfTradePreventionMode): Promise<SelfTradePreventionDefault>;
 }

package/dist/api/profile/api.js

@@ -17,7 +17,7 @@
  * console.log(`User: ${profile.username} (${profile.address})`);
  * ```
  */
-import { GetUserMovementsSchema, GetUserTradesSchema, ListFundingPaymentsSchema, validate } from "@0xmonaco/types";
+import { GetUserMovementsSchema, GetUserTradesSchema, ListFundingPaymentsSchema, SetSelfTradePreventionDefaultSchema, validate } from "@0xmonaco/types";
 import { APIError } from "../../errors";
 import { BaseAPI } from "../base";
 export class ProfileAPIImpl extends BaseAPI {
@@ -360,4 +360,50 @@ export class ProfileAPIImpl extends BaseAPI {
         const url = queryString ? `/api/v1/accounts/funding-payments?${queryString}` : "/api/v1/accounts/funding-payments";
         return await this.makeAuthenticatedRequest(url);
     }
+    /**
+     * Get the wallet's self-trade-prevention default.
+     *
+     * Fetches the setting from the /api/v1/accounts/self-trade-prevention endpoint.
+     * Requires a valid access token to be set. The default is wallet-scoped: it
+     * covers every application and account sharing the wallet address, and a
+     * per-order mode always overrides it.
+     *
+     * @returns Promise resolving to the effective mode plus whether it was explicitly set
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const stp = await profileAPI.getSelfTradePreventionDefault();
+     * console.log(`Mode: ${stp.mode} (explicitly set: ${stp.isCustom})`);
+     * ```
+     */
+    async getSelfTradePreventionDefault() {
+        return await this.makeAuthenticatedRequest("/api/v1/accounts/self-trade-prevention");
+    }
+    /**
+     * Set the wallet's self-trade-prevention default.
+     *
+     * Sends a PUT to the /api/v1/accounts/self-trade-prevention endpoint. The
+     * write is sequenced through the matching engine; on success the wallet
+     * family's next order already resolves the new mode. Delegated-agent
+     * sessions cannot change it (403).
+     *
+     * @param mode - One of "CANCEL_MAKER", "CANCEL_TAKER", "CANCEL_BOTH", "SKIP"
+     * @returns Promise resolving to the setting now in force
+     * @throws ValidationError If mode is not a known token; this occurs before any network request.
+     * @throws {APIError} When the request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const stp = await profileAPI.setSelfTradePreventionDefault("SKIP");
+     * console.log(`Mode is now ${stp.mode}`);
+     * ```
+     */
+    async setSelfTradePreventionDefault(mode) {
+        const validated = validate(SetSelfTradePreventionDefaultSchema, { mode });
+        return await this.makeAuthenticatedRequest("/api/v1/accounts/self-trade-prevention", {
+            method: "PUT",
+            body: JSON.stringify(validated),
+        });
+    }
 }

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, PositionSide, ReplaceOrderResponse, 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, ListTwapOrdersParams, ListTwapOrdersResponse, MarginMode, OrderSide, ParentTpSlLegParams, PositionSide, ReplaceOrderResponse, SelfTradePreventionMode, TimeInForce, TradingAPI, TradingMode, TwapOrder } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
     /**
@@ -88,6 +88,7 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
         leverage?: string;
         reduceOnly?: boolean;
         postOnly?: boolean;
+        selfTradePreventionMode?: SelfTradePreventionMode;
         clientOrderId?: string;
         /** Generated once per call when omitted. Supply the same key to retry a logical order within 24 hours. */
         idempotencyKey?: string;
@@ -148,6 +149,7 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
+        selfTradePreventionMode?: SelfTradePreventionMode;
         takeProfit?: ParentTpSlLegParams;
         stopLoss?: ParentTpSlLegParams;
         clientOrderId?: string;
@@ -218,6 +220,7 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
         quantity?: string;
         useMasterBalance?: boolean;
         postOnly?: boolean;
+        selfTradePreventionMode?: SelfTradePreventionMode;
         clientOrderId?: string;
     }): Promise<ReplaceOrderResponse>;
     /**

package/dist/api/trading/api.js

@@ -120,6 +120,7 @@ export class TradingAPIImpl extends BaseAPI {
             leverage: options?.leverage,
             reduceOnly: options?.reduceOnly,
             postOnly: options?.postOnly,
+            selfTradePreventionMode: options?.selfTradePreventionMode,
             clientOrderId: options?.clientOrderId,
             idempotencyKey: options?.idempotencyKey === undefined ? crypto.randomUUID() : options.idempotencyKey,
             takeProfit: parentTpSlLegToRequest(options?.takeProfit),
@@ -197,6 +198,7 @@ export class TradingAPIImpl extends BaseAPI {
             positionSide: options?.positionSide,
             leverage: options?.leverage,
             reduceOnly: options?.reduceOnly,
+            selfTradePreventionMode: options?.selfTradePreventionMode,
             takeProfit: parentTpSlLegToRequest(options?.takeProfit),
             stopLoss: parentTpSlLegToRequest(options?.stopLoss),
             clientOrderId: options?.clientOrderId,
@@ -327,6 +329,9 @@ export class TradingAPIImpl extends BaseAPI {
         if (newOrder.postOnly !== undefined) {
             requestBody.postOnly = newOrder.postOnly;
         }
+        if (newOrder.selfTradePreventionMode !== undefined) {
+            requestBody.selfTradePreventionMode = newOrder.selfTradePreventionMode;
+        }
         if (newOrder.clientOrderId !== undefined) {
             requestBody.clientOrderId = newOrder.clientOrderId;
         }
@@ -388,6 +393,7 @@ export class TradingAPIImpl extends BaseAPI {
                 leverage: order.leverage,
                 reduceOnly: order.reduceOnly,
                 postOnly: order.postOnly,
+                selfTradePreventionMode: order.selfTradePreventionMode,
                 clientOrderId: order.clientOrderId,
                 idempotencyKey: order.idempotencyKey === undefined ? crypto.randomUUID() : order.idempotencyKey,
             })),
@@ -442,6 +448,7 @@ export class TradingAPIImpl extends BaseAPI {
                 quantity: order.quantity,
                 useMasterBalance: order.useMasterBalance,
                 postOnly: order.postOnly,
+                selfTradePreventionMode: order.selfTradePreventionMode,
                 clientOrderId: order.clientOrderId,
             })),
         };

package/dist/api/websocket/websocket.js

@@ -543,6 +543,7 @@ function parseOrderSnapshotItem(raw) {
     // conditionally so an absent one stays absent rather than becoming
     // `clientOrderId: undefined`, which a structural comparison would see.
     const clientOrderId = readOptionalString(item, "clientOrderId");
+    const selfTradePreventionMode = readOptionalString(item, "selfTradePreventionMode");
     const version = readOptionalNumber(item, "version");
     return {
         orderId: readString(item, "orderId"),
@@ -574,6 +575,9 @@ function parseOrderSnapshotItem(raw) {
         leverage: readNullableString(item, "leverage"),
         reduceOnly: readBoolean(item, "reduceOnly"),
         ...(clientOrderId === undefined ? {} : { clientOrderId }),
+        // Spread in conditionally like `clientOrderId`: absent means the order
+        // requested no override, and must stay absent (0XM-2733).
+        ...(selfTradePreventionMode === undefined ? {} : { selfTradePreventionMode }),
         // Spread in conditionally for the same reason as `clientOrderId`: the
         // server omits the key when unknown, and absent must stay absent rather
         // than becoming `version: undefined` — a resync compares this value, and

package/dist/coverage.d.ts

@@ -38,7 +38,9 @@ export declare const COVERED: {
     get_sweeper_chains: string;
     get_my_trader_code: string;
     get_rewards_balance: string;
+    get_self_trade_prevention_default: string;
     get_trader_code_info: string;
+    set_self_trade_prevention_default: string;
     set_trader_code: string;
     clear_trader_code: string;
     check_trader_code_availability: string;

package/dist/coverage.js

@@ -38,7 +38,9 @@ export const COVERED = {
     get_sweeper_chains: "sweeper.getChains",
     get_my_trader_code: "pitpass.getMyTraderCode",
     get_rewards_balance: "pitpass.getRewardsBalance",
+    get_self_trade_prevention_default: "profile.getSelfTradePreventionDefault",
     get_trader_code_info: "pitpass.getTraderCodeInfo",
+    set_self_trade_prevention_default: "profile.setSelfTradePreventionDefault",
     set_trader_code: "pitpass.setTraderCode",
     clear_trader_code: "pitpass.clearTraderCode",
     check_trader_code_availability: "pitpass.checkTraderCodeAvailability",

package/package.json

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