@0xmonaco/types 1.0.57 → 1.0.58-develop.f12e78b

package/dist/validation/trading.d.ts

@@ -43,6 +43,15 @@ export declare const ConditionalTimeInForceSchema: z.ZodEnum<{
     GTC: "GTC";
     IOC: "IOC";
 }>;
+/**
+ * Per-order self-trade-prevention override validation
+ */
+export declare const SelfTradePreventionModeSchema: z.ZodEnum<{
+    CANCEL_MAKER: "CANCEL_MAKER";
+    CANCEL_TAKER: "CANCEL_TAKER";
+    CANCEL_BOTH: "CANCEL_BOTH";
+    SKIP: "SKIP";
+}>;
 /**
  * Order type validation
  */
@@ -126,6 +135,12 @@ export declare const PlaceLimitOrderSchema: z.ZodObject<{
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
         takeProfit: z.ZodOptional<z.ZodObject<{
             triggerPrice: z.ZodString;
             orderType: z.ZodEnum<{
@@ -192,6 +207,12 @@ export declare const PlaceMarketOrderSchema: z.ZodObject<{
         }>>;
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
         takeProfit: z.ZodOptional<z.ZodObject<{
             triggerPrice: z.ZodString;
             orderType: z.ZodEnum<{
@@ -248,6 +269,12 @@ export declare const ReplaceOrderSchema: z.ZodObject<{
         quantity: z.ZodOptional<z.ZodString>;
         useMasterBalance: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
@@ -437,6 +464,12 @@ export declare const BatchCreateOrderItemSchema: z.ZodObject<{
     leverage: z.ZodOptional<z.ZodString>;
     reduceOnly: z.ZodOptional<z.ZodBoolean>;
     postOnly: z.ZodOptional<z.ZodBoolean>;
+    selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+        CANCEL_MAKER: "CANCEL_MAKER";
+        CANCEL_TAKER: "CANCEL_TAKER";
+        CANCEL_BOTH: "CANCEL_BOTH";
+        SKIP: "SKIP";
+    }>>;
 }, z.core.$strip>;
 /**
  * Maximum items per batch create/replace/cancel request. Mirrors the server's
@@ -491,6 +524,12 @@ export declare const BatchCreateOrdersSchema: z.ZodObject<{
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -505,6 +544,12 @@ export declare const BatchReplaceOrderItemSchema: z.ZodObject<{
     quantity: z.ZodOptional<z.ZodString>;
     useMasterBalance: z.ZodOptional<z.ZodBoolean>;
     postOnly: z.ZodOptional<z.ZodBoolean>;
+    selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+        CANCEL_MAKER: "CANCEL_MAKER";
+        CANCEL_TAKER: "CANCEL_TAKER";
+        CANCEL_BOTH: "CANCEL_BOTH";
+        SKIP: "SKIP";
+    }>>;
 }, z.core.$strip>;
 /**
  * Batch Replace Orders validation schema
@@ -518,5 +563,11 @@ export declare const BatchReplaceOrdersSchema: z.ZodObject<{
         quantity: z.ZodOptional<z.ZodString>;
         useMasterBalance: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/validation/trading.js

@@ -36,6 +36,12 @@ export const TimeInForceSchema = z.enum(["GTC", "IOC", "FOK"], {
 export const ConditionalTimeInForceSchema = z.enum(["GTC", "IOC"], {
     message: 'Conditional order time in force must be "GTC" or "IOC"',
 });
+/**
+ * Per-order self-trade-prevention override validation
+ */
+export const SelfTradePreventionModeSchema = z.enum(["CANCEL_MAKER", "CANCEL_TAKER", "CANCEL_BOTH", "SKIP"], {
+    message: 'Self-trade prevention mode must be "CANCEL_MAKER", "CANCEL_TAKER", "CANCEL_BOTH", or "SKIP"',
+});
 /**
  * Order type validation
  */
@@ -153,6 +159,7 @@ export const PlaceLimitOrderSchema = z
         leverage: PositiveDecimalStringSchema.optional(),
         reduceOnly: z.boolean().optional(),
         postOnly: z.boolean().optional(),
+        selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
         takeProfit: ParentTpSlLegSchema.optional(),
         stopLoss: ParentTpSlLegSchema.optional(),
     })
@@ -231,6 +238,7 @@ export const PlaceMarketOrderSchema = z
         positionSide: PositionSideSchema.optional(),
         leverage: PositiveDecimalStringSchema.optional(),
         reduceOnly: z.boolean().optional(),
+        selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
         takeProfit: ParentTpSlLegSchema.optional(),
         stopLoss: ParentTpSlLegSchema.optional(),
     })
@@ -316,6 +324,8 @@ export const ReplaceOrderSchema = z.object({
         // replaceable fields — the server validates postOnly against the
         // persisted original order, which this client-side schema cannot see.
         postOnly: z.boolean().optional(),
+        // Re-stated per replace, never inherited from the original order.
+        selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
     }),
 });
 /**
@@ -530,6 +540,7 @@ export const BatchCreateOrderItemSchema = z
     leverage: PositiveDecimalStringSchema.optional(),
     reduceOnly: z.boolean().optional(),
     postOnly: z.boolean().optional(),
+    selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
 })
     .refine((data) => data.orderType !== "LIMIT" || data.price !== undefined, {
     message: "Price is required for LIMIT orders",
@@ -624,6 +635,8 @@ export const BatchReplaceOrderItemSchema = z
     // replaceable fields — the server validates postOnly against the
     // persisted original order, which this client-side schema cannot see.
     postOnly: z.boolean().optional(),
+    // Re-stated per replace, never inherited from the original order.
+    selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
 })
     .refine((data) => data.price !== undefined || data.quantity !== undefined, {
     message: "At least one of price or quantity must be provided",

package/dist/websocket/events/orders-events.d.ts

@@ -4,7 +4,7 @@
  * TypeScript types for order websocket events matching the Rust backend definitions.
  * Each event type has specific data fields based on the event context.
  */
