@pear-protocol/exchanges-sdk 0.0.1

package/dist/account/types.d.ts

@@ -0,0 +1,81 @@
+import { Connector, BinanceUSDMCredentialsDTO, BybitCredentialsDTO } from '@pear-protocol/types';
+
+type MarginMode = 'cross' | 'isolated';
+interface AssetBalance {
+    asset: string;
+    free: string;
+    used: string;
+    total: string;
+    walletBalance: string;
+    unrealizedPnl: string;
+    usdValue: string;
+    initialMargin: string;
+    maintenanceMargin: string;
+    isCollateral: boolean;
+    collateralRatio: string;
+    borrowedAmount: string;
+}
+interface AccountBalance {
+    exchange: string;
+    accountType: string;
+    marginMode: string;
+    free: Record<string, string>;
+    used: Record<string, string>;
+    total: Record<string, string>;
+    availableToTrade: string;
+    totalEquity: string;
+    walletBalance: string;
+    unrealizedPnl: string;
+    initialMarginUsed: string;
+    maintenanceMargin: string;
+    marginRatio: string;
+    assets: AssetBalance[];
+    timestamp: number;
+}
+interface AccountPosition {
+    symbol: string;
+    side: 'long' | 'short' | 'both';
+    size: string;
+    entryPrice: string;
+    unrealizedPnl: string;
+    leverage: string;
+    marginType: MarginMode;
+    liquidationPrice: string | null;
+}
+interface TrackedAssetInfo {
+    coin: string;
+    leverage: string;
+    marginType: MarginMode;
+    availableToTrade: [string, string] | null;
+    maxTradeSzs: [string, string] | null;
+    collateralToken: string | null;
+}
+interface ExchangeState {
+    balance: AccountBalance | null;
+    positions: Map<string, AccountPosition>;
+    leverageSettings: Map<string, string>;
+    trackedAssets: Map<string, TrackedAssetInfo>;
+    lastUpdated: number;
+    initialized: boolean;
+}
+type BalanceCallback = (balance: AccountBalance) => void;
+type PositionsCallback = (positions: AccountPosition[]) => void;
+type TrackedAssetCallback = (info: TrackedAssetInfo) => void;
+interface Tracker<T> {
+    get(): T;
+    untrack(): void;
+}
+interface AccountConfig {
+    exchange: Connector;
+    demo?: boolean;
+    onAuthError?: () => void;
+}
+type SupportedCredentials = BinanceUSDMCredentialsDTO | BybitCredentialsDTO;
+interface StateUpdate {
+    balance?: AccountBalance;
+    positions?: Map<string, AccountPosition>;
+    leverageSettings?: Map<string, string>;
+    trackedAssets?: Map<string, TrackedAssetInfo>;
+}
+
+export type { AccountBalance, AccountConfig, AccountPosition, AssetBalance, BalanceCallback, ExchangeState, MarginMode, PositionsCallback, StateUpdate, SupportedCredentials, TrackedAssetCallback, TrackedAssetInfo, Tracker };

package/dist/account/types.js

@@ -0,0 +1 @@
+

package/dist/account/utils.d.ts

@@ -0,0 +1,7 @@
+import { ExchangeState } from './types.js';
+import '@pear-protocol/types';
+
+declare function createEmptyState(): ExchangeState;
+declare function positionKey(symbol: string, side: string): string;
+
+export { createEmptyState, positionKey };

package/dist/account/utils.js

@@ -0,0 +1,15 @@
+function createEmptyState() {
+  return {
+    balance: null,
+    positions: /* @__PURE__ */ new Map(),
+    leverageSettings: /* @__PURE__ */ new Map(),
+    trackedAssets: /* @__PURE__ */ new Map(),
+    lastUpdated: 0,
+    initialized: false
+  };
+}
+function positionKey(symbol, side) {
+  return `${symbol}:${side}`;
+}
+
+export { createEmptyState, positionKey };

package/dist/credentials.d.ts

@@ -0,0 +1,28 @@
+import PearSDK from '@pear-protocol/core-sdk';
+import { Connector, ConnectorCredentialsDTO } from '@pear-protocol/types';
+
+declare class Credentials {
+    private sdk;
+    private cache;
+    constructor(sdk: PearSDK);
+    /**
+     * Fetch exchange credentials from the backend and cache them in memory.
+     */
+    fetch<T extends Connector>(tradeAccountId: string): Promise<ConnectorCredentialsDTO[T]>;
+    /**
+     * Get previously fetched credentials from the in-memory cache.
+     * Returns null if not yet fetched in this SDK instance.
+     */
+    get<T extends Connector>(tradeAccountId: string): ConnectorCredentialsDTO[T] | null;
+    /**
+     * Get credentials from in-memory cache or fetch from the backend if not available.
+     */
+    getOrFetch<T extends Connector>(tradeAccountId: string): Promise<ConnectorCredentialsDTO[T]>;
+    /**
+     * Clear in-memory credentials for a specific trade account,
+     * or all cached credentials if no ID is provided.
+     */
+    clear(tradeAccountId?: string): void;
+}
+
+export { Credentials };

package/dist/credentials.js

