@pear-protocol/exchanges-sdk 0.0.18 → 0.1.3

package/dist/client/bybit/exchange-ws.d.ts

@@ -0,0 +1,20 @@
+import { BybitCredentialsDTO } from '@pear-protocol/types';
+import { BaseWs } from '../base-ws.js';
+import { ExchangeWs } from '../exchange-ws.js';
+import { BybitWs } from './ws.js';
+import 'partysocket';
+
+declare class BybitExchangeWs extends ExchangeWs {
+    main: BybitWs;
+    private readonly creds;
+    readonly exchange: "bybit";
+    constructor(main: BybitWs, creds: BybitCredentialsDTO);
+    protected connections(): BaseWs[];
+    authenticate(): Promise<void>;
+    static create(config: {
+        demo: boolean;
+        credentials: BybitCredentialsDTO;
+    }): Promise<BybitExchangeWs>;
+}
+
+export { BybitExchangeWs };

package/dist/client/bybit/exchange-ws.js

@@ -0,0 +1,28 @@
+import { ExchangeWs } from '../exchange-ws';
+import { BybitWs } from './ws';
+
+class BybitExchangeWs extends ExchangeWs {
+  constructor(main, creds) {
+    super();
+    this.main = main;
+    this.creds = creds;
+  }
+  main;
+  creds;
+  exchange = "bybit";
+  connections() {
+    return [this.main];
+  }
+  authenticate() {
+    return this.main.authenticate(this.creds);
+  }
+  static async create(config) {
+    const main = new BybitWs({ demo: config.demo });
+    await main.connect();
+    const wrapper = new BybitExchangeWs(main, config.credentials);
+    await wrapper.authenticate();
+    return wrapper;
+  }
+}
+
+export { BybitExchangeWs };

package/dist/{account/exchanges → client}/bybit/rest.js

@@ -1,6 +1,7 @@
-import { hmacSha256Hex } from '../../../utils/hmac';
-import { BASE_URL_DEMO, BASE_URL } from './const';
+import { hmacSha256Hex } from '../hmac';
 
