@0xmonaco/types 1.0.83 → 1.0.85

package/dist/auth/index.d.ts

@@ -27,7 +27,7 @@ export interface AuthAPI extends BaseAPI {
      *   relationship. Has no effect when the user already exists.
      * @returns Promise resolving to the authentication state (including the session keypair)
      */
-    authenticate(clientId: string, referralCode?: string): Promise<AuthState>;
+    authenticate(clientId: string, referralCode?: string, inviteCode?: string): Promise<AuthState>;
     /**
      * Signs a challenge message using the wallet client.
      *
@@ -75,7 +75,18 @@ export interface AuthAPI extends BaseAPI {
      *   recorded at first sign-up only.
      * @returns Promise resolving to the authentication state
      */
-    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials, referralCode?: string): Promise<AuthState>;
+    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials, referralCode?: string, inviteCode?: string): Promise<AuthState>;
+    /**
+     * Mint one available Mainnet invite code immediately, without admin review.
+     * Each call consumes a slot; read the allowance with {@link listInviteCodes}.
+     */
+    requestInviteCodes(): Promise<InviteCodeRequestSummary>;
+    /**
+     * Read the wallet's invite allowance and the codes it minted, newest first.
+     * Read-only: never consumes a slot, and recovers a code whose mint response
+     * was lost. Refused for delegated-agent sessions.
+     */
+    listInviteCodes(): Promise<InviteCodeList>;
     /**
      * Refreshes the current session's expiry. The request is signed with the
      * active session key (set via {@link setSessionKeypair}). For a delegated
@@ -98,3 +109,58 @@ export interface AuthAPI extends BaseAPI {
     setWalletClient(walletClient: unknown): void;
 }
 export type { ApplicationInfo, AuthState, ChallengeResponse, SessionCredentials, SessionRefreshResponse, User, } from "./responses";
+export interface InviteCodeRequestSummary {
+    mainnetVolumeUsd: string;
+    eligibleMilestones: number;
+    pendingMilestones: number[];
+    issuedMilestones: number[];
+    redeemedMilestones: number[];
+    newlyRequestedMilestones: number[];
+    /** Newly minted bearer code; absent when the allowance is exhausted. Never log it. */
+    code?: string;
+    codeId?: string;
+    /** Slot 0 is the initial code; N is the Nth 250,000 USDC milestone. */
+    mintedMilestone?: number;
+    totalAllowance: number;
+    availableCodes: number;
+    revokedMilestones: number[];
+}
+/** One code the wallet minted or was issued. */
+export interface InviteCodeEntry {
+    codeId: string;
+    /** Slot 0 is the initial code; N is the Nth 250,000 USDC milestone. */
+    milestone: number;
+    /** `issued`, `redeemed` or `revoked`. */
+    status: string;
+    /** Bearer code, present only while issued and unredeemed. Never log it. */
+    code?: string;
+    /** RFC 3339 creation time. */
+    createdAt: string;
+    /** RFC 3339 redemption time; absent until redeemed. */
+    redeemedAt?: string;
+}
+/** The wallet's invite allowance and its codes, from `listInviteCodes()`. */
+export interface InviteCodeList {
+    mainnetVolumeUsd: string;
+    eligibleMilestones: number;
+    totalAllowance: number;
+    availableCodes: number;
+    codes: InviteCodeEntry[];
+}
+/**
+ * Stable codes on a refused sign-in (deactivation applies in either mode), read
+ * from `APIError.serverCode` (REST error envelope `code`, gRPC
+ * `google.rpc.ErrorInfo` reason in the `auth.0xmonaco.com` domain). These are
+ * HTTP 403. ACCOUNT_DEACTIVATED also survives signed-request authentication
+ * and WebSocket authentication/revalidation. Expired or revoked sessions still
+ * require a fresh sign-in; a wallet without a grant receives INVITE_CODE_REQUIRED.
+ */
+export declare const INVITE_ERROR_CODES: {
+    /** The signing account is deactivated. */
+    readonly ACCOUNT_DEACTIVATED: "ACCOUNT_DEACTIVATED";
+    /** The wallet has no Mainnet access grant and no invite code was supplied: show code entry. */
+    readonly INVITE_CODE_REQUIRED: "INVITE_CODE_REQUIRED";
+    /** The invite code was not accepted (wrong, already redeemed, revoked, or issued by a deactivated wallet; deliberately indistinguishable). */
+    readonly INVITE_CODE_INVALID: "INVITE_CODE_INVALID";
+};
+export type InviteErrorCode = (typeof INVITE_ERROR_CODES)[keyof typeof INVITE_ERROR_CODES];

