@0xmonaco/core 0.0.0-develop-20260120180031

package/dist/api/base.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Base API Implementation
+ *
+ * Provides common functionality for all API classes including access token management,
+ * authenticated request handling, and standardized error responses.
+ *
+ * This base class eliminates code duplication across API implementations and provides
+ * a consistent interface for token-based authentication and HTTP request handling.
+ *
+ * @example
+ * ```typescript
+ * class MyAPIImpl extends BaseAPI implements MyAPI {
+ *   constructor(apiUrl: string) {
+ *     super(apiUrl);
+ *   }
+ *
+ *   async getData(): Promise<any> {
+ *     return this.makeAuthenticatedRequest<any>('/api/v1/data');
+ *   }
+ * }
+ * ```
+ */
+export interface RetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+}
+export declare abstract class BaseAPI {
+    protected readonly apiUrl: string;
+    protected accessToken?: string;
+    protected retryOptions: Required<RetryOptions>;
+    /**
+     * Creates a new BaseAPI instance.
+     *
+     * @param apiUrl - The base URL for the Monaco API Gateway
+     * @param retryOptions - Configuration for retry behavior on network failures
+     */
+    constructor(apiUrl: string, retryOptions?: RetryOptions);
+    /**
+     * Set the access token for authenticated requests.
+     *
+     * @param token - JWT access token
+     */
+    setAccessToken(token: string): void;
+    /**
+     * Get the current access token.
+     *
+     * @returns The current access token or undefined if not set
+     */
+    protected getAccessToken(): string | undefined;
+    /**
+     * Parse request body for error logging
+     *
+     * Attempts to extract meaningful data from various BodyInit types for debugging.
+     * Note: Binary data (Blob, ArrayBuffer, ReadableStream) is logged as metadata only
+     * to avoid performance issues and maintain log readability.
+     *
+     * @param body - Request body from fetch options
+     * @returns Parsed body for logging, or metadata for binary types
+     */
+    private parseRequestBody;
+    /**
+     * Extract metadata from response headers
+     */
+    private extractResponseMetadata;
+    /**
+     * Execute HTTP request with error handling
+     */
+    private executeRequest;
+    /**
+     * Makes an authenticated API request with automatic token handling.
+     *
+     * This method automatically includes the Authorization header with the Bearer token
+     * and provides consistent error handling across all API operations.
+     *
+     * @param endpoint - The API endpoint to call (should start with /)
+     * @param options - Request options (method, body, headers, etc.)
+     * @returns Promise resolving to the response data
+     * @throws {APIError} When access token is not set or API request fails
+     *
+     * @example
+     * ```typescript
+     * // GET request
+     * const data = await this.makeAuthenticatedRequest<UserProfile>('/api/v1/profile');
+     *
+     * // POST request
+     * const result = await this.makeAuthenticatedRequest<CreateOrderResponse>(
+     *   '/api/v1/orders',
+     *   {
+     *     method: 'POST',
+     *     body: JSON.stringify({ trading_pair: 'ETH-USD', side: 'BUY' })
+     *   }
+     * );
+     * ```
+     */
+    protected makeAuthenticatedRequest<T>(endpoint: string, options?: RequestInit): Promise<T>;
+    /**
+     * Makes an unauthenticated API request.
+     *
+     * This method is useful for endpoints that don't require authentication,
+     * such as public data endpoints or authentication endpoints themselves.
+     *
+     * @param endpoint - The API endpoint to call (should start with /)
+     * @param options - Request options (method, body, headers, etc.)
+     * @returns Promise resolving to the response data
+     * @throws {APIError} When API request fails
+     *
+     * @example
+     * ```typescript
+     * // Public endpoint
+     * const data = await this.makePublicRequest<PublicData>('/api/v1/public/markets');
+     *
+     * // Authentication endpoint
+     * const challenge = await this.makePublicRequest<ChallengeResponse>(
+     *   '/api/v1/auth/challenge',
+     *   {
+     *     method: 'POST',
+     *     body: JSON.stringify({ address, client_id: clientId })
+     *   }
+     * );
+     * ```
+     */
+    protected makePublicRequest<T>(endpoint: string, options?: RequestInit): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/api/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/api/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8BAAsB,OAAO;IAWzB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAVnC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE/C;;;;;OAKG;gBAEkB,MAAM,EAAE,MAAM,EACjC,YAAY,CAAC,EAAE,YAAY;IAQ7B;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC;;;;OAIG;IACH,SAAS,CAAC,cAAc,IAAI,MAAM,GAAG,SAAS;IAI9C;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAkDxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;YACW,cAAc;IAmF5B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;cACa,wBAAwB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IA0BpG;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;cACa,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;CAiB9F"}

package/dist/api/base.js

@@ -0,0 +1,284 @@
+/**
+ * Base API Implementation
+ *
+ * Provides common functionality for all API classes including access token management,
+ * authenticated request handling, and standardized error responses.
+ *
+ * This base class eliminates code duplication across API implementations and provides
+ * a consistent interface for token-based authentication and HTTP request handling.
+ *
+ * @example
+ * ```typescript
+ * class MyAPIImpl extends BaseAPI implements MyAPI {
+ *   constructor(apiUrl: string) {
+ *     super(apiUrl);
+ *   }
+ *
+ *   async getData(): Promise<any> {
+ *     return this.makeAuthenticatedRequest<any>('/api/v1/data');
+ *   }
+ * }
+ * ```
+ */
+import { StatusCodes } from "http-status-codes";
+import { APIError } from "../errors";
+export class BaseAPI {
+    /**
+     * Creates a new BaseAPI instance.
+     *
+     * @param apiUrl - The base URL for the Monaco API Gateway
+     * @param retryOptions - Configuration for retry behavior on network failures
+     */
+    constructor(apiUrl, retryOptions) {
+        this.apiUrl = apiUrl;
+        this.retryOptions = {
+            maxRetries: retryOptions?.maxRetries ?? 3,
+            baseDelayMs: retryOptions?.baseDelayMs ?? 1000,
+        };
+    }
+    /**
+     * Set the access token for authenticated requests.
+     *
+     * @param token - JWT access token
+     */
+    setAccessToken(token) {
+        this.accessToken = token;
+    }
+    /**
+     * Get the current access token.
+     *
+     * @returns The current access token or undefined if not set
+     */
+    getAccessToken() {
+        return this.accessToken;
+    }
+    /**
+     * Parse request body for error logging
+     *
+     * Attempts to extract meaningful data from various BodyInit types for debugging.
+     * Note: Binary data (Blob, ArrayBuffer, ReadableStream) is logged as metadata only
+     * to avoid performance issues and maintain log readability.
+     *
+     * @param body - Request body from fetch options
+     * @returns Parsed body for logging, or metadata for binary types
+     */
+    parseRequestBody(body) {
+        if (!body)
+            return undefined;
+        // String bodies (most common case) - parse as JSON if possible
+        if (typeof body === "string") {
+            try {
+                return JSON.parse(body);
+            }
+            catch {
+                return body; // Return as-is if not valid JSON
+            }
+        }
+        // FormData - convert to object for logging
+        if (body instanceof FormData) {
+            const formObject = {};
+            body.forEach((value, key) => {
+                formObject[key] = value instanceof File ? `[File: ${value.name}]` : value;
+            });
+            return formObject;
+        }
+        // URLSearchParams - convert to object
+        if (body instanceof URLSearchParams) {
+            const params = {};
+            body.forEach((value, key) => {
+                params[key] = value;
+            });
+            return params;
+        }
+        // Blob - log metadata only (avoid reading binary data)
+        if (body instanceof Blob) {
+            return { type: "[Blob]", size: body.size, contentType: body.type };
+        }
+        // ArrayBuffer/ArrayBufferView - log metadata only
+        if (body instanceof ArrayBuffer || ArrayBuffer.isView(body)) {
+            const size = body instanceof ArrayBuffer ? body.byteLength : body.byteLength;
+            return { type: "[ArrayBuffer]", size };
+        }
+        // ReadableStream - log metadata only (cannot read without consuming)
+        if (typeof ReadableStream !== "undefined" && body instanceof ReadableStream) {
+            return { type: "[ReadableStream]", note: "Stream body not captured for logging" };
+        }
+        // Fallback for unknown types
+        return { type: "[Unknown]", bodyType: typeof body };
+    }
+    /**
+     * Extract metadata from response headers
+     */
+    extractResponseMetadata(headers) {
+        if (!headers)
+            return {};
+        const requestId = headers.get("x-request-id") || headers.get("request-id") || headers.get("x-correlation-id") || undefined;
+        // Parse Retry-After header with validation
+        const retryAfterHeader = headers.get("retry-after");
+        let retryAfter;
+        if (retryAfterHeader !== null) {
+            const parsed = Number.parseInt(retryAfterHeader, 10);
+            retryAfter = Number.isNaN(parsed) ? undefined : parsed;
+        }
+        return { requestId, retryAfter };
+    }
+    /**
+     * Execute HTTP request with error handling
+     */
+    async executeRequest(url, endpoint, options, requestBody) {
+        let response;
+        try {
+            response = await fetch(url, options);
+        }
+        catch (error) {
+            throw new APIError(`Network request failed for ${endpoint}`, {
+                endpoint: url,
+                cause: error instanceof Error ? error : new Error(String(error)),
+                requestBody,
+            });
+        }
+        // Parse response body with error handling for non-JSON responses
+        let responseBody;
+        const contentType = response.headers?.get("content-type") || "unknown";
+        // Clone the response to avoid consuming the body stream twice (if clone method exists)
+        const responseClone = response.clone ? response.clone() : response;
+        try {
+            responseBody = await response.json();
+        }
+        catch (parseError) {
+            // If JSON parsing fails, try to get response as text for better error messages
+            let responseText;
+            try {
+                responseText = await responseClone.text();
+            }
+            catch {
+                responseText = "[Unable to read response body]";
+            }
+            // If response is not OK and we can't parse JSON, it's likely an error page (HTML, plain text, etc.)
+            if (!response.ok) {
+                const errorMessage = `API request failed: ${response.status}. Response is not JSON (Content-Type: ${contentType})`;
+                const { requestId, retryAfter } = this.extractResponseMetadata(response.headers);
+                throw new APIError(errorMessage, {
+                    endpoint: url,
+                    statusCode: response.status,
+                    responseBody: {
+                        rawResponse: responseText.substring(0, 500), // Limit to 500 chars to avoid huge error logs
+                        contentType,
+                        parseError: parseError instanceof Error ? parseError.message : String(parseError),
+                    },
+                    cause: parseError instanceof Error ? parseError : undefined,
+                    requestBody,
+                    requestId,
+                    retryAfter,
+                });
+            }
+            // If response is OK but not JSON, throw a more specific error
+            throw new APIError(`Expected JSON response but received ${contentType}`, {
+                endpoint: url,
+                statusCode: response.status,
+                responseBody: { rawResponse: responseText.substring(0, 500), contentType },
+                cause: parseError instanceof Error ? parseError : undefined,
+                requestBody,
+            });
+        }
+        if (!response.ok) {
+            // Runtime validation before extracting error message from response body
+            const errorBody = responseBody !== null && typeof responseBody === "object" ? responseBody : undefined;
+            const errorMessage = (typeof errorBody?.message === "string" ? errorBody.message : undefined) ||
+                (typeof errorBody?.error === "string" ? errorBody.error : undefined) ||
+                `API request failed: ${response.status}`;
+            const { requestId, retryAfter } = this.extractResponseMetadata(response.headers);
+            throw new APIError(errorMessage, {
+                endpoint: url,
+                statusCode: response.status,
+                responseBody,
+                requestBody,
+                requestId,
+                retryAfter,
+            });
+        }
+        return responseBody;
+    }
+    /**
+     * Makes an authenticated API request with automatic token handling.
+     *
+     * This method automatically includes the Authorization header with the Bearer token
+     * and provides consistent error handling across all API operations.
+     *
+     * @param endpoint - The API endpoint to call (should start with /)
+     * @param options - Request options (method, body, headers, etc.)
+     * @returns Promise resolving to the response data
+     * @throws {APIError} When access token is not set or API request fails
+     *
+     * @example
+     * ```typescript
+     * // GET request
+     * const data = await this.makeAuthenticatedRequest<UserProfile>('/api/v1/profile');
+     *
+     * // POST request
+     * const result = await this.makeAuthenticatedRequest<CreateOrderResponse>(
+     *   '/api/v1/orders',
+     *   {
+     *     method: 'POST',
+     *     body: JSON.stringify({ trading_pair: 'ETH-USD', side: 'BUY' })
+     *   }
+     * );
+     * ```
+     */
+    async makeAuthenticatedRequest(endpoint, options = {}) {
+        if (!this.accessToken) {
+            throw new APIError("Access token not set. Call setAccessToken() first.", {
+                endpoint: `${this.apiUrl}${endpoint}`,
+                statusCode: StatusCodes.UNAUTHORIZED,
+            });
+        }
+        const url = `${this.apiUrl}${endpoint}`;
+        const requestBody = this.parseRequestBody(options.body);
+        return this.executeRequest(url, endpoint, {
+            ...options,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.accessToken}`,
+                ...options.headers,
+            },
+        }, requestBody);
+    }
+    /**
+     * Makes an unauthenticated API request.
+     *
+     * This method is useful for endpoints that don't require authentication,
+     * such as public data endpoints or authentication endpoints themselves.
+     *
+     * @param endpoint - The API endpoint to call (should start with /)
+     * @param options - Request options (method, body, headers, etc.)
+     * @returns Promise resolving to the response data
+     * @throws {APIError} When API request fails
+     *
+     * @example
+     * ```typescript
+     * // Public endpoint
+     * const data = await this.makePublicRequest<PublicData>('/api/v1/public/markets');
+     *
+     * // Authentication endpoint
+     * const challenge = await this.makePublicRequest<ChallengeResponse>(
+     *   '/api/v1/auth/challenge',
+     *   {
+     *     method: 'POST',
+     *     body: JSON.stringify({ address, client_id: clientId })
+     *   }
+     * );
+     * ```
+     */
+    async makePublicRequest(endpoint, options = {}) {
+        const url = `${this.apiUrl}${endpoint}`;
+        const requestBody = this.parseRequestBody(options.body);
+        return this.executeRequest(url, endpoint, {
+            ...options,
+            headers: {
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        }, requestBody);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/api/base.js.map

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

package/dist/api/fees/api.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Fees API Implementation
+ *
+ * Handles fee simulation and calculation operations.
+ * All operations use JWT authentication and go through the API Gateway.
+ *
+ * This class provides a complete interface for fee-related operations on the Monaco protocol,
+ * including simulating fees before placing orders.
+ *
+ * @example
+ * ```typescript
+ * const feesAPI = new FeesAPIImpl(apiUrl);
+ * feesAPI.setAccessToken(jwtToken);
+ *
+ * // Simulate fees for an order
+ * const feeDetails = await feesAPI.simulateFees({
+ *   trading_pair_id: "123e4567-e89b-12d3-a456-426614174000",
+ *   side: "BUY",
+ *   price: "40000.00",
+ *   quantity: "0.5"
+ * });
+ * ```
+ */
+import type { FeesAPI, SimulateFeeParams, SimulateFeeResponse } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export declare class FeesAPIImpl extends BaseAPI implements FeesAPI {
+    /**
+     * Simulate fees for an order before placing it.
+     *
+     * Returns exact fees for that specific order including Monaco protocol fees,
+     * application fees, and total amounts the taker must pay or maker will receive.
+     *
+     * @param params - Parameters for fee simulation
+     * @param params.trading_pair_id - The trading pair UUID
+     * @param params.side - The order side ("BUY" or "SELL")
+     * @param params.price - The price per unit as string
+     * @param params.quantity - The quantity to trade as string
+     * @returns Promise resolving to SimulateFeeResponse with fee breakdown
+     *
+     * @example
+     * ```typescript
+     * // Simulate fees for a buy order
+     * const buyFees = await feesAPI.simulateFees({
+     *   trading_pair_id: "123e4567-e89b-12d3-a456-426614174000",
+     *   side: "BUY",
+     *   price: "40000.00",
+     *   quantity: "0.5"
+     * });
+     *
+     * console.log(`Notional value: ${buyFees.notional}`);
+     * console.log(`Monaco taker fee: ${buyFees.monaco_taker_fee}`);
+     * console.log(`Application taker fee: ${buyFees.application_taker_fee}`);
+     * console.log(`Total taker fees: ${buyFees.total_taker_fees}`);
+     * console.log(`Total payment required: ${buyFees.taker_total_payment}`);
+     * console.log(`Lock amount for BUY: ${buyFees.buy_order_lock_amount}`);
+     *
+     * // Simulate fees for a sell order
+     * const sellFees = await feesAPI.simulateFees({
+     *   trading_pair_id: "123e4567-e89b-12d3-a456-426614174000",
+     *   side: "SELL",
+     *   price: "40000.00",
+     *   quantity: "0.5"
+     * });
+     *
+     * console.log(`Maker rebate: ${sellFees.monaco_maker_rebate}`);
+     * console.log(`Maker total receipt: ${sellFees.maker_total_receipt}`);
+     * ```
+     */
+    simulateFees(params: SimulateFeeParams): Promise<SimulateFeeResponse>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api/fees/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api/fees/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,WAAY,SAAQ,OAAQ,YAAW,OAAO;IACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAgB5E"}

package/dist/api/fees/api.js

@@ -0,0 +1,83 @@
+/**
+ * Fees API Implementation
+ *
+ * Handles fee simulation and calculation operations.
+ * All operations use JWT authentication and go through the API Gateway.
+ *
+ * This class provides a complete interface for fee-related operations on the Monaco protocol,
+ * including simulating fees before placing orders.
+ *
+ * @example
+ * ```typescript
+ * const feesAPI = new FeesAPIImpl(apiUrl);
+ * feesAPI.setAccessToken(jwtToken);
+ *
+ * // Simulate fees for an order
+ * const feeDetails = await feesAPI.simulateFees({
+ *   trading_pair_id: "123e4567-e89b-12d3-a456-426614174000",
+ *   side: "BUY",
+ *   price: "40000.00",
+ *   quantity: "0.5"
+ * });
+ * ```
+ */
+import { SimulateFeeParamsSchema, validate } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export class FeesAPIImpl extends BaseAPI {
+    /**
+     * Simulate fees for an order before placing it.
+     *
+     * Returns exact fees for that specific order including Monaco protocol fees,
+     * application fees, and total amounts the taker must pay or maker will receive.
+     *
+     * @param params - Parameters for fee simulation
+     * @param params.trading_pair_id - The trading pair UUID
+     * @param params.side - The order side ("BUY" or "SELL")
+     * @param params.price - The price per unit as string
+     * @param params.quantity - The quantity to trade as string
+     * @returns Promise resolving to SimulateFeeResponse with fee breakdown
+     *
+     * @example
+     * ```typescript
+     * // Simulate fees for a buy order
+     * const buyFees = await feesAPI.simulateFees({
+     *   trading_pair_id: "123e4567-e89b-12d3-a456-426614174000",
+     *   side: "BUY",
+     *   price: "40000.00",
+     *   quantity: "0.5"
+     * });
+     *
+     * console.log(`Notional value: ${buyFees.notional}`);
+     * console.log(`Monaco taker fee: ${buyFees.monaco_taker_fee}`);
+     * console.log(`Application taker fee: ${buyFees.application_taker_fee}`);
+     * console.log(`Total taker fees: ${buyFees.total_taker_fees}`);
+     * console.log(`Total payment required: ${buyFees.taker_total_payment}`);
+     * console.log(`Lock amount for BUY: ${buyFees.buy_order_lock_amount}`);
+     *
+     * // Simulate fees for a sell order
+     * const sellFees = await feesAPI.simulateFees({
+     *   trading_pair_id: "123e4567-e89b-12d3-a456-426614174000",
+     *   side: "SELL",
+     *   price: "40000.00",
+     *   quantity: "0.5"
+     * });
+     *
+     * console.log(`Maker rebate: ${sellFees.monaco_maker_rebate}`);
+     * console.log(`Maker total receipt: ${sellFees.maker_total_receipt}`);
+     * ```
+     */
+    async simulateFees(params) {
+        // Validate parameters using the validate helper
+        const validatedParams = validate(SimulateFeeParamsSchema, params);
+        const searchParams = new URLSearchParams();
+        searchParams.append("trading_pair_id", validatedParams.trading_pair_id);
+        searchParams.append("side", validatedParams.side);
+        searchParams.append("price", validatedParams.price);
+        searchParams.append("quantity", validatedParams.quantity);
+        const endpoint = `/api/v1/fees/simulate?${searchParams.toString()}`;
+        return await this.makeAuthenticatedRequest(endpoint, {
+            method: "GET",
+        });
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api/fees/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/api/fees/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,OAAO,WAAY,SAAQ,OAAO;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,KAAK,CAAC,YAAY,CAAC,MAAyB;QAC1C,gDAAgD;QAChD,MAAM,eAAe,GAAG,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;QAElE,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;QAC3C,YAAY,CAAC,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;QACxE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAClD,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;QACpD,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,yBAAyB,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC;QAEpE,OAAO,MAAM,IAAI,CAAC,wBAAwB,CAAsB,QAAQ,EAAE;YACxE,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/api/fees/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fees API Module
+ *
+ * Exports fees API implementation.
+ */
+export { FeesAPIImpl } from "./api";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/fees/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/fees/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}

package/dist/api/fees/index.js

@@ -0,0 +1,7 @@
+/**
+ * Fees API Module
+ *
+ * Exports fees API implementation.
+ */
+export { FeesAPIImpl } from "./api";
+//# sourceMappingURL=index.js.map

package/dist/api/fees/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/fees/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}

package/dist/api/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * API Module Exports
+ *
+ * This module exports the new simplified APIs for the Monaco SDK.
+ */
+export * from "./applications/index";
+export * from "./base";
+export * from "./fees";
+export * from "./market";
+export * from "./orderbook";
+export * from "./profile";
+export * from "./trades";
+export * from "./trading";
+export * from "./vault";
+export * from "./websocket";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,16 @@
+/**
+ * API Module Exports
+ *
+ * This module exports the new simplified APIs for the Monaco SDK.
+ */
+export * from "./applications/index";
+export * from "./base";
+export * from "./fees";
+export * from "./market";
+export * from "./orderbook";
+export * from "./profile";
+export * from "./trades";
+export * from "./trading";
+export * from "./vault";
+export * from "./websocket";
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/api/market/api.d.ts

@@ -0,0 +1,14 @@
+import type { Candlestick, GetCandlesticksParams, GetTradingPairsParams, GetTradingPairsResponse, Interval, MarketAPI, MarketMetadata, TradingPair } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+/**
+ * Market API Implementation
+ *
+ * Provides read-only market metadata endpoints such as trading pair listings.
+ */
+export declare class MarketAPIImpl extends BaseAPI implements MarketAPI {
+    getPaginatedTradingPairs(params?: GetTradingPairsParams): Promise<GetTradingPairsResponse>;
+    getTradingPairBySymbol(symbol: string): Promise<TradingPair | undefined>;
+    getCandlesticks(tradingPairId: string, interval: Interval, params?: GetCandlesticksParams): Promise<Candlestick[]>;
+    getMarketMetadata(tradingPairId: string): Promise<MarketMetadata>;
+}
+//# sourceMappingURL=api.d.ts.map