@@ -0,0 +1,46 @@
+class Credentials {
+  sdk;
+  cache = /* @__PURE__ */ new Map();
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  /**
+   * Fetch exchange credentials from the backend and cache them in memory.
+   */
+  async fetch(tradeAccountId) {
+    const response = await this.sdk.info.accounts.credentials(tradeAccountId);
+    const credentials = response.credentials;
+    this.cache.set(tradeAccountId, { credentials, connector: response.connector });
+    return credentials;
+  }
+  /**
+   * Get previously fetched credentials from the in-memory cache.
+   * Returns null if not yet fetched in this SDK instance.
+   */
+  get(tradeAccountId) {
+    const cached = this.cache.get(tradeAccountId);
+    if (!cached) return null;
+    return cached.credentials;
+  }
+  /**
+   * Get credentials from in-memory cache or fetch from the backend if not available.
+   */
+  async getOrFetch(tradeAccountId) {
+    const cached = this.get(tradeAccountId);
+    if (cached) return cached;
+    return await this.fetch(tradeAccountId);
+  }
+  /**
+   * Clear in-memory credentials for a specific trade account,
+   * or all cached credentials if no ID is provided.
+   */
+  clear(tradeAccountId) {
+    if (tradeAccountId) {
+      this.cache.delete(tradeAccountId);
+    } else {
+      this.cache.clear();
+    }
+  }
+}
+
+export { Credentials };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import PearSDK from '@pear-protocol/core-sdk';
+import { AccountManager } from './account/account-manager.js';
+export { ExchangeAccount } from './account/exchange-account.js';
+export { createOrchestrator } from './account/exchanges/index.js';
+export { AccountBalance, AccountConfig, AccountPosition, AssetBalance, BalanceCallback, ExchangeState, MarginMode, PositionsCallback, StateUpdate, SupportedCredentials, TrackedAssetCallback, TrackedAssetInfo, Tracker } from './account/types.js';
+import { Credentials } from './credentials.js';
+export { Orchestrator, OrchestratorConfig } from './account/exchanges/base.js';
+import '@pear-protocol/types';
+
+type ExchangesSDKConfig = {
+    sdk: PearSDK;
+    demo?: boolean;
+};
+declare class ExchangesSDK {
+    credentials: Credentials;
+    account: AccountManager;
+    sdk: PearSDK;
+    constructor(config: ExchangesSDKConfig);
+    destroy(): void;
+}
+
+export { AccountManager, Credentials, ExchangesSDK, type ExchangesSDKConfig };

package/dist/index.js

@@ -0,0 +1,21 @@
+import { AccountManager } from './account';
+export * from './account';
+import { Credentials } from './credentials';
+export * from './credentials';
+
+class ExchangesSDK {
+  credentials;
+  account;
+  sdk;
+  constructor(config) {
+    this.sdk = config.sdk;
+    this.credentials = new Credentials(config.sdk);
+    this.account = new AccountManager(this.credentials, config.demo);
+  }
+  destroy() {
+    this.account.destroy();
+    this.credentials.clear();
+  }
+}
+
+export { ExchangesSDK };

package/dist/utils/hmac.d.ts

@@ -0,0 +1,4 @@
+declare function hmacSha256Hex(secret: string, message: string): Promise<string>;
+declare function hmacSha256Base64(secret: string, message: string): Promise<string>;
+
+export { hmacSha256Base64, hmacSha256Hex };

package/dist/utils/hmac.js

@@ -0,0 +1,17 @@
+const encoder = new TextEncoder();
+async function hmacSha256Hex(secret, message) {
+  const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, [
+    "sign"
+  ]);
+  const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(message));
+  return Array.from(new Uint8Array(signature)).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function hmacSha256Base64(secret, message) {
+  const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, [
+    "sign"
+  ]);
+  const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(message));
+  return btoa(String.fromCharCode(...new Uint8Array(signature)));
+}
+
+export { hmacSha256Base64, hmacSha256Hex };

package/dist/utils/ws.d.ts

@@ -0,0 +1,7 @@
+declare function reconnectDelay(attempt: number): number;
+declare function connectWs(url: string): Promise<WebSocket>;
+declare function sendWs(ws: WebSocket | null, msg: Record<string, unknown> | string): void;
+declare function clearTimer(timer: ReturnType<typeof setTimeout> | null): null;
+declare function clearIntervalTimer(timer: ReturnType<typeof setInterval> | null): null;
+
+export { clearIntervalTimer, clearTimer, connectWs, reconnectDelay, sendWs };

package/dist/utils/ws.js

@@ -0,0 +1,25 @@
+function reconnectDelay(attempt) {
+  return Math.min(1e3 * 2 ** (attempt - 1), 3e4);
+}
+function connectWs(url) {
+  return new Promise((resolve, reject) => {
+    const ws = new WebSocket(url);
+    ws.onopen = () => resolve(ws);
+    ws.onerror = () => reject(new Error(`WebSocket connection failed: ${url}`));
+  });
+}
+function sendWs(ws, msg) {
+  if (ws?.readyState === WebSocket.OPEN) {
+    ws.send(typeof msg === "string" ? msg : JSON.stringify(msg));
+  }
+}
+function clearTimer(timer) {
+  if (timer) clearTimeout(timer);
+  return null;
+}
+function clearIntervalTimer(timer) {
+  if (timer) clearInterval(timer);
+  return null;
+}
+
+export { clearIntervalTimer, clearTimer, connectWs, reconnectDelay, sendWs };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@pear-protocol/exchanges-sdk",
+  "version": "0.0.1",
+  "description": "Pear Protocol Exchanges SDK",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist .turbo",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pear-protocol/core-sdk": "0.0.3",
+    "@pear-protocol/types": "0.0.3"
+  },
+  "devDependencies": {
+    "@backend/typescript-config": "workspace:*",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
+  }
+}