@0xmonaco/types 0.4.1 → 0.5.0

package/dist/validation/market.js

@@ -0,0 +1,185 @@
+/**
+ * Market API Validation Schemas
+ */
+import { z } from "zod";
+import { UUIDSchema } from "./trading";
+/**
+ * Candlestick interval validation
+ */
+export const IntervalSchema = z.enum(["1m", "5m", "15m", "30m", "1h", "4h", "1d", "1w", "1M"], {
+    message: 'Interval must be one of: "1m", "5m", "15m", "30m", "1h", "4h", "1d", "1w", "1M"',
+});
+/**
+ * Maximum allowed future offset for timestamps (1 year in milliseconds)
+ *
+ * Allows queries for future dates (e.g., for scheduling or filtering) but
+ * prevents unreasonably far future dates that are likely input errors.
+ */
+const MAX_TIMESTAMP_FUTURE_OFFSET_MS = 365 * 24 * 60 * 60 * 1000; // 1 year
+/**
+ * Minimum allowed timestamp (Jan 1, 2000 in milliseconds)
+ *
+ * This catches the common error of passing timestamps in seconds instead of milliseconds.
+ * Any timestamp before year 2000 is likely an error (either seconds or invalid date).
+ */
+const MIN_TIMESTAMP_MS = 946684800000; // Jan 1, 2000 00:00:00 UTC
+/**
+ * Timestamp validation (milliseconds since epoch)
+ *
+ * Validates that the timestamp is:
+ * - A positive integer
+ * - At least Jan 1, 2000 (catches seconds vs milliseconds errors)
+ * - Within JavaScript's safe integer range
+ * - Not unreasonably far in the future (max 1 year ahead)
+ *
+ * **Why these bounds matter:**
+ * - Prevents typos (e.g., using seconds instead of milliseconds: 1609459200 vs 1609459200000)
+ * - Catches date calculation errors (e.g., Date.now() * 1000 instead of Date.now())
+ * - Ensures timestamps won't cause precision issues in JavaScript
+ *
+ * @example
+ * ```typescript
+ * // Valid timestamps (milliseconds)
+ * validate(TimestampSchema, 1609459200000);  // Jan 1, 2021 ✅
+ * validate(TimestampSchema, Date.now());      // Current time ✅
+ * validate(TimestampSchema, Date.now() + 86400000);  // Tomorrow ✅
+ *
+ * // Invalid timestamps
+ * validate(TimestampSchema, 1609459200);      // Seconds instead of ms (Jan 19, 1970) ❌
+ * validate(TimestampSchema, Date.now() * 1000);  // Way too large ❌
+ * validate(TimestampSchema, 9999999999999999);   // Far future (year 2286) ❌
+ * validate(TimestampSchema, 100000);          // Too old (Jan 1, 1970) ❌
+ * ```
+ */
+export const TimestampSchema = z
+    .number()
+    .int()
+    .positive({
+    message: "Timestamp must be a positive integer (milliseconds since epoch)",
+})
+    .min(MIN_TIMESTAMP_MS, {
+    message: "Timestamp must be at least Jan 1, 2000 (946684800000 ms). Did you pass seconds instead of milliseconds?",
+})
+    .max(Number.MAX_SAFE_INTEGER, {
+    message: "Timestamp must not exceed JavaScript's maximum safe integer",
+})
+    .refine((value) => value <= Date.now() + MAX_TIMESTAMP_FUTURE_OFFSET_MS, {
+    message: "Timestamp must not be unreasonably far in the future (max 1 year ahead)",
+});
+/**
+ * Get Candlesticks validation schema (by trading pair ID)
+ *
+ * Validates parameters for fetching candlestick (OHLCV) data using a trading pair UUID.
+ * Ensures that the time range is valid by checking that startTime < endTime.
+ *
+ * @example
+ * ```typescript
+ * // Valid request
+ * validate(GetCandlesticksSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1609459200000,  // Jan 1, 2021
+ *   endTime: 1640995200000      // Jan 1, 2022
+ * });
+ *
+ * // Invalid: backwards time range
+ * validate(GetCandlesticksSchema, {
+ *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+ *   interval: "1h",
+ *   startTime: 1640995200000,  // Jan 1, 2022
+ *   endTime: 1609459200000      // Jan 1, 2021
+ * });
+ * // ValidationError: startTime must be less than endTime
+ * ```
+ */
+export const GetCandlesticksSchema = z
+    .object({
+    tradingPairId: UUIDSchema,
+    interval: IntervalSchema,
+    startTime: TimestampSchema,
+    endTime: TimestampSchema,
+})
+    .refine((data) => data.startTime < data.endTime, {
+    message: "startTime must be less than endTime",
+    path: ["endTime"],
+});
+/**
+ * Trading pair symbol validation
+ *
+ * Validates trading pair symbols like "BTC/USDT", "ETH/USD", etc.
+ * Symbol format: BASE/QUOTE where:
+ * - BASE and QUOTE are 1-10 alphanumeric characters
+ * - Separated by a forward slash
+ *
+ * @example
+ * ```typescript
+ * // Valid symbols
+ * validate(TradingPairSymbolSchema, "BTC/USDT");   ✅
+ * validate(TradingPairSymbolSchema, "ETH/USD");    ✅
+ * validate(TradingPairSymbolSchema, "MTK/USDCo");  ✅
+ *
+ * // Invalid symbols
+ * validate(TradingPairSymbolSchema, "BTC");        ❌ Missing quote token
+ * validate(TradingPairSymbolSchema, "BTC-USDT");   ❌ Wrong separator
+ * validate(TradingPairSymbolSchema, "/USDT");      ❌ Missing base token
+ * ```
+ */
+export const TradingPairSymbolSchema = z
+    .string()
+    .min(1, "Trading pair symbol cannot be empty")
+    .regex(/^[A-Za-z0-9]{1,10}\/[A-Za-z0-9]{1,10}$/, {
+    message: 'Trading pair symbol must be in format "BASE/QUOTE" (e.g., "BTC/USDT", "ETH/USD")',
+});
+/**
+ * Get Candlesticks By Symbol validation schema
+ *
+ * Validates parameters for fetching candlestick (OHLCV) data using a trading pair symbol.
+ * This is the schema used by the actual API endpoint which accepts symbols like "BTC/USDT".
+ * Ensures that the time range is valid by checking that startTime < endTime.
+ *
+ * @example
+ * ```typescript
+ * // Valid request
+ * validate(GetCandlesticksBySymbolSchema, {
+ *   symbol: "BTC/USDT",
+ *   interval: "1h",
+ *   startTime: 1609459200000,  // Jan 1, 2021
+ *   endTime: 1640995200000      // Jan 1, 2022
+ * });
+ *
+ * // Invalid: backwards time range
+ * validate(GetCandlesticksBySymbolSchema, {
+ *   symbol: "ETH/USD",
+ *   interval: "1h",
+ *   startTime: 1640995200000,  // Jan 1, 2022
+ *   endTime: 1609459200000      // Jan 1, 2021
+ * });
+ * // ValidationError: startTime must be less than endTime
+ * ```
+ */
+export const GetCandlesticksBySymbolSchema = z
+    .object({
+    symbol: TradingPairSymbolSchema,
+    interval: IntervalSchema,
+    startTime: TimestampSchema,
+    endTime: TimestampSchema,
+})
+    .refine((data) => data.startTime < data.endTime, {
+    message: "startTime must be less than endTime",
+    path: ["endTime"],
+});
+/**
+ * Get Trading Pair validation schema
+ */
+export const GetTradingPairSchema = z.object({
+    tradingPairId: UUIDSchema,
+});
+/**
+ * Search Trading Pairs validation schema
+ */
+export const SearchTradingPairsSchema = z.object({
+    query: z.string().min(1, "Search query cannot be empty").optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    offset: z.number().int().min(0).optional(),
+});
+//# sourceMappingURL=market.js.map

package/dist/validation/market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.js","sourceRoot":"","sources":["../../src/validation/market.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IAC7F,OAAO,EAAE,iFAAiF;CAC3F,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,8BAA8B,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAE3E;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,YAAY,CAAC,CAAC,2BAA2B;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,GAAG,EAAE;KACL,QAAQ,CAAC;IACR,OAAO,EAAE,iEAAiE;CAC3E,CAAC;KACD,GAAG,CAAC,gBAAgB,EAAE;IACrB,OAAO,EAAE,yGAAyG;CACnH,CAAC;KACD,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE;IAC5B,OAAO,EAAE,6DAA6D;CACvE,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,8BAA8B,EAAE;IACvE,OAAO,EAAE,yEAAyE;CACnF,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,eAAe;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,qCAAqC;IAC9C,IAAI,EAAE,CAAC,SAAS,CAAC;CAClB,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;KAC7C,KAAK,CAAC,wCAAwC,EAAE;IAC/C,OAAO,EAAE,kFAAkF;CAC5F,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,MAAM,EAAE,uBAAuB;IAC/B,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,eAAe;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,qCAAqC;IAC9C,IAAI,EAAE,CAAC,SAAS,CAAC;CAClB,CAAC,CAAC;AAEL;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,UAAU;CAC1B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC,CAAC,QAAQ,EAAE;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC"}

