@pear-protocol/market-sdk 0.2.1 → 0.3.0

package/dist/chart/collector/helpers.js

@@ -17,7 +17,8 @@ async function fetchHistoricalCandles(connector, symbol, startTime, endTime, int
     case "okx":
       return fetchHistoricalCandles$2(symbol, startTime, endTime, interval);
     case "lighter":
-      return fetchHistoricalCandles$1(symbol, startTime, endTime, interval, authToken);
+    case "lighter_rhc":
+      return fetchHistoricalCandles$1(connector, symbol, startTime, endTime, interval, authToken);
     default:
       throw new Error(`Unsupported connector: ${connector}`);
   }

package/dist/chart/collector/lighter.d.ts

@@ -1,10 +1,12 @@
+import { LighterConnector } from '../../shared/lighter-hosts.js';
 import { CandleInterval, CandleData } from '../types.js';
-import '../../transport/index.js';
 import '@pear-protocol/types';
+import '../../transport/index.js';
 import '../../shared/types.js';
 import '../../transport/base-transport.js';
 import 'partysocket';
 
-declare function fetchHistoricalCandles(symbol: string, startTime: number, endTime: number, interval: CandleInterval, authToken?: string): Promise<CandleData[]>;
+/** Reads one deployment's candles for a range, synthesizing the resolutions it does not serve. */
+declare function fetchHistoricalCandles(connector: LighterConnector, symbol: string, startTime: number, endTime: number, interval: CandleInterval, authToken?: string): Promise<CandleData[]>;
 
 export { fetchHistoricalCandles };

package/dist/chart/collector/lighter.js