package/dist/auth/index.js

@@ -4,3 +4,19 @@
  * Types for wallet authentication operations including challenge creation,
  * signature verification, and session lifecycle.
  */
+/**
+ * Stable codes on a refused sign-in (deactivation applies in either mode), read
+ * from `APIError.serverCode` (REST error envelope `code`, gRPC
+ * `google.rpc.ErrorInfo` reason in the `auth.0xmonaco.com` domain). These are
+ * HTTP 403. ACCOUNT_DEACTIVATED also survives signed-request authentication
+ * and WebSocket authentication/revalidation. Expired or revoked sessions still
+ * require a fresh sign-in; a wallet without a grant receives INVITE_CODE_REQUIRED.
+ */
+export const INVITE_ERROR_CODES = {
+    /** The signing account is deactivated. */
+    ACCOUNT_DEACTIVATED: "ACCOUNT_DEACTIVATED",
+    /** The wallet has no Mainnet access grant and no invite code was supplied: show code entry. */
+    INVITE_CODE_REQUIRED: "INVITE_CODE_REQUIRED",
+    /** The invite code was not accepted (wrong, already redeemed, revoked, or issued by a deactivated wallet; deliberately indistinguishable). */
+    INVITE_CODE_INVALID: "INVITE_CODE_INVALID",
+};

package/dist/positions/index.d.ts

@@ -162,11 +162,11 @@ export interface Position {
      * comparison rather than ranking it as oldest.
      *
      * The merge rule is PER FIELD GROUP, never per payload. On an EQUAL version
-     * skip the versioned fields as an idempotent redelivery — EXCEPT
-     * `isolatedMargin`, which the WebSocket positions snapshot overlays from an
-     * independent live matching-engine read rather than from the versioned row,
-     * so it can reflect a later command than the version names and must be
-     * taken from the newer payload. Also still take
+     * skip the versioned fields as an idempotent redelivery — EXCEPT on a
+     * WebSocket positions snapshot row, which wins the tie on every field: it
+     * is built from live matching-engine state under the persisted row's
+     * version, so it can reflect a later command than the version names. Also
+     * still take
      * `markPrice`, `unrealizedPnl`, `liquidationPrice`, `leverage`,
      * `maintenanceMarginRequired` and `initialMarginRequired` from the newer
      * payload: those six are re-derived on every read rather than served from

package/dist/sdk/index.d.ts

@@ -177,9 +177,14 @@ export interface MonacoSDK {
      * Complete authentication flow
      * @param clientId - The client ID for authentication
      * @param options - Optional configuration for login
+     * @param options.connectWebSocket - Auto-connect WebSocket after login (default: false)
+     * @param options.inviteCode - Optional case-sensitive Mainnet invite code. Needed while Mainnet
+     *   Invite Mode is on for any wallet without a Mainnet access grant, existing accounts included;
+     *   a wallet that already has access never needs it.
      */
     login(clientId: string, options?: {
         connectWebSocket?: boolean;
+        inviteCode?: string;
     }): Promise<AuthState>;
     /**
      * Create and adopt an owner-scoped delegated session.

package/dist/websocket/base.d.ts

@@ -104,6 +104,8 @@ export type WebSocketErrorCode =
 "AUTH_REQUIRED"
 /** The `Authenticate` handshake was rejected; the connection is closed after this frame. */
  | "AUTH_FAILED"
+/** The account is deactivated; the connection closes and must not automatically reconnect. */
+ | "ACCOUNT_DEACTIVATED"
 /** 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. */
@@ -168,9 +170,9 @@ 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).
+     * `Authenticate` handshake itself was rejected), or `ACCOUNT_DEACTIVATED`.
      */
