@0xmonaco/types 1.0.83 → 1.0.86

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

@@ -201,7 +201,7 @@ export interface ScreenerSnapshotPoint {
     quoteVolume: string;
     /** Percent price change (close - open) / open * 100 for the day */
     priceChangePercent: string;
-    /** Daily average of the valued completed-UTC-minute gross open-interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
+    /** Daily average of the valued completed-UTC-minute one-sided LONG open-interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
     openInterestNotionalAvg: string | null;
 }
 /**
@@ -252,22 +252,24 @@ export interface ScreenerItem {
      */
     lastFundingTime: string | null;
     /**
-     * Gross open interest (longs plus shorts) in base-asset units (e.g. BTC);
-     * null for spot pairs, "0" for a margin pair with no open positions
+     * One-sided LONG open interest (each contract counted once) in base-asset units
+     * (e.g. BTC), from the latest completed-minute sample; null for spot pairs or
+     * when no sample was recorded in the last five minutes, "0" for a margin pair with no
+     * open positions
      */
     openInterestBase: string | null;
     /**
-     * Gross open-interest notional (longs plus shorts) in quote units
+     * One-sided LONG open-interest notional in quote units
      * (openInterestBase × latest trade price); null for spot pairs. Valued at the pair's latest trade price (a
      * snapshot); the mark-accurate notional lives on getPerpMarketSummary /
      * getOpenInterest
      */
     openInterestNotional: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
     openInterestNotionalAvg1h: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
     openInterestNotionalAvg24h: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
     openInterestNotionalAvg7d: string | null;
     /**
      * Estimated rate for the in-progress funding window (decimal fraction per
@@ -436,11 +438,11 @@ export interface PerpMarketSummary {
     quoteVolume24h?: string;
     priceChange24h?: string;
     priceChangePercent24h?: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (legacy alias of openInterestBase) */
     openInterest: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (e.g. BTC) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (e.g. BTC) */
     openInterestBase?: string;
-    /** Gross open-interest notional (longs plus shorts) in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
+    /** One-sided LONG open-interest notional in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
     openInterestNotional?: string;
     currentFundingRate?: string;
     estimatedNextFundingRate?: string;
@@ -595,11 +597,11 @@ export interface ListAllFundingHistoryResponse {
 }
 export interface OpenInterest {
     tradingPairId: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (legacy alias of openInterestBase) */
     openInterest?: string;
-    /** Gross open interest (longs plus shorts) in base-asset units */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units */
     openInterestBase: string;
-    /** Gross open-interest notional (longs plus shorts) in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
+    /** One-sided LONG open-interest notional in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
     openInterestNotional: string;
     updatedAt: string;
 }

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/market-stats-events.d.ts

@@ -45,7 +45,8 @@ export interface MarketStatsData {
     /** Best ask price (decimal string) */
     bestAskPrice?: string;
     /**
-     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * One-sided LONG open interest (each contract counted once) in base
+     * units (decimal string).
      * Perp-only; omitted for spot, and omitted (never zero) until the market's
      * open interest is known.
      */
@@ -58,8 +59,8 @@ export interface MarketStatsData {
     openInterestLimit?: string;
     /**
      * What is left of `openInterestLimit` at the mark, in quote (USD) notional,
-     * never below zero (decimal string): the cap minus the gross `openInterest`
-     * × `markPrice`. At zero, orders that open exposure are refused until open
+     * never below zero (decimal string): the cap minus the gross open interest
+     * (longs plus shorts, not derivable from `openInterest`) × `markPrice`. At zero, orders that open exposure are refused until open
      * interest or the mark falls. Perp-only; omitted for spot, when there is no
      * mark, and until open interest is known.
      */
@@ -147,7 +148,8 @@ export interface MarketStatsSummary {
     /** 24h low price (decimal string) */
     dailyPriceLow?: string;
     /**
-     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * One-sided LONG open interest (each contract counted once) in base
+     * units (decimal string).
      * Perp-only; omitted for spot, and omitted (never zero) until the market's
      * open interest is known.
      */
@@ -169,8 +171,7 @@ export interface MarketStatsSummary {
     /** Funding premium (decimal string). Perp-only; omitted for spot. */
     premium?: string;
     /**
-     * Gross open interest (longs plus shorts) in quote notional (decimal
-     * string): `openInterest` priced at the mark, falling back to the last trade
+     * One-sided LONG open interest in quote notional (decimal string): `openInterest` priced at the mark, falling back to the last trade
      * price. Perp-only; omitted for spot,
      * and omitted (never zero) until both open interest and a price are known.
      */

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;
@@ -2197,7 +2242,7 @@ export interface paths {
         };
         /**
          * Open Interest
-         * @description Gross open interest (longs plus shorts) for a perp market.
+         * @description One-sided LONG open interest (each open contract counted once) for a perp market.
          */
         get: operations["get_open_interest"];
         put?: never;
@@ -6339,7 +6384,7 @@ export interface components {
             /** @description Cursor for the next page; empty when there are no more. */
             nextPageToken?: string | null;
         };
-        /** @description Latest public gross open interest (longs plus shorts) for a trading pair. */
+        /** @description Latest public one-sided LONG open interest (each open contract counted once) for a trading pair. */
         GetOpenInterestResponse: {
             /**
              * Format: uuid
@@ -6348,7 +6393,7 @@ export interface components {
              */
             tradingPairId?: string | null;
             /**
-             * @description Current gross open interest (longs plus shorts) in base-asset units
+             * @description Current one-sided LONG open interest (each open contract counted once) in base-asset units
              * @example 12345.67
              */
             openInterest?: string | null;
@@ -6358,12 +6403,12 @@ export interface components {
              */
             updatedAt?: string | null;
             /**
-             * @description Current gross open interest (longs plus shorts) in base-asset units
+             * @description Current one-sided LONG open interest (each open contract counted once) in base-asset units
              * @example 12345.67
              */
             openInterestBase?: string | null;
             /**
-             * @description Current gross open-interest notional (longs plus shorts) in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
+             * @description Current one-sided LONG open-interest notional in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
              * @example 1172836500.00
              */
             openInterestNotional?: string | null;
@@ -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;
@@ -6709,7 +6754,7 @@ export interface components {
             priceChange24h?: string | null;
             priceChangePercent24h?: string | null;
             /**
-             * @description Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase)
+             * @description One-sided LONG open interest (each open contract counted once) in base-asset units (legacy alias of openInterestBase)
              * @example 12345.67
              */
             openInterest?: string | null;
@@ -6720,12 +6765,12 @@ export interface components {
             marketRegime?: string | null;
             updatedAt?: string | null;
             /**
-             * @description Gross open interest (longs plus shorts) in base-asset units (e.g. BTC)
+             * @description One-sided LONG open interest (each open contract counted once) in base-asset units (e.g. BTC)
              * @example 12345.67
              */
             openInterestBase?: string | null;
             /**
-             * @description Gross open-interest notional (longs plus shorts) in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
+             * @description One-sided LONG open-interest notional in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
              * @example 1172836500.00
              */
             openInterestNotional?: 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
@@ -9835,27 +9996,27 @@ export interface components {
              */
             lastFundingTime?: string | null;
             /**
-             * @description Gross open interest (longs plus shorts) in base-asset units (e.g. BTC); null for spot pairs, "0" for a margin pair with no open positions
+             * @description One-sided LONG open interest (each open contract counted once) in base-asset units (e.g. BTC), from the latest completed-minute sample; null for spot pairs or when no sample was recorded in the last five minutes, "0" for a margin pair with no open positions
              * @example 12345.67
              */
             openInterestBase?: string | null;
             /**
-             * @description Gross open-interest notional (longs plus shorts) in quote units (openInterestBase x latest trade price); null for spot pairs. Valued at the pair's latest trade price (a snapshot); the mark-accurate notional lives on getPerpMarketSummary / getOpenInterest
+             * @description One-sided LONG open-interest notional in quote units (openInterestBase x latest trade price); null for spot pairs. Valued at the pair's latest trade price (a snapshot); the mark-accurate notional lives on getPerpMarketSummary / getOpenInterest
              * @example 1172836500.00
              */
             openInterestNotional?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 60 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (57) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) over the last 60 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (57) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is the LONG open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
              * @example 1172836500.00
              */
             openInterestNotionalAvg1h?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 1440 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (1368) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) over the last 1440 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (1368) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is the LONG open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
              * @example 1172836500.00
              */
             openInterestNotionalAvg24h?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 10080 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (9576) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) over the last 10080 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (9576) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is the LONG open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
              * @example 1172836500.00
              */
             openInterestNotionalAvg7d?: string | null;
@@ -9883,7 +10044,7 @@ export interface components {
              */
             priceChangePercent?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) in this completed UTC day; published once at least 95% of its 1440 minutes (1368) carry a valued sample, null for spot pairs or below that coverage. Samples use gross open position size x latest trade price in quote units; a minute without a trade price is unvalued, never zero; known zero remains "0". No historical backfill.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) in this completed UTC day; published once at least 95% of its 1440 minutes (1368) carry a valued sample, null for spot pairs or below that coverage. Samples use the LONG open position size x latest trade price in quote units; a minute without a trade price is unvalued, never zero; known zero remains "0". No historical backfill.
              * @example 1172836500.00
              */
             openInterestNotionalAvg?: string | null;
@@ -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.86",
 	"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.86",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {