@0xmonaco/core 0.7.5 → 0.7.7

package/dist/api/base.d.ts

@@ -1,123 +0,0 @@
-/**
- * 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>;
-}

package/dist/api/base.js

@@ -1,286 +0,0 @@
-/**
- * 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 {
-    apiUrl;
-    accessToken;
-    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, 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);
-    }
-}

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

@@ -1,72 +0,0 @@
-/**
- * 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
-     * @param params.order_type - Order type: "LIMIT" (default) or "MARKET"
-     * @param params.slippage_tolerance_bps - Slippage tolerance in bps (0–1000, MARKET only, default 500)
-     * @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>;
-}

package/dist/api/fees/api.js

@@ -1,90 +0,0 @@
-/**
- * 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
-     * @param params.order_type - Order type: "LIMIT" (default) or "MARKET"
-     * @param params.slippage_tolerance_bps - Slippage tolerance in bps (0–1000, MARKET only, default 500)
-     * @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);
-        if (validatedParams.order_type !== undefined) {
-            searchParams.append("order_type", validatedParams.order_type);
-        }
-        if (validatedParams.slippage_tolerance_bps !== undefined) {
-            searchParams.append("slippage_tolerance_bps", String(validatedParams.slippage_tolerance_bps));
-        }
-        const endpoint = `/api/v1/fees/simulate?${searchParams.toString()}`;
-        return await this.makeAuthenticatedRequest(endpoint, {
-            method: "GET",
-        });
-    }
-}

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

@@ -1,6 +0,0 @@
-/**
- * Fees API Module
- *
- * Exports fees API implementation.
- */
-export { FeesAPIImpl } from "./api";

package/dist/api/fees/index.js

@@ -1,6 +0,0 @@
-/**
- * Fees API Module
- *
- * Exports fees API implementation.
- */
-export { FeesAPIImpl } from "./api";

package/dist/api/index.d.ts

@@ -1,18 +0,0 @@
-/**
- * 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 "./margin-accounts";
-export * from "./market";
-export * from "./orderbook";
-export * from "./perp";
-export * from "./positions";
-export * from "./profile";
-export * from "./trades";
-export * from "./trading";
-export * from "./vault";
-export * from "./websocket";

package/dist/api/index.js

@@ -1,18 +0,0 @@
-/**
- * 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 "./margin-accounts";
-export * from "./market";
-export * from "./orderbook";
-export * from "./perp";
-export * from "./positions";
-export * from "./profile";
-export * from "./trades";
-export * from "./trading";
-export * from "./vault";
-export * from "./websocket";

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

@@ -1,12 +0,0 @@
-import type { CreateMarginAccountRequest, CreateMarginAccountResponse, GetAvailableCollateralParams, GetAvailableCollateralResponse, GetMarginAccountMovementsParams, GetMarginAccountMovementsResponse, ListMarginAccountsParams, ListMarginAccountsResponse, MarginAccountSummary, MarginAccountsAPI, SimulateOrderRiskRequest, SimulateOrderRiskResponse, TransferCollateralRequest, TransferCollateralResponse } from "@0xmonaco/types";
-import { BaseAPI } from "../base";
-export declare class MarginAccountsAPIImpl extends BaseAPI implements MarginAccountsAPI {
-    listMarginAccounts(params?: ListMarginAccountsParams): Promise<ListMarginAccountsResponse>;
-    createMarginAccount(request?: CreateMarginAccountRequest): Promise<CreateMarginAccountResponse>;
-    getMarginAccountSummary(marginAccountId: string): Promise<MarginAccountSummary>;
-    getAvailableCollateral(params?: GetAvailableCollateralParams): Promise<GetAvailableCollateralResponse>;
-    transferCollateralToMarginAccount(marginAccountId: string, request: TransferCollateralRequest): Promise<TransferCollateralResponse>;
-    transferCollateralFromMarginAccount(marginAccountId: string, request: TransferCollateralRequest): Promise<TransferCollateralResponse>;
-    getMarginAccountMovements(marginAccountId: string, params?: GetMarginAccountMovementsParams): Promise<GetMarginAccountMovementsResponse>;
-    simulateOrderRisk(marginAccountId: string, request: SimulateOrderRiskRequest): Promise<SimulateOrderRiskResponse>;
-}