@0xmonaco/types 1.0.90 → 1.0.92

package/README.md

@@ -22,7 +22,7 @@ import { MonacoSDK, SDKConfig } from "@0xmonaco/types";
 // SDK configuration
 interface SDKConfig {
   walletClient?: WalletClient; // Wallet client for signing operations
-  network: Network; // Use "staging" for public testnet or "mainnet" for production
+  network: Network; // Use "mainnet" (Sei mainnet, production API)
   seiRpcUrl: string; // RPC URL for Sei blockchain interactions
 }
 
@@ -305,7 +305,7 @@ Types for network configuration:
 ```typescript
 import { Network, NetworkEndpoints } from "@0xmonaco/types";
 
-const publicNetwork: Network = "staging";
+const publicNetwork: Network = "mainnet";
 
 interface NetworkEndpoints {
   rpcUrl: string;
@@ -313,7 +313,7 @@ interface NetworkEndpoints {
 }
 ```
 
-For public integrations, use `"staging"` or `"mainnet"`.
+For public integrations, use `"mainnet"`.
 
 ## Type Reference
 
@@ -321,7 +321,7 @@ For public integrations, use `"staging"` or `"mainnet"`.
 
 - `MonacoSDK`: Main SDK interface with all API modules
 - `SDKConfig`: Configuration options for the Monaco SDK
-- `Network`: SDK network preset type. Public integrations should use `"staging"` or `"mainnet"`.
+- `Network`: SDK network preset type. Public integrations should use `"mainnet"`.
 - `AuthState`: Authentication state information
 
 ### Vault Types

package/dist/auth/index.d.ts

@@ -164,3 +164,17 @@ export declare const INVITE_ERROR_CODES: {
     readonly INVITE_CODE_INVALID: "INVITE_CODE_INVALID";
 };
 export type InviteErrorCode = (typeof INVITE_ERROR_CODES)[keyof typeof INVITE_ERROR_CODES];
+/**
+ * Stable codes for a wallet on the OFAC sanctions list, read from
+ * `APIError.serverCode` (REST error envelope `code`, which here is also the
+ * envelope `error`; gRPC `google.rpc.ErrorInfo` reason in the
+ * `auth.0xmonaco.com` domain). Both are HTTP 403 / gRPC `PERMISSION_DENIED`,
+ * and the envelope `message` is meant to be shown to the user as-is.
+ */
+export declare const SANCTIONS_ERROR_CODES: {
+    /** Sign-in with a listed wallet, or a withdrawal to a listed destination. */
+    readonly ADDRESS_RESTRICTED: "ADDRESS_RESTRICTED";
+    /** A live session whose wallet (or delegated agent) is listed; returned on every signed request and on WebSocket authentication/revalidation. */
+    readonly ACCOUNT_RESTRICTED: "ACCOUNT_RESTRICTED";
+};
+export type SanctionsErrorCode = (typeof SANCTIONS_ERROR_CODES)[keyof typeof SANCTIONS_ERROR_CODES];

package/dist/auth/index.js

@@ -20,3 +20,16 @@ export const INVITE_ERROR_CODES = {
     /** The invite code was not accepted (wrong, already redeemed, revoked, or issued by a deactivated wallet; deliberately indistinguishable). */
     INVITE_CODE_INVALID: "INVITE_CODE_INVALID",
 };
+/**
+ * Stable codes for a wallet on the OFAC sanctions list, read from
+ * `APIError.serverCode` (REST error envelope `code`, which here is also the
+ * envelope `error`; gRPC `google.rpc.ErrorInfo` reason in the
+ * `auth.0xmonaco.com` domain). Both are HTTP 403 / gRPC `PERMISSION_DENIED`,
+ * and the envelope `message` is meant to be shown to the user as-is.
+ */
+export const SANCTIONS_ERROR_CODES = {
+    /** Sign-in with a listed wallet, or a withdrawal to a listed destination. */
+    ADDRESS_RESTRICTED: "ADDRESS_RESTRICTED",
+    /** A live session whose wallet (or delegated agent) is listed; returned on every signed request and on WebSocket authentication/revalidation. */
+    ACCOUNT_RESTRICTED: "ACCOUNT_RESTRICTED",
+};

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/compliance/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Compliance Types
+ *
+ * Types for the public region status endpoint. Monaco refuses callers from a
+ * restricted jurisdiction on every other endpoint with HTTP 451 and the error
+ * code `REGION_RESTRICTED`; this endpoint answers from every region so a
+ * frontend can show a region notice instead.
+ *
+ * NOTE: This endpoint is **public (unauthenticated)**.
+ */
+import type { BaseAPI } from "../api";
+/** The caller's region status. */
+export interface GetRegionStatusResponse {
+    /** True when Monaco is not available in the caller's region. */
+    restricted: boolean;
+    /** ISO 3166-1 alpha-2 country code (`T1` Tor, `XX` unknown); empty when the request carried no location. */
+    country: string;
+}
+/**
+ * Compliance API interface. The endpoint is public (no auth required).
+ */
+export interface ComplianceAPI extends BaseAPI {
+    /**
+     * Get the caller's region status.
+     *
+     * Public/unauthenticated and always answers 200, including from restricted
+     * regions.
+     *
+     * @returns Promise resolving to the caller's region status
+     */
+    getRegionStatus(): Promise<GetRegionStatusResponse>;
+}

