@0xmonaco/types 1.0.21 → 1.0.25-develop.1fab96c

package/dist/faucet/index.d.ts

@@ -33,10 +33,10 @@ export interface FailedMint {
 export interface MintTokensParams {
     /**
      * Cloudflare Turnstile token proving the request came from a real client.
-     * Required when the gateway has captcha enforcement enabled; ignored
-     * otherwise.
+     * Required on every faucet mint request; requests without a valid token are
+     * rejected.
      */
-    turnstileToken?: string;
+    turnstileToken: string;
 }
 /** Result of a faucet mint request. */
 export interface MintTokensResponse {
@@ -47,6 +47,47 @@ export interface MintTokensResponse {
     /** Remaining faucet requests in the next 24h */
     remainingRequests24h: number;
 }
+/** One token minted by a past faucet request. */
+export interface FaucetMintRecord {
+    /** Asset UUID */
+    assetId: string;
+    /** Token symbol */
+    symbol: string;
+    /** Amount minted in token units */
+    amount: string;
+    /**
+     * On-chain transaction hash; absent when the transaction was submitted but
+     * never confirmed
+     */
+    txHash?: string;
+}
+/** One past faucet request (one endpoint call; all tokens minted together). */
+export interface FaucetRequestRecord {
+    /**
+     * Timestamp (ISO 8601) of the request, truncated to the minute (the
+     * quota-session granularity)
+     */
+    requestedAt: string;
+    /** Tokens minted by the request */
+    minted: FaucetMintRecord[];
+}
+/** Result of a faucet info request. */
+export interface GetFaucetInfoResponse {
+    /** Remaining faucet requests in the rolling 24h window */
+    remainingRequests24h: number;
+    /** Maximum faucet requests per rolling 24h window */
+    dailyLimit: number;
+    /**
+     * Timestamp (ISO 8601) safe to retry at or after: when the wallet's next
+     * faucet slot frees under the current daily limit, with a small safety
+     * margin. When remainingRequests24h is 0 this is when the next mint
+     * becomes possible. Absent when no requests are in the rolling 24h window
+     * or when the daily limit is 0. Not a calendar-day reset.
+     */
+    nextAvailableAt?: string;
+    /** Up to 5 most recent faucet requests, newest first */
+    recentRequests: FaucetRequestRecord[];
+}
 /**
  * Faucet API interface. Session-authenticated.
  */
@@ -57,14 +98,25 @@ export interface FaucetAPI extends BaseAPI {
      * Testnet-only and rate-limited; see the module note. The call is
      * synchronous and resolves only when every faucet transaction confirmed
      * on-chain (HTTP 200). Failures reject with meaningful status codes:
-     * 429 when the daily quota is exhausted, 502 when transactions failed or
-     * were only partially confirmed on-chain (the error details carry the
-     * minted/failed breakdown; delivered legs still consume the quota), and
-     * 503 when the faucet is unavailable (nothing credited, safe to retry).
+     * 400 when the Turnstile token is missing or invalid, 429 when the daily
+     * quota is exhausted, 502 when transactions failed or were only partially
+     * confirmed on-chain (the error details carry the minted/failed breakdown;
+     * delivered legs still consume the quota), and 503 when the faucet is
+     * unavailable (nothing credited, safe to retry).
      *
-     * @param params - Optional parameters (Turnstile captcha token when the
-     *   gateway requires one)
+     * @param params - Mint parameters, including the required Turnstile captcha
+     *   token
      * @returns Promise resolving to the minted tokens and remaining quota
      */
-    mint(params?: MintTokensParams): Promise<MintTokensResponse>;
+    mint(params: MintTokensParams): Promise<MintTokensResponse>;
+    /**
+     * Fetches the authenticated wallet's faucet quota and recent requests.
+     *
+     * Read-only: remaining requests in the rolling 24h window, when the next
+     * request becomes available, and the 5 most recent requests. Wallet-scoped
+     * across apps, matching mint enforcement.
+     *
+     * @returns Promise resolving to the quota and recent-request history
+     */
+    getInfo(): Promise<GetFaucetInfoResponse>;
 }

package/dist/margin-accounts/index.d.ts

@@ -114,11 +114,13 @@ export interface GetMarginAccountMovementsResponse {
 export interface SimulateOrderRiskRequest {
     tradingPairId: string;
     side: OrderSide;
-    positionSide: PositionSide;
+    /** @deprecated `side` is authoritative; when present BUY=LONG and SELL=SHORT. */
+    positionSide?: PositionSide;
     orderType: OrderType;
     price?: string;
     quantity: string;
-    leverage: string;
+    /** Required for normal orders; optional and ignored for reduce-only. */
+    leverage?: string;
     reduceOnly?: boolean;
 }
 export type SimulateIsolatedRiskBucketOrderRiskRequest = SimulateOrderRiskRequest & {

package/dist/market/index.d.ts

@@ -273,11 +273,12 @@ export interface MarketStats {
     totalTradeCountLtd: number;
 }
 export interface RiskTier {
-    notional_floor: string;
-    notional_cap?: string;
     initialMarginRatio: string;
     maintenanceMarginRatio: string;
-    maxLeverage: string;
+    /** Maximum authoritative absolute base-asset quantity. */
+    maxPositionSize?: string;
+    /** @deprecated This legacy alias is base quantity, not notional. */
+    maxPositionNotional?: string;
 }
 export interface PerpMarketConfig {
     tradingPairId: string;

package/dist/positions/index.d.ts

@@ -133,6 +133,8 @@ export interface TpSlLeg {
     orderType: OrderType;
     limitPrice?: string;
     quantity?: string;
+    /** Resolve the full live position size when triggered. */
+    closePosition?: boolean;
     timeInForce?: Extract<TimeInForce, "GTC" | "IOC">;
     slippageToleranceBps?: number;
     expiresAt?: string;
@@ -140,6 +142,8 @@ export interface TpSlLeg {
 export interface AttachPositionTpSlRequest {
     takeProfit?: TpSlLeg;
     stopLoss?: TpSlLeg;
+    /** Cancel the sibling after one leg triggers. Requires both legs. */
+    oco?: boolean;
 }
 export interface AttachPositionTpSlResponse {
     positionId: string;

package/dist/sdk/index.d.ts

@@ -56,6 +56,14 @@ export interface SDKConfig {
      * (e.g. Docker DNS `ws://ws-api:8080/ws`). Must be a valid absolute URL.
      */
     wsUrl?: string;
+    /**
+     * Polling frequency in milliseconds for the SDK's internal viem public
+     * client (e.g. `waitForTransactionReceipt` during vault deposits). Sei
+     * produces sub-second blocks, so a value near the chain's block time
+     * confirms transactions much sooner than viem's 4000ms default. Defaults to
+     * 750ms when omitted. Must be a positive finite number when provided.
+     */
+    pollingInterval?: number;
 }
 /**
  * Core SDK interface providing access to all Monaco functionality.

package/dist/trading/index.d.ts

@@ -34,10 +34,13 @@ export interface TradingAPI extends BaseAPI {
         riskBucketId?: string;
         riskBucketCollateral?: string;
         strategyKey?: string;
+        /** @deprecated Order side is authoritative. */
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
+        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         takeProfit?: ParentTpSlLegParams;
+        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
     /**
@@ -58,10 +61,13 @@ export interface TradingAPI extends BaseAPI {
         riskBucketId?: string;
         riskBucketCollateral?: string;
         strategyKey?: string;
+        /** @deprecated Order side is authoritative. */
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
+        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         takeProfit?: ParentTpSlLegParams;
+        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
     /**
@@ -140,6 +146,6 @@ export interface TradingAPI extends BaseAPI {
      */
     getOrder(orderId: string): Promise<GetOrderResponse>;
 }
-export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderType, PositionSide, TimeInForce, TradingMode, } from "./orders";
+export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, PositionSide, TimeInForce, TradingMode, } from "./orders";
 export { ORDER_STATUS_VALUES } from "./orders";
 export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, ConditionalOrder, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, MatchResult, ParentTpSlLegParams, ReplaceOrderResponse, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -70,7 +70,11 @@ export interface Order {
     reduceOnly?: boolean;
     /** Position ID linked to the order, when available */
     positionId?: string;
+    /** Stable cause when status is CANCELLED */
+    terminalReason?: OrderTerminalReason;
 }
+/** Stable terminal causes for accepted orders that end as CANCELLED. */
+export type OrderTerminalReason = "USER_REQUESTED" | "REPLACED" | "LIQUIDATION" | "INSUFFICIENT_MARGIN" | "REDUCE_ONLY_EXHAUSTED" | "POSITION_CLOSED" | "OCO_SIBLING_TRIGGERED" | "SYSTEM";
 /**
  * Role of the creator or order
  */

package/dist/trading/responses.d.ts

@@ -38,7 +38,7 @@ export interface MatchResult {
     } | null;
 }
 /**
- * Parent TP/SL leg attached to a normal margin order.
+ * @deprecated Entry-attached TP/SL is rejected. Use position-associated TP/SL.
  *
  * Parent TP/SL follows the parent order quantity and becomes active once the
  * parent order creates or extends a position.

package/dist/validation/margin-accounts.d.ts

@@ -75,18 +75,18 @@ export declare const SimulateOrderRiskSchema: z.ZodObject<{
             BUY: "BUY";
             SELL: "SELL";
         }>;
-        positionSide: z.ZodEnum<{
+        positionSide: z.ZodOptional<z.ZodEnum<{
             LONG: "LONG";
             SHORT: "SHORT";
             NONE: "NONE";
-        }>;
+        }>>;
         orderType: z.ZodEnum<{
             LIMIT: "LIMIT";
             MARKET: "MARKET";
         }>;
         price: z.ZodOptional<z.ZodString>;
         quantity: z.ZodString;
-        leverage: z.ZodString;
+        leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>;
 }, z.core.$strip>;
@@ -97,18 +97,18 @@ export declare const SimulateParentMarginOrderRiskSchema: z.ZodObject<{
             BUY: "BUY";
             SELL: "SELL";
         }>;
-        positionSide: z.ZodEnum<{
+        positionSide: z.ZodOptional<z.ZodEnum<{
             LONG: "LONG";
             SHORT: "SHORT";
             NONE: "NONE";
-        }>;
+        }>>;
         orderType: z.ZodEnum<{
             LIMIT: "LIMIT";
             MARKET: "MARKET";
         }>;
         price: z.ZodOptional<z.ZodString>;
         quantity: z.ZodString;
-        leverage: z.ZodString;
+        leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>;
 }, z.core.$strip>;
@@ -118,18 +118,18 @@ export declare const SimulateRiskBucketOrderRiskSchema: z.ZodObject<{
             BUY: "BUY";
             SELL: "SELL";
         }>;
-        positionSide: z.ZodEnum<{
+        positionSide: z.ZodOptional<z.ZodEnum<{
             LONG: "LONG";
             SHORT: "SHORT";
             NONE: "NONE";
-        }>;
+        }>>;
         orderType: z.ZodEnum<{
             LIMIT: "LIMIT";
             MARKET: "MARKET";
         }>;
         price: z.ZodOptional<z.ZodString>;
         quantity: z.ZodString;
-        leverage: z.ZodString;
+        leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         tradingPairId: z.ZodUUID;
         strategyKey: z.ZodOptional<z.ZodString>;
@@ -141,18 +141,18 @@ export declare const SimulateRiskBucketOrderRiskSchema: z.ZodObject<{
             BUY: "BUY";
             SELL: "SELL";
         }>;
-        positionSide: z.ZodEnum<{
+        positionSide: z.ZodOptional<z.ZodEnum<{
             LONG: "LONG";
             SHORT: "SHORT";
             NONE: "NONE";
-        }>;
+        }>>;
         orderType: z.ZodEnum<{
             LIMIT: "LIMIT";
             MARKET: "MARKET";
         }>;
         price: z.ZodOptional<z.ZodString>;
         quantity: z.ZodString;
-        leverage: z.ZodString;
+        leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         marginMode: z.ZodLiteral<"CROSS">;
         selectedTradingPairIds: z.ZodArray<z.ZodUUID>;

package/dist/validation/margin-accounts.js

@@ -78,17 +78,39 @@ export const GetParentMarginAccountMovementsSchema = PaginationSchema.extend({
 const BaseSimulateOrderRiskRequestSchema = z.object({
     tradingPairId: UUIDSchema,
     side: OrderSideSchema,
-    positionSide: PositionSideSchema,
+    positionSide: PositionSideSchema.optional(),
     orderType: OrderTypeSchema,
     price: PositiveDecimalStringSchema.optional(),
     quantity: PositiveDecimalStringSchema,
-    leverage: PositiveDecimalStringSchema,
+    leverage: PositiveDecimalStringSchema.optional(),
     reduceOnly: z.boolean().optional(),
 });
-const SimulateOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.strict();
-const SimulateIsolatedRiskBucketOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.merge(IsolatedRiskBucketRequestSchema).strict();
+const validateOneWaySimulationFields = (data, ctx) => {
+    if (data.positionSide !== undefined) {
+        const expected = data.side === "BUY" ? "LONG" : "SHORT";
+        if (data.positionSide !== expected) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "positionSide must match side when provided (BUY=LONG, SELL=SHORT)",
+                path: ["positionSide"],
+            });
+        }
+    }
+    if (data.reduceOnly !== true && data.leverage === undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "leverage is required for normal margin orders",
+            path: ["leverage"],
+        });
+    }
+};
+const SimulateOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.strict().superRefine(validateOneWaySimulationFields);
+const SimulateIsolatedRiskBucketOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.merge(IsolatedRiskBucketRequestSchema)
+    .strict()
+    .superRefine(validateOneWaySimulationFields);
 const SimulateCrossRiskBucketOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.merge(CrossRiskBucketScopeSchema)
     .strict()
+    .superRefine(validateOneWaySimulationFields)
     .refine((data) => data.selectedTradingPairIds.includes(data.tradingPairId), {
     message: "tradingPairId must be included in selectedTradingPairIds for CROSS risk buckets",
     path: ["selectedTradingPairIds"],

package/dist/validation/positions.d.ts

@@ -60,6 +60,7 @@ export declare const AttachPositionTpSlSchema: z.ZodObject<{
             }>;
             limitPrice: z.ZodOptional<z.ZodString>;
             quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
             timeInForce: z.ZodOptional<z.ZodEnum<{
                 GTC: "GTC";
                 IOC: "IOC";
@@ -75,6 +76,7 @@ export declare const AttachPositionTpSlSchema: z.ZodObject<{
             }>;
             limitPrice: z.ZodOptional<z.ZodString>;
             quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
             timeInForce: z.ZodOptional<z.ZodEnum<{
                 GTC: "GTC";
                 IOC: "IOC";
@@ -82,6 +84,7 @@ export declare const AttachPositionTpSlSchema: z.ZodObject<{
             slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
             expiresAt: z.ZodOptional<z.ZodISODateTime>;
         }, z.core.$strip>>;
+        oco: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const ListPositionHistorySchema: z.ZodObject<{

package/dist/validation/positions.js

@@ -60,6 +60,7 @@ const TpSlLegSchema = z
     orderType: OrderTypeSchema,
     limitPrice: PositiveDecimalStringSchema.optional(),
     quantity: PositiveDecimalStringSchema.optional(),
+    closePosition: z.boolean().optional(),
     timeInForce: ConditionalTimeInForceSchema.optional(),
     slippageToleranceBps: SlippageToleranceBpsSchema.optional(),
     expiresAt: ISO8601DateSchema.optional(),
@@ -79,15 +80,28 @@ const TpSlLegSchema = z
     .refine((data) => data.orderType !== "LIMIT" || data.slippageToleranceBps === undefined, {
     message: "slippageToleranceBps is only allowed for MARKET TP/SL legs",
     path: ["slippageToleranceBps"],
+})
+    .refine((data) => data.closePosition !== true || data.quantity === undefined, {
+    message: "quantity must be omitted when closePosition is true",
+    path: ["quantity"],
+})
+    .refine((data) => data.quantity !== undefined || data.closePosition !== false, {
+    message: "quantity is required when closePosition is false",
+    path: ["closePosition"],
 });
 export const AttachPositionTpSlSchema = PositionIdSchema.extend({
     request: z
         .object({
         takeProfit: TpSlLegSchema.optional(),
         stopLoss: TpSlLegSchema.optional(),
+        oco: z.boolean().optional(),
     })
         .refine((data) => data.takeProfit !== undefined || data.stopLoss !== undefined, {
         message: "At least one of takeProfit or stopLoss is required",
+    })
+        .refine((data) => data.oco !== true || (data.takeProfit !== undefined && data.stopLoss !== undefined), {
+        message: "oco=true requires both takeProfit and stopLoss",
+        path: ["oco"],
     }),
 });
 export const ListPositionHistorySchema = PaginationSchema.extend({

package/dist/validation/profile.d.ts

@@ -19,12 +19,12 @@ export declare const LedgerEntryTypeSchema: z.ZodEnum<{
  * Transaction type validation
  */
 export declare const TransactionTypeSchema: z.ZodEnum<{
+    LIQUIDATION: "LIQUIDATION";
     FEE: "FEE";
     DEPOSIT: "DEPOSIT";
     WITHDRAWAL: "WITHDRAWAL";
     TRADE: "TRADE";
     FUNDING: "FUNDING";
-    LIQUIDATION: "LIQUIDATION";
     INTEREST: "INTEREST";
     REWARD: "REWARD";
 }>;
@@ -45,12 +45,12 @@ export declare const GetUserMovementsSchema: z.ZodObject<{
         FEE: "FEE";
     }>>;
     transactionType: z.ZodOptional<z.ZodEnum<{
+        LIQUIDATION: "LIQUIDATION";
         FEE: "FEE";
         DEPOSIT: "DEPOSIT";
         WITHDRAWAL: "WITHDRAWAL";
         TRADE: "TRADE";
         FUNDING: "FUNDING";
-        LIQUIDATION: "LIQUIDATION";
         INTEREST: "INTEREST";
         REWARD: "REWARD";
     }>>;

package/dist/validation/trading.js

@@ -104,6 +104,7 @@ export const ParentTpSlLegSchema = z
     path: ["slippageToleranceBps"],
 });
 const hasParentTpSl = (options) => options?.takeProfit !== undefined || options?.stopLoss !== undefined;
+const legacyPositionSideMatchesOrderSide = (side, positionSide) => positionSide === undefined || (positionSide !== "NONE" && ((side === "BUY" && positionSide === "LONG") || (side === "SELL" && positionSide === "SHORT")));
 /**
  * Place Limit Order validation schema
  */
@@ -132,25 +133,17 @@ export const PlaceLimitOrderSchema = z
     })
         .optional(),
 })
-    .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.positionSide !== undefined, {
-    message: "positionSide is required for MARGIN orders",
+    .refine((data) => legacyPositionSideMatchesOrderSide(data.side, data.options?.positionSide), {
+    message: "positionSide is deprecated; when supplied BUY requires LONG and SELL requires SHORT",
     path: ["options", "positionSide"],
 })
-    .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.leverage !== undefined, {
-    message: "leverage is required for MARGIN orders",
+    .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.reduceOnly === true || data.options.leverage !== undefined, {
+    message: "leverage is required for normal MARGIN orders",
     path: ["options", "leverage"],
 })
-    .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
-    message: "Parent TP/SL is only supported for MARGIN orders",
-    path: ["options", "tradingMode"],
-})
-    .refine((data) => !hasParentTpSl(data.options) || data.options?.positionSide !== "NONE", {
-    message: "Parent TP/SL requires positionSide to be LONG or SHORT",
-    path: ["options", "positionSide"],
-})
-    .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
-    message: "Parent TP/SL cannot be attached to reduceOnly orders",
-    path: ["options", "reduceOnly"],
+    .refine((data) => !hasParentTpSl(data.options), {
+    message: "Entry-attached TP/SL are no longer supported; create position TP/SL after the position opens",
+    path: ["options"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
     message: "riskBucketCollateral is only supported for MARGIN orders",
@@ -209,25 +202,17 @@ export const PlaceMarketOrderSchema = z
     })
         .optional(),
 })
