@0xarchive/sdk 0.3.0 → 0.3.2

package/dist/index.mjs

@@ -15,15 +15,25 @@ var HttpClient = class {
   baseUrl;
   apiKey;
   timeout;
+  validate;
   constructor(options) {
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.apiKey = options.apiKey;
     this.timeout = options.timeout;
+    this.validate = options.validate ?? false;
+  }
+  /** Whether validation is enabled */
+  get validationEnabled() {
+    return this.validate;
   }
   /**
    * Make a GET request to the API
+   *
+   * @param path - API endpoint path
+   * @param params - Query parameters
+   * @param schema - Optional Zod schema for validation (used when validation is enabled)
    */
-  async get(path, params) {
+  async get(path, params, schema) {
     const url = new URL(`${this.baseUrl}${path}`);
     if (params) {
       for (const [key, value] of Object.entries(params)) {
@@ -53,6 +63,17 @@ var HttpClient = class {
           data.meta?.request_id
         );
       }
+      if (this.validate && schema) {
+        const result = schema.safeParse(data);
+        if (!result.success) {
+          throw new OxArchiveError(
+            `Response validation failed: ${result.error.message}`,
+            422,
+            data.meta?.request_id
+          );
+        }
+        return result.data;
+      }
       return data;
     } catch (error) {
       clearTimeout(timeoutId);
@@ -70,6 +91,203 @@ var HttpClient = class {
   }
 };
 
+// src/schemas.ts
+import { z } from "zod";
+var ApiMetaSchema = z.object({
+  count: z.number(),
+  next_cursor: z.string().optional(),
+  request_id: z.string()
+});
+var ApiResponseSchema = (dataSchema) => z.object({
+  success: z.boolean(),
+  data: dataSchema,
+  meta: ApiMetaSchema
+});
+var PriceLevelSchema = z.object({
+  px: z.string(),
+  sz: z.string(),
+  n: z.number()
+});
+var OrderBookSchema = z.object({
+  coin: z.string(),
+  timestamp: z.string(),
+  bids: z.array(PriceLevelSchema),
+  asks: z.array(PriceLevelSchema),
+  mid_price: z.string().optional(),
+  spread: z.string().optional(),
+  spread_bps: z.string().optional()
+});
+var TradeSideSchema = z.enum(["A", "B"]);
+var TradeDirectionSchema = z.enum([
+  "Open Long",
+  "Open Short",
+  "Close Long",
+  "Close Short"
+]);
+var DataSourceSchema = z.enum(["s3", "ws", "api", "live"]);
+var TradeSchema = z.object({
+  coin: z.string(),
+  side: TradeSideSchema,
+  price: z.string(),
+  size: z.string(),
+  timestamp: z.string(),
+  tx_hash: z.string().optional(),
+  trade_id: z.number().optional(),
+  order_id: z.number().optional(),
+  crossed: z.boolean().optional(),
+  fee: z.string().optional(),
+  fee_token: z.string().optional(),
+  closed_pnl: z.string().optional(),
+  direction: TradeDirectionSchema.optional(),
+  start_position: z.string().optional(),
+  source: DataSourceSchema.optional(),
+  user_address: z.string().optional(),
+  maker_address: z.string().optional(),
+  taker_address: z.string().optional()
+});
+var InstrumentTypeSchema = z.enum(["perp", "spot"]);
+var InstrumentSchema = z.object({
+  name: z.string(),
+  szDecimals: z.number(),
+  maxLeverage: z.number().optional(),
+  onlyIsolated: z.boolean().optional(),
+  instrumentType: InstrumentTypeSchema.optional(),
+  isActive: z.boolean()
+});
+var FundingRateSchema = z.object({
+  coin: z.string(),
+  timestamp: z.string(),
+  funding_rate: z.string(),
+  premium: z.string().optional()
+});
+var OpenInterestSchema = z.object({
+  coin: z.string(),
+  timestamp: z.string(),
+  open_interest: z.string(),
+  mark_price: z.string().optional(),
+  oracle_price: z.string().optional(),
+  day_ntl_volume: z.string().optional(),
+  prev_day_price: z.string().optional(),
+  mid_price: z.string().optional(),
+  impact_bid_price: z.string().optional(),
+  impact_ask_price: z.string().optional()
+});
+var WsChannelSchema = z.enum(["orderbook", "trades", "ticker", "all_tickers"]);
+var WsConnectionStateSchema = z.enum(["connecting", "connected", "disconnected", "reconnecting"]);
+var WsSubscribedSchema = z.object({
+  type: z.literal("subscribed"),
+  channel: WsChannelSchema,
+  coin: z.string().optional()
+});
+var WsUnsubscribedSchema = z.object({
+  type: z.literal("unsubscribed"),
+  channel: WsChannelSchema,
+  coin: z.string().optional()
+});
+var WsPongSchema = z.object({
+  type: z.literal("pong")
+});
+var WsErrorSchema = z.object({
+  type: z.literal("error"),
+  message: z.string()
+});
+var WsDataSchema = z.object({
+  type: z.literal("data"),
+  channel: WsChannelSchema,
+  coin: z.string(),
+  data: z.unknown()
+});
+var WsReplayStartedSchema = z.object({
+  type: z.literal("replay_started"),
+  channel: WsChannelSchema,
+  coin: z.string(),
+  start: z.number(),
+  end: z.number(),
+  speed: z.number()
+});
+var WsReplayPausedSchema = z.object({
+  type: z.literal("replay_paused"),
+  current_timestamp: z.number()
+});
+var WsReplayResumedSchema = z.object({
+  type: z.literal("replay_resumed"),
+  current_timestamp: z.number()
+});
+var WsReplayCompletedSchema = z.object({
+  type: z.literal("replay_completed"),
+  channel: WsChannelSchema,
+  coin: z.string(),
+  snapshots_sent: z.number()
+});
+var WsReplayStoppedSchema = z.object({
+  type: z.literal("replay_stopped")
+});
+var WsHistoricalDataSchema = z.object({
+  type: z.literal("historical_data"),
+  channel: WsChannelSchema,
+  coin: z.string(),
+  timestamp: z.number(),
+  data: z.unknown()
+});
+var WsStreamStartedSchema = z.object({
+  type: z.literal("stream_started"),
+  channel: WsChannelSchema,
+  coin: z.string(),
+  start: z.number(),
+  end: z.number()
+});
+var WsStreamProgressSchema = z.object({
+  type: z.literal("stream_progress"),
+  snapshots_sent: z.number()
+});
+var TimestampedRecordSchema = z.object({
+  timestamp: z.number(),
+  data: z.unknown()
+});
+var WsHistoricalBatchSchema = z.object({
+  type: z.literal("historical_batch"),
+  channel: WsChannelSchema,
+  coin: z.string(),
+  data: z.array(TimestampedRecordSchema)
+});
+var WsStreamCompletedSchema = z.object({
+  type: z.literal("stream_completed"),
+  channel: WsChannelSchema,
+  coin: z.string(),
+  snapshots_sent: z.number()
+});
+var WsStreamStoppedSchema = z.object({
+  type: z.literal("stream_stopped"),
+  snapshots_sent: z.number()
+});
+var WsServerMessageSchema = z.discriminatedUnion("type", [
+  WsSubscribedSchema,
+  WsUnsubscribedSchema,
+  WsPongSchema,
+  WsErrorSchema,
+  WsDataSchema,
+  WsReplayStartedSchema,
+  WsReplayPausedSchema,
+  WsReplayResumedSchema,
+  WsReplayCompletedSchema,
+  WsReplayStoppedSchema,
+  WsHistoricalDataSchema,
+  WsStreamStartedSchema,
+  WsStreamProgressSchema,
+  WsHistoricalBatchSchema,
+  WsStreamCompletedSchema,
+  WsStreamStoppedSchema
+]);
+var OrderBookResponseSchema = ApiResponseSchema(OrderBookSchema);
+var OrderBookArrayResponseSchema = ApiResponseSchema(z.array(OrderBookSchema));
+var TradeArrayResponseSchema = ApiResponseSchema(z.array(TradeSchema));
+var InstrumentResponseSchema = ApiResponseSchema(InstrumentSchema);
+var InstrumentArrayResponseSchema = ApiResponseSchema(z.array(InstrumentSchema));
+var FundingRateResponseSchema = ApiResponseSchema(FundingRateSchema);
+var FundingRateArrayResponseSchema = ApiResponseSchema(z.array(FundingRateSchema));
+var OpenInterestResponseSchema = ApiResponseSchema(OpenInterestSchema);
+var OpenInterestArrayResponseSchema = ApiResponseSchema(z.array(OpenInterestSchema));
+
 // src/resources/orderbook.ts
 var OrderBookResource = class {
   constructor(http) {
@@ -85,7 +303,8 @@ var OrderBookResource = class {
   async get(coin, params) {
     const response = await this.http.get(
       `/v1/orderbook/${coin.toUpperCase()}`,
-      params
+      params,
+      this.http.validationEnabled ? OrderBookResponseSchema : void 0
     );
     return response.data;
   }
@@ -99,7 +318,8 @@ var OrderBookResource = class {
   async history(coin, params) {
     const response = await this.http.get(
       `/v1/orderbook/${coin.toUpperCase()}/history`,
-      params
+      params,
+      this.http.validationEnabled ? OrderBookArrayResponseSchema : void 0
     );
     return response.data;
   }
@@ -143,7 +363,8 @@ var TradesResource = class {
   async list(coin, params) {
     const response = await this.http.get(
       `/v1/trades/${coin.toUpperCase()}`,
-      params
+      params,
+      this.http.validationEnabled ? TradeArrayResponseSchema : void 0
     );
     return {
       data: response.data,
@@ -160,7 +381,8 @@ var TradesResource = class {
   async recent(coin, limit) {
     const response = await this.http.get(
       `/v1/trades/${coin.toUpperCase()}/recent`,
-      { limit }
+      { limit },
+      this.http.validationEnabled ? TradeArrayResponseSchema : void 0
     );
     return response.data;
   }
@@ -188,7 +410,8 @@ var TradesResource = class {
   async listWithOffset(coin, params) {
     const response = await this.http.get(
       `/v1/trades/${coin.toUpperCase()}`,
-      params
+      params,
+      this.http.validationEnabled ? TradeArrayResponseSchema : void 0
     );
     return response.data;
   }
@@ -206,7 +429,9 @@ var InstrumentsResource = class {
    */
   async list() {
     const response = await this.http.get(
-      "/v1/instruments"
+      "/v1/instruments",
+      void 0,
+      this.http.validationEnabled ? InstrumentArrayResponseSchema : void 0
     );
     return response.data;
   }
@@ -218,7 +443,9 @@ var InstrumentsResource = class {
    */
   async get(coin) {
     const response = await this.http.get(
-      `/v1/instruments/${coin.toUpperCase()}`
+      `/v1/instruments/${coin.toUpperCase()}`,
+      void 0,
+      this.http.validationEnabled ? InstrumentResponseSchema : void 0
     );
     return response.data;
   }
@@ -239,7 +466,8 @@ var FundingResource = class {
   async history(coin, params) {
     const response = await this.http.get(
       `/v1/funding/${coin.toUpperCase()}`,
-      params
+      params,
+      this.http.validationEnabled ? FundingRateArrayResponseSchema : void 0
     );
     return response.data;
   }
@@ -251,7 +479,9 @@ var FundingResource = class {
    */
   async current(coin) {
     const response = await this.http.get(
-      `/v1/funding/${coin.toUpperCase()}/current`
+      `/v1/funding/${coin.toUpperCase()}/current`,
+      void 0,
+      this.http.validationEnabled ? FundingRateResponseSchema : void 0
     );
     return response.data;
   }
@@ -272,7 +502,8 @@ var OpenInterestResource = class {
   async history(coin, params) {
     const response = await this.http.get(
       `/v1/openinterest/${coin.toUpperCase()}`,
-      params
+      params,
+      this.http.validationEnabled ? OpenInterestArrayResponseSchema : void 0
     );
     return response.data;
   }
@@ -284,7 +515,9 @@ var OpenInterestResource = class {
    */
   async current(coin) {
     const response = await this.http.get(
-      `/v1/openinterest/${coin.toUpperCase()}/current`
+      `/v1/openinterest/${coin.toUpperCase()}/current`,
+      void 0,
+      this.http.validationEnabled ? OpenInterestResponseSchema : void 0
     );
     return response.data;
   }
@@ -327,7 +560,8 @@ var OxArchive = class {
     this.http = new HttpClient({
       baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
       apiKey: options.apiKey,
-      timeout: options.timeout ?? DEFAULT_TIMEOUT
+      timeout: options.timeout ?? DEFAULT_TIMEOUT,
+      validate: options.validate ?? false
     });
     this.orderbook = new OrderBookResource(this.http);
     this.trades = new TradesResource(this.http);
@@ -342,6 +576,39 @@ var DEFAULT_WS_URL = "wss://api.0xarchive.io/ws";
 var DEFAULT_PING_INTERVAL = 3e4;
 var DEFAULT_RECONNECT_DELAY = 1e3;
 var DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;
+function transformTrade(coin, raw) {
+  if ("price" in raw && "size" in raw) {
+    return raw;
+  }
+  const px = raw.px;
+  const sz = raw.sz;
+  const side = raw.side;
+  const time = raw.time;
+  const hash = raw.hash;
+  const tid = raw.tid;
+  const users = raw.users;
+  const maker_address = users && users.length > 0 ? users[0] : void 0;
+  const taker_address = users && users.length > 1 ? users[1] : void 0;
+  const user_address = raw.userAddress ?? raw.user_address;
+  return {
+    coin,
+    side: side === "A" || side === "B" ? side : "B",
+    price: px ?? "0",
+    size: sz ?? "0",
+    timestamp: time ? new Date(time).toISOString() : (/* @__PURE__ */ new Date()).toISOString(),
+    tx_hash: hash,
+    trade_id: tid,
+    maker_address,
+    taker_address,
+    user_address
+  };
+}
+function transformTrades(coin, rawTrades) {
+  if (!Array.isArray(rawTrades)) {
+    return [transformTrade(coin, rawTrades)];
+  }
+  return rawTrades.map((raw) => transformTrade(coin, raw));
+}
 function transformOrderbook(coin, raw) {
   if ("bids" in raw && "asks" in raw) {
     return raw;
@@ -797,8 +1064,9 @@ var OxArchiveWs = class {
             handler(message.coin, orderbook);
           }
         } else if (message.channel === "trades") {
+          const trades = transformTrades(message.coin, message.data);
           for (const handler of this.tradesHandlers) {
-            handler(message.coin, message.data);
+            handler(message.coin, trades);
           }
         }
         break;
@@ -807,9 +1075,50 @@ var OxArchiveWs = class {
   }
 };
 export {
+  ApiMetaSchema,
+  ApiResponseSchema,
+  DataSourceSchema,
+  FundingRateArrayResponseSchema,
+  FundingRateResponseSchema,
+  FundingRateSchema,
+  InstrumentArrayResponseSchema,
+  InstrumentResponseSchema,
+  InstrumentSchema,
+  InstrumentTypeSchema,
+  OpenInterestArrayResponseSchema,
+  OpenInterestResponseSchema,
+  OpenInterestSchema,
+  OrderBookArrayResponseSchema,
+  OrderBookResponseSchema,
+  OrderBookSchema,
   OxArchive,
   OxArchiveError,
   OxArchiveWs,
+  PriceLevelSchema,
+  TimestampedRecordSchema,
+  TradeArrayResponseSchema,
+  TradeDirectionSchema,
+  TradeSchema,
+  TradeSideSchema,
+  WsChannelSchema,
+  WsConnectionStateSchema,
+  WsDataSchema,
+  WsErrorSchema,
+  WsHistoricalBatchSchema,
+  WsHistoricalDataSchema,
+  WsPongSchema,
+  WsReplayCompletedSchema,
+  WsReplayPausedSchema,
+  WsReplayResumedSchema,
+  WsReplayStartedSchema,
+  WsReplayStoppedSchema,
+  WsServerMessageSchema,
+  WsStreamCompletedSchema,
+  WsStreamProgressSchema,
+  WsStreamStartedSchema,
+  WsStreamStoppedSchema,
+  WsSubscribedSchema,
+  WsUnsubscribedSchema,
   OxArchive as default
 };
 //# sourceMappingURL=index.mjs.map