@0xmonaco/types 1.0.90 → 1.0.91

package/dist/buildercodes/index.d.ts

@@ -48,8 +48,10 @@ export interface BuildercodesAPI extends BaseAPI {
      * The bucket is resolved from the authenticated caller's own wallet address,
      * so a caller can only ever claim their own accrued balance. A wallet that
      * has never been an enrolled frontend's payout address has nothing to claim.
-     * A wallet that *used to be* a payout address keeps what it accrued back then
-     * and can still claim it — payout-address changes are not retroactive.
+     * Shortly after Monaco moves a frontend's payout address to a new wallet, the
+     * unclaimed balance accrued to the old wallet moves with it. A wallet that
+     * *used to be* a payout address can still claim whatever remains in its
+     * bucket.
      *
      * Throws 403 when the session is a delegated agent — a permanent
      * restriction on that session type, not a rollout state. No program switch

package/dist/fees/responses.d.ts

@@ -34,10 +34,8 @@ export declare const SimulateFeeResponseSchema: z.ZodObject<{
     applicationMakerFee: z.ZodOptional<z.ZodString>;
     applicationMakerFeeBps: z.ZodOptional<z.ZodNumber>;
     monacoMakerRebate: z.ZodString;
-    monacoMakerRebateBps: z.ZodNumber;
     monacoMakerRebateBpsExact: z.ZodString;
     monacoTakerFee: z.ZodString;
-    monacoTakerFeeBps: z.ZodNumber;
     monacoTakerFeeBpsExact: z.ZodString;
     notional: z.ZodString;
     takerTotalPayment: z.ZodString;

package/dist/fees/responses.js

@@ -69,12 +69,6 @@ export const SimulateFeeResponseSchema = z.object({
     applicationMakerFeeBps: z.number().optional(),
     /** Monaco protocol maker rebate (negative = rebate) */
     monacoMakerRebate: z.string(),
-    /**
-     * Monaco maker rebate in basis points.
-     * @deprecated Integer field cannot represent fractional tiered rebates (e.g. -1.15); it
-     * echoes the flat trading-pair column, not the tier-resolved rate. Use monacoMakerRebateBpsExact.
-     */
-    monacoMakerRebateBps: z.number(),
     /**
      * Tier-resolved Monaco maker rebate as a decimal basis-points string (negative is a
      * rebate), e.g. "-1" — the exact rate the ledger credits this caller.
@@ -82,12 +76,6 @@ export const SimulateFeeResponseSchema = z.object({
     monacoMakerRebateBpsExact: z.string(),
     /** Monaco protocol taker fee */
     monacoTakerFee: z.string(),
-    /**
-     * Monaco taker fee in basis points.
-     * @deprecated Integer field cannot represent fractional tiered rates (e.g. 6.5); it echoes
-     * the flat trading-pair column, not the tier-resolved rate. Use monacoTakerFeeBpsExact.
-     */
-    monacoTakerFeeBps: z.number(),
     /**
      * Tier-resolved Monaco taker fee as a decimal basis-points string, e.g. "6.5" — the exact
      * rate the ledger charges this caller (equals monacoTakerFee / notional).

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

@@ -221,10 +221,26 @@ export interface TransferCollateralRequest {
      * bucket, which has no trading pair and so cannot be named any other way.
      */
     marginMode?: MarginMode;
+    /**
+     * Submission identity (1-64 of `A-Za-z0-9._:-`), shared with order create.
+     * Retrying the same key and request within 15 minutes returns the first
+     * transfer's result, its `movementId` included, and moves nothing again.
+     * Generate one per intended transfer and keep it across its retries; a
+     * different request under the same key fails with `IDEMPOTENCY_KEY_CONFLICT`.
+     */
+    idempotencyKey?: string;
 }
 export interface TransferCollateralToParentMarginAccountRequest {
     asset: string;
     amount: string;
+    /**
+     * Submission identity (1-64 of `A-Za-z0-9._:-`), shared with order create.
+     * Retrying the same key and request within 15 minutes returns the first
+     * transfer's result, its `movementId` included, and moves nothing again.
+     * Generate one per intended transfer and keep it across its retries; a
+     * different request under the same key fails with `IDEMPOTENCY_KEY_CONFLICT`.
+     */
+    idempotencyKey?: string;
 }
 /**
  * Fund a pair's isolated risk bucket from the parent margin account's
@@ -289,6 +305,14 @@ export type TransferCollateralToRiskBucketRequest = TransferCollateralToIsolated
 export interface TransferCollateralFromParentMarginAccountRequest {
     asset: string;
     amount: string;
+    /**
+     * Submission identity (1-64 of `A-Za-z0-9._:-`), shared with order create.
+     * Retrying the same key and request within 15 minutes returns the first
+     * transfer's result, its `movementId` included, and moves nothing again.
+     * Generate one per intended transfer and keep it across its retries; a
+     * different request under the same key fails with `IDEMPOTENCY_KEY_CONFLICT`.
+     */
+    idempotencyKey?: string;
 }
 export interface TransferCollateralResponse {
     movementId: string;
@@ -582,6 +606,14 @@ export interface TransferMarginCollateralRequest {
     amount: string;
     from: CollateralTransferEndpoint;
     to: CollateralTransferEndpoint;
+    /**
+     * Submission identity (1-64 of `A-Za-z0-9._:-`), shared with order create.
+     * Retrying the same key and request within 15 minutes returns the first
+     * transfer's result, its `movementId` included, and moves nothing again.
+     * Generate one per intended transfer and keep it across its retries; a
+     * different request under the same key fails with `IDEMPOTENCY_KEY_CONFLICT`.
+     */
+    idempotencyKey?: string;
 }
 export interface TransferMarginCollateralResponse {
     movementId: string;

package/dist/portfolio/index.d.ts

@@ -28,6 +28,12 @@ export interface PortfolioSummaryCurrent {
     spotEquity?: string;
     perpsEquity: string;
     unrealizedPnl?: string;
+    /**
+     * What the user can spend or withdraw now: USDC available on spot plus the
+     * parent margin account's `withdrawableCollateral`. Other spot assets and
+     * unrealized margin gains are not counted. Served even when the valuation
+     * is partial.
+     */
     availableValue?: string;
 }
 export interface PortfolioSummaryActivity {

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

@@ -30,12 +30,14 @@ export declare const TransferCollateralSchema: z.ZodObject<{
             ISOLATED: "ISOLATED";
             CROSS: "CROSS";
         }>>;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const TransferCollateralToParentMarginAccountSchema: z.ZodObject<{
     request: z.ZodObject<{
         asset: z.ZodString;
         amount: z.ZodString;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const TransferCollateralToRiskBucketSchema: z.ZodObject<{
@@ -48,6 +50,7 @@ export declare const TransferCollateralToRiskBucketSchema: z.ZodObject<{
     }, z.core.$loose>, z.ZodUnion<readonly [z.ZodObject<{
         asset: z.ZodString;
         amount: z.ZodString;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
         tradingPairId: z.ZodUUID;
         strategyKey: z.ZodOptional<z.ZodString>;
         marginMode: z.ZodOptional<z.ZodLiteral<"ISOLATED">>;
@@ -57,6 +60,7 @@ export declare const TransferCollateralToRiskBucketSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         asset: z.ZodString;
         amount: z.ZodString;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
         marginMode: z.ZodLiteral<"CROSS">;
         marginAccountId: z.ZodOptional<z.ZodUUID>;
         selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
@@ -68,6 +72,7 @@ export declare const TransferCollateralFromParentMarginAccountSchema: z.ZodObjec
     request: z.ZodObject<{
         asset: z.ZodString;
         amount: z.ZodString;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const GetMarginAccountMovementsSchema: z.ZodObject<{
@@ -200,6 +205,7 @@ export declare const CloseMarginSubAccountSchema: z.ZodObject<{
 export declare const SubAccountCollateralTransferSchema: z.ZodObject<{
     marginAccountId: z.ZodUUID;
     amount: z.ZodString;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const GetMarginAccountPnlSchema: z.ZodObject<{
     marginAccountId: z.ZodUUID;
@@ -220,5 +226,6 @@ export declare const TransferMarginCollateralSchema: z.ZodObject<{
             marginAccountId: z.ZodUUID;
             riskBucketId: z.ZodOptional<z.ZodUUID>;
         }, z.core.$strict>]>;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
 }, z.core.$strip>;

package/dist/validation/margin-accounts.js

@@ -2,7 +2,7 @@
  * Margin Account API Validation Schemas
  */
 import { z } from "zod";
-import { MarketSlippageToleranceBpsSchema, OrderSideSchema, OrderTypeSchema, PositionSideSchema, PositiveDecimalStringSchema, UUIDSchema } from "./trading";
+import { MarketSlippageToleranceBpsSchema, OrderIdempotencyKeySchema, OrderSideSchema, OrderTypeSchema, PositionSideSchema, PositiveDecimalStringSchema, UUIDSchema, } from "./trading";
 const CursorPaginationSchema = z.object({
     /**
      * Rejected, not ignored. A non-strict object would let a JS or `any` caller
@@ -41,6 +41,7 @@ const TransferCollateralRequestSchema = z
     // A cross risk bucket has no trading pair, so CROSS is the only way to name
     // one on the way out (0XM-2420). The two never combine.
     marginMode: z.enum(["ISOLATED", "CROSS"]).optional(),
+    idempotencyKey: OrderIdempotencyKeySchema.optional(),
 })
     .refine((request) => !(request.marginMode === "CROSS" && request.tradingPairId !== undefined), {
     message: "tradingPairId is not supported for CROSS risk buckets",
@@ -49,6 +50,7 @@ const TransferCollateralRequestSchema = z
 const ParentMarginAccountCollateralRequestSchema = z.object({
     asset: z.string().trim().min(1, "Asset cannot be empty"),
     amount: PositiveDecimalStringSchema,
+    idempotencyKey: OrderIdempotencyKeySchema.optional(),
 });
 const RiskBucketRequestSchema = z.object({
     tradingPairId: UUIDSchema,
@@ -256,6 +258,7 @@ export const CloseMarginSubAccountSchema = z.object({
 export const SubAccountCollateralTransferSchema = z.object({
     marginAccountId: UUIDSchema,
     amount: PositiveDecimalStringSchema,
+    idempotencyKey: OrderIdempotencyKeySchema.optional(),
 });
 export const GetMarginAccountPnlSchema = z.object({
     marginAccountId: UUIDSchema,
@@ -271,6 +274,7 @@ export const TransferMarginCollateralSchema = z.object({
         amount: PositiveDecimalStringSchema,
         from: CollateralTransferEndpointSchema,
         to: CollateralTransferEndpointSchema,
+        idempotencyKey: OrderIdempotencyKeySchema.optional(),
     })
         .strict(),
 });

package/dist/wire/schema.d.ts

@@ -904,10 +904,12 @@ export interface paths {
          *      The bucket is resolved from the AUTHENTICATED caller's own wallet address,
          *      never from the request body, so a caller can only ever claim their own
          *      accrued balance. A wallet that has never been an enrolled frontend's payout
-         *      address simply has an empty bucket. A wallet that USED to be a payout
-         *      address keeps whatever it accrued back then and can still claim it —
-         *      payout-address changes are not retroactive, so current enrollment is
-         *      deliberately not required.
+         *      address simply has an empty bucket. Shortly after Monaco moves a
+         *      frontend's payout address to a new wallet, the unclaimed balance accrued
+         *      to the old wallet moves to the new wallet. A wallet several frontends paid
+         *      into before each payout wallet was limited to one frontend is not moved.
+         *      Current enrollment is deliberately not required, so a wallet that used to
+         *      be a payout address can still claim whatever remains in its bucket.
          *
          *      The payout wallet may be an EOA or a smart-contract wallet. An EOA answers
          *      Monaco's signature challenge directly. A contract wallet — a multisig such
@@ -9147,6 +9149,7 @@ export interface components {
             spotEquity?: string | null;
             perpsEquity?: string | null;
             unrealizedPnl?: string | null;
+            /** @description What the user can spend or withdraw now, in USD: the quote asset (USDC) available on spot, at face value, plus the parent margin account's withdrawableCollateral, the same figure the portfolio margin endpoint serves. Other spot assets and unrealized margin gains are equity, not availability, and are not counted. Prices nothing, so it is served even when valuationStatus is partial. */
             availableValue?: string | null;
         };
         PortfolioWindow: {
@@ -10332,20 +10335,6 @@ export interface components {
              * @example 20030.00
              */
             buyOrderLockAmount?: string | null;
-            /**
-             * Format: int32
-             * @deprecated
-             * @description DEPRECATED: whole-basis-points taker rate. An integer cannot represent fractional tiered rates (e.g. 6.5), so this echoes the flat trading_pairs column, NOT the tier-resolved rate the ledger charges. Kept for backward compatibility. Use monaco_taker_fee_bps_exact (or GET /api/v1/fees/tier).
-             * @example 10
-             */
-            monacoTakerFeeBps?: number | null;
-            /**
-             * Format: int32
-             * @deprecated
-             * @description DEPRECATED: whole-basis-points maker rebate. An integer cannot represent fractional tiered rebates (e.g. -1.15), so this echoes the flat trading_pairs column, NOT the tier-resolved rate. Kept for backward compatibility. Use monaco_maker_rebate_bps_exact (or GET /api/v1/fees/tier).
-             * @example -2
-             */
-            monacoMakerRebateBps?: number | null;
             /**
              * Format: int32
              * @description Application taker fee rate in basis points
@@ -10374,12 +10363,12 @@ export interface components {
              */
             slippageToleranceBps?: number | null;
             /**
-             * @description Tier-resolved Monaco taker fee rate as a decimal basis-points string — the exact rate the ledger charges this caller (equals monaco_taker_fee / notional). Fractional and per-tier, e.g. "6.5". Prefer this over the deprecated integer monaco_taker_fee_bps.
+             * @description Tier-resolved Monaco taker fee rate as a decimal basis-points string — the exact rate the ledger charges this caller (equals monaco_taker_fee / notional). Fractional and per-tier, e.g. "6.5".
              * @example 6.5
              */
             monacoTakerFeeBpsExact?: string | null;
             /**
-             * @description Tier-resolved Monaco maker rebate as a decimal basis-points string (negative is a rebate) — the exact rate the ledger credits this caller. Fractional and per-tier, e.g. "-1". Prefer this over the deprecated integer monaco_maker_rebate_bps.
+             * @description Tier-resolved Monaco maker rebate as a decimal basis-points string (negative is a rebate) — the exact rate the ledger credits this caller. Fractional and per-tier, e.g. "-1".
              * @example -1
              */
             monacoMakerRebateBpsExact?: string | null;
@@ -11156,6 +11145,8 @@ export interface components {
              *      trading pair and so cannot be named any other way. Values: ISOLATED, CROSS.
              */
             marginMode?: string | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferCollateralFromMarginAccountResponse: {
             movementId?: string | null;
@@ -11177,11 +11168,15 @@ export interface components {
         TransferCollateralFromParentMarginAccountRequest: {
             asset?: string | null;
             amount?: string | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferCollateralFromSubAccountRequest: {
             /** @description The caller's sub-account the collateral leaves. */
             marginAccountId?: string | null;
             amount?: string | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferCollateralRequest: {
             /** @description Collateral asset symbol or address. */
@@ -11191,6 +11186,8 @@ export interface components {
             from?: components["schemas"]["CollateralTransferEndpoint"] | null;
             /** @description Where the collateral goes. */
             to?: components["schemas"]["CollateralTransferEndpoint"] | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferCollateralResponse: {
             movementId?: string | null;
@@ -11216,6 +11213,8 @@ export interface components {
             tradingPairId?: string | null;
             /** @description Optional strategy key echoed in responses when callers scope a risk bucket. */
             strategyKey?: string | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferCollateralToMarginAccountResponse: {
             movementId?: string | null;
@@ -11259,6 +11258,8 @@ export interface components {
         TransferCollateralToParentMarginAccountRequest: {
             asset?: string | null;
             amount?: string | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferCollateralToRiskBucketRequest: {
             asset?: string | null;
@@ -11314,11 +11315,15 @@ export interface components {
              *      sub-account's buckets belong to its follow and are refused.
              */
             marginAccountId?: string | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferCollateralToSubAccountRequest: {
             /** @description The caller's sub-account that receives the collateral. */
             marginAccountId?: string | null;
             amount?: string | null;
+            /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
+            idempotencyKey?: string | null;
         };
         TransferRewardsRequest: {
             /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.90",
+	"version": "1.0.91",
 	"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.90",
+		"@0xmonaco/contracts": "1.0.91",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {