@pear-protocol/exchanges-sdk 0.5.0 → 0.5.2

package/dist/client/lighter/rest.js

@@ -112,12 +112,13 @@ async function fetchPositionFundingSince(accountIndex, authToken, since, demo =
   const results = /* @__PURE__ */ new Map();
   const seenCursors = /* @__PURE__ */ new Set();
   let cursor;
+  const sinceSeconds = Math.max(1, Math.floor(since.getTime() / 1e3));
   do {
     const params = new URLSearchParams({
       account_index: accountIndex.toString(),
       limit: "100",
       side: "all",
-      start_timestamp: since.getTime().toString(),
+      start_timestamp: sinceSeconds.toString(),
       ...cursor ? { cursor } : {}
     });
     const response = await proxyFetch(`${getLighterBaseUrl(demo)}/api/v1/positionFunding?${params.toString()}`, {
@@ -125,7 +126,7 @@ async function fetchPositionFundingSince(accountIndex, authToken, since, demo =
     });
     const data = await readLighterResponse(response, "/positionFunding");
     for (const funding of data.position_fundings ?? []) {
-      if (funding.timestamp >= since.getTime()) {
+      if (funding.timestamp >= sinceSeconds) {
         results.set(`${funding.market_id}:${funding.funding_id}`, funding);
       }
     }
@@ -138,12 +139,17 @@ async function fetchPositionFundingSince(accountIndex, authToken, since, demo =
   return Array.from(results.values());
 }
 async function readLighterResponse(response, endpoint, acceptedCodes = [200]) {
-  if (!response.ok) {
+  let data;
+  try {
+    data = await response.json();
+  } catch {
+    data = void 0;
+  }
+  if (!data) {
     throw new Error(`Lighter ${endpoint} returned ${response.status}`);
   }
-  const data = await response.json();
   if (!acceptedCodes.includes(data.code)) {
-    throw new Error(`Lighter ${endpoint} returned ${data.code}: ${data.message ?? "unknown error"}`);
+    throw new Error(`Lighter ${endpoint} returned ${data.code}: ${data.message ?? `HTTP ${response.status}`}`);
   }
   return data;
 }

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

@@ -8,7 +8,7 @@ describe("Lighter REST client", () => {
   it("routes demo account reads to testnet and rejects exchange-level errors", async () => {
     const fetchMock = vi.fn().mockResolvedValue(
       new Response(JSON.stringify({ code: 20001, message: "account not found" }), {
-        status: 200
+        status: 400
       })
     );
     vi.stubGlobal("fetch", fetchMock);
@@ -24,7 +24,7 @@ describe("Lighter REST client", () => {
       "fetch",
       vi.fn().mockResolvedValue(
         new Response(JSON.stringify({ code: 21100, message: "account not found" }), {
-          status: 200
+          status: 400
         })
       )
     );
@@ -124,9 +124,15 @@ describe("Lighter REST client", () => {
     const rows = await fetchPositionFundingSince(42, "auth", /* @__PURE__ */ new Date(1e3), true);
     expect(rows.map((row) => row.funding_id)).toEqual([1, 2, 3]);
     expect(fetchMock).toHaveBeenCalledTimes(2);
-    expect(String(fetchMock.mock.calls[0]?.[0])).toContain("start_timestamp=1000");
+    expect(String(fetchMock.mock.calls[0]?.[0])).toContain("start_timestamp=1");
     expect(String(fetchMock.mock.calls[1]?.[0])).toContain("cursor=page-2");
   });
+  it("floors an epoch watermark to start_timestamp=1 since Lighter rejects 0 in seconds", async () => {
+    const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ code: 200, position_fundings: [] }), { status: 200 }));
+    vi.stubGlobal("fetch", fetchMock);
+    await fetchPositionFundingSince(42, "auth", /* @__PURE__ */ new Date(0), true);
+    expect(String(fetchMock.mock.calls[0]?.[0])).toContain("start_timestamp=1");
+  });
   it("stops trades pagination when the API repeats a cursor", async () => {
     const page = new Response(JSON.stringify({ code: 200, trades: [], next_cursor: "same-page" }), { status: 200 });
     const fetchMock = vi.fn().mockResolvedValueOnce(page).mockResolvedValueOnce(

package/dist/index.d.ts

@@ -621,7 +621,6 @@ declare enum BybitAccountType {
 
 declare enum HyperliquidAccountType {
     DEFAULT = "default",
-    DEX_ABSTRACTION = "dexAbstraction",
     DISABLED = "disabled",
     PORTFOLIO_MARGIN = "portfolioMargin",
     UNIFIED_ACCOUNT = "unifiedAccount"

package/dist/status/hyperliquid/status.js

@@ -14,7 +14,7 @@ async function checkHyperliquidAccountStatus(config) {
   const approvalAddress = metadata && "isSubaccount" in metadata && metadata.isSubaccount ? metadata.mainAccountAddress : config.account.exchangeIdentifier;
   try {
     const abstraction = await fetchUserAbstraction(config.account.exchangeIdentifier, config.demo);
-    const supportedAccountMode = abstraction === HyperliquidAccountType.DEFAULT || abstraction === HyperliquidAccountType.DISABLED || abstraction === HyperliquidAccountType.UNIFIED_ACCOUNT;
+    const supportedAccountMode = abstraction === HyperliquidAccountType.DEFAULT || abstraction === HyperliquidAccountType.DISABLED || abstraction === HyperliquidAccountType.UNIFIED_ACCOUNT || abstraction === HyperliquidAccountType.PORTFOLIO_MARGIN;
     if (!supportedAccountMode) {
       reasons.push("hyperliquid_account_mode_unsupported");
     }

package/dist/status/hyperliquid/status.test.js

@@ -54,7 +54,7 @@ describe("checkHyperliquidAccountStatus", () => {
     expect(checkApiWalletMock).toHaveBeenCalledWith({ userAddress: mainAccountAddress, agentWalletAddress });
     expect(checkBuilderFeeApprovalMock).toHaveBeenCalledWith(mainAccountAddress, builderAddress, 10);
   });
-  it.each(["portfolioMargin", "dexAbstraction", "somethingNew"])(
+  it.each(["dexAbstraction", "somethingNew"])(
     "warns when account mode %s cannot be represented safely",
     async (abstraction) => {
       fetchUserAbstractionMock.mockResolvedValue(abstraction);
@@ -65,6 +65,11 @@ describe("checkHyperliquidAccountStatus", () => {
       });
     }
   );
+  it("treats Portfolio Margin as a supported account mode", async () => {
+    fetchUserAbstractionMock.mockResolvedValue("portfolioMargin");
+    const status = await checkHyperliquidAccountStatus(statusConfig());
+    expect(status).toEqual({ status: "active", reasons: [] });
+  });
   it("distinguishes an account-mode API failure from an unsupported mode", async () => {
     fetchUserAbstractionMock.mockRejectedValue(new Error("503"));
     const status = await checkHyperliquidAccountStatus(statusConfig());

package/dist/syncer/lighter/funding.js

@@ -16,7 +16,8 @@ function toFundingPaymentEntries(events, instrumentIds) {
       fundingRate: event.rate,
       notional: event.change,
       fundingPerUnit,
-      timestamp: event.timestamp
+      // Lighter reports funding timestamps in seconds; the payment contract expects ms.
+      timestamp: event.timestamp * 1e3
     });
     return entries;
   }, []);

package/dist/syncer/lighter/funding.test.js

@@ -17,7 +17,7 @@ describe("Lighter funding mapping", () => {
         fundingRate: "0.0001",
         notional: "-2",
         fundingPerUnit: "-0.5",
-        timestamp: 1e3
+        timestamp: 1e6
       },
       {
         connector: "lighter",
@@ -25,7 +25,7 @@ describe("Lighter funding mapping", () => {
         fundingRate: "0.0001",
         notional: "2",
         fundingPerUnit: "-0.5",
-        timestamp: 1e3
+        timestamp: 1e6
       }
     ]);
   });

package/dist/syncer/lighter/syncer.test.js

@@ -214,7 +214,7 @@ describe("LighterAccountSyncer funding mapping", () => {
         fundingRate: "0.0001",
         notional: "-2",
         fundingPerUnit: "-0.5",
-        timestamp: 1e3
+        timestamp: 1e6
       }
     ]);
     expect(fetchPositionFundingSince).toHaveBeenCalledWith(ACCOUNT_INDEX, "test-token", /* @__PURE__ */ new Date(1e3), false);

package/dist/tracker/hyperliquid/mapper.js

@@ -84,10 +84,8 @@ function mapBalance(summary, spotCoinBalances, accountType, collateralTokenMap =
     case HyperliquidAccountType.DISABLED:
       return mapStandardBalance(summary, accountType, collateralTokenMap);
     case HyperliquidAccountType.UNIFIED_ACCOUNT:
-      return mapUnifiedBalance(summary, spotCoinBalances, accountType, collateralTokenMap);
-    case HyperliquidAccountType.DEX_ABSTRACTION:
     case HyperliquidAccountType.PORTFOLIO_MARGIN:
-      return null;
+      return mapUnifiedBalance(summary, spotCoinBalances, accountType, collateralTokenMap);
   }
 }
 function mapPositions(raw) {

package/dist/tracker/hyperliquid/mapper.test.js

@@ -220,22 +220,27 @@ describe("Hyperliquid balance mapping", () => {
     const spotBalances = /* @__PURE__ */ new Map([["USDC", { coin: "USDC", token: 0, total: "0", hold: "0" }]]);
     expect(mapBalance(summary, spotBalances, HyperliquidAccountType.UNIFIED_ACCOUNT)?.marginRatio).toBe("1.0000");
   });
-  it("does not fabricate Portfolio Margin or deprecated DEX-abstraction account totals", () => {
-    const sharedState = buildState({
-      accountValue: "100",
-      totalMarginUsed: "10",
-      crossMaintenanceMarginUsed: "5",
-      withdrawable: "90",
+  it("maps Portfolio Margin balances with the same calculation as Unified Account", () => {
+    const state = buildState({
+      accountValue: "999",
+      totalMarginUsed: "30",
+      crossMaintenanceMarginUsed: "10",
+      withdrawable: "999",
       coin: "BTC",
-      unrealizedPnl: "0"
+      unrealizedPnl: "5"
     });
-    const { summary } = aggregateClearinghouseStates([
-      dexState(sharedState, 0),
-      dexState(sharedState, 0, "builder-dex")
+    const { summary } = aggregateClearinghouseStates([dexState(state, 0)]);
+    const spotBalances = /* @__PURE__ */ new Map([
+      ["USDC", { coin: "USDC", token: 0, total: "100", hold: "5", availableAfterMaintenance: "70" }]
     ]);
-    expect(summary.accountValue).toBe("200");
-    expect(mapBalance(summary, /* @__PURE__ */ new Map(), HyperliquidAccountType.DEX_ABSTRACTION)).toBeNull();
-    expect(mapBalance(summary, /* @__PURE__ */ new Map(), HyperliquidAccountType.PORTFOLIO_MARGIN)).toBeNull();
+    const portfolio = mapBalance(summary, spotBalances, HyperliquidAccountType.PORTFOLIO_MARGIN);
+    const unified = mapBalance(summary, spotBalances, HyperliquidAccountType.UNIFIED_ACCOUNT);
+    expect(portfolio).toMatchObject({
+      accountType: "portfolioMargin",
+      totalEquity: "100",
+      availableToTrade: "70"
+    });
+    expect({ ...portfolio, accountType: "unifiedAccount", timestamp: 0 }).toEqual({ ...unified, timestamp: 0 });
   });
   it("returns a zeroed aggregate for an empty DEX list", () => {
     const { summary, assetPositions } = aggregateClearinghouseStates([]);

package/dist/tracker/hyperliquid/tracker.js

@@ -281,13 +281,10 @@ class HyperliquidAccountTracker extends BaseAccountTracker {
     }
   }
   buildBalance() {
-    if (this.accountType === HyperliquidAccountType.DEX_ABSTRACTION || this.accountType === HyperliquidAccountType.PORTFOLIO_MARGIN) {
-      return null;
-    }
     if (!this.hasClearinghouseState || !this.accountType) {
       return void 0;
     }
-    if (this.accountType === HyperliquidAccountType.UNIFIED_ACCOUNT && !this.hasSpotState) {
+    if ((this.accountType === HyperliquidAccountType.UNIFIED_ACCOUNT || this.accountType === HyperliquidAccountType.PORTFOLIO_MARGIN) && !this.hasSpotState) {
       return void 0;
     }
     return mapBalance(this.lastSummary, this.spotCoinBalances, this.accountType, this.collateralTokenMap);

package/dist/tracker/hyperliquid/tracker.test.js

@@ -512,23 +512,33 @@ describe("HyperliquidAccountTracker live account-mode handling", () => {
     expect(updates).toHaveLength(2);
     expect(updates[1]).toBeNull();
   });
-  it("broadcasts explicit null when a live mode becomes known unsupported", () => {
+  it("emits a live Portfolio Margin balance once spot state joins the clearinghouse state", () => {
     const tracker = buildTracker();
     const updates = [];
     tracker.trackBalance((balance) => updates.push(balance));
-    const send = vi.fn();
     const internals = tracker;
-    internals.accountType = HyperliquidAccountType.DEFAULT;
+    internals.accountType = HyperliquidAccountType.PORTFOLIO_MARGIN;
+    internals.hasSpotState = false;
     internals.hasClearinghouseState = false;
-    internals.ws = { send };
     internals.onClearinghouseState({
       user: address,
       clearinghouseStates: [["", dexState("BTC", "100", "10")]]
     });
-    internals.onWebData3(webData("portfolioMargin"));
     expect(tracker.getBalance()).toBeNull();
-    expect(updates).toHaveLength(2);
-    expect(updates[1]).toBeNull();
+    expect(updates).toEqual([]);
+    internals.onSpotState({
+      user: address,
+      spotState: {
+        balances: [{ coin: "USDC", token: 0, total: "100", hold: "5", entryNtl: "0" }],
+        tokenToAvailableAfterMaintenance: [[0, "90"]]
+      }
+    });
+    expect(tracker.getBalance()).toMatchObject({
+      accountType: "portfolioMargin",
+      walletBalance: "90",
+      availableToTrade: "90"
+    });
+    expect(updates).toHaveLength(1);
   });
   it("retains locked BTC active-asset data even without a user listener", () => {
     const tracker = buildTracker();

package/dist/tracker/hyperliquid/types.js

@@ -1,6 +1,5 @@
 var HyperliquidAccountType = /* @__PURE__ */ ((HyperliquidAccountType2) => {
   HyperliquidAccountType2["DEFAULT"] = "default";
-  HyperliquidAccountType2["DEX_ABSTRACTION"] = "dexAbstraction";
   HyperliquidAccountType2["DISABLED"] = "disabled";
   HyperliquidAccountType2["PORTFOLIO_MARGIN"] = "portfolioMargin";
   HyperliquidAccountType2["UNIFIED_ACCOUNT"] = "unifiedAccount";

package/dist/tracker/types.js

@@ -12,7 +12,6 @@ const ACCOUNT_TYPE_LABELS = {
   [BybitAccountType.PORTFOLIO_MARGIN]: "Portfolio Margin",
   [HyperliquidAccountType.DEFAULT]: "Standard",
   [HyperliquidAccountType.DISABLED]: "Standard",
-  [HyperliquidAccountType.DEX_ABSTRACTION]: "Standard (Shared HIP-3 Balance)",
   [HyperliquidAccountType.PORTFOLIO_MARGIN]: "Portfolio Margin",
   [HyperliquidAccountType.UNIFIED_ACCOUNT]: "Unified Account",
   [LighterAccountType.CLASSIC]: "Classic",

package/package.json

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