@lightconexyz/lightcone-sdk 0.1.0

package/dist/api/client.js

@@ -0,0 +1,452 @@
+"use strict";
+/**
+ * REST API client for Lightcone.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightconeApiClient = exports.DEFAULT_RETRY_CONFIG = exports.DEFAULT_API_URL = void 0;
+const orders_1 = require("../program/orders");
+const error_1 = require("./error");
+const validation_1 = require("./validation");
+const auth_1 = require("../auth");
+/**
+ * Convert a typed params object to query string record.
+ */
+function toQueryParams(params) {
+    const result = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== null) {
+            result[key] = String(value);
+        }
+    }
+    return result;
+}
+const network_1 = require("../network");
+var network_2 = require("../network");
+Object.defineProperty(exports, "DEFAULT_API_URL", { enumerable: true, get: function () { return network_2.DEFAULT_API_URL; } });
+/** Default retry configuration (disabled) */
+exports.DEFAULT_RETRY_CONFIG = {
+    maxRetries: 0,
+    baseDelayMs: 100,
+    maxDelayMs: 10000,
+};
+/**
+ * Calculate delay with exponential backoff and jitter.
+ * Jitter: 75-100% of calculated delay (prevents thundering herd)
+ */
+function calculateRetryDelay(attempt, config) {
+    const expDelay = config.baseDelayMs * Math.pow(2, Math.min(attempt, 10));
+    const cappedDelay = Math.min(expDelay, config.maxDelayMs);
+    const jitterRange = cappedDelay * 0.25;
+    const jitter = Math.random() * jitterRange;
+    return cappedDelay - jitterRange + jitter;
+}
+/**
+ * Check if error is retryable.
+ */
+function isRetryable(error) {
+    if (error.variant === "ServerError")
+        return true;
+    if (error.variant === "RateLimited")
+        return true;
+    if (error.variant === "Http")
+        return true; // Network errors
+    return false;
+}
+/**
+ * Sleep for a duration.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * REST API client for the Lightcone platform.
+ *
+ * @example
+ * ```typescript
+ * import { LightconeApiClient } from "@lightcone/sdk/api";
+ *
+ * const client = new LightconeApiClient();
+ *
+ * // Get all markets
+ * const markets = await client.getMarkets();
+ *
+ * // Get orderbook
+ * const orderbook = await client.getOrderbook("market1:ob1");
+ * ```
+ */
+class LightconeApiClient {
+    baseUrl;
+    timeout;
+    headers;
+    retryConfig;
+    authToken;
+    constructor(config = {}) {
+        this.baseUrl = config.baseUrl || network_1.DEFAULT_API_URL;
+        this.timeout = config.timeout || validation_1.DEFAULT_TIMEOUT_MS;
+        this.headers = {
+            "Content-Type": "application/json",
+            ...config.headers,
+        };
+        this.retryConfig = {
+            ...exports.DEFAULT_RETRY_CONFIG,
+            ...config.retry,
+        };
+        this.authToken = config.authToken;
+    }
+    // ============================================================================
+    // AUTHENTICATION
+    // ============================================================================
+    /**
+     * Log in with a Solana keypair. Stores the auth token for subsequent requests.
+     *
+     * @param keypair - The Solana Keypair for authentication
+     * @returns AuthCredentials containing the auth token and user info
+     */
+    async login(keypair) {
+        const credentials = await (0, auth_1.authenticate)(keypair);
+        this.authToken = credentials.authToken;
+        return credentials;
+    }
+    /**
+     * Set the authentication token manually.
+     */
+    setAuthToken(token) {
+        this.authToken = token;
+    }
+    /**
+     * Clear the authentication token.
+     */
+    clearAuthToken() {
+        this.authToken = undefined;
+    }
+    /**
+     * Check if the client has an authentication token.
+     */
+    hasAuthToken() {
+        return this.authToken !== undefined;
+    }
+    // ============================================================================
+    // PRIVATE HELPERS
+    // ============================================================================
+    /**
+     * Make an HTTP request with retry support.
+     */
+    async request(method, path, body, queryParams, authenticated) {
+        let url = `${this.baseUrl}${path}`;
+        // Add query parameters
+        if (queryParams && Object.keys(queryParams).length > 0) {
+            const params = new URLSearchParams(queryParams);
+            url += `?${params.toString()}`;
+        }
+        // Build headers, adding auth cookie if needed
+        const requestHeaders = { ...this.headers };
+        if (authenticated && this.authToken) {
+            requestHeaders["Cookie"] = `auth_token=${this.authToken}`;
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            // Delay before retry (not on first attempt)
+            if (attempt > 0) {
+                const delay = calculateRetryDelay(attempt - 1, this.retryConfig);
+                await sleep(delay);
+            }
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            try {
+                const response = await fetch(url, {
+                    method,
+                    headers: requestHeaders,
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    let errorMessage = `HTTP ${response.status}`;
+                    try {
+                        const errorData = (await response.json());
+                        errorMessage = (0, error_1.getErrorMessage)(errorData);
+                    }
+                    catch (parseError) {
+                        console.warn(`Failed to parse error response: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+                    }
+                    const error = error_1.ApiError.fromStatus(response.status, errorMessage);
+                    // Check if retryable
+                    if (isRetryable(error) && attempt < this.retryConfig.maxRetries) {
+                        lastError = error;
+                        continue;
+                    }
+                    throw error;
+                }
+                const data = (await response.json());
+                return data;
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                if (error instanceof error_1.ApiError) {
+                    // Already an ApiError - check if retryable
+                    if (isRetryable(error) && attempt < this.retryConfig.maxRetries) {
+                        lastError = error;
+                        continue;
+                    }
+                    throw error;
+                }
+                let apiError;
+                if (error instanceof Error) {
+                    if (error.name === "AbortError") {
+                        apiError = error_1.ApiError.http("Request timeout");
+                    }
+                    else {
+                        apiError = error_1.ApiError.http(error.message);
+                    }
+                }
+                else {
+                    apiError = error_1.ApiError.http("Unknown error");
+                }
+                // Network errors are retryable
+                if (isRetryable(apiError) && attempt < this.retryConfig.maxRetries) {
+                    lastError = apiError;
+                    continue;
+                }
+                throw apiError;
+            }
+        }
+        // Should not reach here, but throw last error if we do
+        throw lastError || error_1.ApiError.http("Unknown error");
+    }
+    // ============================================================================
+    // HEALTH CHECK
+    // ============================================================================
+    /**
+     * Check if the API is healthy.
+     *
+     * @throws {ApiError} If the health check fails
+     */
+    async healthCheck() {
+        await this.request("GET", "/health");
+    }
+    // ============================================================================
+    // MARKETS
+    // ============================================================================
+    /**
+     * Get all available markets.
+     *
+     * @returns List of markets
+     */
+    async getMarkets() {
+        return this.request("GET", "/markets");
+    }
+    /**
+     * Get market information by pubkey.
+     *
+     * @param marketPubkey - Market PDA address (Base58)
+     * @returns Market details
+     * @throws {ApiError} If marketPubkey is invalid
+     */
+    async getMarket(marketPubkey) {
+        (0, validation_1.validatePubkey)(marketPubkey, "marketPubkey");
+        return this.request("GET", `/markets/${encodeURIComponent(marketPubkey)}`);
+    }
+    /**
+     * Get market information by slug.
+     *
+     * @param slug - URL-friendly market slug
+     * @returns Market details
+     */
+    async getMarketBySlug(slug) {
+        return this.request("GET", `/markets/by-slug/${encodeURIComponent(slug)}`);
+    }
+    /**
+     * Get deposit assets for a market.
+     *
+     * @param marketPubkey - Market PDA address (Base58)
+     * @returns Deposit assets
+     * @throws {ApiError} If marketPubkey is invalid
+     */
+    async getDepositAssets(marketPubkey) {
+        (0, validation_1.validatePubkey)(marketPubkey, "marketPubkey");
+        return this.request("GET", `/markets/${encodeURIComponent(marketPubkey)}/deposit-assets`);
+    }
+    // ============================================================================
+    // ORDERBOOK
+    // ============================================================================
+    /**
+     * Get orderbook snapshot.
+     *
+     * @param orderbookId - Orderbook identifier
+     * @param depth - Number of levels (default: 20)
+     * @returns Orderbook snapshot
+     */
+    async getOrderbook(orderbookId, depth) {
+        return this.request("GET", `/orderbook/${encodeURIComponent(orderbookId)}`, undefined, toQueryParams({ depth }));
+    }
+    // ============================================================================
+    // ORDERS
+    // ============================================================================
+    /**
+     * Submit a new order.
+     *
+     * @param request - Order details
+     * @returns Order response with hash and fill info
+     * @throws {ApiError} If any pubkey or signature is invalid
+     */
+    async submitOrder(request) {
+        (0, validation_1.validatePubkey)(request.maker, "maker");
+        (0, validation_1.validatePubkey)(request.market_pubkey, "market_pubkey");
+        (0, validation_1.validatePubkey)(request.base_token, "base_token");
+        (0, validation_1.validatePubkey)(request.quote_token, "quote_token");
+        (0, validation_1.validateSignature)(request.signature);
+        return this.request("POST", "/orders/submit", request);
+    }
+    /**
+     * Cancel an order with a pre-computed signature.
+     *
+     * @param orderHash - Hash of the order to cancel (hex)
+     * @param maker - Order creator's pubkey (Base58)
+     * @param signature - Ed25519 signature over the order hash (hex, 128 chars)
+     * @returns Cancel response
+     * @throws {ApiError} If maker pubkey or signature is invalid
+     */
+    async cancelOrderWithSignature(orderHash, maker, signature) {
+        (0, validation_1.validatePubkey)(maker, "maker");
+        (0, validation_1.validateSignature)(signature);
+        const request = { order_hash: orderHash, maker, signature };
+        return this.request("POST", "/orders/cancel", request);
+    }
+    /**
+     * Cancel an order, auto-signing with the given keypair.
+     *
+     * @param orderHash - Hash of the order to cancel (hex)
+     * @param signer - Keypair to sign the cancellation
+     * @returns Cancel response
+     */
+    async cancelOrder(orderHash, signer) {
+        const maker = signer.publicKey.toBase58();
+        const signature = (0, orders_1.signCancelOrder)(orderHash, signer);
+        return this.cancelOrderWithSignature(orderHash, maker, signature);
+    }
+    /**
+     * Cancel all orders for a user with a pre-computed signature.
+     *
+     * @param userPubkey - User's public key (Base58)
+     * @param signature - Ed25519 signature over "cancel_all:{pubkey}:{timestamp}" (hex, 128 chars)
+     * @param timestamp - Unix timestamp used in the signed message
+     * @param orderbookId - Optional orderbook filter
+     * @returns Cancel all response
+     * @throws {ApiError} If any pubkey or signature is invalid
+     */
+    async cancelAllOrdersWithSignature(userPubkey, signature, timestamp, orderbookId) {
+        (0, validation_1.validatePubkey)(userPubkey, "userPubkey");
+        (0, validation_1.validateSignature)(signature);
+        const request = {
+            user_pubkey: userPubkey,
+            orderbook_id: orderbookId,
+            signature,
+            timestamp,
+        };
+        return this.request("POST", "/orders/cancel-all", request);
+    }
+    /**
+     * Cancel all orders for a user, auto-signing with the given keypair.
+     *
+     * @param signer - Keypair to sign the cancellation
+     * @param orderbookId - Optional orderbook filter
+     * @returns Cancel all response
+     */
+    async cancelAllOrders(signer, orderbookId) {
+        const userPubkey = signer.publicKey.toBase58();
+        const timestamp = Math.floor(Date.now() / 1000);
+        const signature = (0, orders_1.signCancelAll)(userPubkey, timestamp, signer);
+        return this.cancelAllOrdersWithSignature(userPubkey, signature, timestamp, orderbookId);
+    }
+    // ============================================================================
+    // USER POSITIONS
+    // ============================================================================
+    /**
+     * Get user positions across all markets.
+     *
+     * @param userPubkey - User's public key (Base58)
+     * @returns User positions
+     * @throws {ApiError} If userPubkey is invalid
+     */
+    async getUserPositions(userPubkey) {
+        (0, validation_1.validatePubkey)(userPubkey, "userPubkey");
+        return this.request("GET", `/users/${encodeURIComponent(userPubkey)}/positions`);
+    }
+    /**
+     * Get user positions in a specific market.
+     *
+     * @param userPubkey - User's public key (Base58)
+     * @param marketPubkey - Market PDA address (Base58)
+     * @returns Market positions
+     * @throws {ApiError} If any pubkey is invalid
+     */
+    async getUserMarketPositions(userPubkey, marketPubkey) {
+        (0, validation_1.validatePubkey)(userPubkey, "userPubkey");
+        (0, validation_1.validatePubkey)(marketPubkey, "marketPubkey");
+        return this.request("GET", `/users/${encodeURIComponent(userPubkey)}/markets/${encodeURIComponent(marketPubkey)}/positions`);
+    }
+    // ============================================================================
+    // USER ORDERS
+    // ============================================================================
+    /**
+     * Get user's open orders.
+     *
+     * @param userPubkey - User's public key (Base58)
+     * @returns User orders and balances
+     * @throws {ApiError} If userPubkey is invalid
+     */
+    async getUserOrders(userPubkey) {
+        (0, validation_1.validatePubkey)(userPubkey, "userPubkey");
+        return this.request("POST", "/users/orders", { user_pubkey: userPubkey }, undefined, true);
+    }
+    // ============================================================================
+    // PRICE HISTORY
+    // ============================================================================
+    /**
+     * Get historical price data.
+     *
+     * @param params - Query parameters
+     * @returns Price history data
+     * @throws {ApiError} If limit is out of bounds (1-500)
+     */
+    async getPriceHistory(params) {
+        (0, validation_1.validateLimit)(params.limit);
+        return this.request("GET", "/price-history", undefined, toQueryParams(params));
+    }
+    // ============================================================================
+    // TRADES
+    // ============================================================================
+    /**
+     * Get recent trades.
+     *
+     * @param params - Query parameters
+     * @returns Trade history
+     * @throws {ApiError} If limit is out of bounds (1-500)
+     */
+    async getTrades(params) {
+        (0, validation_1.validateLimit)(params.limit);
+        return this.request("GET", "/trades", undefined, toQueryParams(params));
+    }
+    // ============================================================================
+    // ADMIN
+    // ============================================================================
+    /**
+     * Admin health check.
+     *
+     * @returns Admin status
+     */
+    async adminHealthCheck() {
+        return this.request("GET", "/admin/test");
+    }
+    /**
+     * Create a new orderbook (admin only).
+     *
+     * @param request - Orderbook creation request
+     * @returns Created orderbook info
+     */
+    async createOrderbook(request) {
+        return this.request("POST", "/admin/create-orderbook", request);
+    }
+}
+exports.LightconeApiClient = LightconeApiClient;
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * REST API client for Lightcone.\n */\n\nimport { Keypair } from \"@solana/web3.js\";\nimport { signCancelOrder, signCancelAll } from \"../program/orders\";\nimport { ApiError, getErrorMessage, type ErrorResponse } from \"./error\";\nimport {\n  validatePubkey,\n  validateSignature,\n  validateLimit,\n  DEFAULT_TIMEOUT_MS,\n} from \"./validation\";\nimport { authenticate, type AuthCredentials } from \"../auth\";\nimport type {\n  MarketsResponse,\n  MarketInfoResponse,\n  DepositAssetsResponse,\n  OrderbookResponse,\n  SubmitOrderRequest,\n  OrderResponse,\n  CancelOrderRequest,\n  CancelResponse,\n  CancelAllOrdersRequest,\n  CancelAllResponse,\n  PositionsResponse,\n  MarketPositionsResponse,\n  UserOrdersResponse,\n  PriceHistoryParams,\n  PriceHistoryResponse,\n  TradesParams,\n  TradesResponse,\n  AdminResponse,\n  CreateOrderbookRequest,\n  CreateOrderbookResponse,\n} from \"./types\";\n\n/**\n * Convert a typed params object to query string record.\n */\nfunction toQueryParams(\n  params: object\n): Record<string, string> {\n  const result: Record<string, string> = {};\n  for (const [key, value] of Object.entries(params)) {\n    if (value !== undefined && value !== null) {\n      result[key] = String(value);\n    }\n  }\n  return result;\n}\n\nimport { DEFAULT_API_URL } from \"../network\";\nexport { DEFAULT_API_URL } from \"../network\";\n\n/**\n * Configuration for retry behavior.\n */\nexport interface RetryConfig {\n  /** Maximum number of retry attempts (default: 0 = disabled) */\n  maxRetries: number;\n  /** Initial delay in milliseconds (default: 100) */\n  baseDelayMs: number;\n  /** Maximum delay cap in milliseconds (default: 10000) */\n  maxDelayMs: number;\n}\n\n/** Default retry configuration (disabled) */\nexport const DEFAULT_RETRY_CONFIG: RetryConfig = {\n  maxRetries: 0,\n  baseDelayMs: 100,\n  maxDelayMs: 10000,\n};\n\n/**\n * Configuration for the Lightcone API client.\n */\nexport interface LightconeApiClientConfig {\n  /** Base URL for the API (default: https://tapi.lightcone.xyz/api) */\n  baseUrl?: string;\n  /** Request timeout in milliseconds (default: 30000) */\n  timeout?: number;\n  /** Additional headers to include in requests */\n  headers?: Record<string, string>;\n  /** Retry configuration for transient failures */\n  retry?: Partial<RetryConfig>;\n  /** Authentication token for authenticated endpoints */\n  authToken?: string;\n}\n\n/**\n * Calculate delay with exponential backoff and jitter.\n * Jitter: 75-100% of calculated delay (prevents thundering herd)\n */\nfunction calculateRetryDelay(attempt: number, config: RetryConfig): number {\n  const expDelay = config.baseDelayMs * Math.pow(2, Math.min(attempt, 10));\n  const cappedDelay = Math.min(expDelay, config.maxDelayMs);\n  const jitterRange = cappedDelay * 0.25;\n  const jitter = Math.random() * jitterRange;\n  return cappedDelay - jitterRange + jitter;\n}\n\n/**\n * Check if error is retryable.\n */\nfunction isRetryable(error: ApiError): boolean {\n  if (error.variant === \"ServerError\") return true;\n  if (error.variant === \"RateLimited\") return true;\n  if (error.variant === \"Http\") return true; // Network errors\n  return false;\n}\n\n/**\n * Sleep for a duration.\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * REST API client for the Lightcone platform.\n *\n * @example\n * ```typescript\n * import { LightconeApiClient } from \"@lightcone/sdk/api\";\n *\n * const client = new LightconeApiClient();\n *\n * // Get all markets\n * const markets = await client.getMarkets();\n *\n * // Get orderbook\n * const orderbook = await client.getOrderbook(\"market1:ob1\");\n * ```\n */\nexport class LightconeApiClient {\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n  private readonly headers: Record<string, string>;\n  private readonly retryConfig: RetryConfig;\n  private authToken?: string;\n\n  constructor(config: LightconeApiClientConfig = {}) {\n    this.baseUrl = config.baseUrl || DEFAULT_API_URL;\n    this.timeout = config.timeout || DEFAULT_TIMEOUT_MS;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      ...config.headers,\n    };\n    this.retryConfig = {\n      ...DEFAULT_RETRY_CONFIG,\n      ...config.retry,\n    };\n    this.authToken = config.authToken;\n  }\n\n  // ============================================================================\n  // AUTHENTICATION\n  // ============================================================================\n\n  /**\n   * Log in with a Solana keypair. Stores the auth token for subsequent requests.\n   *\n   * @param keypair - The Solana Keypair for authentication\n   * @returns AuthCredentials containing the auth token and user info\n   */\n  async login(keypair: Keypair): Promise<AuthCredentials> {\n    const credentials = await authenticate(keypair);\n    this.authToken = credentials.authToken;\n    return credentials;\n  }\n\n  /**\n   * Set the authentication token manually.\n   */\n  setAuthToken(token: string): void {\n    this.authToken = token;\n  }\n\n  /**\n   * Clear the authentication token.\n   */\n  clearAuthToken(): void {\n    this.authToken = undefined;\n  }\n\n  /**\n   * Check if the client has an authentication token.\n   */\n  hasAuthToken(): boolean {\n    return this.authToken !== undefined;\n  }\n\n  // ============================================================================\n  // PRIVATE HELPERS\n  // ============================================================================\n\n  /**\n   * Make an HTTP request with retry support.\n   */\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    queryParams?: Record<string, string>,\n    authenticated?: boolean\n  ): Promise<T> {\n    let url = `${this.baseUrl}${path}`;\n\n    // Add query parameters\n    if (queryParams && Object.keys(queryParams).length > 0) {\n      const params = new URLSearchParams(queryParams);\n      url += `?${params.toString()}`;\n    }\n\n    // Build headers, adding auth cookie if needed\n    const requestHeaders: Record<string, string> = { ...this.headers };\n    if (authenticated && this.authToken) {\n      requestHeaders[\"Cookie\"] = `auth_token=${this.authToken}`;\n    }\n\n    let lastError: ApiError | undefined;\n\n    for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {\n      // Delay before retry (not on first attempt)\n      if (attempt > 0) {\n        const delay = calculateRetryDelay(attempt - 1, this.retryConfig);\n        await sleep(delay);\n      }\n\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const response = await fetch(url, {\n          method,\n          headers: requestHeaders,\n          body: body ? JSON.stringify(body) : undefined,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!response.ok) {\n          let errorMessage = `HTTP ${response.status}`;\n          try {\n            const errorData = (await response.json()) as ErrorResponse;\n            errorMessage = getErrorMessage(errorData);\n          } catch (parseError) {\n            console.warn(\n              `Failed to parse error response: ${parseError instanceof Error ? parseError.message : String(parseError)}`\n            );\n          }\n          const error = ApiError.fromStatus(response.status, errorMessage);\n\n          // Check if retryable\n          if (isRetryable(error) && attempt < this.retryConfig.maxRetries) {\n            lastError = error;\n            continue;\n          }\n          throw error;\n        }\n\n        const data = (await response.json()) as T;\n        return data;\n      } catch (error) {\n        clearTimeout(timeoutId);\n\n        if (error instanceof ApiError) {\n          // Already an ApiError - check if retryable\n          if (isRetryable(error) && attempt < this.retryConfig.maxRetries) {\n            lastError = error;\n            continue;\n          }\n          throw error;\n        }\n\n        let apiError: ApiError;\n        if (error instanceof Error) {\n          if (error.name === \"AbortError\") {\n            apiError = ApiError.http(\"Request timeout\");\n          } else {\n            apiError = ApiError.http(error.message);\n          }\n        } else {\n          apiError = ApiError.http(\"Unknown error\");\n        }\n\n        // Network errors are retryable\n        if (isRetryable(apiError) && attempt < this.retryConfig.maxRetries) {\n          lastError = apiError;\n          continue;\n        }\n        throw apiError;\n      }\n    }\n\n    // Should not reach here, but throw last error if we do\n    throw lastError || ApiError.http(\"Unknown error\");\n  }\n\n  // ============================================================================\n  // HEALTH CHECK\n  // ============================================================================\n\n  /**\n   * Check if the API is healthy.\n   *\n   * @throws {ApiError} If the health check fails\n   */\n  async healthCheck(): Promise<void> {\n    await this.request<{ status: string }>(\"GET\", \"/health\");\n  }\n\n  // ============================================================================\n  // MARKETS\n  // ============================================================================\n\n  /**\n   * Get all available markets.\n   *\n   * @returns List of markets\n   */\n  async getMarkets(): Promise<MarketsResponse> {\n    return this.request<MarketsResponse>(\"GET\", \"/markets\");\n  }\n\n  /**\n   * Get market information by pubkey.\n   *\n   * @param marketPubkey - Market PDA address (Base58)\n   * @returns Market details\n   * @throws {ApiError} If marketPubkey is invalid\n   */\n  async getMarket(marketPubkey: string): Promise<MarketInfoResponse> {\n    validatePubkey(marketPubkey, \"marketPubkey\");\n    return this.request<MarketInfoResponse>(\n      \"GET\",\n      `/markets/${encodeURIComponent(marketPubkey)}`\n    );\n  }\n\n  /**\n   * Get market information by slug.\n   *\n   * @param slug - URL-friendly market slug\n   * @returns Market details\n   */\n  async getMarketBySlug(slug: string): Promise<MarketInfoResponse> {\n    return this.request<MarketInfoResponse>(\n      \"GET\",\n      `/markets/by-slug/${encodeURIComponent(slug)}`\n    );\n  }\n\n  /**\n   * Get deposit assets for a market.\n   *\n   * @param marketPubkey - Market PDA address (Base58)\n   * @returns Deposit assets\n   * @throws {ApiError} If marketPubkey is invalid\n   */\n  async getDepositAssets(marketPubkey: string): Promise<DepositAssetsResponse> {\n    validatePubkey(marketPubkey, \"marketPubkey\");\n    return this.request<DepositAssetsResponse>(\n      \"GET\",\n      `/markets/${encodeURIComponent(marketPubkey)}/deposit-assets`\n    );\n  }\n\n  // ============================================================================\n  // ORDERBOOK\n  // ============================================================================\n\n  /**\n   * Get orderbook snapshot.\n   *\n   * @param orderbookId - Orderbook identifier\n   * @param depth - Number of levels (default: 20)\n   * @returns Orderbook snapshot\n   */\n  async getOrderbook(\n    orderbookId: string,\n    depth?: number\n  ): Promise<OrderbookResponse> {\n    return this.request<OrderbookResponse>(\n      \"GET\",\n      `/orderbook/${encodeURIComponent(orderbookId)}`,\n      undefined,\n      toQueryParams({ depth })\n    );\n  }\n\n  // ============================================================================\n  // ORDERS\n  // ============================================================================\n\n  /**\n   * Submit a new order.\n   *\n   * @param request - Order details\n   * @returns Order response with hash and fill info\n   * @throws {ApiError} If any pubkey or signature is invalid\n   */\n  async submitOrder(request: SubmitOrderRequest): Promise<OrderResponse> {\n    validatePubkey(request.maker, \"maker\");\n    validatePubkey(request.market_pubkey, \"market_pubkey\");\n    validatePubkey(request.base_token, \"base_token\");\n    validatePubkey(request.quote_token, \"quote_token\");\n    validateSignature(request.signature);\n    return this.request<OrderResponse>(\"POST\", \"/orders/submit\", request);\n  }\n\n  /**\n   * Cancel an order with a pre-computed signature.\n   *\n   * @param orderHash - Hash of the order to cancel (hex)\n   * @param maker - Order creator's pubkey (Base58)\n   * @param signature - Ed25519 signature over the order hash (hex, 128 chars)\n   * @returns Cancel response\n   * @throws {ApiError} If maker pubkey or signature is invalid\n   */\n  async cancelOrderWithSignature(\n    orderHash: string,\n    maker: string,\n    signature: string\n  ): Promise<CancelResponse> {\n    validatePubkey(maker, \"maker\");\n    validateSignature(signature);\n    const request: CancelOrderRequest = { order_hash: orderHash, maker, signature };\n    return this.request<CancelResponse>(\"POST\", \"/orders/cancel\", request);\n  }\n\n  /**\n   * Cancel an order, auto-signing with the given keypair.\n   *\n   * @param orderHash - Hash of the order to cancel (hex)\n   * @param signer - Keypair to sign the cancellation\n   * @returns Cancel response\n   */\n  async cancelOrder(orderHash: string, signer: Keypair): Promise<CancelResponse> {\n    const maker = signer.publicKey.toBase58();\n    const signature = signCancelOrder(orderHash, signer);\n    return this.cancelOrderWithSignature(orderHash, maker, signature);\n  }\n\n  /**\n   * Cancel all orders for a user with a pre-computed signature.\n   *\n   * @param userPubkey - User's public key (Base58)\n   * @param signature - Ed25519 signature over \"cancel_all:{pubkey}:{timestamp}\" (hex, 128 chars)\n   * @param timestamp - Unix timestamp used in the signed message\n   * @param orderbookId - Optional orderbook filter\n   * @returns Cancel all response\n   * @throws {ApiError} If any pubkey or signature is invalid\n   */\n  async cancelAllOrdersWithSignature(\n    userPubkey: string,\n    signature: string,\n    timestamp: number,\n    orderbookId?: string\n  ): Promise<CancelAllResponse> {\n    validatePubkey(userPubkey, \"userPubkey\");\n    validateSignature(signature);\n    const request: CancelAllOrdersRequest = {\n      user_pubkey: userPubkey,\n      orderbook_id: orderbookId,\n      signature,\n      timestamp,\n    };\n    return this.request<CancelAllResponse>(\"POST\", \"/orders/cancel-all\", request);\n  }\n\n  /**\n   * Cancel all orders for a user, auto-signing with the given keypair.\n   *\n   * @param signer - Keypair to sign the cancellation\n   * @param orderbookId - Optional orderbook filter\n   * @returns Cancel all response\n   */\n  async cancelAllOrders(\n    signer: Keypair,\n    orderbookId?: string\n  ): Promise<CancelAllResponse> {\n    const userPubkey = signer.publicKey.toBase58();\n    const timestamp = Math.floor(Date.now() / 1000);\n    const signature = signCancelAll(userPubkey, timestamp, signer);\n    return this.cancelAllOrdersWithSignature(userPubkey, signature, timestamp, orderbookId);\n  }\n\n  // ============================================================================\n  // USER POSITIONS\n  // ============================================================================\n\n  /**\n   * Get user positions across all markets.\n   *\n   * @param userPubkey - User's public key (Base58)\n   * @returns User positions\n   * @throws {ApiError} If userPubkey is invalid\n   */\n  async getUserPositions(userPubkey: string): Promise<PositionsResponse> {\n    validatePubkey(userPubkey, \"userPubkey\");\n    return this.request<PositionsResponse>(\n      \"GET\",\n      `/users/${encodeURIComponent(userPubkey)}/positions`\n    );\n  }\n\n  /**\n   * Get user positions in a specific market.\n   *\n   * @param userPubkey - User's public key (Base58)\n   * @param marketPubkey - Market PDA address (Base58)\n   * @returns Market positions\n   * @throws {ApiError} If any pubkey is invalid\n   */\n  async getUserMarketPositions(\n    userPubkey: string,\n    marketPubkey: string\n  ): Promise<MarketPositionsResponse> {\n    validatePubkey(userPubkey, \"userPubkey\");\n    validatePubkey(marketPubkey, \"marketPubkey\");\n    return this.request<MarketPositionsResponse>(\n      \"GET\",\n      `/users/${encodeURIComponent(userPubkey)}/markets/${encodeURIComponent(marketPubkey)}/positions`\n    );\n  }\n\n  // ============================================================================\n  // USER ORDERS\n  // ============================================================================\n\n  /**\n   * Get user's open orders.\n   *\n   * @param userPubkey - User's public key (Base58)\n   * @returns User orders and balances\n   * @throws {ApiError} If userPubkey is invalid\n   */\n  async getUserOrders(userPubkey: string): Promise<UserOrdersResponse> {\n    validatePubkey(userPubkey, \"userPubkey\");\n    return this.request<UserOrdersResponse>(\n      \"POST\",\n      \"/users/orders\",\n      { user_pubkey: userPubkey },\n      undefined,\n      true\n    );\n  }\n\n  // ============================================================================\n  // PRICE HISTORY\n  // ============================================================================\n\n  /**\n   * Get historical price data.\n   *\n   * @param params - Query parameters\n   * @returns Price history data\n   * @throws {ApiError} If limit is out of bounds (1-500)\n   */\n  async getPriceHistory(params: PriceHistoryParams): Promise<PriceHistoryResponse> {\n    validateLimit(params.limit);\n    return this.request<PriceHistoryResponse>(\n      \"GET\",\n      \"/price-history\",\n      undefined,\n      toQueryParams(params)\n    );\n  }\n\n  // ============================================================================\n  // TRADES\n  // ============================================================================\n\n  /**\n   * Get recent trades.\n   *\n   * @param params - Query parameters\n   * @returns Trade history\n   * @throws {ApiError} If limit is out of bounds (1-500)\n   */\n  async getTrades(params: TradesParams): Promise<TradesResponse> {\n    validateLimit(params.limit);\n    return this.request<TradesResponse>(\n      \"GET\",\n      \"/trades\",\n      undefined,\n      toQueryParams(params)\n    );\n  }\n\n  // ============================================================================\n  // ADMIN\n  // ============================================================================\n\n  /**\n   * Admin health check.\n   *\n   * @returns Admin status\n   */\n  async adminHealthCheck(): Promise<AdminResponse> {\n    return this.request<AdminResponse>(\"GET\", \"/admin/test\");\n  }\n\n  /**\n   * Create a new orderbook (admin only).\n   *\n   * @param request - Orderbook creation request\n   * @returns Created orderbook info\n   */\n  async createOrderbook(\n    request: CreateOrderbookRequest\n  ): Promise<CreateOrderbookResponse> {\n    return this.request<CreateOrderbookResponse>(\n      \"POST\",\n      \"/admin/create-orderbook\",\n      request\n    );\n  }\n}\n"]}

package/dist/api/error.d.ts

@@ -0,0 +1,58 @@
+/**
+ * API error types for the Lightcone REST API client.
+ */
+/**
+ * API error variants
+ */
+export type ApiErrorVariant = "Http" | "NotFound" | "BadRequest" | "Forbidden" | "Conflict" | "ServerError" | "Deserialize" | "InvalidParameter" | "UnexpectedStatus" | "RateLimited" | "Unauthorized";
+/**
+ * API-specific error class for the Lightcone REST API client.
+ */
+export declare class ApiError extends Error {
+    readonly variant: ApiErrorVariant;
+    readonly statusCode?: number;
+    readonly details?: string;
+    constructor(variant: ApiErrorVariant, message: string, statusCode?: number, details?: string);
+    /** HTTP/network error */
+    static http(message: string): ApiError;
+    /** Resource not found (404) */
+    static notFound(message: string): ApiError;
+    /** Invalid request parameters (400) */
+    static badRequest(message: string): ApiError;
+    /** Permission denied, signature mismatch (403) */
+    static forbidden(message: string): ApiError;
+    /** Resource already exists (409) */
+    static conflict(message: string): ApiError;
+    /** Server-side error (500) */
+    static serverError(message: string): ApiError;
+    /** JSON deserialization error */
+    static deserialize(message: string): ApiError;
+    /** Invalid parameter provided */
+    static invalidParameter(message: string): ApiError;
+    /** Unexpected HTTP status code */
+    static unexpectedStatus(statusCode: number, message: string): ApiError;
+    /** Rate limited (429) */
+    static rateLimited(message: string): ApiError;
+    /** Unauthorized - invalid or missing authentication (401) */
+    static unauthorized(message: string): ApiError;
+    /** Create from HTTP status code */
+    static fromStatus(statusCode: number, message: string): ApiError;
+}
+/**
+ * Error response format from the API.
+ */
+export interface ErrorResponse {
+    /** Error status (usually "error") */
+    status?: string;
+    /** Human-readable error message */
+    message?: string;
+    /** Alternative error field */
+    error?: string;
+    /** Additional error details */
+    details?: string;
+}
+/**
+ * Get the error message from an ErrorResponse.
+ */
+export declare function getErrorMessage(response: ErrorResponse): string;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/api/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,UAAU,GACV,YAAY,GACZ,WAAW,GACX,UAAU,GACV,aAAa,GACb,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,aAAa,GACb,cAAc,CAAC;AAEnB;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAQ5F,yBAAyB;IACzB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAItC,+BAA+B;IAC/B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI1C,uCAAuC;IACvC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI5C,kDAAkD;IAClD,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI3C,oCAAoC;IACpC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI1C,8BAA8B;IAC9B,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI7C,iCAAiC;IACjC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI7C,iCAAiC;IACjC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAIlD,kCAAkC;IAClC,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ;IAItE,yBAAyB;IACzB,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI7C,6DAA6D;IAC7D,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAI9C,mCAAmC;IACnC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ;CAuBjE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAE/D"}