@pear-protocol/exchanges-sdk 0.4.0 → 0.5.0

package/dist/client/binance/rest.js

@@ -1,3 +1,4 @@
+import { proxyFetch } from '@pear-protocol/utils';
 import { hmacSha256Hex } from '../hmac';
 
 const BASE_URL = "https://fapi.binance.com";
@@ -8,7 +9,7 @@ async function signedGet(creds, path, params, demo) {
   const allParams = { ...params, timestamp, recvWindow: "5000" };
   const queryString = new URLSearchParams(allParams).toString();
   const signature = await hmacSha256Hex(creds.read.api_secret, queryString);
-  const response = await fetch(`${baseUrl}${path}?${queryString}&signature=${signature}`, {
+  const response = await proxyFetch(`${baseUrl}${path}?${queryString}&signature=${signature}`, {
     headers: { "X-MBX-APIKEY": creds.read.api_key }
   });
   if (!response.ok) {
@@ -20,7 +21,7 @@ async function signedGet(creds, path, params, demo) {
 }
 async function createListenKey(apiKey, demo = false) {
   const baseUrl = demo ? BASE_URL_TESTNET : BASE_URL;
-  const response = await fetch(`${baseUrl}/fapi/v1/listenKey`, {
+  const response = await proxyFetch(`${baseUrl}/fapi/v1/listenKey`, {
     method: "POST",
     headers: { "X-MBX-APIKEY": apiKey }
   });
@@ -32,7 +33,7 @@ async function createListenKey(apiKey, demo = false) {
 }
 async function keepAliveListenKey(apiKey, demo = false) {
   const baseUrl = demo ? BASE_URL_TESTNET : BASE_URL;
-  const response = await fetch(`${baseUrl}/fapi/v1/listenKey`, {
+  const response = await proxyFetch(`${baseUrl}/fapi/v1/listenKey`, {
     method: "PUT",
     headers: { "X-MBX-APIKEY": apiKey }
   });

package/dist/client/bybit/rest.js

@@ -1,3 +1,4 @@
+import { proxyFetch } from '@pear-protocol/utils';
 import { hmacSha256Hex } from '../hmac';
 
 const BASE_URL = "https://api.bybit.com";
@@ -9,7 +10,7 @@ async function signedGet(creds, path, params, demo) {
   const queryString = new URLSearchParams(params).toString();
   const signPayload = `${timestamp}${creds.api_key}${recvWindow}${queryString}`;
   const signature = await hmacSha256Hex(creds.api_secret, signPayload);
-  const response = await fetch(`${baseUrl}${path}?${queryString}`, {
+  const response = await proxyFetch(`${baseUrl}${path}?${queryString}`, {
     headers: {
       "X-BAPI-API-KEY": creds.api_key,
       "X-BAPI-SIGN": signature,

package/dist/client/hyperliquid/rest.js

@@ -1,10 +1,12 @@
+import { proxyFetch } from '@pear-protocol/utils';
+
 const HL_INFO_URLS = {
   mainnet: "https://api.hyperliquid.xyz/info",
   testnet: "https://api.hyperliquid-testnet.xyz/info"
 };
 async function fetchInfo(body, demo = false) {
   const url = demo ? HL_INFO_URLS.testnet : HL_INFO_URLS.mainnet;
-  const res = await fetch(url, {
+  const res = await proxyFetch(url, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(body)

package/dist/client/lighter/rest.js

@@ -1,8 +1,9 @@
+import { proxyFetch } from '@pear-protocol/utils';
 import { getLighterBaseUrl } from './constants';
 
 async function fetchApiKeys(accountIndex, demo = false) {
   const url = `${getLighterBaseUrl(demo)}/api/v1/apikeys?account_index=${accountIndex}`;
-  const response = await fetch(url);
+  const response = await proxyFetch(url);
   const data = await readLighterResponse(response, "/apikeys");
   return data.api_keys;
 }
@@ -16,7 +17,7 @@ async function fetchAccountsByL1Address(l1Address, demo = false) {
       l1_address: l1Address,
       ...cursor ? { cursor } : {}
     });
-    const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/accountsByL1Address?${params.toString()}`);
+    const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/accountsByL1Address?${params.toString()}`);
     const data = await readLighterResponse(response, "/accountsByL1Address", [200, 21100]);
     if (data.code === 21100) return data;
     message ??= data.message;
@@ -36,22 +37,25 @@ async function fetchAccountsByL1Address(l1Address, demo = false) {
   };
 }
 async function fetchAccount(accountIndex, demo = false) {
-  const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/account?by=index&value=${accountIndex}`);
+  const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/account?by=index&value=${accountIndex}`);
   return readLighterResponse(response, "/account");
 }
 async function fetchAccountLimits(accountIndex, authToken, demo = false) {
-  const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/accountLimits?account_index=${accountIndex}`, {
+  const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/accountLimits?account_index=${accountIndex}`, {
     headers: { authorization: authToken }
   });
   return readLighterResponse(response, "/accountLimits");
 }
 async function fetchAccountMetadata(accountIndex, authToken, demo = false) {
-  const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/accountMetadata?by=index&value=${accountIndex}`, {
-    headers: {
-      accept: "application/json",
-      authorization: authToken
+  const response = await proxyFetch(
+    `${getLighterBaseUrl(demo)}/api/v1/accountMetadata?by=index&value=${accountIndex}`,
+    {
+      headers: {
+        accept: "application/json",
+        authorization: authToken
+      }
     }
-  });
+  );
   const data = await readLighterResponse(response, "/accountMetadata");
   const matchesAccount = data.account_metadatas?.some((metadata) => metadata.account_index === accountIndex);
   if (!matchesAccount) {
@@ -59,12 +63,12 @@ async function fetchAccountMetadata(accountIndex, authToken, demo = false) {
   }
 }
 async function fetchOrderBookDetails(demo = false) {
-  const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/orderBookDetails?filter=perp`);
+  const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/orderBookDetails?filter=perp`);
   const data = await readLighterResponse(response, "/orderBookDetails");
   return data.order_book_details;
 }
 async function fetchAssetDetails(demo) {
-  const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/assetDetails`);
+  const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/assetDetails`);
   const data = await readLighterResponse(response, "/assetDetails");
   return data.asset_details;
 }
@@ -85,7 +89,7 @@ async function fetchTradesSince(accountIndex, authToken, since, demo = false) {
       aggregate: "false",
       ...cursor ? { cursor } : {}
     });
-    const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/trades?${params.toString()}`, {
+    const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/trades?${params.toString()}`, {
       headers: { authorization: authToken }
     });
     const data = await readLighterResponse(response, "/trades");
@@ -116,7 +120,7 @@ async function fetchPositionFundingSince(accountIndex, authToken, since, demo =
       start_timestamp: since.getTime().toString(),
       ...cursor ? { cursor } : {}
     });
-    const response = await fetch(`${getLighterBaseUrl(demo)}/api/v1/positionFunding?${params.toString()}`, {
+    const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/positionFunding?${params.toString()}`, {
       headers: { authorization: authToken }
     });
     const data = await readLighterResponse(response, "/positionFunding");

package/dist/client/lighter/rest.test.js

@@ -13,7 +13,7 @@ describe("Lighter REST client", () => {
     );
     vi.stubGlobal("fetch", fetchMock);
     await expect(fetchAccount(42, true)).rejects.toThrow("Lighter /account returned 20001: account not found");
-    expect(fetchMock).toHaveBeenCalledWith("https://testnet.zklighter.elliot.ai/api/v1/account?by=index&value=42");
+    expect(fetchMock.mock.calls[0]?.[0]).toBe("https://testnet.zklighter.elliot.ai/api/v1/account?by=index&value=42");
   });
   it("rejects HTTP failures before reading endpoint data", async () => {
     vi.stubGlobal("fetch", vi.fn().mockResolvedValue(new Response("unavailable", { status: 503 })));
@@ -98,7 +98,7 @@ describe("Lighter REST client", () => {
     await expect(fetchAssetDetails(false)).resolves.toEqual([
       { asset_id: 1, symbol: "ETH", l1_decimals: 18, decimals: 8 }
     ]);
-    expect(fetchMock).toHaveBeenCalledWith("https://mainnet.zklighter.elliot.ai/api/v1/assetDetails");
+    expect(fetchMock.mock.calls[0]?.[0]).toBe("https://mainnet.zklighter.elliot.ai/api/v1/assetDetails");
   });
   it("paginates and de-duplicates funding rows by market and funding id", async () => {
     const duplicate = fundingRow({ funding_id: 2, timestamp: 2e3 });

package/dist/client/okx/rest.js

@@ -1,3 +1,4 @@
+import { proxyFetch } from '@pear-protocol/utils';
 import { hmacSha256Base64 } from '../hmac';
 
 const REST_BASE_URL = "https://www.okx.com";
@@ -17,7 +18,7 @@ async function signedGet(creds, path, params, demo) {
   if (demo) {
     headers["x-simulated-trading"] = "1";
   }
-  const response = await fetch(`${REST_BASE_URL}${fullPath}`, { headers });
+  const response = await proxyFetch(`${REST_BASE_URL}${fullPath}`, { headers });
   if (!response.ok) {
     throw new Error(`OKX API error: ${response.status} ${response.statusText}`);
   }

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { HttpTypes, Connector, BinanceCredentialsDTO, BybitCredentialsDTO, OkxCredentialsDTO, TradeAccount } from '@pear-protocol/types';
 import PearSDK from '@pear-protocol/core-sdk';
+import { ProxyConfig } from '@pear-protocol/utils';
 import { WebSocket } from 'partysocket';
 import { WalletClient, Transport, Chain, Account } from 'viem';
 
@@ -8,6 +9,12 @@ type ExchangesSDKConfig = {
     sdk: PearSDK;
     demo?: boolean;
     options?: ConnectOptions;
+    /**
+     * Optional forward-proxy for the exchange REST calls. When enabled, requests are re-pointed at
+     * `proxy.url` with the original venue host in `X-Proxy-Target`. Injected here because the SDK
+     * also runs in the browser, where env vars are unavailable.
+     */
+    proxy?: ProxyConfig;
 };
 type AccountHealthStatus = 'active' | 'warning';
 type AccountWarningReason = 'lighter_api_key_invalid' | 'lighter_integrator_not_approved' | 'hyperliquid_api_wallet_invalid' | 'hyperliquid_builder_fee_not_approved' | 'hyperliquid_account_mode_check_failed' | 'hyperliquid_account_mode_unsupported' | 'api_key_invalid';

package/dist/sdk.js

@@ -1,3 +1,4 @@
+import { configureProxy } from '@pear-protocol/utils';
 import './helper';
 import { createExchangeHelper } from './helper/factory';
 import { checkAccountStatus } from './status';
@@ -12,6 +13,7 @@ class ExchangesSDK {
     this.sdk = config.sdk;
     this.demo = config.demo ?? false;
     this.options = config.options;
+    if (config.proxy) configureProxy(config.proxy);
   }
   async connect(tradeAccountId) {
     return this.fetchCredentials(tradeAccountId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/exchanges-sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Pear Protocol Exchanges SDK",
   "private": false,
   "type": "module",
@@ -27,9 +27,9 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@pear-protocol/core-sdk": "^1.5.0",
-    "@pear-protocol/types": "^1.6.0",
-    "@pear-protocol/utils": "^0.1.0",
+    "@pear-protocol/core-sdk": "^1.7.0",
+    "@pear-protocol/types": "^1.9.0",
+    "@pear-protocol/utils": "^0.2.0",
     "bignumber.js": "^11.1.1",
     "partysocket": "^1.0.3",
     "viem": "^2.48.8"