@0xmonaco/types 0.8.22 → 1.0.3

package/dist/auth/index.d.ts

@@ -22,9 +22,12 @@ export interface AuthAPI extends BaseAPI {
      * 4. Verifies the signature, registering the session public key
      *
      * @param clientId - Client ID of the application
+     * @param referralCode - Optional PitPass TraderCode (wallet address) of the referrer.
+     *   Passed through to the verify call so a first-time sign-up records the referral
+     *   relationship. Has no effect when the user already exists.
      * @returns Promise resolving to the authentication state (including the session keypair)
      */
-    authenticate(clientId: string): Promise<AuthState>;
+    authenticate(clientId: string, referralCode?: string): Promise<AuthState>;
     /**
      * Signs a challenge message using the wallet client.
      *
@@ -54,9 +57,11 @@ export interface AuthAPI extends BaseAPI {
      * @param nonce - Nonce from the challenge response
      * @param clientId - Client ID of the application
      * @param session - The locally-generated session keypair (hex-encoded)
+     * @param referralCode - Optional PitPass TraderCode (wallet address) of the referrer;
+     *   recorded at first sign-up only.
      * @returns Promise resolving to the authentication state
      */
-    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials): Promise<AuthState>;
+    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials, referralCode?: string): Promise<AuthState>;
     /**
      * Extends the current session's expiry. The request is signed with the
      * active session key (set via {@link setSessionKeypair}).

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from "./faucet";
 export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
+export * from "./pitpass";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";

package/dist/index.js

@@ -14,6 +14,7 @@ export * from "./faucet";
 export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
+export * from "./pitpass";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";

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

@@ -145,6 +145,14 @@ export interface SimulateOrderRiskResponse {
     maintenanceMarginRequiredAfter: string;
     freeCollateralAfter: string;
     estimatedFee?: string;
+    /**
+     * Estimated liquidation mark-price. In ISOLATED mode, this is the
+     * position/risk-bucket threshold. In CROSS mode, it is conditional: it varies
+     * only the target position's mark while all other marks in the cross risk
+     * bucket remain unchanged. Other position marks, funding, realized PnL,
+     * fees/reserves, and collateral can change it. Treat an absent or blank value
+     * as unavailable, never as zero.
+     */
     estimatedLiquidationPrice?: string;
 }
 export interface MarginAccountsAPI extends BaseAPI {

package/dist/pitpass/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * PitPass Types
+ *
+ * Types for PitPass TraderCode API: code lookup, rewards balance, and transfer.
+ */
+import type { BaseAPI } from "../api";
+import type { GetRewardsBalanceResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "./responses";
+/**
+ * PitPass TraderCode API interface.
+ *
+ * Provides methods for reading your wallet-derived TraderCode, looking up a
+ * referral code at sign-up, reading your accrued rewards balance, and
+ * transferring rewards into a tradeable balance.
+ */
+export interface PitpassAPI extends BaseAPI {
+    /**
+     * Return the authenticated caller's TraderCode (their normalized wallet address).
+     *
+     * Never 404s — every signed-in wallet has a derivable code. Ensures the
+     * backing row so referrals attributed to this wallet have a code to link.
+     *
+     * @returns Promise resolving to the caller's TraderCode and its creation timestamp
+     */
+    getMyTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Public, unauthenticated lookup of a TraderCode.
+     *
+     * Used to validate a referral code at sign-up. The code is a wallet address
+     * (the `Monaco - <address>` display form is also accepted). Returns the
+     * normalized code when it resolves to a known wallet, or throws a 404 when
+     * the code does not resolve to any user.
+     *
+     * @param code - The TraderCode (wallet address or `Monaco - <address>` form) to look up
+     * @returns Promise resolving to the normalized TraderCode
+     */
+    getTraderCodeInfo(code: string): Promise<TraderCodeInfoResponse>;
+    /**
+     * Return the caller's current PitPass rewards-bucket balances.
+     *
+     * Rewards accumulate here as referred users trade. Call
+     * {@link transferRewards} to move them into a tradeable balance.
+     * Returns an empty `balances` array when no rewards have been earned yet.
+     *
+     * @returns Promise resolving to the list of per-token reward balances
+     */
+    getRewardsBalance(): Promise<GetRewardsBalanceResponse>;
+    /**
+     * Transfer earned PitPass rewards into a trading balance.
+     *
+     * Moves the specified amount of a reward token from the caller's rewards
+     * bucket into their trading balance under the authenticated application.
+     * Ledger-only — no on-chain transaction, immediately tradeable.
+     *
+     * @param params - Token address and raw-unit amount to transfer
+     * @returns Promise resolving to the post-transfer rewards and trading balances
+     */
+    transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
+}
+export type { GetRewardsBalanceResponse, RewardsBalanceEntry, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse, } from "./responses";
+export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/pitpass/index.js

@@ -0,0 +1,6 @@
+/**
+ * PitPass Types
+ *
+ * Types for PitPass TraderCode API: code lookup, rewards balance, and transfer.
+ */
+export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/pitpass/responses.d.ts

@@ -0,0 +1,44 @@
+/**
+ * PitPass TraderCode Response Types
+ *
+ * Types for PitPass TraderCode API responses and requests.
+ * All types are derived from Zod schemas for runtime validation.
+ */
+import { z } from "zod";
+/** Schema for a single token entry in the rewards balance response. */
+export declare const RewardsBalanceEntrySchema: z.ZodObject<{
+    token: z.ZodString;
+    available: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the rewards balance response. */
+export declare const GetRewardsBalanceResponseSchema: z.ZodObject<{
+    balances: z.ZodArray<z.ZodObject<{
+        token: z.ZodString;
+        available: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Schema for a TraderCode response. */
+export declare const TraderCodeResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the public TraderCode info response. */
+export declare const TraderCodeInfoResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the transfer rewards request body. */
+export declare const TransferRewardsParamsSchema: z.ZodObject<{
+    token: z.ZodString;
+    amount: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the transfer rewards response. */
+export declare const TransferRewardsResponseSchema: z.ZodObject<{
+    rewardsBalance: z.ZodString;
+    tradingBalance: z.ZodString;
+}, z.core.$strip>;
+export type RewardsBalanceEntry = z.infer<typeof RewardsBalanceEntrySchema>;
+export type GetRewardsBalanceResponse = z.infer<typeof GetRewardsBalanceResponseSchema>;
+export type TraderCodeResponse = z.infer<typeof TraderCodeResponseSchema>;
+export type TraderCodeInfoResponse = z.infer<typeof TraderCodeInfoResponseSchema>;
+export type TransferRewardsParams = z.infer<typeof TransferRewardsParamsSchema>;
+export type TransferRewardsResponse = z.infer<typeof TransferRewardsResponseSchema>;

package/dist/pitpass/responses.js

@@ -0,0 +1,53 @@
+/**
+ * PitPass TraderCode Response Types
+ *
+ * Types for PitPass TraderCode API responses and requests.
+ * All types are derived from Zod schemas for runtime validation.
+ */
+import { z } from "zod";
+/** Schema for a single token entry in the rewards balance response. */
+export const RewardsBalanceEntrySchema = z.object({
+    /** Reward token contract address (0x-prefixed). */
+    token: z.string(),
+    /** Available rewards balance in RAW atomic units of the token. */
+    available: z.string(),
+});
+/** Schema for the rewards balance response. */
+export const GetRewardsBalanceResponseSchema = z.object({
+    /** One entry per reward token that has a non-zero available balance. */
+    balances: z.array(RewardsBalanceEntrySchema),
+});
+/** Schema for a TraderCode response. */
+export const TraderCodeResponseSchema = z.object({
+    /** The caller's TraderCode — their normalized wallet address. */
+    code: z.string(),
+    /** RFC 3339 timestamp when the code row was first derived. */
+    createdAt: z.string(),
+});
+/** Schema for the public TraderCode info response. */
+export const TraderCodeInfoResponseSchema = z.object({
+    /** The resolved TraderCode (normalized wallet address). */
+    code: z.string(),
+});
+/** Schema for the transfer rewards request body. */
+export const TransferRewardsParamsSchema = z.object({
+    /** Reward token contract address (0x-prefixed) to transfer. */
+    token: z
+        .string()
+        .trim()
+        .min(1, "token is required")
+        .regex(/^0x[0-9a-fA-F]{40}$/, "token must be a 0x-prefixed EVM address"),
+    /** Amount to transfer, in RAW atomic units of the token. Must be a positive integer string. */
+    amount: z
+        .string()
+        .trim()
+        .min(1, "amount is required")
+        .refine((v) => /^\d+$/.test(v) && BigInt(v) > 0n, "amount must be a positive integer string"),
+});
+/** Schema for the transfer rewards response. */
+export const TransferRewardsResponseSchema = z.object({
+    /** Your rewards-bucket balance after the transfer, RAW atomic units. */
+    rewardsBalance: z.string(),
+    /** Your trading balance for the token after the transfer, RAW atomic units. */
+    tradingBalance: z.string(),
+});

package/dist/positions/index.d.ts

@@ -28,6 +28,14 @@ export interface Position {
      * the market initial-margin floor; zero without open exposure.
      */
     initialMarginRequired?: string;
+    /**
+     * Liquidation mark-price threshold. In ISOLATED mode, this is the
+     * position/risk-bucket threshold. In CROSS mode, it is conditional: it varies
+     * only this position's mark while all other marks in the cross risk bucket
+     * remain unchanged. Other position marks, funding, realized PnL,
+     * fees/reserves, and collateral can change it. Treat an absent or blank value
+     * as unavailable, never as zero.
+     */
     liquidationPrice: string;
     status: PositionStatus;
     updatedAt: string;
@@ -84,6 +92,14 @@ export interface PositionRisk {
     markPrice: string;
     indexPrice?: string;
     unrealizedPnl: string;
+    /**
+     * Liquidation mark-price threshold. In ISOLATED mode, this is the
+     * position/risk-bucket threshold. In CROSS mode, it is conditional: it varies
+     * only this position's mark while all other marks in the cross risk bucket
+     * remain unchanged. Other position marks, funding, realized PnL,
+     * fees/reserves, and collateral can change it. Treat an absent or blank value
+     * as unavailable, never as zero.
+     */
     liquidationPrice: string;
     marginRatio: string;
     /**
@@ -138,17 +154,45 @@ export interface ListPositionHistoryParams {
     tradingPairId?: string;
     page?: number;
     pageSize?: number;
+    /** Return only per-execution position reductions, closes, and liquidations. */
+    reductionOnly?: boolean;
 }
 export interface PositionHistoryEvent {
-    event_id: string;
-    positionId?: string;
-    marginAccountId?: string;
-    tradingPairId?: string;
-    eventType: string;
+    /** Wire-format event ID. */
+    id: string;
+    /** @deprecated Use id. */
+    event_id?: string;
+    positionId: string;
+    marginAccountId: string;
+    tradingPairId: string;
+    /** Lifecycle action from the API, for example DECREASE or CLOSE. */
+    action: string;
+    /** @deprecated Use action. */
+    eventType?: string;
+    /** Signed quantity change for lifecycle rows. */
+    sizeChange?: string;
+    /** @deprecated Use sizeChange. */
     quantity?: string;
     price?: string;
     realizedPnl?: string;
-    timestamp: string;
+    feesPaid?: string;
+    collateralChange?: string;
+    orderId?: string;
+    createdAt: string;
+    /** @deprecated Use createdAt. */
+    timestamp?: string;
+    /** Average entry price before this reducing execution. */
+    entryPrice?: string;
+    /** Initial margin allocated to this reducing execution. */
+    allocatedInitialMargin?: string;
+    /** Funding allocated to this reducing execution; positive means paid. */
+    fundingPaid?: string;
+    /** Realized PnL after trading fees and funding. */
+    netRealizedPnl?: string;
+    /** Realized return on the allocated initial margin, as a percentage. */
+    realizedRoe?: string;
+    /** Side of the position before this reducing execution. */
+    positionSide?: "LONG" | "SHORT";
 }
 export interface ListPositionHistoryResponse {
     events: PositionHistoryEvent[];

package/dist/sdk/index.d.ts

@@ -6,6 +6,7 @@ import type { FaucetAPI } from "../faucet";
 import type { FeesAPI } from "../fees";
 import type { MarginAccountsAPI } from "../margin-accounts";
 import type { Interval, MarketAPI } from "../market";
+import type { PitpassAPI } from "../pitpass";
 import type { PositionsAPI } from "../positions";
 import type { ProfileAPI } from "../profile";
 import type { SubAccountsAPI } from "../sub-accounts";
@@ -81,6 +82,8 @@ export interface MonacoSDK {
     positions: PositionsAPI;
     /** Sub-account management API */
     subAccounts: SubAccountsAPI;
+    /** PitPass TraderCode referral and rewards API */
+    pitpass: PitpassAPI;
     /** Testnet faucet API */
     faucet: FaucetAPI;
     /** Public whitelist (waitlist) submission API */

package/dist/validation/positions.d.ts

@@ -90,6 +90,7 @@ export declare const ListPositionHistorySchema: z.ZodObject<{
     positionId: z.ZodOptional<z.ZodUUID>;
     marginAccountId: z.ZodOptional<z.ZodUUID>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
+    reductionOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const GetPositionPnlHistorySchema: z.ZodObject<{
     positionId: z.ZodUUID;

package/dist/validation/positions.js

@@ -94,6 +94,7 @@ export const ListPositionHistorySchema = PaginationSchema.extend({
     positionId: UUIDSchema.optional(),
     marginAccountId: UUIDSchema.optional(),
     tradingPairId: UUIDSchema.optional(),
+    reductionOnly: z.boolean().optional(),
 });
 const PnlHistoryIntervalSchema = z.enum(["1m", "5m", "15m", "1h", "4h", "1d"], {
     message: 'Interval must be one of "1m", "5m", "15m", "1h", "4h", "1d"',

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_position_margin", "attach_position_tp_sl", "authenticate_backend", "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", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "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_chart", "get_portfolio_stats", "get_position", "get_position_pnl_history", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "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", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "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_chart", "get_portfolio_stats", "get_position", "get_position_pnl_history", "get_position_risk", "get_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -41,6 +41,7 @@ export const OPERATION_IDS = [
     "get_market_metadata",
     "get_market_stats",
     "get_my_fee_tier",
+    "get_my_trader_code",
     "get_open_interest",
     "get_order_by_id",
     "get_orderbook_snapshot",
@@ -54,9 +55,11 @@ export const OPERATION_IDS = [
     "get_position",
     "get_position_pnl_history",
     "get_position_risk",
+    "get_rewards_balance",
     "get_screener",
     "get_sub_account_limits",
     "get_trade_by_id",
+    "get_trader_code_info",
     "get_trades",
     "get_trading_pair_by_id",
     "get_user_balance_by_asset",
@@ -98,6 +101,7 @@ export const OPERATION_IDS = [
     "transfer_collateral_to_margin_account",
     "transfer_collateral_to_parent_margin_account",
     "transfer_collateral_to_risk_bucket",
+    "transfer_rewards",
     "update_sub_account_limit",
     "upsert_delegated_agent",
     "verify_signature",

package/dist/wire/schema.d.ts

@@ -1470,6 +1470,108 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/pitpass/codes/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get your TraderCode
+         * @description Claim your TraderCode.
+         *
+         *      Get your TraderCode.
+         *
+         *      Return the authenticated caller's TraderCode, which is derived from their
+         *      wallet address (rendered `Monaco - <address>` by clients). Never 404s — the
+         *      code always exists for a signed-in wallet — and ensures the backing row so
+         *      referrals attributed to this wallet have a code to link.
+         */
+        get: operations["get_my_trader_code"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/pitpass/codes/{code}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Look up a TraderCode
+         * @description Look up a TraderCode (public).
+         *
+         *      Public, unauthenticated lookup used to validate a referral code at signup.
+         *      The code is a wallet address; returns the normalized code when it resolves
+         *      to a known wallet. Returns 404 when the code does not resolve to a user.
+         */
+        get: operations["get_trader_code_info"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/pitpass/rewards/balance": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get your rewards balance
+         * @description Read accrued PitPass rewards balance.
+         *
+         *      Return the caller's current rewards-bucket balances across all reward tokens.
+         *      Rewards accumulate here as referred users trade; call TransferRewards to move
+         *      them into a tradeable balance. Returns an empty list when no rewards have
+         *      been earned yet.
+         */
+        get: operations["get_rewards_balance"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/pitpass/rewards/transfer": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Transfer rewards into a trading balance
+         * @description Transfer earned rewards into a trading balance.
+         *
+         *      Move spendable PitPass reward balance from your rewards bucket into a
+         *      trading balance under the authenticated application, making it tradeable
+         *      immediately. Ledger-only (one shared vault + one backend ledger) — no
+         *      on-chain transaction and no gas. Fails with 402 when the rewards balance is
+         *      insufficient.
+         */
+        post: operations["transfer_rewards"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/positions": {
         parameters: {
             query?: never;
@@ -1808,7 +1910,10 @@ export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
         AccountBalance: {
-            /** @description Token contract address */
+            /**
+             * @description Token contract address
+             * @example 0x6a86da986797d59a839d136db490292cd560c131
+             */
             token?: string | null;
             /**
              * @description Token symbol
@@ -1878,7 +1983,10 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             id?: string | null;
-            /** @description Wallet address */
+            /**
+             * @description Wallet address
+             * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
+             */
             address?: string | null;
             /**
              * @description Display username
@@ -2515,7 +2623,10 @@ export interface components {
             message?: string | null;
         };
         Candle: {
-            /** @description Unix timestamp for the start of the candle period in milliseconds */
+            /**
+             * @description Unix timestamp for the start of the candle period in milliseconds
+             * @example 1699800000000
+             */
             timestamp?: string | null;
             /**
              * @description Opening price
@@ -2553,18 +2664,27 @@ export interface components {
              * @example 342
              */
             tradeCount?: number | null;
-            /** @description Unix timestamp for the end of the candle period in milliseconds */
+            /**
+             * @description Unix timestamp for the end of the candle period in milliseconds
+             * @example 1699800059999
+             */
             closeTimestampMs?: string | null;
         };
         ChallengeRequest: {
-            /** @description Ethereum wallet address */
+            /**
+             * @description Ethereum wallet address
+             * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
+             */
             address: string;
             /**
              * @description Optional application identifier
              * @example monaco-frontend
              */
             clientId?: string | null;
-            /** @description Optional chain ID supplied by SDK clients */
+            /**
+             * @description Optional chain ID supplied by SDK clients
+             * @example 1328
+             */
             chainId?: string | null;
             /**
              * @description Lowercase hex (64 chars) ed25519 public key generated locally by the SDK. The returned challenge message will embed this key so the wallet's signature binds it; the same value must be submitted to /api/v1/auth/verify.
@@ -2657,7 +2777,10 @@ export interface components {
             sessionPublicKey?: string | null;
         };
         CreateDelegatedSessionResponse: {
-            /** @description Session expiry as a Unix timestamp (seconds) */
+            /**
+             * @description Session expiry as a Unix timestamp (seconds)
+             * @example 1735689599
+             */
             expiresAt?: string | null;
             /**
              * Format: uuid
@@ -2857,7 +2980,10 @@ export interface components {
              * @description Owner account UUID the agent acts on behalf of
              */
             ownerUserId?: string | null;
-            /** @description Agent wallet address (EVM) */
+            /**
+             * @description Agent wallet address (EVM)
+             * @example 0x742d35cc6634c0532925a3b8d4060f31e2c3d8b5
+             */
             agentAddress?: string | null;
             /** @description Human-friendly label for the agent */
             name?: string | null;
@@ -3062,7 +3188,10 @@ export interface components {
              * @example 5.67
              */
             applicationTakerFee?: string | null;
-            /** @description Total number of trades */
+            /**
+             * @description Total number of trades
+             * @example 42
+             */
             tradeCount?: string | null;
         };
         GetAvailableCollateralResponse: {
@@ -3079,7 +3208,10 @@ export interface components {
             marginAvailableCollateral?: string | null;
         };
         GetBalanceByAssetResponse: {
-            /** @description Token contract address */
+            /**
+             * @description Token contract address
+             * @example 0x6a86da986797d59a839d136db490292cd560c131
+             */
             token?: string | null;
             /**
              * @description Token symbol
@@ -3175,7 +3307,10 @@ export interface components {
             allowedOrigins?: string[] | null;
             /** @description Webhook URL for notifications */
             webhookUrl?: string | null;
-            /** @description Vault contract address for this application */
+            /**
+             * @description Vault contract address for this application
+             * @example 0xA393B04EA77354570Ace35869F5EbB1e380DC232
+             */
             vaultContractAddress?: string | null;
             /**
              * @description Application client ID, embedded in on-chain deposit calls
@@ -3759,9 +3894,15 @@ export interface components {
              * @example 231.81
              */
             volume?: string | null;
-            /** @description Number of trades in period */
+            /**
+             * @description Number of trades in period
+             * @example 42
+             */
             totalTrades?: string | null;
-            /** @description Number of orders in period */
+            /**
+             * @description Number of orders in period
+             * @example 56
+             */
             totalOrders?: string | null;
             /**
              * @description Total fees paid by user
@@ -3852,6 +3993,14 @@ export interface components {
              *      position has no open exposure.
              */
             initialMarginRequired?: string | null;
+            /**
+             * @description Liquidation mark-price threshold. In ISOLATED mode, this is the
+             *      position/risk-bucket threshold. In CROSS mode, it is conditional: it varies
+             *      only this position's mark while all other marks in the cross risk bucket
+             *      remain unchanged. Other position marks, funding, realized PnL,
+             *      fees/reserves, and collateral can change it. Treat an absent or blank value
+             *      as unavailable, never as zero.
+             */
             liquidationPrice?: string | null;
             status?: string | null;
             updatedAt?: string | null;
@@ -3863,6 +4012,14 @@ export interface components {
             markPrice?: string | null;
             indexPrice?: string | null;
             unrealizedPnl?: string | null;
+            /**
+             * @description Liquidation mark-price threshold. In ISOLATED mode, this is the
+             *      position/risk-bucket threshold. In CROSS mode, it is conditional: it varies
+             *      only this position's mark while all other marks in the cross risk bucket
+             *      remain unchanged. Other position marks, funding, realized PnL,
+             *      fees/reserves, and collateral can change it. Treat an absent or blank value
+             *      as unavailable, never as zero.
+             */
             liquidationPrice?: string | null;
             marginRatio?: string | null;
             /**
@@ -3885,7 +4042,10 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             id?: string | null;
-            /** @description Wallet address */
+            /**
+             * @description Wallet address
+             * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
+             */
             address?: string | null;
             /**
              * @description Display username
@@ -3932,6 +4092,10 @@ export interface components {
              */
             applicationMakerFeeBps?: number | null;
         };
+        GetRewardsBalanceResponse: {
+            /** @description One entry per reward token that has a non-zero available balance. */
+            balances?: components["schemas"]["RewardsBalanceEntry"][] | null;
+        };
         /** @description Paginated screener response sorted by quoteVolume24h desc (nulls last). */
         GetScreenerResponse: {
             items?: components["schemas"]["ScreenerItem"][] | null;
@@ -3980,6 +4144,13 @@ export interface components {
              */
             tradingMode?: string | null;
         };
+        GetTraderCodeInfoResponse: {
+            /**
+             * @description The resolved TraderCode (normalized wallet address)
+             * @example 0x0000000000000000000000000000000000000002
+             */
+            code?: string | null;
+        };
         /** @description Recent trades for a trading pair. */
         GetTradesResponse: {
             trades?: components["schemas"]["PublicTrade"][] | null;
@@ -4002,13 +4173,25 @@ export interface components {
         };
         GetUserTradesResponse: {
             trades?: components["schemas"]["UserTrade"][] | null;
-            /** @description Current page number */
+            /**
+             * @description Current page number
+             * @example 1
+             */
             page?: string | null;
-            /** @description Items per page */
+            /**
+             * @description Items per page
+             * @example 20
+             */
             pageSize?: string | null;
-            /** @description Total number of trades */
+            /**
+             * @description Total number of trades
+             * @example 150
+             */
             total?: string | null;
-            /** @description Total number of pages */
+            /**
+             * @description Total number of pages
+             * @example 8
+             */
             totalPages?: string | null;
         };
         IndexComponent: {
@@ -4029,7 +4212,10 @@ export interface components {
              * @example 1000000000000000000
              */
             amount?: string | null;
-            /** @description On-chain address that will receive the withdrawal (EVM, 42 chars including 0x) */
+            /**
+             * @description On-chain address that will receive the withdrawal (EVM, 42 chars including 0x)
+             * @example 0x742d35cc6634c0532925a3b8d4060f31e2c3d8b5
+             */
             destination?: string | null;
             /**
              * @description Source ledger to withdraw from: "spot" (default) debits spot balance; "margin" directly debits withdrawable collateral from the parent margin account
@@ -4059,7 +4245,10 @@ export interface components {
              * @example 100.50
              */
             amount?: string | null;
-            /** @description Token contract address */
+            /**
+             * @description Token contract address
+             * @example 0x6a86da986797d59a839d136db490292cd560c131
+             */
             token?: string | null;
             /**
              * @description Available balance before this movement
@@ -4096,9 +4285,15 @@ export interface components {
              * @example USDC deposit
              */
             description?: string | null;
-            /** @description On-chain transaction hash (if applicable) */
+            /**
+             * @description On-chain transaction hash (if applicable)
+             * @example 0xabc123...
+             */
             txHash?: string | null;
-            /** @description Block number of the on-chain transaction */
+            /**
+             * @description Block number of the on-chain transaction
+             * @example 18500000
+             */
             blockNumber?: string | null;
             /**
              * @description Movement timestamp (ISO 8601)
@@ -4539,7 +4734,10 @@ export interface components {
              * @example 10000.00
              */
             amount?: string | null;
-            /** @description On-chain transaction hash */
+            /**
+             * @description On-chain transaction hash
+             * @example 0xabc123def456...
+             */
             txHash?: string | null;
         };
         OrderbookData: {
@@ -4606,7 +4804,10 @@ export interface components {
          *      is confirmed on-chain; fetch it from GetWithdrawal once it becomes ready).
          */
         PendingWithdrawal: {
-            /** @description Allocated withdrawal index — matches executeWithdrawal.index on-chain */
+            /**
+             * @description Allocated withdrawal index — matches executeWithdrawal.index on-chain
+             * @example 42
+             */
             withdrawalIndex?: string | null;
             /**
              * Format: uuid
@@ -4624,7 +4825,10 @@ export interface components {
              * @example 1000000000000000000
              */
             amount?: string | null;
-            /** @description On-chain address that will receive the withdrawal (EVM, 42 chars including 0x) */
+            /**
+             * @description On-chain address that will receive the withdrawal (EVM, 42 chars including 0x)
+             * @example 0x742d35cc6634c0532925a3b8d4060f31e2c3d8b5
+             */
             destination?: string | null;
             /**
              * @description Withdrawal lifecycle status; always "pending" for entries in this response
@@ -4700,6 +4904,14 @@ export interface components {
              *      position has no open exposure.
              */
             initialMarginRequired?: string | null;
+            /**
+             * @description Liquidation mark-price threshold. In ISOLATED mode, this is the
+             *      position/risk-bucket threshold. In CROSS mode, it is conditional: it varies
+             *      only this position's mark while all other marks in the cross risk bucket
+             *      remain unchanged. Other position marks, funding, realized PnL,
+             *      fees/reserves, and collateral can change it. Treat an absent or blank value
+             *      as unavailable, never as zero.
+             */
             liquidationPrice?: string | null;
             status?: string | null;
             updatedAt?: string | null;
@@ -4721,6 +4933,18 @@ export interface components {
             /** Format: uuid */
             orderId?: string | null;
             createdAt?: string | null;
+            /** @description Average entry price immediately before this reduction execution. */
+            entryPrice?: string | null;
+            /** @description Initial margin allocated pro rata to this reduction execution. */
+            allocatedInitialMargin?: string | null;
+            /** @description Funding allocated pro rata to this reduction; positive means paid. */
+            fundingPaid?: string | null;
+            /** @description Realized PnL after trading fees and funding for this reduction execution. */
+            netRealizedPnl?: string | null;
+            /** @description Net realized PnL divided by allocated_initial_margin, expressed as a percentage. */
+            realizedRoe?: string | null;
+            /** @description Position side immediately before this reduction execution. */
+            positionSide?: string | null;
         };
         /**
          * @description One PnL state sample for a position in one bucket. Cumulative fields are
@@ -4924,6 +5148,18 @@ export interface components {
              */
             message?: string | null;
         };
+        RewardsBalanceEntry: {
+            /**
+             * @description Reward token contract address (0x-prefixed).
+             * @example 0x0000000000000000000000000000000000000002
+             */
+            token?: string | null;
+            /**
+             * @description Available rewards balance in RAW atomic units of the token.
+             * @example 1200000
+             */
+            available?: string | null;
+        };
         RiskTier: {
             initialMarginRatio?: string | null;
             maintenanceMarginRatio?: string | null;
@@ -5130,6 +5366,14 @@ export interface components {
             maintenanceMarginRequiredAfter?: string | null;
             freeCollateralAfter?: string | null;
             estimatedFee?: string | null;
+            /**
+             * @description Estimated liquidation mark-price. In ISOLATED mode, this is the
+             *      position/risk-bucket threshold. In CROSS mode, it is conditional: it varies
+             *      only the target position's mark while all other marks in the cross risk
+             *      bucket remain unchanged. Other position marks, funding, realized PnL,
+             *      fees/reserves, and collateral can change it. Treat an absent or blank value
+             *      as unavailable, never as zero.
+             */
             estimatedLiquidationPrice?: string | null;
             /**
              * @description The margin account the simulation was resolved against. Always populated;
@@ -5179,7 +5423,10 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             id?: string | null;
-            /** @description Sub-account wallet address */
+            /**
+             * @description Sub-account wallet address
+             * @example 0x742d35Cc6634C0532925a3b8D1B9d7c2bd34e8Dc
+             */
             address?: string | null;
             /**
              * @description Sub-account display username
@@ -5211,7 +5458,10 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             subAccountId?: string | null;
-            /** @description Token contract address */
+            /**
+             * @description Token contract address
+             * @example 0x6a86da986797d59a839d136db490292cd560c131
+             */
             token?: string | null;
             /**
              * @description Maximum daily spending limit in token units
@@ -5256,7 +5506,10 @@ export interface components {
             isActive?: boolean | null;
         };
         SubmitWhitelistRequest: {
-            /** @description Applicant wallet address */
+            /**
+             * @description Applicant wallet address
+             * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
+             */
             walletAddress: string;
             /**
              * Format: email
@@ -5332,6 +5585,18 @@ export interface components {
              */
             tradeId?: string | null;
         };
+        TraderCodeResponse: {
+            /**
+             * @description Your TraderCode — your normalized wallet address (clients render it `Monaco - <address>`).
+             * @example 0x0000000000000000000000000000000000000002
+             */
+            code?: string | null;
+            /**
+             * @description RFC 3339 timestamp when the code row was first derived
+             * @example 2026-07-07T18:00:00Z
+             */
+            createdAt?: string | null;
+        };
         /** @description Trading pair configuration including tokens, fees, and order limits. */
         TradingPairData: {
             /**
@@ -5356,7 +5621,10 @@ export interface components {
              * @example BTC
              */
             baseToken?: string | null;
-            /** @description Base token contract address */
+            /**
+             * @description Base token contract address
+             * @example 0x1234567890abcdef1234567890abcdef12345678
+             */
             baseTokenContract?: string | null;
             /**
              * Format: uuid
@@ -5412,7 +5680,10 @@ export interface components {
              * @example USDC
              */
             quoteToken?: string | null;
-            /** @description Quote token contract address */
+            /**
+             * @description Quote token contract address
+             * @example 0x6a86da986797d59a839d136db490292cd560c131
+             */
             quoteTokenContract?: string | null;
             /**
              * @description Trading pair symbol
@@ -5532,6 +5803,30 @@ export interface components {
             /** @description Trading pair UUIDs selected into the cross risk bucket. Required when marginMode is CROSS. */
             selectedTradingPairIds?: string[] | null;
         };
+        TransferRewardsRequest: {
+            /**
+             * @description Reward token contract address (0x-prefixed) to transfer.
+             * @example 0x0000000000000000000000000000000000000002
+             */
+            token: string;
+            /**
+             * @description Amount to transfer, in RAW atomic units of the token.
+             * @example 1000000
+             */
+            amount: string;
+        };
+        TransferRewardsResponse: {
+            /**
+             * @description Your rewards-bucket balance after the transfer, RAW atomic units.
+             * @example 0
+             */
+            rewardsBalance?: string | null;
+            /**
+             * @description Your trading balance for the token after the transfer, RAW atomic units.
+             * @example 1000000
+             */
+            tradingBalance?: string | null;
+        };
         UpdateLimitRequest: {
             /**
              * Format: uuid
@@ -5577,7 +5872,10 @@ export interface components {
             quantity?: string | null;
         };
         UpsertDelegatedAgentRequest: {
-            /** @description Agent wallet address (EVM, 42 chars including 0x) */
+            /**
+             * @description Agent wallet address (EVM, 42 chars including 0x)
+             * @example 0x742d35cc6634c0532925a3b8d4060f31e2c3d8b5
+             */
             agentAddress?: string | null;
             /**
              * @description Optional human-friendly label for the agent
@@ -5639,7 +5937,10 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             id?: string | null;
-            /** @description Wallet address */
+            /**
+             * @description Wallet address
+             * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
+             */
             address?: string | null;
             /**
              * @description Display username
@@ -5663,9 +5964,15 @@ export interface components {
             timestamp?: string | null;
         };
         VerifyRequest: {
-            /** @description Ethereum wallet address */
+            /**
+             * @description Ethereum wallet address
+             * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
+             */
             address: string;
-            /** @description Wallet signature over the challenge message */
+            /**
+             * @description Wallet signature over the challenge message
+             * @example 0x1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0
+             */
             signature: string;
             /**
              * @description Challenge nonce
@@ -5677,13 +5984,21 @@ export interface components {
              * @example monaco-frontend
              */
             clientId?: string | null;
-            /** @description Optional chain ID supplied by SDK clients */
+            /**
+             * @description Optional chain ID supplied by SDK clients
+             * @example 1328
+             */
             chainId?: string | null;
             /**
              * @description Lowercase hex (64 chars) ed25519 public key generated locally by the SDK. Subsequent authenticated requests are signed with the matching private key. The wallet's signature on the challenge message proves the user authorized this specific public key.
              * @example 3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29
              */
             sessionPublicKey: string;
+            /**
+             * @description Optional PitPass TraderCode captured at signup (e.g. from a `?ref=CODE` link). When a user verifies for the very first time with a valid code, a referral relationship is recorded atomically. Ignored for users who already exist, and silently ignored if the code is unknown — a bad code never blocks sign-in.
+             * @example 0x1234567890abcdef1234567890abcdef12345678
+             */
+            referralCode?: string | null;
         };
         VerifyResponse: {
             /**
@@ -5695,9 +6010,15 @@ export interface components {
             user?: components["schemas"]["UserInfo"];
         };
         Withdrawal: {
-            /** @description Allocated withdrawal index — matches executeWithdrawal.index on-chain */
+            /**
+             * @description Allocated withdrawal index — matches executeWithdrawal.index on-chain
+             * @example 42
+             */
             withdrawalIndex?: string | null;
-            /** @description 0x-prefixed lowercase address of the vault contract the calldata is submitted to */
+            /**
+             * @description 0x-prefixed lowercase address of the vault contract the calldata is submitted to
+             * @example 0x5fbdb2315678afecb367f032d93f642f64180aa3
+             */
             vaultAddress?: string | null;
             /** @description 0x-prefixed ABI-encoded executeWithdrawal(...) calldata; submit as tx.data to the vault. Empty on InitiateWithdrawal (the merkle proof is not available until the withdrawal root is confirmed on-chain) — fetch it from GetWithdrawal once ready */
             calldata?: string | null;
@@ -8724,6 +9045,162 @@ export interface operations {
             };
         };
     };
+    get_my_trader_code: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TraderCodeResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_code_info: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                code: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetTraderCodeInfoResponse"];
+                };
+            };
+            /** @description Code not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_rewards_balance: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetRewardsBalanceResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    transfer_rewards: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TransferRewardsRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransferRewardsResponse"];
+                };
+            };
+            /** @description Invalid token or amount */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Insufficient rewards balance */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     list_positions: {
         parameters: {
             query?: {
@@ -8790,6 +9267,8 @@ export interface operations {
                 page?: number;
                 /** @description Items per page (max 100) */
                 pageSize?: number;
+                /** @description When true, return only DECREASE, CLOSE, and LIQUIDATE execution rows. */
+                reductionOnly?: boolean;
             };
             header?: never;
             path?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "0.8.22",
+	"version": "1.0.3",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "0.8.22",
+		"@0xmonaco/contracts": "1.0.3",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {