@0xmonaco/types 1.1.0 → 1.1.2

package/dist/buildercodes/responses.js

@@ -19,7 +19,7 @@ export const GetBuildercodesConfigResponseSchema = z.object({
     builderFeeEnabled: z.boolean(),
     builderFeeBps: z.number().int().min(0).max(100),
     builderFeeCapBps: z.number().int().min(0).max(100),
-    changesRemaining: z.number().int().min(0).max(2),
+    changesRemaining: z.number().int().min(0).max(100),
     nextChangeAllowedAt: z.string().nullable().optional(),
     /**
      * The stored maker add-on in basis points: the additional fee this frontend
@@ -44,7 +44,7 @@ export const SetBuilderFeeParamsSchema = z.object({
 export const SetBuilderFeeResponseSchema = z.object({
     builderFeeBps: z.number().int().min(0).max(100),
     previousBuilderFeeBps: z.number().int().min(0).max(100),
-    changesRemaining: z.number().int().min(0).max(2),
+    changesRemaining: z.number().int().min(0).max(100),
     nextChangeAllowedAt: z.string().nullable().optional(),
     /** The maker add-on now stored. Absent from servers older than this field. */
     builderMakerFeeBps: z.number().int().min(0).max(100).optional(),

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

@@ -6,6 +6,12 @@ export interface MarginAccountSummary {
     label?: string;
     riskBucketId?: string;
     marginMode?: MarginMode;
+    /**
+     * On a cross risk-bucket row: the markets where the bucket has an open
+     * position, sorted by trading pair id. A market joins once a fill's position
+     * is persisted and leaves once its last position's close is persisted, so a
+     * position still being liquidated counts; resting orders alone do not.
+     */
     selectedTradingPairIds?: string[];
     tradingPairId?: string;
     strategyKey?: string;
@@ -280,13 +286,10 @@ export interface TransferCollateralToIsolatedRiskBucketRequest extends TransferC
 /**
  * Fund the account's cross risk bucket from the parent's unallocated
  * collateral (the bucket is created if needed). A cross transfer names no
- * pairs: cross scope is derived from trading — a pair joins the bucket when a
- * cross order on it succeeds and leaves when its positions close — so funding
- * has nothing to declare. Read the current scope from the cross bucket's row
- * in `listMarginAccounts()` (`selectedTradingPairIds`) or from this call's
- * response; the parent summary row carries no scope. Pairs declared before
- * scope became derived stay recorded until they trade and their positions
- * close.
+ * pairs: cross scope is the markets where the bucket has an open position, so
+ * funding has nothing to declare. Read the current scope from the cross
+ * bucket's row in `listMarginAccounts()` (`selectedTradingPairIds`) or from
+ * this call's response; the parent summary row carries no scope.
  */
 export interface TransferCollateralToCrossRiskBucketRequest extends TransferCollateralToParentMarginAccountRequest {
     marginMode: "CROSS";
@@ -323,6 +326,7 @@ export interface TransferCollateralResponse {
     strategyKey?: string;
     riskBucketId?: string;
     marginMode?: MarginMode;
+    /** On a cross risk-bucket transfer: the markets where the bucket has an open position, sorted by trading pair id. */
     selectedTradingPairIds?: string[];
     asset: string;
     amount: string;
@@ -426,11 +430,9 @@ export type SimulateIsolatedRiskBucketOrderRiskRequest = SimulateOrderRiskReques
 /**
  * Preview an order against the account's cross risk bucket, or the
  * deterministic bucket a first cross order would create. A cross preview names
- * no pairs: cross scope is derived from trading — a pair joins the bucket when
- * a cross order on it succeeds and, once its positions close, stays listed
- * until a later successful cross order on another pair reconciles the bucket —
- * so the previewed pair is in scope by construction. Read the derived scope
- * the preview ran against from the response's `selectedTradingPairIds`.
+ * no pairs: cross scope is the markets where the bucket has an open position,
+ * and the previewed pair is in scope by construction. Read the scope the
+ * preview ran against from the response's `selectedTradingPairIds`.
  */
 export type SimulateCrossRiskBucketOrderRiskRequest = SimulateOrderRiskRequest & {
     marginMode: "CROSS";
@@ -466,13 +468,10 @@ export interface SimulateOrderRiskResponse {
     marginMode?: MarginMode;
     /**
      * The cross scope the preview ran against; absent for isolated previews and
-     * never a caller's list. From `simulateRiskBucketOrderRisk` in CROSS mode it
-     * is the DERIVED scope: the active cross bucket's recorded pairs (a pair
-     * whose positions have closed stays recorded until a later cross order on
-     * another pair reconciles the bucket), every pair with an open position in
-     * that bucket, and the previewed pair — the previewed pair alone before the
-     * first cross order. `simulateOrderRisk` and `simulateParentMarginOrderRisk`
-     * report the recorded pairs plus the previewed pair.
+     * never a caller's list: the markets where the active cross bucket has an
+     * open position, sorted by trading pair id, then the previewed pair when it
+     * is not already among them — the previewed pair alone when no cross bucket
+     * is active yet.
      */
     selectedTradingPairIds?: string[];
     equityAfter: string;

package/dist/portfolio/index.d.ts

@@ -273,7 +273,8 @@ export interface PortfolioRiskBucket {
     /**
      * The trading pair this bucket is scoped to. Present for `ISOLATED`
      * buckets; absent (the key is omitted, never null) for `CROSS`, which spans
-     * the pairs selected into it and is scoped to none of them individually.
+     * the markets where it has an open position and is scoped to none of them
+     * individually.
      *
      * For a cross bucket's membership read
      * `MarginAccountSummary.selectedTradingPairIds` — it is not carried here

package/dist/validation/margin-accounts.js

@@ -117,7 +117,7 @@ const CrossTransferNamesNoPairsSchema = z
         code: "custom",
         path: ["selectedTradingPairIds"],
         message: request.marginMode === "CROSS"
-            ? "selectedTradingPairIds is not accepted on a CROSS transfer: cross scope is derived from trading, so a funding call has nothing to declare"
+            ? "selectedTradingPairIds is not accepted on a CROSS transfer: cross scope is the markets where the bucket has an open position, so a funding call has nothing to declare"
             : "selectedTradingPairIds is not supported for ISOLATED risk buckets",
     });
 });
@@ -207,7 +207,7 @@ const CrossSimulateNamesNoPairsSchema = z
         code: "custom",
         path: ["selectedTradingPairIds"],
         message: request.marginMode === "CROSS"
-            ? "selectedTradingPairIds is not accepted on a CROSS preview: cross scope is derived from trading, so a preview has nothing to declare"
+            ? "selectedTradingPairIds is not accepted on a CROSS preview: cross scope is the markets where the bucket has an open position, so a preview has nothing to declare"
             : "selectedTradingPairIds is not supported for ISOLATED risk buckets",
     });
 });

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

@@ -10,7 +10,11 @@ import type { Address } from "viem";
  *
  * 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
+ * user/application and token: higher is newer, equal is idempotent. `lock`
+ * is sent when a spot order's remainder rests on the book, and `unlock` when
+ * that lock is released (cancel, partial cancel, expiry, a replace whose
+ * replacement doesn't rest on the same row, batch cancel). Market, IOC and FOK orders never rest and send neither; a step
+ * that also fills on the row sends only its `trade` frame. `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

package/dist/wire/schema.d.ts

@@ -733,8 +733,10 @@ export interface paths {
          *      maker add-on unchanged. Each must be between 0 and the current builder-fee
          *      cap (`builderFeeCapBps` on `GetBuildercodesConfig`) inclusive; the cap and
          *      the switches are shared by both sides. The application must be enrolled in
-         *      BuilderCodes with a payout address. At most two changes are allowed in any
-         *      rolling 24 hours, and one call that sets both sides is one change; changes
+         *      BuilderCodes with a payout address. The number of changes allowed in any
+         *      rolling 24 hours is a limit Monaco sets (10 by default, never below 1);
+         *      `changesRemaining` on `GetBuildercodesConfig` reports what is left. One
+         *      call that sets both sides is one change; changes
          *      Monaco makes on the application's behalf do not count. Setting the values
          *      it already has is a no-op that succeeds and does not use up a change.
          *
@@ -5892,7 +5894,7 @@ export interface components {
             builderFeeCapBps?: number | null;
             /**
              * Format: uint32
-             * @description Builder-fee changes this application can still make in the current rolling 24 hours (at most 2).
+             * @description Builder-fee changes this application can still make in the current rolling 24 hours, under the limit Monaco sets (10 by default, at most 100).
              * @example 2
              */
             changesRemaining?: number | null;
@@ -6144,6 +6146,10 @@ export interface components {
             strategyKey?: string | null;
             riskBucketId?: string | null;
             marginMode?: string | null;
+            /**
+             * @description Present for cross risk-bucket summary rows: the markets where the cross
+             *      bucket has an open position, sorted by trading pair id.
+             */
             selectedTradingPairIds?: string[] | null;
             /**
              * @description See `MarginAccountSummary.available_order_collateral`: the collateral
@@ -8610,7 +8616,13 @@ export interface components {
             riskBucketId?: string | null;
             /** @description Present only for risk-bucket summary rows. Values: ISOLATED, CROSS. */
             marginMode?: string | null;
-            /** @description Present for cross risk-bucket summary rows. */
+            /**
+             * @description Present for cross risk-bucket summary rows: the markets where the cross
+             *      bucket has an open position, sorted by trading pair id. A market joins
+             *      once a fill's position is persisted and leaves once its last position's
+             *      close is persisted, so a position still being liquidated counts; resting
+             *      orders alone do not.
+             */
             selectedTradingPairIds?: string[] | null;
             /**
              * @description The collateral still available to open NEW orders in this risk bucket:
@@ -9142,12 +9154,12 @@ export interface components {
             /**
              * Format: uuid
              * @description Trading pair UUID this bucket is scoped to. Present for ISOLATED buckets;
-             *      absent for CROSS, which spans the pairs selected into it and is scoped to
-             *      none of them individually — the same invariant the transfer-in endpoint
-             *      enforces by rejecting a `trading_pair_id` in CROSS mode. Read the cross
-             *      bucket's membership from `MarginAccountSummary.selected_trading_pair_ids`;
-             *      it is not carried here because it lives in a separate table and would cost
-             *      this endpoint an extra query per request.
+             *      absent for CROSS, which spans the markets where it has an open position and
+             *      is scoped to none of them individually — the same invariant the
+             *      transfer-in endpoint enforces by rejecting a `trading_pair_id` in CROSS
+             *      mode. Read the cross bucket's membership from
+             *      `MarginAccountSummary.selected_trading_pair_ids`; it is not carried here
+             *      because deriving it would cost this endpoint an extra query per request.
              *
              *      These labels do NOT make this response row-for-row joinable with the
              *      margin-accounts surface on (mode, pair). That surface emits rows this one
@@ -10322,7 +10334,7 @@ export interface components {
             previousBuilderFeeBps?: number | null;
             /**
              * Format: uint32
-             * @description Builder-fee changes this application can still make in the current rolling 24 hours (at most 2).
+             * @description Builder-fee changes this application can still make in the current rolling 24 hours, under the limit Monaco sets (10 by default, at most 100).
              * @example 1
              */
             changesRemaining?: number | null;
@@ -10523,14 +10535,10 @@ export interface components {
             marginMode?: string | null;
             /**
              * @description The cross scope the preview ran against; absent for isolated previews and
-             *      never a request's deprecated list. `SimulateRiskBucketOrderRisk` in CROSS
-             *      mode reports the DERIVED scope: the active cross bucket's recorded pairs
-             *      (a pair whose positions have closed stays recorded until a later cross
-             *      order on another pair reconciles the bucket), every pair with an open
-             *      position in that bucket, and the previewed pair — the previewed pair alone
-             *      before the first cross order. `SimulateOrderRisk` and
-             *      `SimulateParentMarginOrderRisk` report the recorded pairs plus the
-             *      previewed pair.
+             *      never a request's deprecated list: the markets where the active cross
+             *      bucket has an open position, sorted by trading pair id, then the previewed
+             *      pair when it is not already among them — the previewed pair alone when no
+             *      cross bucket is active yet.
              */
             selectedTradingPairIds?: string[] | null;
             /**
@@ -10634,7 +10642,7 @@ export interface components {
             marginMode?: string | null;
             /**
              * @deprecated
-             * @description Deprecated: accepted and ignored. Cross scope is derived from trading (a pair joins the cross bucket when a cross order on it succeeds; after its positions close it stays listed until a later successful cross order on another pair reconciles the bucket), so a cross preview has nothing to declare: it runs against the account's active cross bucket — or the deterministic bucket a first cross order would create — and the previewed pair is in scope by construction. Rejected for ISOLATED, as before. The response's selectedTradingPairIds reports the derived scope (recorded pairs, pairs with open positions in the bucket, and the previewed pair), never this list.
+             * @description Deprecated: accepted and ignored. Cross scope is the markets where the cross bucket has an open position, so a cross preview has nothing to declare: it runs against the account's active cross bucket — or the deterministic bucket a first cross order would create — and the previewed pair is in scope by construction. Rejected for ISOLATED, as before. The response's selectedTradingPairIds reports that scope plus the previewed pair, never this list.
              */
             selectedTradingPairIds?: string[] | null;
             /**
@@ -11265,11 +11273,9 @@ export interface components {
             /** @description Present when collateral was allocated to a risk bucket. Values: ISOLATED, CROSS. */
             marginMode?: string | null;
             /**
-             * @description The cross bucket's recorded pair scope: what trading has recorded (a pair
-             *      joins when a cross order on it fills and leaves when its positions close),
-             *      plus any pair declared before scope became derived, until it trades and
-             *      its positions close. Only on cross risk-bucket transfers, and omitted
-             *      while empty — i.e. until a cross order on the bucket has filled.
+             * @description The cross bucket's scope: the markets where it has an open position,
+             *      sorted by trading pair id. Only on cross risk-bucket transfers, and
+             *      omitted while empty — i.e. while the bucket has no open position.
              */
             selectedTradingPairIds?: string[] | null;
             /**
@@ -11301,14 +11307,13 @@ export interface components {
             strategyKey?: string | null;
             /**
              * @description Risk bucket mode. Defaults to ISOLATED. Values: ISOLATED, CROSS. A CROSS
-             *      transfer names no pairs: the cross bucket's scope is derived from trading —
-             *      a pair joins when a cross order on it succeeds and leaves when its positions
-             *      close — so funding the bucket has nothing to declare.
+             *      transfer names no pairs: the cross bucket's scope is the markets where it
+             *      has an open position, so funding the bucket has nothing to declare.
              */
             marginMode?: string | null;
             /**
              * @deprecated
-             * @description Deprecated: accepted and ignored. Cross scope is derived from trading (a pair joins the cross bucket when a cross order on it succeeds; after its positions close it stays listed until a later successful cross order on another pair reconciles the bucket), so a cross transfer-in has nothing to declare and can no longer replace the scope. Rejected for ISOLATED, as before. Read the current scope from the cross bucket's row in the margin-accounts list or from this response's selectedTradingPairIds; the parent row carries no scope. Pairs declared before scope became derived stay recorded until they trade and their positions close.
+             * @description Deprecated: accepted and ignored. Cross scope is the markets where the cross bucket has an open position, so a cross transfer-in has nothing to declare and can no longer replace the scope. Rejected for ISOLATED, as before. Read the current scope from the cross bucket's row in the margin-accounts list or from this response's selectedTradingPairIds; the parent row carries no scope.
              */
             selectedTradingPairIds?: string[] | null;
             /**
@@ -13929,7 +13934,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The application is not enrolled in BuilderCodes with a payout address, or it has already made two changes in the last 24 hours; the latter carries `details.nextChangeAllowedAt` (gRPC: FAILED_PRECONDITION) */
+            /** @description The application is not enrolled in BuilderCodes with a payout address, or it has already used every change the limit allows in the last 24 hours; the latter carries `details.nextChangeAllowedAt` (gRPC: FAILED_PRECONDITION) */
             409: {
                 headers: {
                     [name: string]: unknown;

package/package.json

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