+const BASE_URL = "https://api.bybit.com";
+const BASE_URL_DEMO = "https://api-demo.bybit.com";
 async function signedGet(creds, path, params, demo) {
   const baseUrl = demo ? BASE_URL_DEMO : BASE_URL;
   const timestamp = Date.now().toString();

package/dist/{account/exchanges → client}/bybit/types.d.ts

@@ -23,11 +23,6 @@ interface BybitRawWallet {
     accountMMRate: string;
     coin: BybitRawCoin[];
 }
-declare enum BybitAccountType {
-    ISOLATED_MARGIN = "ISOLATED_MARGIN",
-    REGULAR_MARGIN = "REGULAR_MARGIN",
-    PORTFOLIO_MARGIN = "PORTFOLIO_MARGIN"
-}
 interface BybitRawAccountInfo {
     marginMode: string;
     updatedTime: string;
@@ -63,8 +58,5 @@ type BybitWsMessage = {
     topic: 'position';
     data: BybitRawPosition[];
 };
-interface BybitWsHandlers {
-    onMessage: (msg: BybitWsMessage) => void;
-}
 
-export { BybitAccountType, type BybitRawAccountInfo, type BybitRawCoin, type BybitRawCollateralRatioEntry, type BybitRawCollateralTier, type BybitRawPosition, type BybitRawWallet, type BybitResponse, type BybitWsHandlers, type BybitWsMessage };
+export type { BybitRawAccountInfo, BybitRawCoin, BybitRawCollateralRatioEntry, BybitRawCollateralTier, BybitRawPosition, BybitRawWallet, BybitResponse, BybitWsMessage };

package/dist/client/bybit/types.js

@@ -0,0 +1 @@
+

package/dist/client/bybit/ws.d.ts

@@ -0,0 +1,17 @@
+import { BybitCredentialsDTO } from '@pear-protocol/types';
+import { BaseWs, WsMessage } from '../base-ws.js';
+import 'partysocket';
+
+type BybitWsConfig = {
+    demo: boolean;
+};
+declare class BybitWs extends BaseWs {
+    private readonly demo;
+    constructor(config: BybitWsConfig);
+    protected getWsUrl(): string;
+    protected getPingIntervalMs(): number;
+    protected buildPingMessage(): WsMessage;
+    authenticate(creds: BybitCredentialsDTO): Promise<void>;
+}
+
+export { BybitWs, type BybitWsConfig };

package/dist/client/bybit/ws.js

@@ -0,0 +1,50 @@
+import { BaseWs } from '../base-ws';
+import { hmacSha256Hex } from '../hmac';
+
+const WS_URL = "wss://stream.bybit.com/v5/private";
+const WS_URL_DEMO = "wss://stream-demo.bybit.com/v5/private";
+const PING_INTERVAL_MS = 2e4;
+const AUTH_TIMEOUT_MS = 1e4;
+class BybitWs extends BaseWs {
+  demo;
+  constructor(config) {
+    super();
+    this.demo = config.demo;
+  }
+  getWsUrl() {
+    return this.demo ? WS_URL_DEMO : WS_URL;
+  }
+  getPingIntervalMs() {
+    return PING_INTERVAL_MS;
+  }
+  buildPingMessage() {
+    return { op: "ping" };
+  }
+  async authenticate(creds) {
+    const expires = Date.now() + AUTH_TIMEOUT_MS;
+    const signature = await hmacSha256Hex(creds.api_secret, `GET/realtime${expires}`);
+    return new Promise((resolve, reject) => {
+      let listenerId = "";
+      const timer = setTimeout(() => {
+        this.removeMessageListener(listenerId);
+        reject(new Error("Bybit auth timeout"));
+      }, AUTH_TIMEOUT_MS);
+      listenerId = this.addMessageListener((raw) => {
+        let msg;
+        try {
+          msg = JSON.parse(raw);
+        } catch {
+          return;
+        }
+        if (msg.op !== "auth") return;
+        clearTimeout(timer);
+        this.removeMessageListener(listenerId);
+        if (msg.success) resolve();
+        else reject(new Error(`Bybit auth failed: ${msg.ret_msg}`));
+      });
+      this.send({ op: "auth", args: [creds.api_key, expires, signature] });
+    });
+  }
+}
+
+export { BybitWs };

package/dist/client/exchange-ws.d.ts

@@ -0,0 +1,12 @@
+import { Connector } from '@pear-protocol/types';
+import { BaseWs } from './base-ws.js';
+import 'partysocket';
+
+declare abstract class ExchangeWs {
+    abstract readonly exchange: Connector;
+    protected abstract connections(): BaseWs[];
+    destroy(): void;
+    get isConnected(): boolean;
+}
+
+export { ExchangeWs };

package/dist/client/exchange-ws.js

@@ -0,0 +1,10 @@
+class ExchangeWs {
+  destroy() {
+    for (const c of this.connections()) c.destroy();
+  }
+  get isConnected() {
+    return this.connections().every((c) => c.connected);
+  }
+}
+
+export { ExchangeWs };

package/dist/client/hyperliquid/exchange-ws.d.ts

@@ -0,0 +1,15 @@
+import { BaseWs } from '../base-ws.js';
+import { ExchangeWs } from '../exchange-ws.js';
+import { HyperliquidWs } from './ws.js';
+import 'partysocket';
+import '@pear-protocol/types';
+
+declare class HyperliquidExchangeWs extends ExchangeWs {
+    main: HyperliquidWs;
+    readonly exchange: "hyperliquid";
+    constructor(main: HyperliquidWs);
+    protected connections(): BaseWs[];
+    static create(): Promise<HyperliquidExchangeWs>;
+}
+
+export { HyperliquidExchangeWs };

package/dist/client/hyperliquid/exchange-ws.js

@@ -0,0 +1,21 @@
+import { ExchangeWs } from '../exchange-ws';
+import { HyperliquidWs } from './ws';
+
+class HyperliquidExchangeWs extends ExchangeWs {
+  constructor(main) {
+    super();
+    this.main = main;
+  }
+  main;
+  exchange = "hyperliquid";
+  connections() {
+    return [this.main];
+  }
+  static async create() {
+    const main = new HyperliquidWs();
+    await main.connect();
+    return new HyperliquidExchangeWs(main);
+  }
+}
+
+export { HyperliquidExchangeWs };

package/dist/client/hyperliquid/rest.d.ts

@@ -0,0 +1,3 @@
+declare function fetchInfo<T>(body: Record<string, unknown>): Promise<T>;
+
+export { fetchInfo };

package/dist/client/hyperliquid/rest.js

@@ -0,0 +1,12 @@
+const HL_INFO_URL = "https://api.hyperliquid.xyz/info";
+async function fetchInfo(body) {
+  const res = await fetch(HL_INFO_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) throw new Error(`Hyperliquid info request failed: ${res.status}`);
+  return res.json();
+}
+
+export { fetchInfo };

package/dist/{account/exchanges → client}/hyperliquid/types.d.ts

@@ -1,24 +1,11 @@
-declare enum HyperliquidAccountType {
-    DEFAULT = "default",
-    DEX_ABSTRACTION = "dexAbstraction",
-    DISABLED = "disabled",
-    PORTFOLIO_MARGIN = "portfolioMargin",
-    UNIFIED_ACCOUNT = "unifiedAccount"
-}
-interface HyperliquidCoinBalance {
-    coin: string;
-    total: number;
-    hold: number;
-}
-interface AggregatedClearinghouseSummary {
-    accountValue: number;
-    totalMarginUsed: number;
-    totalRawUsd: number;
-    crossMaintenanceMarginUsed: number;
-    withdrawable: number;
-    totalUnrealizedPnl: number;
-}
-declare const COLLATERAL_TOKEN_MAP: Record<number, string>;
+type LeverageInfo = {
+    type: 'isolated';
+    value: number;
+    rawUsd: string;
+} | {
+    type: 'cross';
+    value: number;
+};
 type MetaResponse = {
     universe: {
         szDecimals: number;
@@ -41,14 +28,6 @@ type MetaResponse = {
     collateralToken: number;
 };
 type AllPerpMetasResponse = MetaResponse[];
-type LeverageInfo = {
-    type: 'isolated';
-    value: number;
-    rawUsd: string;
-} | {
-    type: 'cross';
-    value: number;
-};
 type ClearinghouseStateResponse = {
     marginSummary: {
         accountValue: string;
@@ -87,6 +66,15 @@ type ClearinghouseStateResponse = {
     time: number;
 };
 type AssetPosition = ClearinghouseStateResponse['assetPositions'][number];
+type SpotClearinghouseStateResponse = {
+    balances: {
+        coin: string;
+        token: number;
+        total: string;
+        hold: string;
+        entryNtl: string;
+    }[];
+};
 type AllDexsClearinghouseStateEvent = {
     user: `0x${string}`;
     clearinghouseStates: [dex: string, state: ClearinghouseStateResponse][];
@@ -99,15 +87,6 @@ type ActiveAssetDataEvent = {
     availableToTrade: [min: string, max: string];
     markPx: string;
 };
-type SpotClearinghouseStateResponse = {
-    balances: {
-        coin: string;
-        token: number;
-        total: string;
-        hold: string;
-        entryNtl: string;
-    }[];
-};
 type SpotStateEvent = {
     user: `0x${string}`;
     spotState: SpotClearinghouseStateResponse;
@@ -130,5 +109,80 @@ type WebData3Event = {
         leadingVaults?: unknown;
     }[];
 };
+type UserFillsByTimeResponse = {
+    /** Asset symbol. */
+    coin: string;
+    /**
+     * Price.
+     * @pattern ^[0-9]+(\.[0-9]+)?$
+     */
+    px: string;
+    /**
+     * Size.
+     * @pattern ^[0-9]+(\.[0-9]+)?$
+     */
+    sz: string;
+    /** Order side ("B" = Bid/Buy, "A" = Ask/Sell). */
+    side: 'B' | 'A';
+    /** Timestamp when the trade occurred (in ms since epoch). */
+    time: number;
+    /**
+     * Start position size.
+     * @pattern ^-?[0-9]+(\.[0-9]+)?$
+     */
+    startPosition: string;
+    /** Direction indicator for frontend display. */
+    dir: string;
+    /**
+     * Realized PnL.
+     * @pattern ^-?[0-9]+(\.[0-9]+)?$
+     */
+    closedPnl: string;
+    /**
+     * L1 transaction hash.
+     * @pattern ^0x[a-fA-F0-9]{64}$
+     */
+    hash: `0x${string}`;
+    /** Order ID. */
+    oid: number;
+    /** Indicates if the fill was a taker order. */
+    crossed: boolean;
+    /**
+     * Fee charged or rebate received (negative indicates rebate).
+     * @pattern ^-?[0-9]+(\.[0-9]+)?$
+     */
+    fee: string;
+    /**
+     * Optional fee charged by the UI builder.
+     * @pattern ^-?[0-9]+(\.[0-9]+)?$
+     */
+    builderFee?: string;
+    /** Unique transaction identifier for a partial fill of an order. */
+    tid: number;
+    /** Token in which the fee is denominated (e.g., "USDC"). */
+    feeToken: string;
+    /** ID of the TWAP. */
+    twapId: number | null;
+    /**
+     * Client Order ID.
+     * @pattern ^0x[a-fA-F0-9]{32}$
+     */
+    cloid?: `0x${string}`;
+    /** Liquidation details. */
+    liquidation?: {
+        /**
+         * Address of the liquidated user.
+         * @pattern ^0x[a-fA-F0-9]{40}$
+         */
+        liquidatedUser: `0x${string}`;
+        /**
+         * Mark price at the time of liquidation.
+         * @pattern ^[0-9]+(\.[0-9]+)?$
+         */
+        markPx: string;
+        /** Liquidation method. */
+        method: 'market' | 'backstop';
+    };
+};
 
-export { type ActiveAssetDataEvent, type AggregatedClearinghouseSummary, type AllDexsClearinghouseStateEvent, type AllPerpMetasResponse, type AssetPosition, COLLATERAL_TOKEN_MAP, type ClearinghouseStateResponse, HyperliquidAccountType, type HyperliquidCoinBalance, type LeverageInfo, type MetaResponse, type SpotClearinghouseStateResponse, type SpotStateEvent, type WebData3Event };
+export type { ActiveAssetDataEvent, AllDexsClearinghouseStateEvent, AllPerpMetasResponse, AssetPosition, ClearinghouseStateResponse, LeverageInfo, MetaResponse, SpotClearinghouseStateResponse, SpotStateEvent, UserFillsByTimeResponse, WebData3Event };

package/dist/client/hyperliquid/types.js

@@ -0,0 +1 @@
+

package/dist/client/hyperliquid/ws.d.ts

@@ -0,0 +1,10 @@
+import { BaseWs } from '../base-ws.js';
+import 'partysocket';
+
+declare class HyperliquidWs extends BaseWs {
+    protected getWsUrl(): string;
+    protected getPingIntervalMs(): number;
+    protected buildPingMessage(): null;
+}
+
+export { HyperliquidWs };

package/dist/client/hyperliquid/ws.js

@@ -0,0 +1,16 @@
+import { BaseWs } from '../base-ws';
+
+const HL_WS_URL = "wss://api.hyperliquid.xyz/ws";
+class HyperliquidWs extends BaseWs {
+  getWsUrl() {
+    return HL_WS_URL;
+  }
+  getPingIntervalMs() {
+    return 0;
+  }
+  buildPingMessage() {
+    return null;
+  }
+}
+
+export { HyperliquidWs };

package/dist/client/index.d.ts

@@ -0,0 +1,31 @@
+import { Connector } from '@pear-protocol/types';
+import { SupportedCredentials } from '../types.js';
+import { BinanceExchangeWs } from './binance/exchange-ws.js';
+import { BybitExchangeWs } from './bybit/exchange-ws.js';
+import { HyperliquidExchangeWs } from './hyperliquid/exchange-ws.js';
+import { LighterExchangeWs } from './lighter/exchange-ws.js';
+import { OkxExchangeWs } from './okx/exchange-ws.js';
+export { BaseWs, MessageListener, OpenListener, WsMessage } from './base-ws.js';
+export { BinanceUserDataWs, BinanceUserDataWsConfig, BinanceWsApi, BinanceWsApiConfig } from './binance/ws.js';
+export { BybitWs, BybitWsConfig } from './bybit/ws.js';
+export { ExchangeWs } from './exchange-ws.js';
+export { HyperliquidWs } from './hyperliquid/ws.js';
+export { LighterWs } from './lighter/ws.js';
+export { OkxWs, OkxWsConfig } from './okx/ws.js';
+import '@pear-protocol/core-sdk';
+import 'partysocket';
+
+type ExchangeWsByConnector = {
+    binance: BinanceExchangeWs;
+    bybit: BybitExchangeWs;
+    okx: OkxExchangeWs;
+    hyperliquid: HyperliquidExchangeWs;
+    lighter: LighterExchangeWs;
+};
+type CreateExchangeWsConfig = {
+    demo: boolean;
+    credentials: SupportedCredentials;
+};
+declare function createExchangeWs<E extends Connector>(exchange: E, config: CreateExchangeWsConfig): Promise<ExchangeWsByConnector[E]>;
+
+export { BinanceExchangeWs, BybitExchangeWs, type CreateExchangeWsConfig, type ExchangeWsByConnector, HyperliquidExchangeWs, LighterExchangeWs, OkxExchangeWs, createExchangeWs };

package/dist/client/index.js

@@ -0,0 +1,47 @@
+import { BinanceExchangeWs } from './binance/exchange-ws';
+export { BinanceExchangeWs } from './binance/exchange-ws';
+import { BybitExchangeWs } from './bybit/exchange-ws';
+export { BybitExchangeWs } from './bybit/exchange-ws';
+import { HyperliquidExchangeWs } from './hyperliquid/exchange-ws';
+export { HyperliquidExchangeWs } from './hyperliquid/exchange-ws';
+import { LighterExchangeWs } from './lighter/exchange-ws';
+export { LighterExchangeWs } from './lighter/exchange-ws';
+import { OkxExchangeWs } from './okx/exchange-ws';
+export { OkxExchangeWs } from './okx/exchange-ws';
+export { BaseWs } from './base-ws';
+export { BinanceUserDataWs, BinanceWsApi } from './binance/ws';
+export { BybitWs } from './bybit/ws';
+export { ExchangeWs } from './exchange-ws';
+export { HyperliquidWs } from './hyperliquid/ws';
+export { LighterWs } from './lighter/ws';
+export { OkxWs } from './okx/ws';
+
+async function createExchangeWs(exchange, config) {
+  switch (exchange) {
+    case "binance":
+      return BinanceExchangeWs.create({
+        demo: config.demo,
+        credentials: config.credentials
+      });
+    case "bybit":
+      return BybitExchangeWs.create({
+        demo: config.demo,
+        credentials: config.credentials
+      });
+    case "okx":
+      return OkxExchangeWs.create({
+        demo: config.demo,
+        credentials: config.credentials
+      });
+    case "hyperliquid":
+      return HyperliquidExchangeWs.create();
+    case "lighter":
+      return LighterExchangeWs.create();
+    default: {
+      const _exhaustive = exchange;
+      throw new Error(`Unsupported exchange: ${String(_exhaustive)}`);
+    }
+  }
+}
+
+export { createExchangeWs };

package/dist/client/lighter/constants.d.ts

@@ -0,0 +1,4 @@
+declare const LIGHTER_BASE_URL = "https://mainnet.zklighter.elliot.ai";
+declare const LIGHTER_WS_URL = "wss://mainnet.zklighter.elliot.ai/stream";
+
+export { LIGHTER_BASE_URL, LIGHTER_WS_URL };

package/dist/client/lighter/constants.js

@@ -0,0 +1,4 @@
+const LIGHTER_BASE_URL = "https://mainnet.zklighter.elliot.ai";
+const LIGHTER_WS_URL = "wss://mainnet.zklighter.elliot.ai/stream";
+
+export { LIGHTER_BASE_URL, LIGHTER_WS_URL };

package/dist/client/lighter/exchange-ws.d.ts

@@ -0,0 +1,15 @@
+import { BaseWs } from '../base-ws.js';
+import { ExchangeWs } from '../exchange-ws.js';
+import { LighterWs } from './ws.js';
+import 'partysocket';
+import '@pear-protocol/types';
+
+declare class LighterExchangeWs extends ExchangeWs {
+    main: LighterWs;
+    readonly exchange: "lighter";
+    constructor(main: LighterWs);
+    protected connections(): BaseWs[];
+    static create(): Promise<LighterExchangeWs>;
+}
+
+export { LighterExchangeWs };

package/dist/client/lighter/exchange-ws.js

@@ -0,0 +1,21 @@
+import { ExchangeWs } from '../exchange-ws';
+import { LighterWs } from './ws';
+
+class LighterExchangeWs extends ExchangeWs {
+  constructor(main) {
+    super();
+    this.main = main;
+  }
+  main;
+  exchange = "lighter";
+  connections() {
+    return [this.main];
+  }
+  static async create() {
+    const main = new LighterWs();
+    await main.connect();
+    return new LighterExchangeWs(main);
+  }
+}
+
+export { LighterExchangeWs };

package/dist/client/lighter/rest.d.ts

@@ -0,0 +1,56 @@
+type ApiKey = {
+    account_index: number;
+    api_key_index: number;
+    nonce: number;
+    public_key: string;
+    transaction_time: number;
+};
+type LighterSubAccount = {
+    account_type: number;
+    index: number;
+};
+type LighterAccountResponse = {
+    code: number;
+    message?: string;
+    sub_accounts?: LighterSubAccount[];
+};
+type ApprovedIntegrator = {
+    account_index: number;
+    name: string;
+    max_perps_taker_fee: number;
+    max_perps_maker_fee: number;
+    max_spot_taker_fee: number;
+    max_spot_maker_fee: number;
+    approval_expiry: number;
+};
+type RestPosition = {
+    market_id: number;
+    symbol: string;
+    initial_margin_fraction: string;
+    sign: 1 | -1;
+    position: string;
+    avg_entry_price: string;
+    unrealized_pnl: string;
+    liquidation_price: string;
+    margin_mode: 0 | 1;
+};
+type DetailedAccountResponse = {
+    code: number;
+    message?: string;
+    accounts: {
+        positions: RestPosition[];
+        approved_integrators?: ApprovedIntegrator[];
+    }[];
+};
+type OrderBookDetail = {
+    symbol: string;
+    market_id: number;
+    status: 'active' | 'inactive';
+    default_initial_margin_fraction: number;
+};
+declare function fetchApiKeys(accountIndex: number): Promise<ApiKey[]>;
+declare function fetchAccountsByL1Address(l1Address: string): Promise<LighterAccountResponse>;
+declare function fetchAccount(accountIndex: number): Promise<DetailedAccountResponse>;
+declare function fetchOrderBookDetails(): Promise<OrderBookDetail[]>;
+
+export { type ApiKey, type ApprovedIntegrator, type DetailedAccountResponse, type LighterAccountResponse, type LighterSubAccount, type OrderBookDetail, type RestPosition, fetchAccount, fetchAccountsByL1Address, fetchApiKeys, fetchOrderBookDetails };

package/dist/client/lighter/rest.js

@@ -0,0 +1,27 @@
+import { LIGHTER_BASE_URL } from './constants';
+
+async function fetchApiKeys(accountIndex) {
+  const url = `${LIGHTER_BASE_URL}/api/v1/apikeys?account_index=${accountIndex}`;
+  const response = await fetch(url);
+  if (!response.ok) throw new Error(`Lighter /apikeys returned ${response.status}`);
+  const data = await response.json();
+  return data.api_keys;
+}
+async function fetchAccountsByL1Address(l1Address) {
+  const res = await fetch(`${LIGHTER_BASE_URL}/api/v1/accountsByL1Address?l1_address=${l1Address}`);
+  if (!res.ok) throw new Error(`Lighter /accountsByL1Address returned ${res.status}`);
+  return res.json();
+}
+async function fetchAccount(accountIndex) {
+  const res = await fetch(`${LIGHTER_BASE_URL}/api/v1/account?by=index&value=${accountIndex}`);
+  if (!res.ok) throw new Error(`Lighter /account returned ${res.status}`);
+  return res.json();
+}
+async function fetchOrderBookDetails() {
+  const res = await fetch(`${LIGHTER_BASE_URL}/api/v1/orderBookDetails?filter=perp`);
+  if (!res.ok) throw new Error(`Lighter /orderBookDetails returned ${res.status}`);
+  const data = await res.json();
+  return data.order_book_details;
+}
+
+export { fetchAccount, fetchAccountsByL1Address, fetchApiKeys, fetchOrderBookDetails };