@@ -1,9 +1,9 @@
+import { LIGHTER_BASE_URLS } from '../../shared/lighter-hosts';
 import { getIntervalSeconds } from '../utils';
 import { getWeekStart, aggregateDailyCandlesToWeekly } from '../weekly';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const BASE_URL = "https://mainnet.zklighter.elliot.ai";
 const MAX_LIMIT = 500;
 const DAY_MS = getIntervalSeconds("1d") * 1e3;
 const RESOLUTION_MAP = {
@@ -16,25 +16,25 @@ const RESOLUTION_MAP = {
   "12h": "12h",
   "1d": "1d"
 };
-async function fetchHistoricalCandles(symbol, startTime, endTime, interval, authToken) {
+async function fetchHistoricalCandles(connector, symbol, startTime, endTime, interval, authToken) {
   if (interval === "1w") {
-    const dailyCandles = await fetchDailyCandlesChunked(symbol, getWeekStart(startTime), endTime, authToken);
+    const dailyCandles = await fetchDailyCandlesChunked(connector, symbol, getWeekStart(startTime), endTime, authToken);
     return aggregateDailyCandlesToWeekly(dailyCandles);
   }
-  return fetchResolutionCandles(symbol, startTime, endTime, interval, authToken);
+  return fetchResolutionCandles(connector, symbol, startTime, endTime, interval, authToken);
 }
 __name(fetchHistoricalCandles, "fetchHistoricalCandles");
-async function fetchDailyCandlesChunked(symbol, startTime, endTime, authToken) {
+async function fetchDailyCandlesChunked(connector, symbol, startTime, endTime, authToken) {
   const chunkMs = MAX_LIMIT * DAY_MS;
   const chunkStarts = [];
   for (let chunkStart = startTime; chunkStart < endTime; chunkStart += chunkMs) {
     chunkStarts.push(chunkStart);
   }
-  const chunks = await Promise.all(chunkStarts.map((chunkStart) => fetchResolutionCandles(symbol, chunkStart, Math.min(chunkStart + chunkMs, endTime), "1d", authToken)));
+  const chunks = await Promise.all(chunkStarts.map((chunkStart) => fetchResolutionCandles(connector, symbol, chunkStart, Math.min(chunkStart + chunkMs, endTime), "1d", authToken)));
   return chunks.flat();
 }
 __name(fetchDailyCandlesChunked, "fetchDailyCandlesChunked");
-async function fetchResolutionCandles(symbol, startTime, endTime, interval, authToken) {
+async function fetchResolutionCandles(connector, symbol, startTime, endTime, interval, authToken) {
   const resolution = RESOLUTION_MAP[interval];
   if (!resolution) throw new Error(`Lighter does not support the '${interval}' interval`);
   const intervalMs = getIntervalSeconds(interval) * 1e3;
@@ -46,7 +46,7 @@ async function fetchResolutionCandles(symbol, startTime, endTime, interval, auth
     end_timestamp: String(endTime),
     count_back: String(countBack)
   });
-  const response = await fetch(`${BASE_URL}/api/v1/candles?${params}`, authToken ? {
+  const response = await fetch(`${LIGHTER_BASE_URLS[connector]}/api/v1/candles?${params}`, authToken ? {
     headers: {
       authorization: authToken
     }

package/dist/chart/ws/index.js

@@ -18,6 +18,7 @@ function createCandleWs(transport, connector, onCandle) {
     case "okx":
       return new OkxCandleWs(transport, onCandle);
     case "lighter":
+    case "lighter_rhc":
       return new LighterCandleWs(transport, onCandle);
     default: {
       const _exhaustive = connector;

package/dist/funding-rate/fetcher/index.js

@@ -17,7 +17,8 @@ async function fetchHistoricalFundingRates(connector, symbol, startTime, endTime
     case "okx":
       return fetchHistoricalFundingRates$2(symbol, startTime, endTime);
     case "lighter":
-      return fetchHistoricalFundingRates$1(symbol, startTime, endTime, duration, authToken);
+    case "lighter_rhc":
+      return fetchHistoricalFundingRates$1(connector, symbol, startTime, endTime, duration, authToken);
     default:
       throw new Error(`Unsupported connector: ${connector}`);
   }

package/dist/funding-rate/fetcher/lighter.d.ts

@@ -1,10 +1,11 @@
+import { LighterConnector } from '../../shared/lighter-hosts.js';
 import { FundingRateDuration, FundingRateEntry } from '../types.js';
-import '../../transport/index.js';
 import '@pear-protocol/types';
+import '../../transport/index.js';
 import '../../shared/types.js';
 import '../../transport/base-transport.js';
 import 'partysocket';
 
-declare function fetchHistoricalFundingRates(symbol: string, startTime: number, endTime: number, _duration: FundingRateDuration, authToken?: string): Promise<FundingRateEntry[]>;
+declare function fetchHistoricalFundingRates(connector: LighterConnector, symbol: string, startTime: number, endTime: number, _duration: FundingRateDuration, authToken?: string): Promise<FundingRateEntry[]>;
 
 export { fetchHistoricalFundingRates };

package/dist/funding-rate/fetcher/lighter.js

@@ -1,17 +1,17 @@
 import BigNumber from 'bignumber.js';
+import { LIGHTER_BASE_URLS } from '../../shared/lighter-hosts';
 import { httpGet } from './http-client';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const BASE_URL = "https://mainnet.zklighter.elliot.ai";
 const MAX_LIMIT = 500;
-async function fetchHistoricalFundingRates(symbol, startTime, endTime, _duration, authToken) {
+async function fetchHistoricalFundingRates(connector, symbol, startTime, endTime, _duration, authToken) {
   const intervalMs = 60 * 60 * 1e3;
   const allRates = [];
   let cursor = startTime;
   while (cursor < endTime) {
     const countBack = Math.min(Math.ceil((endTime - cursor) / intervalMs) + 1, MAX_LIMIT);
-    const data = await httpGet(`${BASE_URL}/api/v1/fundings`, {
+    const data = await httpGet(`${LIGHTER_BASE_URLS[connector]}/api/v1/fundings`, {
       market_id: symbol,
       resolution: "1h",
       start_timestamp: String(cursor),

package/dist/orderbook/ws/index.js

@@ -18,6 +18,7 @@ function createDepthWs(transport, connector, onUpdate) {
     case "okx":
       return new OkxDepthWs(transport, onUpdate);
     case "lighter":
+    case "lighter_rhc":
       return new LighterDepthWs(transport, onUpdate);
     default: {
       const _exhaustive = connector;

package/dist/shared/lighter-hosts.d.ts

@@ -0,0 +1,18 @@
+import { Connector } from '@pear-protocol/types';
+
+/**
+ * The connector values that are deployments of the Lighter stack. The deployments share the
+ * protocol but nothing else — hosts and market indices are per-deployment, so every Lighter code
+ * path in this SDK resolves its host from the connector value.
+ */
+type LighterConnector = Extract<Connector, 'lighter' | 'lighter_rhc'>;
+/**
+ * REST host per Lighter deployment.
+ */
+declare const LIGHTER_BASE_URLS: Record<LighterConnector, string>;
+/**
+ * WebSocket stream URL per Lighter deployment.
+ */
+declare const LIGHTER_WS_URLS: Record<LighterConnector, string>;
+
+export { LIGHTER_BASE_URLS, LIGHTER_WS_URLS, type LighterConnector };

package/dist/shared/lighter-hosts.js

@@ -0,0 +1,10 @@
+const LIGHTER_BASE_URLS = {
+  lighter: "https://mainnet.zklighter.elliot.ai",
+  lighter_rhc: "https://api.rh.lighter.xyz"
+};
+const LIGHTER_WS_URLS = {
+  lighter: "wss://mainnet.zklighter.elliot.ai/stream",
+  lighter_rhc: "wss://api.rh.lighter.xyz/stream"
+};
+
+export { LIGHTER_BASE_URLS, LIGHTER_WS_URLS };

package/dist/transport/index.js

@@ -18,7 +18,8 @@ function CreateTransport(connector, options) {
     case "hyperliquid":
       return new HyperliquidTransport();
     case "lighter":
-      return new LighterTransport(options?.authToken);
+    case "lighter_rhc":
+      return new LighterTransport(connector, options?.authToken);
     default: {
       const _exhaustive = connector;
       throw new Error(`Unsupported connector: ${String(_exhaustive)}`);

package/dist/transport/lighter.d.ts

@@ -1,6 +1,7 @@
-import { Connector } from '@pear-protocol/types';
+import { LighterConnector } from '../shared/lighter-hosts.js';
 import { AuthTokenProvider, WsMessage } from '../shared/types.js';
 import { BaseTransport } from './base-transport.js';
+import '@pear-protocol/types';
 import 'partysocket';
 
 /**
@@ -10,14 +11,17 @@ import 'partysocket';
  */
 
 declare class LighterTransport extends BaseTransport {
-    readonly connector: Connector;
+    readonly connector: LighterConnector;
     private readonly authTokenProvider;
     private cachedAuthToken;
     private authRefreshTimer;
     private mintInFlight;
     private wantsConnection;
-    /** Takes the caller's minter; without one this transport stays anonymous for its whole life. */
-    constructor(authTokenProvider?: AuthTokenProvider);
+    /**
+     * Takes the deployment this transport streams from, and the caller's minter; without a minter
+     * this transport stays anonymous for its whole life.
+     */
+    constructor(connector: LighterConnector, authTokenProvider?: AuthTokenProvider);
     /** Holds the socket until a first token lands, so the opening subscriptions carry it. */
     connect(): void;
     /** Tears the socket down and drops the identity that belonged to it. */
@@ -26,7 +30,7 @@ declare class LighterTransport extends BaseTransport {
     get authToken(): string | undefined;
     /** Refreshes the cached token; the caller's provider owns expiry and request coalescing. */
     retrieveAuthToken(): Promise<string | undefined>;
-    /** The venue's public market-data stream, which serves both authenticated and anonymous traffic. */
+    /** The deployment's public market-data stream, which serves both authenticated and anonymous traffic. */
     protected getWsUrl(): string;
     /** How often the socket must speak to stay open. */
     protected getPingIntervalMs(): number;

package/dist/transport/lighter.js

@@ -1,3 +1,4 @@
+import { LIGHTER_WS_URLS } from '../shared/lighter-hosts';
 import { BaseTransport } from './base-transport';
 
 var __defProp = Object.defineProperty;
@@ -7,15 +8,19 @@ class LighterTransport extends BaseTransport {
   static {
     __name(this, "LighterTransport");
   }
-  connector = "lighter";
+  connector;
   authTokenProvider;
   cachedAuthToken;
   authRefreshTimer = null;
   mintInFlight = false;
   wantsConnection = false;
-  /** Takes the caller's minter; without one this transport stays anonymous for its whole life. */
-  constructor(authTokenProvider) {
+  /**
+  * Takes the deployment this transport streams from, and the caller's minter; without a minter
+  * this transport stays anonymous for its whole life.
+  */
+  constructor(connector, authTokenProvider) {
     super();
+    this.connector = connector;
     this.authTokenProvider = authTokenProvider;
   }
   /** Holds the socket until a first token lands, so the opening subscriptions carry it. */
@@ -61,9 +66,9 @@ class LighterTransport extends BaseTransport {
     }
     return this.cachedAuthToken;
   }
-  /** The venue's public market-data stream, which serves both authenticated and anonymous traffic. */
+  /** The deployment's public market-data stream, which serves both authenticated and anonymous traffic. */
   getWsUrl() {
-    return "wss://mainnet.zklighter.elliot.ai/stream";
+    return LIGHTER_WS_URLS[this.connector];
   }
   /** How often the socket must speak to stay open. */
   getPingIntervalMs() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/market-sdk",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Pear Protocol Market SDK",
   "private": false,
   "type": "module",
@@ -26,7 +26,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^2.0.0",
+    "@pear-protocol/types": "^2.2.0",
     "bignumber.js": "^9.1.2",
     "partysocket": "^1.0.3"
   },