-import type { OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, TimeInForce, TradingMode } from "../../trading";
+import type { OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, SelfTradePreventionMode, TimeInForce, TradingMode } from "../../trading";
 import type { RawEventMessage } from "../base";
 /**
  * Order event types
@@ -137,6 +137,19 @@ export interface CommonOrderEventData {
      * Wire: `post_only`.
      */
     postOnly?: boolean;
+    /**
+     * The self-trade-prevention override REQUESTED on the order
+     * (`"CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP"`), echoed so a
+     * subscriber can confirm what was accepted without a round trip to
+     * `getOrder`. Carried on the `OrderPlaced` acknowledgement, taker fills and
+     * remainder cancels, maker fills (the maker's OWN requested mode), the
+     * resting order's lifecycle frames, and the `orders` snapshot frame. Omitted
+     * when the order carried none — including every order that merely matched
+     * under a wallet or platform default, and every event emitted by a server
+     * predating the field: this echoes the request, never the resolved default.
+     * Wire: `self_trade_prevention_mode`.
+     */
+    selfTradePreventionMode?: SelfTradePreventionMode | (string & {});
 }
 /**
  * OrderPlaced event - emitted when a new order is placed
@@ -389,6 +402,21 @@ export interface OrderCancelledEvent extends OrderEvent {
         reason?: string;
         /** Stable machine-readable cancellation cause */
         terminalReason?: OrderTerminalReason | (string & {});
+        /**
+         * The counterparty order behind a self-trade-prevention cancellation: for
+         * a resting order cancelled because an order of the same owner arrived
+         * against it, the arriving order's id; for an arriving order whose
+         * remainder was cancelled instead, the owner's resting order it would
+         * have matched. The same audit back-pointer Bybit publishes as
+         * `smpOrderId`.
+         *
+         * Present ONLY when `terminalReason` is `SELF_TRADE_PREVENTION`, so
+         * presence is the whole signal. Absent means this was not an STP
+         * cancellation — or the event predates the field, including every event
+         * until the STP modes ship, since nothing emits it yet. Wire:
+         * `stp_counterparty_order_id`.
+         */
+        stpCounterpartyOrderId?: string;
         /**
          * Cumulative order fill at cancellation, mirroring `filledQuantity` on the
          * taker/maker fill events so consumers read one field across every order
@@ -481,6 +509,15 @@ export interface OrderPartiallyCancelledEvent extends OrderEvent {
         remainingQuantityRaw: string;
         /** Caller-supplied cancel reason; explicit `null` when none was given */
         reason: string | null;
+        /**
+         * Reserved: the counterparty order behind a self-trade-prevention
+         * REDUCTION. No shipped STP mode reduces a resting order — the four modes
+         * cancel in full, and DECREMENT/TRANSFER are out of scope — so nothing
+         * emits this today; the field exists so a future reducing mode needs no
+         * wire change. Same contract as `OrderCancelledEvent`'s field when it is
+         * present. Wire: `stp_counterparty_order_id`.
+         */
+        stpCounterpartyOrderId?: string;
         /** When the reduction happened (RFC3339 `Z`). Wire: `reduced_at`. */
         reducedAt: string;
     };

package/dist/websocket/events/position-events.d.ts