package/dist/compliance/index.js

@@ -0,0 +1,10 @@
+/**
+ * Compliance Types
+ *
+ * Types for the public region status endpoint. Monaco refuses callers from a
+ * restricted jurisdiction on every other endpoint with HTTP 451 and the error
+ * code `REGION_RESTRICTED`; this endpoint answers from every region so a
+ * frontend can show a region notice instead.
+ *
+ * NOTE: This endpoint is **public (unauthenticated)**.
+ */

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/index.d.ts

@@ -8,6 +8,7 @@ export * from "./api";
 export * from "./applications";
 export * from "./auth";
 export * from "./buildercodes";
+export * from "./compliance";
 export * from "./contracts";
 export * from "./copy-trading";
 export * from "./delegated-agents";

package/dist/index.js

@@ -9,6 +9,7 @@ export * from "./api";
 export * from "./applications";
 export * from "./auth";
 export * from "./buildercodes";
+export * from "./compliance";
 export * from "./contracts";
 export * from "./copy-trading";
 export * from "./delegated-agents";

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/sdk/index.d.ts

@@ -2,6 +2,7 @@ import type { Address, PublicClient, TransactionReceipt, WalletClient } from "vi
 import type { ApplicationsAPI } from "../applications";
 import type { AuthAPI, AuthState } from "../auth/index";
 import type { BuildercodesAPI } from "../buildercodes";
+import type { ComplianceAPI } from "../compliance";
 import type { CopyTradingAPI } from "../copy-trading";
 import type { DelegatedAgentsAPI } from "../delegated-agents";
 import type { FaucetAPI } from "../faucet";