-    code: "SESSION_INVALID" | "AUTH_FAILED";
+    code: "SESSION_INVALID" | "AUTH_FAILED" | "ACCOUNT_DEACTIVATED";
     /** 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/websocket/events/account-events.d.ts

@@ -2,7 +2,8 @@
  * Account WebSocket Event Types
  *
  * Types for real-time account-level margin updates: equity, collateral, free
- * collateral, margin ratio, and maintenance requirement for a margin account.
+ * collateral, margin ratio, maintenance requirement, initial margin required,
+ * withdrawable collateral, and realized PnL for a margin account.
  *
  * This is an authenticated channel - requires the signed session-key handshake.
  * Detected broadcast lag closes the connection with 1013 and requires resync.
@@ -84,6 +85,30 @@ export interface AccountEventData {
     marginRatio: string;
     /** Maintenance margin required to keep the account solvent (decimal string) */
     maintenanceRequirement: string;
+    /**
+     * Initial margin required by the account's open positions and resting
+     * orders (decimal string). The same value as the margin-account REST row's
+     * `initialMarginRequired`, so placing or cancelling a resting order moves it.
+     *
+     * The three margin fields are optional only so a frame from an older server
+     * still parses: every current frame and snapshot row carries them. Treat
+     * `undefined` as unknown, never as zero.
+     */
+    initialMarginRequired?: string;
+    /**
+     * The largest amount a withdrawal or transfer out of this margin account
+     * will accept (decimal string): the margin-account REST row's
+     * `withdrawableCollateral`. Floored at zero and rounded toward zero at 6
+     * decimal places, so a transfer of exactly this amount is accepted.
+     */
+    withdrawableCollateral?: string;
+    /**
+     * Realized PnL settled to the margin account plus net funding (decimal
+     * string): the margin-account REST row's `realizedPnl`. Realized PnL still
+     * held by an open risk bucket is not included; the margin-account PnL
+     * endpoint reports that part.
+     */
+    realizedPnl?: string;
     /** Timestamp when the account state was updated (ISO 8601) */
     updatedAt: string;
 }

package/dist/websocket/events/account-events.js

@@ -2,7 +2,8 @@
  * Account WebSocket Event Types
  *
  * Types for real-time account-level margin updates: equity, collateral, free
- * collateral, margin ratio, and maintenance requirement for a margin account.
+ * collateral, margin ratio, maintenance requirement, initial margin required,
+ * withdrawable collateral, and realized PnL for a margin account.
  *
  * This is an authenticated channel - requires the signed session-key handshake.
  * Detected broadcast lag closes the connection with 1013 and requires resync.

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