@@ -67,6 +67,49 @@ export interface PositionEventData {
     reason: string;
     /** Timestamp when the position state was updated (ISO 8601) */
     updatedAt: string;
+    /**
+     * Opaque, non-negative producer-owned row version for this position
+     * (0XM-2673). Compare only within the same `positionId`; higher is newer.
+     *
+     * Carried on RANKED live frames and on the subscribe-time `positions`
+     * snapshot, so a client can rank the two against each other on
+     * `positionId + version`. Not every live frame is ranked — see below — so
+     * an unranked frame is not comparable with a snapshot row even when their
+     * state matches.
+     * Absent means UNRANKED, never "oldest", and it does NOT tell you whether
+     * anything was persisted. Four cases reach it: the frame came from a
+     * producer that predates this field; the emit path wrote no row;
+     * the path DID write the row but re-reads live risk state after sequencing
+     * (funding, `margin_added`/`margin_reduced`), so the mutation did advance
+     * the persisted version; or the frame is a different projection of the row
+     * than persistence stores (terminal frames report `size` 0 and
+     * `LIQUIDATED`, while the stored row keeps its size and records `CLOSED`).
+     * In the last two, a REST read or a fresh snapshot ranks the mutation.
+     * Fall back to a full field comparison rather than ranking it lowest.
+     *
+     * The merge rule is PER FIELD GROUP, never per frame. On a higher version
+     * apply everything. On an EQUAL version skip the versioned fields as an
+     * idempotent redelivery — EXCEPT `isolatedMargin`, which the subscribe-time
+     * snapshot overlays from an independent live matching-engine read rather
+     * than from the versioned row, so it can reflect a later command than the
+     * version names and must be taken from the newer payload or you retain
+     * stale backing. Also still take `markPrice`, `unrealizedPnl`,
+     * `liquidationPrice` and `leverage` from the newer frame: those four are
+     * re-derived from the oracle mark on every frame, carry no version, and the
+     * version does not advance for them. Discarding an equal-version frame
+     * wholesale freezes displayed unrealized PnL until the position's next real
+     * mutation — up to the one-hour funding interval.
+     *
+     * A frame is ranked only when it is a faithful projection of the row
+     * persisted at that sequence: in practice the FILLS THAT LEAVE A POSITION
+     * OPEN. Unranked are (a) frames that re-read live risk state after their
+     * command was sequenced, since a later command can overtake that read —
+     * the `funding` and `margin_added`/`margin_reduced` frames — and (b)
+     * TERMINAL frames, which report `size` 0 and `LIQUIDATED` while the stored
+     * row keeps its size and records `CLOSED`. Those mutations still advance
+     * the persisted version, so REST and a fresh snapshot rank them.
+     */
+    version?: number;
 }
 /**
  * Position event emitted when a user's position state changes.

package/dist/websocket/snapshots.d.ts

@@ -24,7 +24,7 @@
  * frame, so its callback is never invoked. That is a silent no-op, never an
  * error.
  */
-import type { OrderSide, OrderType, TimeInForce, TradingMode } from "../trading";
+import type { OrderSide, OrderType, SelfTradePreventionMode, TimeInForce, TradingMode } from "../trading";
 /**
  * Receives one channel's complete subscribe-time state.
  *
@@ -59,8 +59,8 @@ export type SnapshotHandler<T> = (items: T[]) => void;
  * Nullability mirrors the wire exactly. Every optional field below is a Rust
  * `Option` serialized WITHOUT `skip_serializing_if`, so the key is always
  * present and carries `null` when unset — hence `| null` rather than `?`.
- * `clientOrderId` is the sole field the server omits outright, so it is the
- * sole `?`.
+ * `clientOrderId`, `selfTradePreventionMode` and `version` are the fields the
+ * server omits outright, so they are the `?`s.
  *
  * The value unions are widened (`Union | (string & {})`) for the same reason
  * the order event's are: the parser hands an unrecognized value through rather
@@ -122,6 +122,14 @@ export interface OrderSnapshotItem {
      * when the order carried none, matching the live event payload.
      */
     clientOrderId?: string;
+    /**
+     * The self-trade-prevention override REQUESTED on the order
+     * (`"CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP"`), carried for
+     * the `clientOrderId` reason above. Omitted — not `null` — when the order
+     * carried none, matching the live event payload: this echoes the request,
+     * never the resolved wallet or platform default.
+     */
+    selfTradePreventionMode?: SelfTradePreventionMode | (string & {});
     /**
      * Sequencer step this order's state was last written by — the SAME counter
      * the live order events and the REST endpoints carry (0XM-2440).

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "cancel_twap_order", "check_trader_code_availability", "clear_trader_code", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_faucet_info", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "clear_trader_code", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -22,6 +22,7 @@ export const OPERATION_IDS = [
     "cancel_order",
     "cancel_twap_order",
     "check_trader_code_availability",
+    "claim_buildercode_rewards",
     "clear_trader_code",
     "close_position",
     "create_challenge",
@@ -33,6 +34,9 @@ export const OPERATION_IDS = [
     "get_application_config",
     "get_application_stats",
     "get_available_collateral",
+    "get_buildercode_payout_summary",
+    "get_buildercode_rewards_balance",
+    "get_buildercodes_config",
     "get_candles",
     "get_conditional_order",
     "get_faucet_info",
@@ -66,6 +70,7 @@ export const OPERATION_IDS = [
     "get_pulse",
     "get_rewards_balance",
     "get_screener",
+    "get_self_trade_prevention_default",
     "get_sub_account_limits",
     "get_sweeper_chains",
     "get_trade_by_id",
@@ -87,6 +92,7 @@ export const OPERATION_IDS = [
     "list_application_movements",
     "list_application_orders",
     "list_application_users",
+    "list_buildercode_payouts",
     "list_conditional_orders",
     "list_delegated_agent_owners",
     "list_delegated_agents",
@@ -105,6 +111,7 @@ export const OPERATION_IDS = [
     "replace_order",
     "revoke_delegated_agent",
     "revoke_session",
+    "set_self_trade_prevention_default",
     "set_trader_code",
     "simulate_fees",
     "simulate_order_risk",