@0xmonaco/core 1.0.56 → 1.0.58

package/dist/api/base.js

@@ -20,7 +20,7 @@
  * }
  * ```
  */
-import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils";
+import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils.js";
 import { StatusCodes } from "http-status-codes";
 import { buildHttpSignatureHeaders } from "../crypto/http-signatures";
 import { composeSigningString, keypairFromHex, sha256Hex, signMessage } from "../crypto/session";

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>;
     /**
@@ -257,6 +260,17 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * Each order is canceled and re-created with new parameters.
      * Failed replacements do not prevent other orders from being replaced.
      *
+     * Pre-sequencing validation is scoped per item too, matching `batchCreate`:
+     * a malformed `orderId`, `price`, `quantity` or `clientOrderId`, or a
+     * `postOnly` violation, fails only that item — its result slot carries a
+     * structured `error.code` (`INVALID_ORDER_ID`, `INVALID_PRICE`,
+     * `INVALID_QUANTITY`, `INVALID_CLIENT_ORDER_ID`, `INVALID_POST_ONLY`) and its
+     * original is left untouched — while the valid items proceed. A `2xx`
+     * response can therefore mix executed replacements and failed items: read
+     * `results[]` per item rather than treating the status code as the verdict.
+     * Only an empty or oversize (>100) batch rejects the whole request.
+     * `totalRequested === totalSucceeded + totalFailed` always holds.
+     *
      * @param orders - Array of order replacement parameters
      * @returns Promise resolving to BatchReplaceOrdersResponse with individual results
      * @throws {APIError} When API communication fails
@@ -281,6 +295,11 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * Gets orders based on query parameters, cursor-paginated by default.
      *
      * Retrieves orders with optional filtering by status, trading pair, and pagination.
+     * Every kind of order comes back in ONE stream ordered by timestamp: book orders,
+     * TWAP parents (`orderType: "TWAP"`, detail on `twap`) and conditional orders
+     * (`orderType: "CONDITIONAL"`, detail on `conditional`). There is no separate
+     * open-orders call — filter `status` to `["SUBMITTED", "PARTIALLY_FILLED"]` for the
+     * working set.
      * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
      * pagination: it starts a cursor walk from the newest (or oldest, for
      * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Cursor
@@ -305,6 +324,17 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      *
      * @example
      * ```typescript
+     * // Every working order, of every kind, in one page
+     * const open = await tradingAPI.getPaginatedOrders({ status: ["SUBMITTED", "PARTIALLY_FILLED"] });
+     * for (const order of open.orders) {
+     *   if (order.orderType === "TWAP") console.log("TWAP parent", order.twap?.slicesPlaced);
+     *   else if (order.orderType === "CONDITIONAL") console.log("trigger", order.conditional?.triggerPrice);
+     *   else console.log("resting", order.price);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
      * // Walk full order history with cursor pagination (the default mode)
      * let pageToken: string | undefined;
      * do {

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,
             })),
@@ -403,6 +409,17 @@ export class TradingAPIImpl extends BaseAPI {
      * Each order is canceled and re-created with new parameters.
      * Failed replacements do not prevent other orders from being replaced.
      *
+     * Pre-sequencing validation is scoped per item too, matching `batchCreate`:
+     * a malformed `orderId`, `price`, `quantity` or `clientOrderId`, or a
+     * `postOnly` violation, fails only that item — its result slot carries a
+     * structured `error.code` (`INVALID_ORDER_ID`, `INVALID_PRICE`,
+     * `INVALID_QUANTITY`, `INVALID_CLIENT_ORDER_ID`, `INVALID_POST_ONLY`) and its
+     * original is left untouched — while the valid items proceed. A `2xx`
+     * response can therefore mix executed replacements and failed items: read
+     * `results[]` per item rather than treating the status code as the verdict.
+     * Only an empty or oversize (>100) batch rejects the whole request.
+     * `totalRequested === totalSucceeded + totalFailed` always holds.
+     *
      * @param orders - Array of order replacement parameters
      * @returns Promise resolving to BatchReplaceOrdersResponse with individual results
      * @throws {APIError} When API communication fails
@@ -431,6 +448,7 @@ export class TradingAPIImpl extends BaseAPI {
                 quantity: order.quantity,
                 useMasterBalance: order.useMasterBalance,
                 postOnly: order.postOnly,
+                selfTradePreventionMode: order.selfTradePreventionMode,
                 clientOrderId: order.clientOrderId,
             })),
         };
@@ -443,6 +461,11 @@ export class TradingAPIImpl extends BaseAPI {
      * Gets orders based on query parameters, cursor-paginated by default.
      *
      * Retrieves orders with optional filtering by status, trading pair, and pagination.
+     * Every kind of order comes back in ONE stream ordered by timestamp: book orders,
+     * TWAP parents (`orderType: "TWAP"`, detail on `twap`) and conditional orders
+     * (`orderType: "CONDITIONAL"`, detail on `conditional`). There is no separate
+     * open-orders call — filter `status` to `["SUBMITTED", "PARTIALLY_FILLED"]` for the
+     * working set.
      * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
      * pagination: it starts a cursor walk from the newest (or oldest, for
      * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Cursor
@@ -467,6 +490,17 @@ export class TradingAPIImpl extends BaseAPI {
      *
      * @example
      * ```typescript
+     * // Every working order, of every kind, in one page
+     * const open = await tradingAPI.getPaginatedOrders({ status: ["SUBMITTED", "PARTIALLY_FILLED"] });
+     * for (const order of open.orders) {
+     *   if (order.orderType === "TWAP") console.log("TWAP parent", order.twap?.slicesPlaced);
+     *   else if (order.orderType === "CONDITIONAL") console.log("trigger", order.conditional?.triggerPrice);
+     *   else console.log("resting", order.price);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
      * // Walk full order history with cursor pagination (the default mode)
      * let pageToken: string | undefined;
      * do {

package/dist/api/websocket/websocket.js

@@ -1,4 +1,4 @@
-import { hexToBytes } from "@noble/hashes/utils";
+import { hexToBytes } from "@noble/hashes/utils.js";
 import { composeWsSigningString, signMessage } from "../../crypto/session";
 import { ALL_MAGNITUDES } from "../../utils";
 import { keysToCamelCase } from "./utils";
@@ -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/dist/crypto/http-signatures.js

@@ -1,7 +1,7 @@
 /** Monaco's RFC 9421 Ed25519 profile; key registration remains wallet-authorized. */
 import { ed25519 } from "@noble/curves/ed25519";
-import { sha256 } from "@noble/hashes/sha2";
-import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils";
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils.js";
 function base64(bytes) {
     return btoa(String.fromCharCode(...bytes));
 }

package/dist/crypto/session.js

@@ -8,8 +8,8 @@
  * key — it never sees the private key, so it cannot mint requests as the user.
  */
 import { ed25519 } from "@noble/curves/ed25519";
-import { sha256 } from "@noble/hashes/sha2";
-import { bytesToHex, hexToBytes, utf8ToBytes } from "@noble/hashes/utils";
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bytesToHex, hexToBytes, utf8ToBytes } from "@noble/hashes/utils.js";
 /**
  * Generate a fresh ed25519 session keypair.
  *

package/package.json

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