package/dist/validation/trading.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Trading API Validation Schemas
+ *
+ * Zod schemas for validating trading API inputs before making requests.
+ * Provides clear, actionable error messages for invalid parameters.
+ */
+import { z } from "zod";
+/**
+ * Order side validation
+ */
+export declare const OrderSideSchema: z.ZodEnum<{
+    BUY: "BUY";
+    SELL: "SELL";
+}>;
+/**
+ * Trading mode validation
+ */
+export declare const TradingModeSchema: z.ZodEnum<{
+    SPOT: "SPOT";
+    MARGIN: "MARGIN";
+}>;
+/**
+ * Time in force validation
+ */
+export declare const TimeInForceSchema: z.ZodEnum<{
+    GTC: "GTC";
+    IOC: "IOC";
+    FOK: "FOK";
+}>;
+/**
+ * Positive decimal string validation (for quantities and prices)
+ */
+export declare const PositiveDecimalStringSchema: z.ZodString;
+/**
+ * Non-negative decimal string validation (allows 0)
+ */
+export declare const NonNegativeDecimalStringSchema: z.ZodString;
+/**
+ * UUID validation
+ */
+export declare const UUIDSchema: z.ZodString;
+/**
+ * ISO 8601 date string validation
+ */
+export declare const ISO8601DateSchema: z.ZodString;
+/**
+ * Slippage tolerance validation (0 to 1, where 0.01 = 1%)
+ */
+export declare const SlippageToleranceSchema: z.ZodOptional<z.ZodNumber>;
+/**
+ * Place Limit Order validation schema
+ */
+export declare const PlaceLimitOrderSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    quantity: z.ZodString;
+    price: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        tradingMode: z.ZodOptional<z.ZodEnum<{
+            SPOT: "SPOT";
+            MARGIN: "MARGIN";
+        }>>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+        expirationDate: z.ZodOptional<z.ZodString>;
+        timeInForce: z.ZodOptional<z.ZodEnum<{
+            GTC: "GTC";
+            IOC: "IOC";
+            FOK: "FOK";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Place Market Order validation schema
+ */
+export declare const PlaceMarketOrderSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    quantity: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        tradingMode: z.ZodOptional<z.ZodEnum<{
+            SPOT: "SPOT";
+            MARGIN: "MARGIN";
+        }>>;
+        slippageTolerance: z.ZodOptional<z.ZodNumber>;
+        timeInForce: z.ZodOptional<z.ZodEnum<{
+            GTC: "GTC";
+            IOC: "IOC";
+            FOK: "FOK";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Cancel Order validation schema
+ */
+export declare const CancelOrderSchema: z.ZodObject<{
+    orderId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Replace Order validation schema
+ *
+ * Validates parameters for replacing an existing order.
+ * Matches the replaceOrder method signature which accepts:
+ * - orderId: string (UUID)
+ * - newOrder: { price?: string, quantity?: string, useMasterBalance?: boolean }
+ */
+export declare const ReplaceOrderSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    newOrder: z.ZodObject<{
+        price: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodOptional<z.ZodString>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Get Paginated Orders validation schema
+ *
+ * Validates parameters for fetching paginated orders.
+ * Status field accepts all valid OrderStatus values for comprehensive filtering.
+ */
+export declare const GetOrdersSchema: z.ZodObject<{
+    tradingPairId: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            PENDING: "PENDING";
+            SUBMITTED: "SUBMITTED";
+            ACKNOWLEDGED: "ACKNOWLEDGED";
+            PARTIALLY_FILLED: "PARTIALLY_FILLED";
+            FILLED: "FILLED";
+            SETTLED: "SETTLED";
+            CANCELLED: "CANCELLED";
+            REJECTED: "REJECTED";
+            EXPIRED: "EXPIRED";
+        }>>;
+        side: z.ZodOptional<z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=trading.d.ts.map

package/dist/validation/trading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading.d.ts","sourceRoot":"","sources":["../../src/validation/trading.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe;;;EAE1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;EAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;EAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B,aAOpC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,8BAA8B,aAOvC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,UAAU,aAErB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,4BAIvB,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;iBAahC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;iBAWjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC"}

package/dist/validation/trading.js

@@ -0,0 +1,139 @@
+/**
+ * Trading API Validation Schemas
+ *
+ * Zod schemas for validating trading API inputs before making requests.
+ * Provides clear, actionable error messages for invalid parameters.
+ */
+import { z } from "zod";
+/**
+ * Order side validation
+ */
+export const OrderSideSchema = z.enum(["BUY", "SELL"], {
+    message: 'Order side must be "BUY" or "SELL"',
+});
+/**
+ * Trading mode validation
+ */
+export const TradingModeSchema = z.enum(["SPOT", "MARGIN"], {
+    message: 'Trading mode must be "SPOT" or "MARGIN"',
+});
+/**
+ * Time in force validation
+ */
+export const TimeInForceSchema = z.enum(["GTC", "IOC", "FOK"], {
+    message: 'Time in force must be "GTC", "IOC", or "FOK"',
+});
+/**
+ * Positive decimal string validation (for quantities and prices)
+ */
+export const PositiveDecimalStringSchema = z
+    .string()
+    .trim()
+    .min(1, "Value cannot be empty")
+    .regex(/^\d+(\.\d+)?$/, "Value must be a positive decimal number (e.g., '1.5', '100')")
+    .refine((val) => Number.parseFloat(val) > 0, {
+    message: "Value must be greater than 0",
+});
+/**
+ * Non-negative decimal string validation (allows 0)
+ */
+export const NonNegativeDecimalStringSchema = z
+    .string()
+    .trim()
+    .min(1, "Value cannot be empty")
+    .regex(/^\d+(\.\d+)?$/, "Value must be a non-negative decimal number")
+    .refine((val) => Number.parseFloat(val) >= 0, {
+    message: "Value must be greater than or equal to 0",
+});
+/**
+ * UUID validation
+ */
+export const UUIDSchema = z.string().uuid({
+    message: "Must be a valid UUID (e.g., '123e4567-e89b-12d3-a456-426614174000')",
+});
+/**
+ * ISO 8601 date string validation
+ */
+export const ISO8601DateSchema = z.string().datetime({
+    message: "Must be a valid ISO 8601 date string (e.g., '2024-12-31T23:59:59Z')",
+});
+/**
+ * Slippage tolerance validation (0 to 1, where 0.01 = 1%)
+ */
+export const SlippageToleranceSchema = z
+    .number()
+    .min(0, "Slippage tolerance must be at least 0 (no slippage)")
+    .max(1, "Slippage tolerance cannot exceed 1 (100%)")
+    .optional();
+/**
+ * Place Limit Order validation schema
+ */
+export const PlaceLimitOrderSchema = z.object({
+    tradingPairId: UUIDSchema,
+    side: OrderSideSchema,
+    quantity: PositiveDecimalStringSchema,
+    price: PositiveDecimalStringSchema,
+    options: z
+        .object({
+        tradingMode: TradingModeSchema.optional(),
+        useMasterBalance: z.boolean().optional(),
+        expirationDate: ISO8601DateSchema.optional(),
+        timeInForce: TimeInForceSchema.optional(),
+    })
+        .optional(),
+});
+/**
+ * Place Market Order validation schema
+ */
+export const PlaceMarketOrderSchema = z.object({
+    tradingPairId: UUIDSchema,
+    side: OrderSideSchema,
+    quantity: PositiveDecimalStringSchema,
+    options: z
+        .object({
+        tradingMode: TradingModeSchema.optional(),
+        slippageTolerance: SlippageToleranceSchema,
+        timeInForce: TimeInForceSchema.optional(),
+    })
+        .optional(),
+});
+/**
+ * Cancel Order validation schema
+ */
+export const CancelOrderSchema = z.object({
+    orderId: UUIDSchema,
+});
+/**
+ * Replace Order validation schema
+ *
+ * Validates parameters for replacing an existing order.
+ * Matches the replaceOrder method signature which accepts:
+ * - orderId: string (UUID)
+ * - newOrder: { price?: string, quantity?: string, useMasterBalance?: boolean }
+ */
+export const ReplaceOrderSchema = z.object({
+    orderId: UUIDSchema,
+    newOrder: z.object({
+        price: PositiveDecimalStringSchema.optional(),
+        quantity: PositiveDecimalStringSchema.optional(),
+        useMasterBalance: z.boolean().optional(),
+    }),
+});
+/**
+ * Get Paginated Orders validation schema
+ *
+ * Validates parameters for fetching paginated orders.
+ * Status field accepts all valid OrderStatus values for comprehensive filtering.
+ */
+export const GetOrdersSchema = z.object({
+    tradingPairId: UUIDSchema.optional(),
+    options: z
+        .object({
+        status: z.enum(["PENDING", "SUBMITTED", "ACKNOWLEDGED", "PARTIALLY_FILLED", "FILLED", "SETTLED", "CANCELLED", "REJECTED", "EXPIRED"]).optional(),
+        side: OrderSideSchema.optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+        offset: z.number().int().min(0).optional(),
+    })
+        .optional(),
+});
+//# sourceMappingURL=trading.js.map

package/dist/validation/trading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading.js","sourceRoot":"","sources":["../../src/validation/trading.ts"],"names":[],"mappings":"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"}

package/dist/validation/vault.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Vault API Validation Schemas
+ */
+import { z } from "zod";
+/**
+ * Ethereum address validation
+ */
+export declare const AddressSchema: z.ZodString;
+/**
+ * Positive BigInt validation
+ *
+ * Accepts either:
+ * - A positive integer string (e.g., "1000000000000000000" for 1 token with 18 decimals)
+ * - A positive bigint value (e.g., 1000000000000000000n)
+ *
+ * This flexibility allows validation of:
+ * - User input (strings from forms)
+ * - Parsed amounts (bigint from parseUnits())
+ *
+ * @example
+ * ```typescript
+ * // String input (from user)
+ * validate(PositiveBigIntStringSchema, "1000000");
+ *
+ * // BigInt input (from parseUnits)
+ * import { parseUnits } from 'viem';
+ * const amount = parseUnits("1.0", 18); // 1000000000000000000n
+ * validate(PositiveBigIntStringSchema, amount);
+ * ```
+ */
+export declare const PositiveBigIntStringSchema: z.ZodUnion<readonly [z.ZodString, z.ZodBigInt]>;
+/**
+ * Approve Token validation schema
+ */
+export declare const ApproveTokenSchema: z.ZodObject<{
+    tokenAddress: z.ZodString;
+    amount: z.ZodUnion<readonly [z.ZodString, z.ZodBigInt]>;
+    autoWait: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Deposit validation schema
+ */
+export declare const DepositSchema: z.ZodObject<{
+    assetId: z.ZodString;
+    amount: z.ZodUnion<readonly [z.ZodString, z.ZodBigInt]>;
+    autoWait: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Withdraw validation schema
+ */
+export declare const WithdrawSchema: z.ZodObject<{
+    assetId: z.ZodString;
+    amount: z.ZodUnion<readonly [z.ZodString, z.ZodBigInt]>;
+    autoWait: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Get Balance validation schema
+ */
+export declare const GetBalanceSchema: z.ZodObject<{
+    tokenAddress: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=vault.d.ts.map

package/dist/validation/vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/validation/vault.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,aAAa,aAExB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,0BAA0B,iDAUrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;iBAIxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;iBAIzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC"}

package/dist/validation/vault.js

@@ -0,0 +1,75 @@
+/**
+ * Vault API Validation Schemas
+ */
+import { z } from "zod";
+import { UUIDSchema } from "./trading";
+/**
+ * Ethereum address validation
+ */
+export const AddressSchema = z.string().regex(/^0x[a-fA-F0-9]{40}$/, {
+    message: "Must be a valid Ethereum address (e.g., '0x1234...5678')",
+});
+/**
+ * Positive BigInt validation
+ *
+ * Accepts either:
+ * - A positive integer string (e.g., "1000000000000000000" for 1 token with 18 decimals)
+ * - A positive bigint value (e.g., 1000000000000000000n)
+ *
+ * This flexibility allows validation of:
+ * - User input (strings from forms)
+ * - Parsed amounts (bigint from parseUnits())
+ *
+ * @example
+ * ```typescript
+ * // String input (from user)
+ * validate(PositiveBigIntStringSchema, "1000000");
+ *
+ * // BigInt input (from parseUnits)
+ * import { parseUnits } from 'viem';
+ * const amount = parseUnits("1.0", 18); // 1000000000000000000n
+ * validate(PositiveBigIntStringSchema, amount);
+ * ```
+ */
+export const PositiveBigIntStringSchema = z.union([
+    z
+        .string()
+        .regex(/^\d+$/, "Must be a positive integer string")
+        .refine((val) => BigInt(val) > 0n, {
+        message: "Amount must be greater than 0",
+    }),
+    z.bigint().refine((val) => val > 0n, {
+        message: "Amount must be greater than 0",
+    }),
+]);
+/**
+ * Approve Token validation schema
+ */
+export const ApproveTokenSchema = z.object({
+    tokenAddress: AddressSchema,
+    amount: PositiveBigIntStringSchema,
+    autoWait: z.boolean().optional(),
+});
+/**
+ * Deposit validation schema
+ */
+export const DepositSchema = z.object({
+    assetId: UUIDSchema,
+    amount: PositiveBigIntStringSchema,
+    autoWait: z.boolean().optional(),
+});
+/**
+ * Withdraw validation schema
+ */
+export const WithdrawSchema = z.object({
+    assetId: UUIDSchema,
+    amount: PositiveBigIntStringSchema,
+    autoWait: z.boolean().optional(),
+});
+/**
+ * Get Balance validation schema
+ */
+export const GetBalanceSchema = z.object({
+    tokenAddress: AddressSchema,
+});
+//# sourceMappingURL=vault.js.map

package/dist/validation/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/validation/vault.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE;IACnE,OAAO,EAAE,0DAA0D;CACpE,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC;SACE,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,mCAAmC,CAAC;SACnD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE;QACjC,OAAO,EAAE,+BAA+B;KACzC,CAAC;IACJ,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,EAAE;QACnC,OAAO,EAAE,+BAA+B;KACzC,CAAC;CACH,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,YAAY,EAAE,aAAa;IAC3B,MAAM,EAAE,0BAA0B;IAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,0BAA0B;IAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,0BAA0B;IAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,YAAY,EAAE,aAAa;CAC5B,CAAC,CAAC"}

package/dist/vault/index.d.ts

@@ -3,8 +3,8 @@
  *
  * Types for vault operations including deposits, withdrawals, and balance management.
  */
-import type { BaseAPI } from "../api/index.js";
-import type { Balance, TransactionResult } from "./responses.js";
+import type { BaseAPI } from "../api/index";
+import type { Balance, TransactionResult } from "./responses";
 /**
  * Vault API interface.
  * Provides methods for managing token deposits and withdrawals.
@@ -21,20 +21,20 @@ export interface VaultAPI extends BaseAPI {
     approve(token: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
     /**
      * Deposits tokens into the vault.
-     * @param token - Address of the token to deposit
+     * @param assetId - Asset identifier (UUID) to deposit
      * @param amount - Amount to deposit
      * @param autoWait - Whether to automatically wait for transaction confirmation (defaults to true)
      * @returns Promise resolving to the transaction result
      */
-    deposit(token: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
+    deposit(assetId: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
     /**
      * Withdraws tokens from the vault.
-     * @param token - Address of the token to withdraw
+     * @param assetId - Asset identifier (UUID) to withdraw
      * @param amount - Amount to withdraw
      * @param autoWait - Whether to automatically wait for transaction confirmation (defaults to true)
      * @returns Promise resolving to the transaction result
      */
-    withdraw(token: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
+    withdraw(assetId: string, amount: bigint, autoWait?: boolean): Promise<TransactionResult>;
     /**
      * Gets the balance of a token in the vault.
      * @param token - Address of the token to check
@@ -60,5 +60,5 @@ export interface VaultAPI extends BaseAPI {
      */
     getVaultAddress(): Promise<string>;
 }
-export type { Balance, TransactionResult } from "./responses.js";
+export type { Balance, TransactionResult } from "./responses";
 //# sourceMappingURL=index.d.ts.map