@@ -130,6 +131,8 @@ export interface MonacoSDK {
     profile: ProfileAPI;
     /** Public market-pulse news feed API (cached, hourly-refreshed) */
     pulse: PulseAPI;
+    /** Public region status API: whether Monaco is available in the caller's region */
+    compliance: ComplianceAPI;
     /** Orderbook REST API for fetching orderbook snapshots */
     orderbook: {
         getOrderbook: (tradingPairId: string, options?: {

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/websocket/base.d.ts

@@ -106,6 +106,8 @@ export type WebSocketErrorCode =
  | "AUTH_FAILED"
 /** The account is deactivated; the connection closes and must not automatically reconnect. */
  | "ACCOUNT_DEACTIVATED"
+/** The session's wallet is on the OFAC sanctions list; the connection closes and must not automatically reconnect. */
+ | "ACCOUNT_RESTRICTED"
 /** The per-user concurrent-connection cap was reached; this connection is closed after the frame. */
  | "CONNECTION_LIMIT"
 /** The per-connection subscription-cardinality cap was reached. */
@@ -170,9 +172,10 @@ export interface WebSocketReauthenticationInfo {
     /**
      * The `Error` frame code that ended the connection: `SESSION_INVALID` (the
      * session was revoked or expired after the handshake) or `AUTH_FAILED` (the
-     * `Authenticate` handshake itself was rejected), or `ACCOUNT_DEACTIVATED`.
+     * `Authenticate` handshake itself was rejected), `ACCOUNT_DEACTIVATED`, or
+     * `ACCOUNT_RESTRICTED` (the wallet is on the OFAC sanctions list).
      */
-    code: "SESSION_INVALID" | "AUTH_FAILED" | "ACCOUNT_DEACTIVATED";
+    code: "SESSION_INVALID" | "AUTH_FAILED" | "ACCOUNT_DEACTIVATED" | "ACCOUNT_RESTRICTED";
     /** Human-readable description from the `Error` frame; for logging and display, never for branching. */
     message: string;
     /** WebSocket close code of the connection that was lost (1008 for `SESSION_INVALID`). */

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_follow_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", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_all_copy_positions", "close_follow_positions", "close_position", "close_sub_account", "create_challenge", "create_delegated_session", "create_order", "create_sub_account", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_liquidation_metrics", "get_margin_account_movements", "get_margin_account_pnl", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "get_my_referral_tree", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_sweeper_deposit_status", "get_trade_by_id", "get_trade_flow", "get_trader_code_info", "get_trader_metrics", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_builder_fee_changes", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_invite_codes", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_liquidation_events", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_sweeper_deposits", "list_trading_pairs", "list_twap_order_slices", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "request_invite_codes", "revoke_delegated_agent", "revoke_session", "set_builder_fee", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_from_sub_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_collateral_to_sub_account", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_follow_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", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_all_copy_positions", "close_follow_positions", "close_position", "close_sub_account", "create_challenge", "create_delegated_session", "create_order", "create_sub_account", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_liquidation_metrics", "get_margin_account_movements", "get_margin_account_pnl", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "get_my_referral_tree", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_region_status", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_sweeper_deposit_status", "get_trade_by_id", "get_trade_flow", "get_trader_code_info", "get_trader_metrics", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_builder_fee_changes", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_invite_codes", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_liquidation_events", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_sweeper_deposits", "list_trading_pairs", "list_twap_order_slices", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "request_invite_codes", "revoke_delegated_agent", "revoke_session", "set_builder_fee", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_from_sub_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_collateral_to_sub_account", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -82,6 +82,7 @@ export const OPERATION_IDS = [
     "get_position_pnl_history",
     "get_position_risk",
     "get_pulse",
+    "get_region_status",
     "get_rewards_balance",
     "get_screener",
     "get_self_trade_prevention_default",

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
@@ -966,6 +968,37 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/compliance/region": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the caller's region status
+         * @description Get the caller's region status.
+         *
+         *      Reports whether Monaco is available in the caller's region, so a
+         *      frontend can show a region notice instead of failing on the next call.
+         *      Public endpoint — no authentication required — and always answers 200.
+         *      Over REST it answers from restricted regions too: GET on this path is
+         *      the one request the production edge lets through. Over gRPC the edge
+         *      refuses a restricted caller with HTTP 451 before it reaches this RPC,
+         *      so clients that need the notice should call the REST endpoint. Every
+         *      other endpoint refuses callers from a restricted region with 451
+         *      REGION_RESTRICTED (gRPC: PERMISSION_DENIED with a google.rpc.ErrorInfo
+         *      reason REGION_RESTRICTED).
+         */
+        get: operations["get_region_status"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/copy-trading/follows": {
         parameters: {
             query?: never;
@@ -7233,6 +7266,18 @@ export interface components {
             /** @description Pulse items, pre-sorted: watchlist order first, MARKET last, most-recent-first within each asset. Items with unverified figures are removed server-side. */
             items?: components["schemas"]["PulseItem"][] | null;
         };
+        GetRegionStatusResponse: {
+            /**
+             * @description True when Monaco is not available in the caller's region; every other endpoint then answers 451 REGION_RESTRICTED
+             * @example false
+             */
+            restricted?: boolean | null;
+            /**
+             * @description The caller's ISO 3166-1 alpha-2 country code as the edge geolocated it (T1 for Tor, XX for unknown); empty when the request carried no location
+             * @example JP
+             */
+            country?: string | null;
+        };
         GetRewardsBalanceResponse: {
             /** @description One entry per reward token that has a non-zero available balance. */
             balances?: components["schemas"]["RewardsBalanceEntry"][] | null;
@@ -9147,6 +9192,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 +10378,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 +10406,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 +11188,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 +11211,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 +11229,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 +11256,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 +11301,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 +11358,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: {
             /**
@@ -13646,7 +13694,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Origin not allowed for this application */
+            /** @description Origin not allowed for this application; or the wallet is on the OFAC sanctions list, refused with code ADDRESS_RESTRICTED (REST error envelope error and code; gRPC google.rpc.ErrorInfo reason, domain auth.0xmonaco.com) and the message "This wallet can't be used on Monaco." */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -13809,7 +13857,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Origin not allowed for this application; the account or wallet is deactivated; or Mainnet Invite Mode is on and the wallet has no access grant and supplied no valid invite code. Auth refusals carry a stable code (REST error envelope code; gRPC google.rpc.ErrorInfo reason, domain auth.0xmonaco.com): ACCOUNT_DEACTIVATED for a deactivated signing account, INVITE_CODE_REQUIRED when no code was supplied, and INVITE_CODE_INVALID for a wrong, already redeemed or revoked code, or an unused code whose issuer is deactivated. No account identity or administrative deactivation reason is disclosed. Unused invites become usable again after issuer reactivation */
+            /** @description Origin not allowed for this application; the account or wallet is deactivated; or Mainnet Invite Mode is on and the wallet has no access grant and supplied no valid invite code. Auth refusals carry a stable code (REST error envelope code; gRPC google.rpc.ErrorInfo reason, domain auth.0xmonaco.com): ACCOUNT_DEACTIVATED for a deactivated signing account, INVITE_CODE_REQUIRED when no code was supplied, and INVITE_CODE_INVALID for a wrong, already redeemed or revoked code, or an unused code whose issuer is deactivated. A wallet on the OFAC sanctions list is refused with ADDRESS_RESTRICTED. No account identity or administrative deactivation reason is disclosed. Unused invites become usable again after issuer reactivation */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -14285,6 +14333,26 @@ export interface operations {
             };
         };
     };
+    get_region_status: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetRegionStatusResponse"];
+                };
+            };
+        };
+    };
     list_my_follows: {
         parameters: {
             query?: {
@@ -19904,7 +19972,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Caller lacks the withdraw permission */
+            /** @description Caller lacks the withdraw permission; or the destination is on the OFAC sanctions list, refused with code ADDRESS_RESTRICTED (REST error envelope error and code; gRPC google.rpc.ErrorInfo reason, domain auth.0xmonaco.com) and the message "Withdrawals to this address aren't supported." */
             403: {
                 headers: {
                     [name: string]: unknown;

package/package.json

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