@0xmonaco/types 1.0.2 → 1.0.7

package/dist/faucet/index.d.ts

@@ -45,10 +45,15 @@ export interface FaucetAPI extends BaseAPI {
     /**
      * Mints the full set of testnet tokens to the authenticated user.
      *
-     * Testnet-only and rate-limited; see the module note. Partial success is
-     * possible — inspect `minted` and `failed` in the response.
+     * Testnet-only and rate-limited; see the module note. The call is
+     * synchronous and resolves only when every faucet transaction confirmed
+     * on-chain (HTTP 200). Failures reject with meaningful status codes:
+     * 429 when the daily quota is exhausted, 502 when transactions failed or
+     * were only partially confirmed on-chain (the error details carry the
+     * minted/failed breakdown; delivered legs still consume the quota), and
+     * 503 when the faucet is unavailable (nothing credited, safe to retry).
      *
-     * @returns Promise resolving to the minted/failed tokens and remaining quota
+     * @returns Promise resolving to the minted tokens and remaining quota
      */
     mint(): Promise<MintTokensResponse>;
 }

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

@@ -671,7 +671,8 @@ export interface paths {
          * @description Mint all testnet tokens.
          *
          *      Mint all available testnet tokens to the authenticated user's address.
-         *      Rate limited per 24 hours.
+         *      Rate limited per 24 hours. The request is synchronous: it returns 200
+         *      only once every faucet transaction is confirmed on-chain.
          */
         post: operations["mint_tokens"];
         delete?: never;
@@ -3993,6 +3994,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;
@@ -4004,6 +4013,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;
             /**
@@ -4888,6 +4905,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;
@@ -4909,6 +4934,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
@@ -5330,6 +5367,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;
@@ -7504,6 +7549,20 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Faucet transactions failed or were only partially confirmed on-chain; the error details carry the minted/failed breakdown. Do not blindly retry: delivered legs consume the daily quota */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Faucet unavailable (not configured, resolver down, or reply timed out); nothing is known to have been credited, safe to retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     simulate_fees: {
@@ -9223,6 +9282,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": "1.0.2",
+	"version": "1.0.7",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.2",
+		"@0xmonaco/contracts": "1.0.7",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {