@strkfarm/sdk 2.0.0-dev.35 → 2.0.0-dev.36

package/src/modules/ExtendedWrapperSDk/wrapper.ts

@@ -1,611 +0,0 @@
-/**
- * ExtendedWrapper - TypeScript wrapper for Extended Exchange API
- * Provides a clean interface to interact with the Extended Exchange trading API
- */
-
-import BigNumber from "bignumber.js";
-import {
-  CreateOrderRequest,
-  WithdrawRequest,
-  SignedWithdrawRequest,
-  CancelOrderRequest,
-  PlacedOrder,
-  OpenOrder,
-  Position,
-  Balance,
-  Market,
-  MarketStats,
-  AssetOperation,
-  ExtendedApiResponse,
-  ExtendedWrapperConfig,
-  OrderSide,
-  TimeInForce,
-  AssetOperationType,
-  AssetOperationStatus,
-  FundingRate,
-  FundingPayment,
-  UpdateLeverageRequest,
-} from "./types";
-
-type ExtendedTradingRules = {
-  minOrderSize: BigNumber;
-  qtyStep: BigNumber;
-  priceStep: BigNumber;
-};
-
-function asRecord(v: unknown): Record<string, unknown> | null {
-  return v !== null && typeof v === "object" && !Array.isArray(v)
-    ? (v as Record<string, unknown>)
-    : null;
-}
-
-function pickTradingConfig(row: Record<string, unknown>): Record<string, unknown> | null {
-  const tc = row.trading_config ?? row.tradingConfig;
-  return asRecord(tc);
-}
-
-function readTcString(
-  tc: Record<string, unknown>,
-  snake: string,
-  camel: string,
-): string | undefined {
-  const v = tc[snake] ?? tc[camel];
-  if (v === undefined || v === null) return undefined;
-  return String(v).trim();
-}
-
-function tradingRulesFromMarketRow(
-  marketName: string,
-  row: unknown,
-): ExtendedTradingRules {
-  const r = asRecord(row);
-  if (!r) {
-    throw new Error(`ExtendedWrapper: invalid market payload for ${marketName}`);
-  }
-  const tc = pickTradingConfig(r);
-  if (!tc) {
-    throw new Error(`ExtendedWrapper: missing tradingConfig for market ${marketName}`);
-  }
-  const minS = readTcString(tc, "min_order_size", "minOrderSize");
-  const qtyStep = readTcString(tc, "min_order_size_change", "minOrderSizeChange");
-  const pxStep = readTcString(tc, "min_price_change", "minPriceChange");
-  if (!minS || !qtyStep || !pxStep) {
-    throw new Error(`ExtendedWrapper: incomplete tradingConfig for market ${marketName}`);
-  }
-  const minOrderSize = new BigNumber(minS);
-  const qty = new BigNumber(qtyStep);
-  const px = new BigNumber(pxStep);
-  if (!minOrderSize.isFinite() || minOrderSize.lte(0)) {
-    throw new Error(`ExtendedWrapper: invalid minOrderSize for ${marketName}`);
-  }
-  if (!qty.isFinite() || qty.lte(0)) {
-    throw new Error(`ExtendedWrapper: invalid minOrderSizeChange for ${marketName}`);
-  }
-  if (!px.isFinite() || px.lte(0)) {
-    throw new Error(`ExtendedWrapper: invalid minPriceChange for ${marketName}`);
-  }
-  return { minOrderSize, qtyStep: qty, priceStep: px };
-}
-
-function roundToStepBn(value: BigNumber, step: BigNumber): BigNumber {
-  if (step.lte(0)) return value;
-  return value.div(step).round(0, BigNumber.ROUND_HALF_UP).times(step);
-}
-
-function formatBnForApi(bn: BigNumber, step: BigNumber): string {
-  const dp = Math.max(step.decimalPlaces() ?? 0, bn.decimalPlaces() ?? 0, 0);
-  return Number(bn.toFixed(Math.min(80, dp))).toString();
-}
-
-export class ExtendedWrapper {
-  private readUrl: string;
-  private writeUrl: string;
-  private apiKey?: string;
-  private timeout: number;
-  private retries: number;
-  /** Per-market rules from GET /markets (tradingConfig); retained for process lifetime (no TTL). */
-  private marketTradingRulesCache = new Map<string, ExtendedTradingRules>();
-  private marketTradingRulesInflight = new Map<
-    string,
-    Promise<ExtendedTradingRules>
-  >();
-
-  constructor(config: ExtendedWrapperConfig) {
-    this.apiKey = config.apiKey;
-    this.timeout = config.timeout || 30000; // 30 seconds default
-    this.retries = config.retries || 3;
-    this.readUrl = config.readUrl.replace(/\/$/, "");
-    this.writeUrl = config.writeUrl.replace(/\/$/, "");
-  }
-
-  /**
-   * Make HTTP request with retry logic and error handling
-   */
-  private async makeRequest<T>(
-    endpoint: string,
-    isRead: boolean,
-    options: RequestInit = {},
-  ): Promise<ExtendedApiResponse<T>> {
-    const url = `${isRead ? this.readUrl : this.writeUrl}${endpoint}`;
-    const headers: Record<string, any> = {
-      "Content-Type": "application/json",
-      ...options.headers,
-    };
-    if (this.apiKey) {
-      headers["X-API-Key"] = this.apiKey;
-    }
-
-    const requestOptions: RequestInit = {
-      ...options,
-      headers,
-      signal: AbortSignal.timeout(this.timeout),
-    };
-
-    let lastError: Error | null = null;
-
-    for (let attempt = 1; attempt <= this.retries; attempt++) {
-      try {
-        const response = await fetch(url, requestOptions);
-
-        if (!response.ok) {
-          const errorData = await response.json().catch(() => ({}));
-          throw new Error(
-            `HTTP ${response.status}: ${
-              errorData.detail || response.statusText
-            }`,
-          );
-        }
-
-        const text = await response.text();
-
-        // Replace large integers (greater than MAX_SAFE_INTEGER) with quoted strings
-        // This regex finds numbers that are likely to be large integers in the "data" field
-        const MAX_SAFE_INTEGER_STR = "9007199254740991";
-        const largeIntegerRegex = /"data"\s*:\s*(\d{16,})/g;
-
-        const modifiedText = text.replace(
-          largeIntegerRegex,
-          (match, largeInt) => {
-            // Compare as strings to avoid precision loss
-            if (
-              largeInt.length > MAX_SAFE_INTEGER_STR.length ||
-              (largeInt.length === MAX_SAFE_INTEGER_STR.length &&
-                largeInt > MAX_SAFE_INTEGER_STR)
-            ) {
-              // Replace the number with a quoted string to preserve precision
-              return `"data":"${largeInt}"`;
-            }
-            return match; // Keep original if it's a safe integer
-          },
-        );
-
-        const data = JSON.parse(modifiedText);
-
-        if (data && typeof data.data === "string" && /^\d+$/.test(data.data)) {
-          const numValue = Number(data.data);
-          if (Number.isSafeInteger(numValue)) {
-            data.data = numValue;
-          }
-        }
-
-        return data;
-      } catch (error) {
-        lastError = error as Error;
-
-        if (attempt < this.retries) {
-          // Exponential backoff
-          const delay = Math.pow(2, attempt) * 1000;
-          await new Promise((resolve) => setTimeout(resolve, delay));
-        }
-      }
-    }
-
-    throw lastError || new Error("Request failed after all retries");
-  }
-
-  private async resolveTradingRules(
-    marketName: string,
-  ): Promise<ExtendedTradingRules> {
-    const cached = this.marketTradingRulesCache.get(marketName);
-    if (cached) return cached;
-    const existing = this.marketTradingRulesInflight.get(marketName);
-    if (existing) return existing;
-    const inflight = (async () => {
-      const res = await this.getMarkets(marketName);
-      if (res.status !== "OK") {
-        throw new Error(
-          `ExtendedWrapper: getMarkets failed for ${marketName}: ${res.message}`,
-        );
-      }
-      const rows = res.data;
-      if (!Array.isArray(rows) || rows.length === 0) {
-        throw new Error(
-          `ExtendedWrapper: empty markets response for ${marketName}`,
-        );
-      }
-      const row = rows.find((m) => asRecord(m)?.name === marketName);
-      if (!row) {
-        throw new Error(
-          `ExtendedWrapper: market ${marketName} not found in markets list`,
-        );
-      }
-      const rules = tradingRulesFromMarketRow(marketName, row);
-      this.marketTradingRulesCache.set(marketName, rules);
-      return rules;
-    })();
-    this.marketTradingRulesInflight.set(marketName, inflight);
-    void inflight.finally(() => {
-      if (this.marketTradingRulesInflight.get(marketName) === inflight) {
-        this.marketTradingRulesInflight.delete(marketName);
-      }
-    });
-    return inflight;
-  }
-
-  /**
-   * Create a new order on Extended Exchange
-   */
-  async createOrder(
-    request: CreateOrderRequest,
-  ): Promise<ExtendedApiResponse<PlacedOrder>> {
-    const rules = await this.resolveTradingRules(request.market_name);
-    const amountBn = new BigNumber(String(request.amount).trim());
-    const priceBn = new BigNumber(String(request.price).trim());
-    if (!amountBn.isFinite() || amountBn.lte(0)) {
-      throw new Error(`ExtendedWrapper: invalid order amount=${request.amount}`);
-    }
-    if (!priceBn.isFinite() || priceBn.lte(0)) {
-      throw new Error(`ExtendedWrapper: invalid order price=${request.price}`);
-    }
-    if (amountBn.lt(rules.minOrderSize)) {
-      throw new Error(
-        `ExtendedWrapper: order amount ${request.amount} is below minOrderSize ${rules.minOrderSize.toFixed()} for ${request.market_name}`,
-      );
-    }
-    const adjAmount = roundToStepBn(amountBn, rules.qtyStep);
-    const adjPrice = roundToStepBn(priceBn, rules.priceStep);
-    if (adjAmount.lt(rules.minOrderSize)) {
-      throw new Error(
-        `ExtendedWrapper: amount after tick rounding ${formatBnForApi(adjAmount, rules.qtyStep)} is below minOrderSize ${rules.minOrderSize.toFixed()} (${request.market_name})`,
-      );
-    }
-    const payload: CreateOrderRequest = {
-      ...request,
-      amount: formatBnForApi(adjAmount, rules.qtyStep),
-      price: formatBnForApi(adjPrice, rules.priceStep),
-    };
-    return this.makeRequest<PlacedOrder>("/api/v1/orders", false, {
-      method: "POST",
-      body: JSON.stringify(payload),
-    });
-  }
-
-  /**
-   * Get all markets
-   */
-  async getMarkets(
-    marketNames?: string,
-  ): Promise<ExtendedApiResponse<Market[]>> {
-    const params = marketNames
-      ? `?market_names=${encodeURIComponent(marketNames)}`
-      : "";
-    return this.makeRequest<Market[]>(`/api/v1/markets${params}`, false);
-  }
-
-  /**
-   *
-   * @param orderId - The ID of the order to get
-   * @returns The order
-   */
-  async getOrderByOrderId(
-    orderId: string,
-  ): Promise<ExtendedApiResponse<OpenOrder>> {
-    const orderIdInt = parseInt(orderId);
-    return this.makeRequest<OpenOrder>(`/api/v1/orderId/${orderIdInt}`, false);
-  }
-
-  /**
-   * Get market statistics for a specific market
-   */
-  async getMarketStatistics(
-    marketName: string,
-  ): Promise<ExtendedApiResponse<MarketStats>> {
-    return this.makeRequest<MarketStats>(
-      `/api/v1/markets/statistics?market_name=${encodeURIComponent(marketName)}`,
-      false,
-    );
-  }
-
-  /**
-   * Get current trading positions
-   */
-  async getPositions(
-    marketNames?: string,
-  ): Promise<ExtendedApiResponse<Position[]>> {
-    const params = marketNames
-      ? `?market_names=${encodeURIComponent(marketNames)}`
-      : "";
-    const response = await this.makeRequest<Position[]>(`/api/v1/positions${params}`, true);
-    return response;
-  }
-
-  /**
-   * Get account balance and holdings
-   */
-  async getHoldings(): Promise<ExtendedApiResponse<Balance>> {
-    return this.makeRequest<Balance>("/api/v1/holdings", true);
-  }
-
-  /**
-   * Initiate a withdrawal from Extended Exchange
-   * Returns data as number | string to preserve precision for large integers
-   */
-  async withdraw(
-    request: WithdrawRequest,
-  ): Promise<ExtendedApiResponse<number | string>> {
-    return this.makeRequest<number | string>("/api/v1/withdraw", false, {
-      method: "POST",
-      body: JSON.stringify(request),
-    });
-  }
-
-  /**
-   * Create and sign a withdrawal request hash
-   */
-  async signWithdrawalRequest(request: SignedWithdrawRequest): Promise<
-    ExtendedApiResponse<{
-      withdraw_request_hash: string;
-      signature: {
-        r: string;
-        s: string;
-      };
-    }>
-  > {
-    return this.makeRequest("/api/v1/withdraw/sign", false, {
-      method: "POST",
-      body: JSON.stringify(request),
-    });
-  }
-
-  /**
-   * Cancel an existing order
-   */
-  async cancelOrder(
-    request: CancelOrderRequest,
-  ): Promise<ExtendedApiResponse<{}>> {
-    return this.makeRequest<{}>("/api/v1/orders/cancel", false, {
-      method: "POST",
-      body: JSON.stringify(request),
-    });
-  }
-
-  /**
-   * Get all open orders
-   */
-  async getOpenOrders(
-    marketName?: string,
-  ): Promise<ExtendedApiResponse<OpenOrder[]>> {
-    const endpoint = marketName
-      ? `/api/v1/marketOrders/${marketName}`
-      : "/api/v1/marketOrders";
-    return this.makeRequest<OpenOrder[]>(endpoint, false, {
-      method: "GET",
-      headers: {
-        "Content-Type": "application/json",
-      },
-    });
-  }
-
-  /**
-   * Update leverage on the market
-   * @param request
-   * @returns
-   */
-  async updateLeverage(
-    request: UpdateLeverageRequest,
-  ): Promise<ExtendedApiResponse<{}>> {
-    return this.makeRequest<{}>("/api/v1/leverage", false, {
-      method: "POST",
-      body: JSON.stringify(request),
-    });
-  }
-
-  /**
-   * Get asset operations with optional filtering
-   */
-  async getAssetOperations(
-    options: {
-      id?: number;
-      operationsType?: AssetOperationType[];
-      operationsStatus?: AssetOperationStatus[];
-      startTime?: number;
-      endTime?: number;
-      cursor?: number;
-      limit?: number;
-    } = {},
-  ): Promise<ExtendedApiResponse<AssetOperation[]>> {
-    const params = new URLSearchParams();
-
-    if (options.id !== undefined) params.append("id", options.id.toString());
-    if (options.operationsType) {
-      params.append("operations_type", options.operationsType.join(","));
-    }
-    if (options.operationsStatus) {
-      params.append("operations_status", options.operationsStatus.join(","));
-    }
-    if (options.startTime !== undefined)
-      params.append("start_time", options.startTime.toString());
-    if (options.endTime !== undefined)
-      params.append("end_time", options.endTime.toString());
-    if (options.cursor !== undefined)
-      params.append("cursor", options.cursor.toString());
-    if (options.limit !== undefined)
-      params.append("limit", options.limit.toString());
-
-    const queryString = params.toString();
-    const endpoint = `/api/v1/asset-operations${
-      queryString ? `?${queryString}` : ""
-    }`;
-
-    return this.makeRequest<AssetOperation[]>(endpoint, false);
-  }
-
-  /**
-   * Health check endpoint
-   */
-  async healthCheck(): Promise<ExtendedApiResponse<MarketStats>> {
-    return this.makeRequest<MarketStats>("/api/v1/health", false);
-  }
-
-  /**
-   * Convenience method to create a buy order
-   */
-  async createBuyOrder(
-    marketName: string,
-    amount: string,
-    price: string,
-    options: {
-      post_only?: boolean;
-      reduce_only?: boolean;
-      previous_order_id?: number;
-      external_id?: string;
-      time_in_force?: TimeInForce;
-    } = {},
-  ): Promise<ExtendedApiResponse<PlacedOrder>> {
-    return this.createOrder({
-      market_name: marketName,
-      amount,
-      price,
-      side: OrderSide.BUY,
-      ...options,
-    });
-  }
-
-  /**
-   * Get order by ID
-   * @param orderId - The ID of the order to get
-   * @returns The order
-   */
-  async getOrderById(orderId: number): Promise<ExtendedApiResponse<OpenOrder>> {
-    return this.makeRequest<OpenOrder>(`/api/v1/orderId/${orderId}`, false);
-  }
-
-  /**
-   * Convenience method to create a sell order
-   */
-  async createSellOrder(
-    marketName: string,
-    amount: string,
-    price: string,
-    options: {
-      post_only?: boolean;
-      reduce_only?: boolean;
-      previous_order_id?: number;
-      external_id?: string;
-      time_in_force?: TimeInForce;
-    } = {},
-  ): Promise<ExtendedApiResponse<PlacedOrder>> {
-    return this.createOrder({
-      market_name: marketName,
-      amount,
-      price,
-      side: OrderSide.SELL,
-      ...options,
-    });
-  }
-
-  /**
-   * Get positions for a specific market
-   */
-  async getPositionsForMarket(
-    marketName: string,
-  ): Promise<ExtendedApiResponse<Position[]>> {
-    return this.getPositions(marketName);
-  }
-
-  /**
-   * Get open orders for a specific market
-   */
-  async getOpenOrdersForMarket(
-    marketName: string,
-  ): Promise<ExtendedApiResponse<OpenOrder[]>> {
-    return this.getOpenOrders(marketName);
-  }
-
-  /**
-   * Cancel order by ID (convenience method)
-   */
-  async cancelOrderById(orderId: number): Promise<ExtendedApiResponse<{}>> {
-    return this.cancelOrder({ order_id: orderId });
-  }
-
-  /**
-   * Get order history for a specific market
-   * @param marketName - The name of the market to get order history for
-   * @returns The order history for the specified market
-   */
-  async getOrderHistory(
-    marketName: string,
-  ): Promise<ExtendedApiResponse<OpenOrder[]>> {
-    return this.makeRequest<OpenOrder[]>(`/api/v1/marketOrders/${marketName}`, false);
-  }
-
-  /**
-   * Withdraw USDC (convenience method)
-   * Returns data as number | string to preserve precision for large integers
-   */
-  async withdrawUSDC(
-    amount: string,
-  ): Promise<ExtendedApiResponse<number | string>> {
-    return this.withdraw({ amount, asset: "USDC" });
-  }
-
-  /**
-   * Get funding rates for a specific market
-   * @param marketName - The name of the market to get funding rates for
-   * @returns The funding rates for the specified market
-   */
-  async getFundingRates(
-    marketName: string,
-    side: string,
-    startTime?: number,
-    endTime?: number,
-    // in epoch  milliseconds
-  ): Promise<ExtendedApiResponse<FundingRate[]>> {
-    const endTimeParam = endTime !== undefined ? `&end_time=${endTime}` : "";
-    const startTimeParam =
-      startTime !== undefined ? `&start_time=${startTime}` : "";
-    const response = await this.makeRequest<FundingRate[]>(
-      `/api/v1/markets/funding-rates?market_name=${encodeURIComponent(
-        marketName,
-      )}&side=${encodeURIComponent(side)}${startTimeParam}${endTimeParam}`,
-      true
-    );
-    return response;
-  }
-
-  /**
-   * Get funding payments for a specific market.
-   */
-  async getUserFundingPayments(
-    marketName: string,
-    side: string,
-    startTime: number,
-    limit?: number,
-    cursor?: number,
-  ): Promise<ExtendedApiResponse<FundingPayment[]>> {
-    const params = new URLSearchParams();
-    params.append("start_time", String(startTime));
-    params.append("market_names", marketName);
-    params.append("side", side);
-    if (limit !== undefined) params.append("limit", String(limit));
-    if (cursor !== undefined) params.append("cursor", String(cursor));
-
-    return this.makeRequest<FundingPayment[]>(
-      `/api/v1/account/funding-payments?${params.toString()}`,
-      true,
-    );
-  }
-}
-
-export default ExtendedWrapper;