-    .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.positionSide !== undefined, {
-    message: "positionSide is required for MARGIN orders",
+    .refine((data) => legacyPositionSideMatchesOrderSide(data.side, data.options?.positionSide), {
+    message: "positionSide is deprecated; when supplied BUY requires LONG and SELL requires SHORT",
     path: ["options", "positionSide"],
 })
-    .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.leverage !== undefined, {
-    message: "leverage is required for MARGIN orders",
+    .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.reduceOnly === true || data.options.leverage !== undefined, {
+    message: "leverage is required for normal MARGIN orders",
     path: ["options", "leverage"],
 })
-    .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
-    message: "Parent TP/SL is only supported for MARGIN orders",
-    path: ["options", "tradingMode"],
-})
-    .refine((data) => !hasParentTpSl(data.options) || data.options?.positionSide !== "NONE", {
-    message: "Parent TP/SL requires positionSide to be LONG or SHORT",
-    path: ["options", "positionSide"],
-})
-    .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
-    message: "Parent TP/SL cannot be attached to reduceOnly orders",
-    path: ["options", "reduceOnly"],
+    .refine((data) => !hasParentTpSl(data.options), {
+    message: "Entry-attached TP/SL are no longer supported; create position TP/SL after the position opens",
+    path: ["options"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
     message: "riskBucketCollateral is only supported for MARGIN orders",
@@ -391,12 +376,12 @@ export const BatchCreateOrderItemSchema = z
     message: "reduceOnly orders cannot create a new risk bucket",
     path: ["reduceOnly"],
 })
-    .refine((data) => data.tradingMode !== "MARGIN" || data.positionSide !== undefined, {
-    message: "positionSide is required for MARGIN orders",
+    .refine((data) => legacyPositionSideMatchesOrderSide(data.side, data.positionSide), {
+    message: "positionSide is deprecated; when supplied BUY requires LONG and SELL requires SHORT",
     path: ["positionSide"],
 })
-    .refine((data) => data.tradingMode !== "MARGIN" || data.leverage !== undefined, {
-    message: "leverage is required for MARGIN orders",
+    .refine((data) => data.tradingMode !== "MARGIN" || data.reduceOnly === true || data.leverage !== undefined, {
+    message: "leverage is required for normal MARGIN orders",
     path: ["leverage"],
 });
 /**

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, OrderType, TimeInForce, TradingMode } from "../../trading";
+import type { OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, TimeInForce, TradingMode } from "../../trading";
 import type { RawEventMessage } from "../base";
 /**
  * Order event types
@@ -197,6 +197,8 @@ export interface OrderCancelledEvent extends OrderEvent {
     data: CommonOrderEventData & {
         /** Reason for cancellation */
         reason?: string;
+        /** Stable machine-readable cancellation cause */
+        terminalReason?: OrderTerminalReason;
         /** Total filled quantity before cancellation */
         totalFilled?: string;
         /** Remaining quantity when canceled */

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 ["add_position_margin", "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", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "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_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "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", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "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 ["add_position_margin", "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", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "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_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "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", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "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

@@ -32,6 +32,7 @@ export const OPERATION_IDS = [
     "get_available_collateral",
     "get_candles",
     "get_conditional_order",
+    "get_faucet_info",
     "get_funding_state",
     "get_index_price",
     "get_margin_account_movements",

package/dist/wire/schema.d.ts

@@ -734,6 +734,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/faucet/info": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get faucet quota and recent requests
+         * @description Get faucet quota and recent requests.
+         *
+         *      Returns the authenticated wallet's remaining faucet requests in the
+         *      rolling 24h window, when the next request becomes available, and the
+         *      5 most recent faucet requests. Quota is wallet-scoped: it aggregates
+         *      across all user rows sharing the wallet address, matching mint
+         *      enforcement.
+         */
+        get: operations["get_faucet_info"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/faucet/mint": {
         parameters: {
             query?: never;
@@ -2280,8 +2306,13 @@ export interface components {
             updatedAt?: string | null;
         };
         AttachPositionTpSlRequest: {
-            stopLoss?: components["schemas"]["TpSlLeg"];
+            /**
+             * @description One-cancels-the-other. Defaults to false. When true, both take_profit and
+             *      stop_loss are required and the sibling is cancelled after either triggers.
+             */
+            oco?: boolean | null;
             takeProfit?: components["schemas"]["TpSlLeg"];
+            stopLoss?: components["schemas"]["TpSlLeg"];
         };
         AttachPositionTpSlResponse: {
             positionId?: string | null;
@@ -2499,13 +2530,14 @@ export interface components {
              */
             riskBucketCollateral?: string | null;
             /**
-             * @description Position side for margin orders: LONG, SHORT, or NONE
+             * @deprecated
+             * @description DEPRECATED compatibility field. Order side is authoritative. When supplied, BUY requires LONG and SELL requires SHORT; NONE is rejected.
              * @example LONG
              * @enum {string|null}
              */
-            positionSide?: "LONG" | "SHORT" | "NONE" | null;
+            positionSide?: "LONG" | "SHORT" | null;
             /**
-             * @description Leverage multiplier as decimal string for margin orders
+             * @description Leverage multiplier as a decimal string. Required for normal margin orders; optional and ignored for reduce-only orders.
              * @example 5
              */
             leverage?: string | null;
@@ -2947,13 +2979,14 @@ export interface components {
              */
             riskBucketCollateral?: string | null;
             /**
-             * @description Position side for margin orders: LONG, SHORT, or NONE
+             * @deprecated
+             * @description DEPRECATED compatibility field. Order side is authoritative. When supplied, BUY requires LONG and SELL requires SHORT; NONE is rejected.
              * @example LONG
              * @enum {string|null}
              */
-            positionSide?: "LONG" | "SHORT" | "NONE" | null;
+            positionSide?: "LONG" | "SHORT" | null;
             /**
-             * @description Leverage multiplier as decimal string for margin orders
+             * @description Leverage multiplier as a decimal string. Required for normal margin orders; optional and ignored for reduce-only orders.
              * @example 5
              */
             leverage?: string | null;
@@ -3123,6 +3156,32 @@ export interface components {
              */
             error?: string | null;
         };
+        /** @description One token minted by a past faucet request. */
+        FaucetMintRecord: {
+            /**
+             * Format: uuid
+             * @description Asset UUID
+             */
+            assetId?: string | null;
+            /**
+             * @description Token symbol
+             * @example USDC
+             */
+            symbol?: string | null;
+            /**
+             * @description Amount minted in token units
+             * @example 1000
+             */
+            amount?: string | null;
+            /** @description On-chain transaction hash; absent when the transaction was submitted but never confirmed */
+            txHash?: string | null;
+        };
+        /** @description One past faucet request (one endpoint call; all tokens minted together). */
+        FaucetRequestRecord: {
+            /** @description Timestamp (ISO 8601) of the request, truncated to the minute (the quota-session granularity) */
+            requestedAt?: string | null;
+            minted?: components["schemas"]["FaucetMintRecord"][] | null;
+        };
         FeeTierScheduleRow: {
             /**
              * Format: int32
@@ -3372,6 +3431,27 @@ export interface components {
              */
             clientId?: string | null;
         };
+        GetFaucetInfoResponse: {
+            /**
+             * Format: uint32
+             * @description Remaining faucet requests in the rolling 24h window
+             * @example 2
+             */
+            remainingRequests24h?: number | null;
+            /**
+             * Format: uint32
+             * @description Maximum faucet requests per rolling 24h window
+             * @example 3
+             */
+            dailyLimit?: number | null;
+            /** @description Timestamp (ISO 8601) safe to retry at or after: when the wallet's next faucet slot frees under the current daily limit, with a small safety margin. When remaining_requests_24h is 0 this is when the next mint becomes possible. Absent when no requests are in the rolling 24h window or when the daily limit is 0. Not a calendar-day reset. */
+            nextAvailableAt?: string | null;
+            /**
+             * @description Up to 5 most recent faucet requests, newest first, regardless of the
+             *      24h window.
+             */
+            recentRequests?: components["schemas"]["FaucetRequestRecord"][] | null;
+        };
         GetFundingStateResponse: {
             /** Format: uuid */
             tradingPairId?: string | null;
@@ -3739,7 +3819,8 @@ export interface components {
              */
             marginAccountId?: string | null;
             /**
-             * @description Position side for margin orders
+             * @deprecated
+             * @description DEPRECATED derived compatibility value. Order side is authoritative.
              * @example LONG
              */
             positionSide?: string | null;
@@ -3831,6 +3912,11 @@ export interface components {
              * @description Batch UUID for batch orders
              */
             batchId?: string | null;
+            /**
+             * @description Stable terminal cause for a cancelled order: USER_REQUESTED, REPLACED, LIQUIDATION, INSUFFICIENT_MARGIN, REDUCE_ONLY_EXHAUSTED, POSITION_CLOSED, OCO_SIBLING_TRIGGERED, or SYSTEM
+             * @example REDUCE_ONLY_EXHAUSTED
+             */
+            terminalReason?: string | null;
         };
         /** @description Orderbook snapshot with token metadata and sequence number. */
         GetOrderbookResponse: {
@@ -4810,8 +4896,8 @@ export interface components {
             executionPriceRange?: components["schemas"]["ExecutionPriceRange"];
         };
         MintTokensRequest: {
-            /** @description Cloudflare Turnstile token; required when faucet captcha enforcement is enabled */
-            turnstileToken?: string | null;
+            /** @description Cloudflare Turnstile token proving the request came from a real client. Required on every faucet mint request. */
+            turnstileToken: string;
         };
         MintTokensResponse: {
             minted?: components["schemas"]["MintedToken"][] | null;
@@ -5415,7 +5501,13 @@ export interface components {
         RiskTier: {
             initialMarginRatio?: string | null;
             maintenanceMarginRatio?: string | null;
+            /**
+             * @deprecated
+             * @description DEPRECATED compatibility alias. This value is a maximum absolute base-asset quantity, not a notional. Use maxPositionSize.
+             */
             maxPositionNotional?: string | null;
+            /** @description Maximum authoritative absolute position size in base-asset quantity. */
+            maxPositionSize?: string | null;
         };
         /** @description Per-pair screener row. Window fields null when insufficient history. */
         ScreenerItem: {
@@ -5615,10 +5707,15 @@ export interface components {
             /** Format: uuid */
             tradingPairId?: string | null;
             side?: string | null;
+            /**
+             * @description Deprecated compatibility value. `side` is authoritative; when present,
+             *      BUY must carry LONG and SELL must carry SHORT.
+             */
             positionSide?: string | null;
             orderType?: string | null;
             price?: string | null;
             quantity?: string | null;
+            /** @description Required for normal orders; optional and ignored for reduce-only. */
             leverage?: string | null;
             reduceOnly?: boolean | null;
         };
@@ -5657,10 +5754,12 @@ export interface components {
             /** Format: uuid */
             tradingPairId?: string | null;
             side?: string | null;
+            /** @description Deprecated compatibility value; `side` is authoritative. */
             positionSide?: string | null;
             orderType?: string | null;
             price?: string | null;
             quantity?: string | null;
+            /** @description Required for normal orders; optional and ignored for reduce-only. */
             leverage?: string | null;
             reduceOnly?: boolean | null;
         };
@@ -5669,10 +5768,12 @@ export interface components {
             tradingPairId?: string | null;
             strategyKey?: string | null;
             side?: string | null;
+            /** @description Deprecated compatibility value; `side` is authoritative. */
             positionSide?: string | null;
             orderType?: string | null;
             price?: string | null;
             quantity?: string | null;
+            /** @description Required for normal orders; optional and ignored for reduce-only. */
             leverage?: string | null;
             reduceOnly?: boolean | null;
             /** @description Risk bucket mode. Defaults to ISOLATED. Values: ISOLATED, CROSS. */
@@ -5814,6 +5915,12 @@ export interface components {
             /** Format: int32 */
             slippageToleranceBps?: number | null;
             expiresAt?: string | null;
+            /**
+             * @description Resolve the full live position size when triggered. Mutually exclusive
+             *      with quantity. For compatibility, omitting both quantity and this field
+             *      also means full-position close.
+             */
+            closePosition?: boolean | null;
         };
         /** @description Core fields of a single executed trade, nested under `data` in the public trade event envelope. */
         TradeData: {
@@ -7964,6 +8071,47 @@ export interface operations {
             };
         };
     };
+    get_faucet_info: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetFaucetInfoResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Faucet quota configuration unavailable; safe to retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     mint_tokens: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.21",
+	"version": "1.0.25-develop.1fab96c",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.21",
+		"@0xmonaco/contracts": "1.0.25-develop.1fab96c",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {