@0xmonaco/types 1.0.99 → 1.1.0

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

@@ -87,9 +87,12 @@ export interface MarginAccountSummary {
      * reducing, reduce-only, or opposite-side order sheltered by a larger
      * resting ladder needs less or none of it (and can be admitted even when
      * this field is zero), while an order crossing a losing position can need
-     * more than its own margin-plus-fee. Divide by a market's initial margin
-     * rate for indicative notional capacity; the authoritative per-order answer
-     * remains `simulateRiskBucketOrderRisk`.
+     * more than its own margin-plus-fee. A bucket below its initial margin pays
+     * that gap out of the parent headroom first: its next order that opens,
+     * adds to or flips a position draws the gap with its own requirement, so
+     * the figure there is the headroom less the gap. Divide by a market's
+     * initial margin rate for indicative notional capacity; the authoritative
+     * per-order answer remains `simulateRiskBucketOrderRisk`.
      *
      * Present only on risk-bucket rows served from a live risk engine snapshot;
      * absent (the key is omitted, never null) on parent rows and on

package/dist/trading/orders.d.ts

@@ -46,7 +46,7 @@ export interface Order {
     /** Trading mode (SPOT or MARGIN) */
     tradingMode: TradingMode;
     /**
-     * Time in force - GTC, IOC, or FOK (GTD is deprecated and rejected).
+     * Time in force - GTC, IOC, or FOK.
      * Absent on a MARKET order, which has none.
      */
     timeInForce?: TimeInForce;
@@ -269,12 +269,11 @@ export type TradingMode = "SPOT" | "MARGIN";
  * - GTC: Good Till Cancel - remains active until filled or canceled
  * - IOC: Immediate or Cancel - execute immediately and cancel unfilled portion
  * - FOK: Fill or Kill - execute completely or cancel entirely
- * - GTD: **deprecated, never implemented** - the server rejects it with HTTP
- *   400 (`Time in force must be GTC, IOC, or FOK`). The variant is retained so
- *   existing code keeps compiling. For an order that expires at a set time, use
- *   `GTC` together with `expirationDate`.
+ *
+ * For an order that expires at a set time, use `GTC` together with
+ * `expirationDate`.
  */
-export type TimeInForce = "GTC" | "IOC" | "FOK" | "GTD";
+export type TimeInForce = "GTC" | "IOC" | "FOK";
 /**
  * Per-order self-trade-prevention override: how the engine resolves the order
  * matching against one of your own resting orders (whole wallet family,

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

@@ -8,24 +8,20 @@ import type { Address } from "viem";
 /**
  * Reason for the balance update.
  *
- * `fee` and `rebate` accompany a fill: `fee` when a taker/application fee is
- * charged, `rebate` when a maker rebate is credited (including perp/margin
- * makers). `funding` accompanies a funding settlement against margin collateral
- * (also surfaced on the movements channel with `transactionType: "funding"`).
- * `liquidation` and `adl` accompany a forced-close on the liquidation-worker
- * path: `liquidation` on the liquidated victim's collateral, `adl` on an
- * account impacted by auto-deleveraging.
+ * Every `balance_update` carries one spot `user_balances` row. Its
+ * producer-owned `version`, when present, is scoped to the authenticated
+ * user/application and token: higher is newer, equal is idempotent. `fee` and `rebate` accompany a
+ * spot fill: `fee` when a taker/application fee is charged, `rebate` when a
+ * maker rebate is credited. A collateral transfer that moves the spot wallet
+ * row (`margin_transfer_in` / `margin_transfer_out`) sends a versioned spot
+ * frame for that leg.
  *
- * A genuine spot frame carries the resulting `user_balances` row and its
- * producer-owned `version`, scoped to the authenticated user/application and
- * token. Higher is newer; equal is idempotent. A collateral transfer that
- * moves the spot wallet row emits a genuine versioned spot frame for that leg.
- * Margin collateral frames — a parent to risk-bucket allocation, which moves
- * no wallet balance — and margin-routed deposit notifications omit `version`:
- * they are not spot rows, and a deposit notification can carry a delta rather
- * than whole-row state.
- * They cannot be reconciled against a spot snapshot or summed as separate
- * credits; refresh authoritative margin-account state instead.
+ * Margin collateral is not a spot row and is not sent on this channel: a
+ * margin-routed deposit, a perp fill, a funding settlement, a liquidation and
+ * an auto-deleveraging close send no `balance_update`. Read margin collateral
+ * from the `account` channel. `margin_deposit`, `funding`, `liquidation` and
+ * `adl` stay in this union so existing code that names them still compiles;
+ * the server does not send them.
  */
 export type BalanceUpdateReason = "lock" | "unlock" | "deposit" | "margin_deposit" | "withdrawal" | "trade" | "fee" | "rebate" | "funding" | "liquidation" | "adl" | "margin_transfer_in" | "margin_transfer_out";
 /**
@@ -36,7 +32,7 @@ export interface UserBalanceEventData {
     tokenAddress: Address;
     /** Token symbol */
     tokenSymbol: string | null;
-    /** Available balance for trading (normalized) */
+    /** Available spot balance (normalized) */
     available: string;
     /** Available balance in raw format (wei) */
     availableRaw: string;
@@ -49,8 +45,8 @@ export interface UserBalanceEventData {
     /** Total balance in raw format (wei) */
     totalRaw: string;
     /**
-     * Opaque durable spot-row version. Present only for genuine `user_balances`
-     * state; absent on legacy frames and margin collateral notifications.
+     * Opaque durable spot-row version. Absent on frames from a producer that
+     * does not stamp versions yet.
      *
      * Only a POSITIVE version is rankable. `0` is the legacy sentinel and means
      * exactly what an absent field means — unranked — so normalize the two

package/dist/wire/schema.d.ts

@@ -8639,9 +8639,12 @@ export interface components {
              *      reducing, reduce-only, or opposite-side order sheltered by a larger
              *      resting ladder needs less or none of it (and can be admitted even when
              *      this field is zero), while an order crossing a losing position can need
-             *      more than its own margin-plus-fee. Divide by a market's initial margin
-             *      rate for indicative notional capacity; the authoritative per-order answer
-             *      remains `simulate_risk_bucket_order_risk`.
+             *      more than its own margin-plus-fee. A bucket below its initial margin pays
+             *      that gap out of the parent headroom first: its next order that opens,
+             *      adds to or flips a position draws the gap with its own requirement, so
+             *      the figure there is the headroom less the gap. Divide by a market's
+             *      initial margin rate for indicative notional capacity; the authoritative
+             *      per-order answer remains `simulate_risk_bucket_order_risk`.
              *
              *      Present only on risk-bucket summary rows served from a live risk engine
              *      snapshot; absent on parent rows and on persisted-fallback reads, where

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.99",
+	"version": "1.1.0",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.99",
+		"@0xmonaco/contracts": "1.1.0",
 		"zod": "^4.6.7"
 	},
 	"peerDependencies": {