@0xarchive/sdk 1.2.0 → 1.4.0

package/dist/index.d.ts

@@ -132,6 +132,18 @@ interface Trade {
     makerAddress?: string;
     /** Taker's wallet address (for market-level WebSocket trades) */
     takerAddress?: string;
+    /** Builder address that routed this order. Present only when the order was placed through a builder. */
+    builderAddress?: string;
+    /** Builder fee charged on this fill, paid to the builder (in quote currency, typically USDC). Present only when builderAddress is set. */
+    builderFee?: string;
+    /** HIP-3 deployer fee share on this fill (in quote currency). Negative for the maker side (rebate), positive for the taker side. Present only on HIP-3 fills. */
+    deployerFee?: string;
+    /** Priority fee burned in HYPE (not USDC) for write priority on the Hyperliquid validator queue. Independent of builderFee and deployerFee — paid to the network, not to a builder or deployer. Present only when the order paid for priority. */
+    priorityGas?: number;
+    /** Client order ID */
+    cloid?: string;
+    /** TWAP execution ID */
+    twapId?: number;
 }
 /**
  * Cursor-based pagination parameters (recommended)
@@ -2288,6 +2300,49 @@ declare class L4OrderBookResource {
     history(symbol: string, params: CursorPaginationParams): Promise<CursorResponse<any[]>>;
 }
 
+interface L2OrderBookParams {
+    timestamp?: number | string;
+    depth?: number;
+}
+/**
+ * L2 Full-Depth Order Book API resource (derived from L4 data)
+ *
+ * Access aggregated price-level orderbook snapshots, history, and tick-level diffs.
+ * Data available from March 10, 2026.
+ *
+ * @example
+ * ```typescript
+ * // Get current full-depth L2 orderbook
+ * const orderbook = await client.hyperliquid.l2Orderbook.get('BTC');
+ *
+ * // Get L2 orderbook at a historical timestamp
+ * const historical = await client.hyperliquid.l2Orderbook.get('BTC', {
+ *   timestamp: 1711900800000
+ * });
+ *
+ * // Get L2 orderbook history
+ * const history = await client.hyperliquid.l2Orderbook.history('BTC', {
+ *   start: Date.now() - 86400000,
+ *   end: Date.now(),
+ *   limit: 100
+ * });
+ * ```
+ */
+declare class L2OrderBookResource {
+    private http;
+    private basePath;
+    private coinTransform;
+    constructor(http: HttpClient, basePath?: string, coinTransform?: (s: string) => string);
+    /** Get full-depth L2 order book snapshot. */
+    get(symbol: string, params?: L2OrderBookParams): Promise<any>;
+    /** Get paginated L2 full-depth history. */
+    history(symbol: string, params: CursorPaginationParams & {
+        depth?: number;
+    }): Promise<CursorResponse<any[]>>;
+    /** Get tick-level L2 order book diffs. */
+    diffs(symbol: string, params: CursorPaginationParams): Promise<CursorResponse<any[]>>;
+}
+
 interface L3OrderBookParams {
     timestamp?: number | string;
     depth?: number;
@@ -2382,6 +2437,10 @@ declare class HyperliquidClient {
      * L4 order book (snapshots, diffs, history)
      */
     readonly l4Orderbook: L4OrderBookResource;
+    /**
+     * L2 full-depth order book (derived from L4)
+     */
+    readonly l2Orderbook: L2OrderBookResource;
     /**
      * HIP-3 builder-deployed perpetuals (February 2026+)
      */
@@ -2461,6 +2520,10 @@ declare class Hip3Client {
      * L4 order book (snapshots, diffs, history)
      */
     readonly l4Orderbook: L4OrderBookResource;
+    /**
+     * L2 full-depth order book (derived from L4)
+     */
+    readonly l2Orderbook: L2OrderBookResource;
     private http;
     constructor(http: HttpClient);
     /**
@@ -3003,6 +3066,109 @@ declare class OxArchiveWs {
     private handleMessage;
 }
 
+/**
+ * L4 order book reconstructor with matching engine.
+ *
+ * Reconstructs Hyperliquid and HIP-3 L4 order books from checkpoints and diffs.
+ * The same class works for both exchanges — the diff format is identical.
+ *
+ * When a new order crosses the spread, the matching engine filled opposite-side
+ * orders at crossing prices. Without removing them, the reconstructed book will
+ * be "crossed" (best bid > best ask).
+ *
+ * Ref: https://github.com/hyperliquid-dex/order_book_server
+ */
+interface L4Order {
+    oid: number;
+    userAddress: string;
+    side: 'B' | 'A';
+    price: number;
+    size: number;
+}
+interface L2Level {
+    px: number;
+    sz: number;
+    n: number;
+}
+interface L4Diff {
+    diff_type?: 'new' | 'update' | 'remove';
+    diffType?: 'new' | 'update' | 'remove';
+    oid: number;
+    side: 'B' | 'A';
+    price: number;
+    new_size?: number | null;
+    newSize?: number | null;
+    user_address?: string;
+    userAddress?: string;
+    block_number?: number;
+    blockNumber?: number;
+}
+interface L4Checkpoint {
+    bids: Array<{
+        oid: number;
+        user_address?: string;
+        userAddress?: string;
+        side: string;
+        price: number;
+        size: number;
+    }>;
+    asks: Array<{
+        oid: number;
+        user_address?: string;
+        userAddress?: string;
+        side: string;
+        price: number;
+        size: number;
+    }>;
+}
+/**
+ * L4 orderbook reconstructor with matching engine.
+ *
+ * Works identically for Hyperliquid and HIP-3 — same diff format,
+ * same checkpoint format, same crossing logic.
+ *
+ * @example
+ * ```typescript
+ * const book = new L4OrderBookReconstructor();
+ * book.loadCheckpoint(checkpoint);
+ *
+ * // Group diffs by block, apply in order
+ * for (const bn of sortedBlockNumbers) {
+ *   const nr = nonRestingByBlock.get(bn);
+ *   for (const diff of blocks.get(bn)!) {
+ *     book.applyDiff(diff, nr);
+ *   }
+ * }
+ *
+ * console.log(book.isCrossed()); // false
+ * const { bids: l2Bids, asks: l2Asks } = book.deriveL2();
+ * ```
+ */
+declare class L4OrderBookReconstructor {
+    private orders;
+    private bidPrices;
+    private askPrices;
+    /** Initialize from an L4 checkpoint. */
+    loadCheckpoint(checkpoint: L4Checkpoint): void;
+    /** Apply a single L4 diff with matching engine. */
+    applyDiff(diff: L4Diff, nonRestingOids?: Set<number>): void;
+    /** Return bids sorted by price descending. */
+    bids(): L4Order[];
+    /** Return asks sorted by price ascending. */
+    asks(): L4Order[];
+    bestBid(): number | null;
+    bestAsk(): number | null;
+    /** Check if the book is crossed. Should be false after correct reconstruction. */
+    isCrossed(): boolean;
+    get bidCount(): number;
+    get askCount(): number;
+    /** Aggregate L4 orders into L2 price levels. */
+    deriveL2(): {
+        bids: L2Level[];
+        asks: L2Level[];
+    };
+}
+
 /**
  * Zod schemas for runtime validation of API responses
  *
@@ -3180,6 +3346,12 @@ declare const TradeSchema: z.ZodObject<{
     userAddress: z.ZodOptional<z.ZodString>;
     makerAddress: z.ZodOptional<z.ZodString>;
     takerAddress: z.ZodOptional<z.ZodString>;
+    builderAddress: z.ZodOptional<z.ZodString>;
+    builderFee: z.ZodOptional<z.ZodString>;
+    deployerFee: z.ZodOptional<z.ZodString>;
+    priorityGas: z.ZodOptional<z.ZodNumber>;
+    cloid: z.ZodOptional<z.ZodString>;
+    twapId: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     coin: string;
     timestamp: string;
@@ -3198,6 +3370,12 @@ declare const TradeSchema: z.ZodObject<{
     userAddress?: string | undefined;
     makerAddress?: string | undefined;
     takerAddress?: string | undefined;
+    builderAddress?: string | undefined;
+    builderFee?: string | undefined;
+    deployerFee?: string | undefined;
+    priorityGas?: number | undefined;
+    cloid?: string | undefined;
+    twapId?: number | undefined;
 }, {
     coin: string;
     timestamp: string;
@@ -3216,6 +3394,12 @@ declare const TradeSchema: z.ZodObject<{
     userAddress?: string | undefined;
     makerAddress?: string | undefined;
     takerAddress?: string | undefined;
+    builderAddress?: string | undefined;
+    builderFee?: string | undefined;
+    deployerFee?: string | undefined;
+    priorityGas?: number | undefined;
+    cloid?: string | undefined;
+    twapId?: number | undefined;
 }>;
 declare const InstrumentTypeSchema: z.ZodEnum<["perp", "spot"]>;
 declare const InstrumentSchema: z.ZodObject<{
@@ -4130,6 +4314,12 @@ declare const TradeArrayResponseSchema: z.ZodObject<{
         userAddress: z.ZodOptional<z.ZodString>;
         makerAddress: z.ZodOptional<z.ZodString>;
         takerAddress: z.ZodOptional<z.ZodString>;
+        builderAddress: z.ZodOptional<z.ZodString>;
+        builderFee: z.ZodOptional<z.ZodString>;
+        deployerFee: z.ZodOptional<z.ZodString>;
+        priorityGas: z.ZodOptional<z.ZodNumber>;
+        cloid: z.ZodOptional<z.ZodString>;
+        twapId: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         coin: string;
         timestamp: string;
@@ -4148,6 +4338,12 @@ declare const TradeArrayResponseSchema: z.ZodObject<{
         userAddress?: string | undefined;
         makerAddress?: string | undefined;
         takerAddress?: string | undefined;
+        builderAddress?: string | undefined;
+        builderFee?: string | undefined;
+        deployerFee?: string | undefined;
+        priorityGas?: number | undefined;
+        cloid?: string | undefined;
+        twapId?: number | undefined;
     }, {
         coin: string;
         timestamp: string;
@@ -4166,6 +4362,12 @@ declare const TradeArrayResponseSchema: z.ZodObject<{
         userAddress?: string | undefined;
         makerAddress?: string | undefined;
         takerAddress?: string | undefined;
+        builderAddress?: string | undefined;
+        builderFee?: string | undefined;
+        deployerFee?: string | undefined;
+        priorityGas?: number | undefined;
+        cloid?: string | undefined;
+        twapId?: number | undefined;
     }>, "many">;
     meta: z.ZodObject<{
         count: z.ZodNumber;
@@ -4199,6 +4401,12 @@ declare const TradeArrayResponseSchema: z.ZodObject<{
         userAddress?: string | undefined;
         makerAddress?: string | undefined;
         takerAddress?: string | undefined;
+        builderAddress?: string | undefined;
+        builderFee?: string | undefined;
+        deployerFee?: string | undefined;
+        priorityGas?: number | undefined;
+        cloid?: string | undefined;
+        twapId?: number | undefined;
     }[];
     success: boolean;
     meta: {
@@ -4225,6 +4433,12 @@ declare const TradeArrayResponseSchema: z.ZodObject<{
         userAddress?: string | undefined;
         makerAddress?: string | undefined;
         takerAddress?: string | undefined;
+        builderAddress?: string | undefined;
+        builderFee?: string | undefined;
+        deployerFee?: string | undefined;
+        priorityGas?: number | undefined;
+        cloid?: string | undefined;
+        twapId?: number | undefined;
     }[];
     success: boolean;
     meta: {
@@ -5462,4 +5676,4 @@ type ValidatedCandle = z.infer<typeof CandleSchema>;
 type ValidatedLiquidation = z.infer<typeof LiquidationSchema>;
 type ValidatedWsServerMessage = z.infer<typeof WsServerMessageSchema>;
 
-export { type ApiError, type ApiMeta, ApiMetaSchema, type ApiResponse, ApiResponseSchema, type Candle, CandleArrayResponseSchema, type CandleHistoryParams, type CandleInterval, CandleIntervalSchema, CandleSchema, type ClientOptions, type CoinFreshness, CoinFreshnessResponseSchema, CoinFreshnessSchema, type CoinSummary, CoinSummaryResponseSchema, CoinSummarySchema, type CompletenessMetrics, type CoverageGap, type CoverageResponse, type CursorResponse, type DataCadence, type DataFreshness, type DataTypeCoverage, type DataTypeFreshnessInfo, DataTypeFreshnessInfoSchema, type DataTypeStatus, type ExchangeCoverage, type ExchangeLatency, type ExchangeStatus, type FundingHistoryParams, type FundingRate, FundingRateArrayResponseSchema, FundingRateResponseSchema, FundingRateSchema, type GetOrderBookParams, type GetTradesCursorParams, Hip3Client, type Hip3Instrument, HyperliquidClient, type Incident, type IncidentSeverityValue, type IncidentStatusValue, type IncidentsResponse, type Instrument, InstrumentArrayResponseSchema, InstrumentResponseSchema, InstrumentSchema, type InstrumentType, InstrumentTypeSchema, type LatencyResponse, LighterClient, type LighterGranularity, type LighterInstrument, type Liquidation, LiquidationArrayResponseSchema, type LiquidationHistoryParams, LiquidationSchema, LiquidationSideSchema, type LiquidationVolume, LiquidationVolumeArrayResponseSchema, type LiquidationVolumeParams, LiquidationVolumeSchema, type LiquidationsByUserParams, type ListIncidentsParams, type OiFundingInterval, type OpenInterest, OpenInterestArrayResponseSchema, type OpenInterestHistoryParams, OpenInterestResponseSchema, OpenInterestSchema, type OrderBook, OrderBookArrayResponseSchema, type OrderBookHistoryParams, OrderBookReconstructor, OrderBookResponseSchema, OrderBookSchema, type OrderbookDelta, OxArchive, OxArchiveError, OxArchiveWs, type Pagination, type PriceHistoryParams, type PriceLevel, PriceLevelSchema, type PriceSnapshot, PriceSnapshotArrayResponseSchema, PriceSnapshotSchema, type ReconstructOptions, type ReconstructedOrderBook, type RestApiLatency, type SiweChallenge, type SlaActual, type SlaParams, type SlaResponse, type SlaTargets, type StatusResponse, type SymbolCoverageOptions, type SymbolCoverageResponse, type SymbolDataTypeCoverage, type SystemStatusValue, type TickData, type TickHistoryParams, type Timestamp, type TimestampedRecord, TimestampedRecordSchema, type Trade, TradeArrayResponseSchema, type TradeDirection, TradeDirectionSchema, TradeSchema, type TradeSide, TradeSideSchema, type ValidatedApiMeta, type ValidatedCandle, type ValidatedFundingRate, type ValidatedInstrument, type ValidatedLiquidation, type ValidatedOpenInterest, type ValidatedOrderBook, type ValidatedPriceLevel, type ValidatedTrade, type ValidatedWsServerMessage, type Web3ApiKey, type Web3KeysList, type Web3PaymentRequired, type Web3RevokeResult, type Web3SignupResult, type Web3SubscribeResult, type WebSocketLatency, type WsChannel, WsChannelSchema, type WsClientMessage, type WsConnectionState, WsConnectionStateSchema, type WsData, WsDataSchema, type WsError, WsErrorSchema, type WsEventHandlers, type WsGapDetected, type WsHistoricalBatch, WsHistoricalBatchSchema, type WsHistoricalData, WsHistoricalDataSchema, type WsHistoricalTickData, type WsL4Batch, type WsL4Snapshot, type WsOptions, type WsPing, type WsPong, WsPongSchema, type WsReplay, type WsReplayCompleted, WsReplayCompletedSchema, type WsReplayPause, type WsReplayPaused, WsReplayPausedSchema, type WsReplayResume, type WsReplayResumed, WsReplayResumedSchema, type WsReplaySeek, type WsReplaySnapshot, WsReplaySnapshotSchema, type WsReplayStarted, WsReplayStartedSchema, type WsReplayStop, type WsReplayStopped, WsReplayStoppedSchema, type WsServerMessage, WsServerMessageSchema, type WsStream, type WsStreamCompleted, WsStreamCompletedSchema, type WsStreamProgress, WsStreamProgressSchema, type WsStreamStarted, WsStreamStartedSchema, type WsStreamStop, type WsStreamStopped, WsStreamStoppedSchema, type WsSubscribe, type WsSubscribed, WsSubscribedSchema, type WsUnsubscribe, type WsUnsubscribed, WsUnsubscribedSchema, OxArchive as default, reconstructFinal, reconstructOrderBook };
+export { type ApiError, type ApiMeta, ApiMetaSchema, type ApiResponse, ApiResponseSchema, type Candle, CandleArrayResponseSchema, type CandleHistoryParams, type CandleInterval, CandleIntervalSchema, CandleSchema, type ClientOptions, type CoinFreshness, CoinFreshnessResponseSchema, CoinFreshnessSchema, type CoinSummary, CoinSummaryResponseSchema, CoinSummarySchema, type CompletenessMetrics, type CoverageGap, type CoverageResponse, type CursorResponse, type DataCadence, type DataFreshness, type DataTypeCoverage, type DataTypeFreshnessInfo, DataTypeFreshnessInfoSchema, type DataTypeStatus, type ExchangeCoverage, type ExchangeLatency, type ExchangeStatus, type FundingHistoryParams, type FundingRate, FundingRateArrayResponseSchema, FundingRateResponseSchema, FundingRateSchema, type GetOrderBookParams, type GetTradesCursorParams, Hip3Client, type Hip3Instrument, HyperliquidClient, type Incident, type IncidentSeverityValue, type IncidentStatusValue, type IncidentsResponse, type Instrument, InstrumentArrayResponseSchema, InstrumentResponseSchema, InstrumentSchema, type InstrumentType, InstrumentTypeSchema, type L2Level, type L2OrderBookParams, L2OrderBookResource, type L4Checkpoint, type L4Diff, type L4Order, L4OrderBookReconstructor, type LatencyResponse, LighterClient, type LighterGranularity, type LighterInstrument, type Liquidation, LiquidationArrayResponseSchema, type LiquidationHistoryParams, LiquidationSchema, LiquidationSideSchema, type LiquidationVolume, LiquidationVolumeArrayResponseSchema, type LiquidationVolumeParams, LiquidationVolumeSchema, type LiquidationsByUserParams, type ListIncidentsParams, type OiFundingInterval, type OpenInterest, OpenInterestArrayResponseSchema, type OpenInterestHistoryParams, OpenInterestResponseSchema, OpenInterestSchema, type OrderBook, OrderBookArrayResponseSchema, type OrderBookHistoryParams, OrderBookReconstructor, OrderBookResponseSchema, OrderBookSchema, type OrderbookDelta, OxArchive, OxArchiveError, OxArchiveWs, type Pagination, type PriceHistoryParams, type PriceLevel, PriceLevelSchema, type PriceSnapshot, PriceSnapshotArrayResponseSchema, PriceSnapshotSchema, type ReconstructOptions, type ReconstructedOrderBook, type RestApiLatency, type SiweChallenge, type SlaActual, type SlaParams, type SlaResponse, type SlaTargets, type StatusResponse, type SymbolCoverageOptions, type SymbolCoverageResponse, type SymbolDataTypeCoverage, type SystemStatusValue, type TickData, type TickHistoryParams, type Timestamp, type TimestampedRecord, TimestampedRecordSchema, type Trade, TradeArrayResponseSchema, type TradeDirection, TradeDirectionSchema, TradeSchema, type TradeSide, TradeSideSchema, type ValidatedApiMeta, type ValidatedCandle, type ValidatedFundingRate, type ValidatedInstrument, type ValidatedLiquidation, type ValidatedOpenInterest, type ValidatedOrderBook, type ValidatedPriceLevel, type ValidatedTrade, type ValidatedWsServerMessage, type Web3ApiKey, type Web3KeysList, type Web3PaymentRequired, type Web3RevokeResult, type Web3SignupResult, type Web3SubscribeResult, type WebSocketLatency, type WsChannel, WsChannelSchema, type WsClientMessage, type WsConnectionState, WsConnectionStateSchema, type WsData, WsDataSchema, type WsError, WsErrorSchema, type WsEventHandlers, type WsGapDetected, type WsHistoricalBatch, WsHistoricalBatchSchema, type WsHistoricalData, WsHistoricalDataSchema, type WsHistoricalTickData, type WsL4Batch, type WsL4Snapshot, type WsOptions, type WsPing, type WsPong, WsPongSchema, type WsReplay, type WsReplayCompleted, WsReplayCompletedSchema, type WsReplayPause, type WsReplayPaused, WsReplayPausedSchema, type WsReplayResume, type WsReplayResumed, WsReplayResumedSchema, type WsReplaySeek, type WsReplaySnapshot, WsReplaySnapshotSchema, type WsReplayStarted, WsReplayStartedSchema, type WsReplayStop, type WsReplayStopped, WsReplayStoppedSchema, type WsServerMessage, WsServerMessageSchema, type WsStream, type WsStreamCompleted, WsStreamCompletedSchema, type WsStreamProgress, WsStreamProgressSchema, type WsStreamStarted, WsStreamStartedSchema, type WsStreamStop, type WsStreamStopped, WsStreamStoppedSchema, type WsSubscribe, type WsSubscribed, WsSubscribedSchema, type WsUnsubscribe, type WsUnsubscribed, WsUnsubscribedSchema, OxArchive as default, reconstructFinal, reconstructOrderBook };

package/dist/index.js

@@ -39,6 +39,8 @@ __export(index_exports, {
   InstrumentResponseSchema: () => InstrumentResponseSchema,
   InstrumentSchema: () => InstrumentSchema,
   InstrumentTypeSchema: () => InstrumentTypeSchema,
+  L2OrderBookResource: () => L2OrderBookResource,
+  L4OrderBookReconstructor: () => L4OrderBookReconstructor,
   LighterClient: () => LighterClient,
   LiquidationArrayResponseSchema: () => LiquidationArrayResponseSchema,
   LiquidationSchema: () => LiquidationSchema,
@@ -321,7 +323,13 @@ var TradeSchema = import_zod.z.object({
   startPosition: import_zod.z.string().optional(),
   userAddress: import_zod.z.string().optional(),
   makerAddress: import_zod.z.string().optional(),
-  takerAddress: import_zod.z.string().optional()
+  takerAddress: import_zod.z.string().optional(),
+  builderAddress: import_zod.z.string().optional(),
+  builderFee: import_zod.z.string().optional(),
+  deployerFee: import_zod.z.string().optional(),
+  priorityGas: import_zod.z.number().optional(),
+  cloid: import_zod.z.string().optional(),
+  twapId: import_zod.z.number().optional()
 });
 var InstrumentTypeSchema = import_zod.z.enum(["perp", "spot"]);
 var InstrumentSchema = import_zod.z.object({
@@ -1789,6 +1797,51 @@ var L4OrderBookResource = class {
   }
 };
 
+// src/resources/l2-orderbook.ts
+var L2OrderBookResource = class {
+  constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
+    this.http = http;
+    this.basePath = basePath;
+    this.coinTransform = coinTransform;
+  }
+  /** Get full-depth L2 order book snapshot. */
+  async get(symbol, params) {
+    const coin = this.coinTransform(symbol);
+    const query = {};
+    if (params?.timestamp != null) query.timestamp = params.timestamp;
+    if (params?.depth != null) query.depth = params.depth;
+    const resp = await this.http.get(
+      `${this.basePath}/orderbook/${encodeURIComponent(coin)}/l2`,
+      query
+    );
+    return resp.data;
+  }
+  /** Get paginated L2 full-depth history. */
+  async history(symbol, params) {
+    const coin = this.coinTransform(symbol);
+    const resp = await this.http.get(
+      `${this.basePath}/orderbook/${encodeURIComponent(coin)}/l2/history`,
+      params
+    );
+    return {
+      data: resp.data,
+      nextCursor: resp.meta?.next_cursor ?? void 0
+    };
+  }
+  /** Get tick-level L2 order book diffs. */
+  async diffs(symbol, params) {
+    const coin = this.coinTransform(symbol);
+    const resp = await this.http.get(
+      `${this.basePath}/orderbook/${encodeURIComponent(coin)}/l2/diffs`,
+      params
+    );
+    return {
+      data: resp.data,
+      nextCursor: resp.meta?.next_cursor ?? void 0
+    };
+  }
+};
+
 // src/resources/l3-orderbook.ts
 var L3OrderBookResource = class {
   constructor(http, basePath = "/v1", coinTransform = (c) => c.toUpperCase()) {
@@ -1864,6 +1917,10 @@ var HyperliquidClient = class {
    * L4 order book (snapshots, diffs, history)
    */
   l4Orderbook;
+  /**
+   * L2 full-depth order book (derived from L4)
+   */
+  l2Orderbook;
   /**
    * HIP-3 builder-deployed perpetuals (February 2026+)
    */
@@ -1881,6 +1938,7 @@ var HyperliquidClient = class {
     this.liquidations = new LiquidationsResource(http, basePath);
     this.orders = new OrdersResource(http, basePath);
     this.l4Orderbook = new L4OrderBookResource(http, basePath);
+    this.l2Orderbook = new L2OrderBookResource(http, basePath);
     this.hip3 = new Hip3Client(http);
   }
   /**
@@ -1967,6 +2025,10 @@ var Hip3Client = class {
    * L4 order book (snapshots, diffs, history)
    */
   l4Orderbook;
+  /**
+   * L2 full-depth order book (derived from L4)
+   */
+  l2Orderbook;
   http;
   constructor(http) {
     this.http = http;
@@ -1981,6 +2043,7 @@ var Hip3Client = class {
     this.liquidations = new LiquidationsResource(http, basePath, coinTransform);
     this.orders = new OrdersResource(http, basePath, coinTransform);
     this.l4Orderbook = new L4OrderBookResource(http, basePath, coinTransform);
+    this.l2Orderbook = new L2OrderBookResource(http, basePath, coinTransform);
   }
   /**
    * Get per-symbol data freshness across all data types
@@ -2860,6 +2923,136 @@ var OxArchiveWs = class {
     }
   }
 };
+
+// src/l4-reconstructor.ts
+var L4OrderBookReconstructor = class {
+  orders = /* @__PURE__ */ new Map();
+  bidPrices = /* @__PURE__ */ new Map();
+  askPrices = /* @__PURE__ */ new Map();
+  /** Initialize from an L4 checkpoint. */
+  loadCheckpoint(checkpoint) {
+    this.orders.clear();
+    this.bidPrices.clear();
+    this.askPrices.clear();
+    for (const order of [...checkpoint.bids, ...checkpoint.asks]) {
+      const oid = order.oid;
+      const price = Number(order.price);
+      const size = Number(order.size);
+      const side = order.side;
+      this.orders.set(oid, {
+        oid,
+        userAddress: order.user_address ?? order.userAddress ?? "",
+        side,
+        price,
+        size
+      });
+      const priceMap = side === "B" ? this.bidPrices : this.askPrices;
+      if (!priceMap.has(price)) priceMap.set(price, /* @__PURE__ */ new Set());
+      priceMap.get(price).add(oid);
+    }
+  }
+  /** Apply a single L4 diff with matching engine. */
+  applyDiff(diff, nonRestingOids) {
+    const dt = diff.diff_type ?? diff.diffType;
+    const oid = diff.oid;
+    if (dt === "new") {
+      if (nonRestingOids?.has(oid)) return;
+      const newSize = diff.new_size ?? diff.newSize;
+      if (newSize == null || newSize <= 0) return;
+      const { side, price } = diff;
+      const sz = newSize;
+      if (side === "B") {
+        for (const [askPx, oids] of this.askPrices) {
+          if (askPx <= price) {
+            for (const crossedOid of oids) this.orders.delete(crossedOid);
+            this.askPrices.delete(askPx);
+          }
+        }
+      } else {
+        for (const [bidPx, oids] of this.bidPrices) {
+          if (bidPx >= price) {
+            for (const crossedOid of oids) this.orders.delete(crossedOid);
+            this.bidPrices.delete(bidPx);
+          }
+        }
+      }
+      this.orders.set(oid, {
+        oid,
+        userAddress: diff.user_address ?? diff.userAddress ?? "",
+        side,
+        price,
+        size: sz
+      });
+      const priceMap = side === "B" ? this.bidPrices : this.askPrices;
+      if (!priceMap.has(price)) priceMap.set(price, /* @__PURE__ */ new Set());
+      priceMap.get(price).add(oid);
+    } else if (dt === "update") {
+      const order = this.orders.get(oid);
+      const updSize = diff.new_size ?? diff.newSize;
+      if (order && updSize != null) {
+        order.size = updSize;
+      }
+    } else if (dt === "remove") {
+      const order = this.orders.get(oid);
+      if (order) {
+        this.orders.delete(oid);
+        const priceMap = order.side === "B" ? this.bidPrices : this.askPrices;
+        const oids = priceMap.get(order.price);
+        if (oids) {
+          oids.delete(oid);
+          if (oids.size === 0) priceMap.delete(order.price);
+        }
+      }
+    }
+  }
+  /** Return bids sorted by price descending. */
+  bids() {
+    return [...this.orders.values()].filter((o) => o.side === "B" && o.size > 0).sort((a, b) => b.price - a.price);
+  }
+  /** Return asks sorted by price ascending. */
+  asks() {
+    return [...this.orders.values()].filter((o) => o.side === "A" && o.size > 0).sort((a, b) => a.price - b.price);
+  }
+  bestBid() {
+    const b = this.bids();
+    return b.length > 0 ? b[0].price : null;
+  }
+  bestAsk() {
+    const a = this.asks();
+    return a.length > 0 ? a[0].price : null;
+  }
+  /** Check if the book is crossed. Should be false after correct reconstruction. */
+  isCrossed() {
+    const bb = this.bestBid();
+    const ba = this.bestAsk();
+    return bb != null && ba != null && bb >= ba;
+  }
+  get bidCount() {
+    return [...this.orders.values()].filter((o) => o.side === "B" && o.size > 0).length;
+  }
+  get askCount() {
+    return [...this.orders.values()].filter((o) => o.side === "A" && o.size > 0).length;
+  }
+  /** Aggregate L4 orders into L2 price levels. */
+  deriveL2() {
+    const bidAgg = /* @__PURE__ */ new Map();
+    const askAgg = /* @__PURE__ */ new Map();
+    for (const o of this.orders.values()) {
+      if (o.size <= 0) continue;
+      const agg = o.side === "B" ? bidAgg : askAgg;
+      const existing = agg.get(o.price);
+      if (existing) {
+        existing.sz += o.size;
+        existing.n += 1;
+      } else {
+        agg.set(o.price, { sz: o.size, n: 1 });
+      }
+    }
+    const bids = [...bidAgg.entries()].sort(([a], [b]) => b - a).map(([px, v]) => ({ px, sz: v.sz, n: v.n }));
+    const asks = [...askAgg.entries()].sort(([a], [b]) => a - b).map(([px, v]) => ({ px, sz: v.sz, n: v.n }));
+    return { bids, asks };
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiMetaSchema,
@@ -2881,6 +3074,8 @@ var OxArchiveWs = class {
   InstrumentResponseSchema,
   InstrumentSchema,
   InstrumentTypeSchema,
+  L2OrderBookResource,
+  L4OrderBookReconstructor,
   LighterClient,
   LiquidationArrayResponseSchema,
   LiquidationSchema,