@@ -158,10 +158,11 @@ export interface CommonOrderEventData {
      * `"ADL"` or `"COPY"` (a copy trading order the engine placed for one of
      * your follows).
      *
-     * Absent means **not reported**, never `"USER"`: the key is omitted until
-     * the event's producer fills it, and `"USER"` is sent explicitly once it
-     * does. Widened past {@link OrderOrigin} because the parser passes an
-     * unrecognized value through rather than dropping the frame.
+     * Every order event carries it, `"USER"` included, so it agrees with REST
+     * `getOrder` and the `orders` snapshot row. Absent means **not reported**
+     * (a server predating the field), never `"USER"`. Widened past
+     * {@link OrderOrigin} because the parser passes an unrecognized value
+     * through rather than dropping the frame.
      * Wire: `origin`.
      */
     origin?: OrderOrigin | (string & {});

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

@@ -175,12 +175,12 @@ export interface PositionEventData {
      * Fall back to a full field comparison rather than ranking it lowest.
      *
      * The merge rule is PER FIELD GROUP, never per frame. On a higher version
-     * apply everything. On an EQUAL version skip the versioned fields as an
-     * idempotent redelivery — EXCEPT `isolatedMargin`, which the subscribe-time
-     * snapshot overlays from an independent live matching-engine read rather
-     * than from the versioned row, so it can reflect a later command than the
-     * version names and must be taken from the newer payload or you retain
-     * stale backing. Also still take `markPrice`, `unrealizedPnl`,
+     * apply everything. On an EQUAL version skip a live frame's versioned
+     * fields as an idempotent redelivery, but take every field of a
+     * subscribe-time snapshot row: the snapshot is built from live
+     * matching-engine state under the persisted row's version, so it can
+     * reflect a later command than the version names, and skipping it keeps
+     * the values the reconnect was meant to correct. Also still take `markPrice`, `unrealizedPnl`,
      * `liquidationPrice`, `leverage`, `maintenanceMarginRequired` and
      * `initialMarginRequired` from the newer frame: those six are re-derived
      * per frame rather than served from the versioned row, carry no version,
@@ -211,7 +211,7 @@ export interface PositionEventData {
      * still open plus the funding its partial closes settled. A terminal frame
      * carries the closed position's whole-life total, the same `fundingPaid` a
      * REST read of the closed position returns. The subscribe-time snapshot
-     * carries the REST value for the same row.
+     * carries the value the position's live frames carry.
      *
      * Absent means UNKNOWN, never zero: the server cannot account for every
      * earlier reduction yet (a value would understate it), or a deployment

package/dist/websocket/snapshots.d.ts

@@ -31,6 +31,7 @@
  */
 import type { Candlestick } from "../market";
 import type { OrderSide, OrderType, SelfTradePreventionMode, TimeInForce, TradingMode } from "../trading";
+import type { OrderOrigin } from "./events/orders-events";
 /**
  * Receives one channel's complete subscribe-time state.
  *
@@ -82,8 +83,8 @@ export type OHLCVSnapshotCandle = Omit<Candlestick, "s">;
  * `Option` serialized WITHOUT `skip_serializing_if`, so the key is always
  * present and carries `null` when unset — hence `| null` rather than `?`.
  * `clientOrderId`, `selfTradePreventionMode`, `parentOrderId`, `postOnly`,
- * `expirationDate`, `triggerPrice`, `positionSide` and `version` are the fields
- * the server omits outright, so they are the `?`s.
+ * `expirationDate`, `triggerPrice`, `positionSide`, `version` and `origin` are
+ * the fields the server omits outright, so they are the `?`s.
  *
  * The value unions are widened (`Union | (string & {})`) for the same reason
  * the order event's are: the parser hands an unrecognized value through rather
@@ -195,4 +196,12 @@ export interface OrderSnapshotItem {
      * before the field existed reports. Absent means unknown, never zero.
      */
     version?: number;
+    /**
+     * What placed the order: `"USER"`, `"LIQUIDATION"`, `"SYSTEM"`, `"ADL"` or
+     * `"COPY"`, as REST `getOrder` returns it and as every live order event
+     * carries it. Omitted, not `null`, when the server does not report it (a
+     * server predating the field); absent means not reported, never `"USER"`.
+     * Wire: `origin`.
+     */
+    origin?: OrderOrigin | (string & {});
 }

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_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_trade_by_id", "get_trader_code_info", "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_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "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_trading_pairs", "list_twap_order_slices", "list_twap_orders", "mint_tokens", "pitpass_check_trader_code_availability", "pitpass_clear_trader_code", "pitpass_get_my_referral_downline", "pitpass_get_my_referral_position", "pitpass_get_my_referral_tree", "pitpass_get_my_trader_code", "pitpass_get_rewards_balance", "pitpass_get_trader_code_info", "pitpass_set_trader_code", "pitpass_transfer_rewards", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "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_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_trade_by_id", "get_trader_code_info", "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_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_trading_pairs", "list_twap_order_slices", "list_twap_orders", "mint_tokens", "pitpass_check_trader_code_availability", "pitpass_clear_trader_code", "pitpass_get_my_referral_downline", "pitpass_get_my_referral_position", "pitpass_get_my_referral_tree", "pitpass_get_my_trader_code", "pitpass_get_rewards_balance", "pitpass_get_trader_code_info", "pitpass_set_trader_code", "pitpass_transfer_rewards", "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

@@ -113,6 +113,7 @@ export const OPERATION_IDS = [
     "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",
@@ -143,6 +144,7 @@ export const OPERATION_IDS = [
     "refresh_session",
     "register_deposit_address",
     "replace_order",
+    "request_invite_codes",
     "revoke_delegated_agent",
     "revoke_session",
     "set_builder_fee",

package/dist/wire/schema.d.ts

@@ -1562,6 +1562,51 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/invite-codes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List my Mainnet invite codes
+         * @description List the authenticated wallet's invite allowance and the codes it minted.
+         *
+         *      Read-only: never mints or consumes an allowance slot, so a client can poll
+         *      it to show progress and to recover a code whose mint response was lost.
+         */
+        get: operations["list_invite_codes"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/invite-codes/requests": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mint one Mainnet invite code
+         * @description Mint one invite code from the authenticated wallet's available allowance.
+         *      Every active wallet has one initial code plus one per 250,000 USDC of executed
+         *      Mainnet USDC volume since the configured launch. Revocation never refunds a slot.
+         */
+        post: operations["request_invite_codes"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/managed-markets/assignments": {
         parameters: {
             query?: never;
@@ -6575,7 +6620,7 @@ export interface components {
              */
             batchId?: string | null;
             /**
-             * @description Stable terminal cause for a cancelled order: USER_REQUESTED, REPLACED, LIQUIDATION, INSUFFICIENT_MARGIN, REDUCE_ONLY_EXHAUSTED, POSITION_CLOSED, OCO_SIBLING_TRIGGERED, SELF_TRADE_PREVENTION, AUTO_DELEVERAGING, PRICE_BAND, SLIPPAGE_TOLERANCE, or SYSTEM. AUTO_DELEVERAGING means auto-deleveraging closed the position your risk bucket held and this resting order was cancelled with it; you were deleveraged as a counterparty, not liquidated. PRICE_BAND means the exchange's protective price band stopped the order and its remainder was cancelled; SLIPPAGE_TOLERANCE means your own slippageToleranceBps did.
+             * @description Stable terminal cause for a cancelled order: USER_REQUESTED, REPLACED, LIQUIDATION, INSUFFICIENT_MARGIN, REDUCE_ONLY_EXHAUSTED, POSITION_CLOSED, OCO_SIBLING_TRIGGERED, SELF_TRADE_PREVENTION, AUTO_DELEVERAGING, PRICE_BAND, SLIPPAGE_TOLERANCE, or SYSTEM. AUTO_DELEVERAGING means auto-deleveraging closed the position your risk bucket held and this resting order was cancelled with it; you were deleveraged as a counterparty, not liquidated. PRICE_BAND means the exchange's protective price band stopped the order and its remainder was cancelled, or, on a resting perp order, that the mark moved the order past the band, where no taker may trade with it; SLIPPAGE_TOLERANCE means your own slippageToleranceBps did.
              * @example REDUCE_ONLY_EXHAUSTED
              */
             terminalReason?: string | null;
@@ -7036,7 +7081,7 @@ export interface components {
             cumFees?: string | null;
             /**
              * Format: int64
-             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills, non-zero funding settlements, terminal closes/liquidations/ADL, direct isolated-position margin adds/reductions, and copy-position margin adds; each uses captured post-command state, and terminal frames retain the stored size and exact CLOSED/LIQUIDATED classification. After restart, a terminal frame rebuilt from legacy reduction history omits the version when that history lacks the margin fields needed to reconstruct complete lifetime allocated margin. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer and funding frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
+             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills, non-zero funding settlements, terminal closes/liquidations/ADL, direct isolated-position margin adds/reductions, and copy-position margin adds; each uses captured post-command state, and terminal frames retain the stored size and exact CLOSED/LIQUIDATED classification. After restart, a terminal frame rebuilt from legacy reduction history omits the version when that history lacks the margin fields needed to reconstruct complete lifetime allocated margin. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer and funding frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. A WebSocket positions snapshot row wins an equal-version tie on every field: it is built from live matching-engine state under the persisted row's version, so it can reflect a later command than that version names. Take all of it on an equal version; an equal-version live frame stays an idempotent redelivery. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
              * @example 918342
              */
             version?: number | null;
@@ -7432,6 +7477,36 @@ export interface components {
              */
             source?: string | null;
         };
+        InviteCode: {
+            /**
+             * Format: uuid
+             * @description Identifier of the code.
+             */
+            codeId?: string | null;
+            /**
+             * Format: int32
+             * @description Allowance slot: 0 for the initial code, N for the Nth 250,000 USDC milestone.
+             * @example 0
+             */
+            milestone?: number | null;
+            /**
+             * @description Lifecycle status: issued, redeemed or revoked.
+             * @example issued
+             */
+            status?: string | null;
+            /** @description The 10-character case-sensitive bearer code, present only while it is issued and unredeemed. Store securely; never log it. */
+            code?: string | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time the code was created.
+             */
+            createdAt?: string | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time the code was redeemed; absent until then.
+             */
+            redeemedAt?: string | null;
+        };
         /** @description Current followers and the collateral they have allocated. Window-free. */
         LeadTraderFollowSummary: {
             /**
@@ -7942,6 +8017,33 @@ export interface components {
              */
             totalCapped?: boolean | null;
         };
+        ListInviteCodesResponse: {
+            /**
+             * @description Executed Mainnet USDC quote notional since the configured production launch, counting maker and taker wallets at 1 USDC = 1 USD. Zero until volume rewards and the launch timestamp are configured.
+             * @example 250000.00
+             */
+            mainnetVolumeUsd?: string | null;
+            /**
+             * Format: int32
+             * @description Number of completed Mainnet volume milestones of 250,000 USDC each.
+             * @example 1
+             */
+            eligibleMilestones?: number | null;
+            /**
+             * Format: int32
+             * @description One initial code plus the number of completed Mainnet volume milestones of 250,000 USDC each; zero without active Mainnet access.
+             * @example 2
+             */
+            totalAllowance?: number | null;
+            /**
+             * Format: int32
+             * @description Allowance slots not yet minted. Revoked slots remain consumed.
+             * @example 1
+             */
+            availableCodes?: number | null;
+            /** @description Codes this wallet minted or was issued, newest first. */
+            codes?: components["schemas"]["InviteCode"][] | null;
+        };
         ListLeadTraderClosedTradesResponse: {
             closedTrades?: components["schemas"]["ClosedTrade"][] | null;
             /** @description Cursor for the next page; empty when there are no more. */
@@ -9051,7 +9153,7 @@ export interface components {
             cumFees?: string | null;
             /**
              * Format: int64
-             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: it means the row predates this field or came from a producer that does not stamp it, so treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills, non-zero funding settlements, terminal closes/liquidations/ADL, direct isolated-position margin adds/reductions, and copy-position margin adds; each uses captured post-command state, and terminal frames retain the stored size and exact CLOSED/LIQUIDATED classification. After restart, a terminal frame rebuilt from legacy reduction history omits the version when that history lacks the margin fields needed to reconstruct complete lifetime allocated margin. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer and funding frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
+             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: it means the row predates this field or came from a producer that does not stamp it, so treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills, non-zero funding settlements, terminal closes/liquidations/ADL, direct isolated-position margin adds/reductions, and copy-position margin adds; each uses captured post-command state, and terminal frames retain the stored size and exact CLOSED/LIQUIDATED classification. After restart, a terminal frame rebuilt from legacy reduction history omits the version when that history lacks the margin fields needed to reconstruct complete lifetime allocated margin. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer and funding frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. A WebSocket positions snapshot row wins an equal-version tie on every field: it is built from live matching-engine state under the persisted row's version, so it can reflect a later command than that version names. Take all of it on an equal version; an equal-version live frame stays an idempotent redelivery. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
              * @example 918342
              */
             version?: number | null;
@@ -9662,6 +9764,65 @@ export interface components {
             updatedFields?: components["schemas"]["UpdatedFields"];
             matchResult?: components["schemas"]["MatchResult"];
         };
+        RequestInviteCodesRequest: Record<string, never>;
+        RequestInviteCodesResponse: {
+            /**
+             * @description Executed Mainnet USDC quote notional since the configured production launch, counting maker and taker wallets at 1 USDC = 1 USD. Zero until volume rewards and the launch timestamp are configured.
+             * @example 250000.00
+             */
+            mainnetVolumeUsd?: string | null;
+            /**
+             * Format: int32
+             * @description Number of completed Mainnet volume milestones of 250,000 USDC each.
+             * @example 1
+             */
+            eligibleMilestones?: number | null;
+            /**
+             * @description Previously pending milestones, retained for compatibility. Self-service minting creates an issued code immediately.
+             * @example [
+             *       1
+             *     ]
+             */
+            pendingMilestones?: number[] | null;
+            /**
+             * @description Issued allowance slots. Slot 0 is the initial code; slot N is the Nth 250,000 USDC volume milestone.
+             * @example []
+             */
+            issuedMilestones?: number[] | null;
+            /**
+             * @description Milestones whose issued code has been redeemed.
+             * @example []
+             */
+            redeemedMilestones?: number[] | null;
+            /**
+             * @description The single allowance slot minted by this call, or an empty array when no allowance remains. Every call may consume the next available slot.
+             * @example [
+             *       0
+             *     ]
+             */
+            newlyRequestedMilestones?: number[] | null;
+            /** @description The newly minted 10-character case-sensitive bearer code. Absent when no allowance remains. Store securely; never log it. */
+            code?: string | null;
+            /** @description Identifier of the newly minted code; absent when no allowance remains. */
+            codeId?: string | null;
+            /**
+             * Format: int32
+             * @description Consumed allowance slot: 0 for the initial code, N for the Nth 250,000 USDC milestone.
+             */
+            mintedMilestone?: number | null;
+            /**
+             * Format: int32
+             * @description One initial code plus the number of completed Mainnet volume milestones of 250,000 USDC each.
+             */
+            totalAllowance?: number | null;
+            /**
+             * Format: int32
+             * @description Unconsumed allowance after this call. Revoked slots remain consumed.
+             */
+            availableCodes?: number | null;
+            /** @description Revoked allowance slots; they cannot be minted again. */
+            revokedMilestones?: number[] | null;
+        };
         RevokeDelegatedAgentResponse: {
             /**
              * @description Revocation status
@@ -11383,6 +11544,11 @@ export interface components {
              * @example 0x1234567890abcdef1234567890abcdef12345678
              */
             referralCode?: string | null;
+            /**
+             * @description Optional Mainnet invite code. Exactly 10 case-sensitive ASCII letters or digits. Required while Mainnet Invite Mode is enabled for any wallet without a Mainnet access grant, including existing accounts that never received one; ignored while Invite Mode is off and unnecessary once the wallet has access. A missing code is refused with 403 and code INVITE_CODE_REQUIRED; a wrong, redeemed or revoked code, or an unused code whose issuer is deactivated, with 403 and code INVITE_CODE_INVALID. A deactivated signing account is refused with 403 and code ACCOUNT_DEACTIVATED.
+             * @example aB3dE5gH7J
+             */
+            inviteCode?: string | null;
         };
         VerifyResponse: {
             /**
@@ -13238,7 +13404,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Origin not allowed for this application */
+            /** @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 */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -13252,7 +13418,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Authentication rate limit exceeded — challenge and verify share one per-client-address budget (60 requests/min sustained, burst 120), checked before the signature; retry after the interval in details.retryAfter */
+            /** @description Authentication rate limit exceeded — challenge and verify share one per-client-address budget (60 requests/min sustained, burst 120), checked before the signature; or, while Mainnet Invite Mode is on, invite-code attempts from this wallet or client address are in their cooldown. Retry after the interval in details.retryAfter */
             429: {
                 headers: {
                     [name: string]: unknown;
@@ -13266,7 +13432,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Contract-wallet (EIP-1271) verification could not be completed for an eligible address: the chain did not answer, did not answer within the deadline, or the server was at its concurrent-verification capacity and declined to ask. Retryable, and not a verdict on the signature. */
+            /** @description Contract-wallet (EIP-1271) verification could not be completed for an eligible address: the chain did not answer, did not answer within the deadline, or the server was at its concurrent-verification capacity and declined to ask; or an invite code could not be validated now (validation at capacity, or no trusted client address). Retryable, and not a verdict on the signature or the code. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -15222,6 +15388,120 @@ export interface operations {
             };
         };
     };
+    list_invite_codes: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListInviteCodesResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Delegated-agent sessions cannot read the owner's invite codes; deactivated signing accounts receive ACCOUNT_DEACTIVATED */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Request rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Mainnet invite access is temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    request_invite_codes: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RequestInviteCodesRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RequestInviteCodesResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Active Mainnet access is required to mint a code; delegated-agent sessions cannot mint the owner's codes; deactivated signing accounts receive ACCOUNT_DEACTIVATED */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Request rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invite encryption is not configured or generation is temporarily at capacity */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     list_managed_market_assignments: {
         parameters: {
             query?: {

package/package.json

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