@pear-protocol/exchanges-sdk 0.6.2 → 0.6.3

package/README.md

@@ -101,7 +101,7 @@ const exchanges = new ExchangesSDK({
 
 Hyperliquid status requires the builder address and the minimum approved fee in tenths of a basis point. Lighter status requires the integrator account and minimum maker/taker approval caps in Lighter fee ticks (parts per million). These thresholds must match the fees configured by the trading backend.
 
-Historical Hyperliquid fill synchronization uses the exchange's globally unique `time:coin:tid` identity. Existing consumers that persisted bare `tid` identifiers must account for the transition overlap. Synchronization also fails closed when the exchange reports a maker rebate: the current core external-fill contract accepts only non-negative fees, so the SDK will not silently turn a rebate into a cost or advance the synchronization watermark past it.
+Historical Hyperliquid fill synchronization identifies fills by bare `tid` and requests them aggregated by time, so partial fills of one crossing order arrive as a single fill. Consumers that persisted composite `time:coin:tid` identifiers must account for the transition overlap. Hyperliquid serves only the 10,000 most recent fills; an account with a longer history imports from that boundary forward, and the snapshot-alignment synthetics cover the residual gap. Synchronization fails closed when the exchange reports a maker rebate: the current core external-fill contract accepts only non-negative fees, so the SDK will not silently turn a rebate into a cost or advance the synchronization watermark past it.
 
 ## Account Status
 

package/dist/syncer/hyperliquid/syncer.js

@@ -64,11 +64,10 @@ class HyperliquidAccountSyncer extends BaseAccountSyncer {
       return acc;
     }, {});
     const allFills = [];
-    const seenFillIds = /* @__PURE__ */ new Set();
+    const seenTids = /* @__PURE__ */ new Set();
     const addFill = (fill) => {
-      const fillId = hyperliquidFillId(fill);
-      if (!seenFillIds.has(fillId)) {
-        seenFillIds.add(fillId);
+      if (!seenTids.has(fill.tid)) {
+        seenTids.add(fill.tid);
         allFills.push(fill);
       }
     };
@@ -80,7 +79,7 @@ class HyperliquidAccountSyncer extends BaseAccountSyncer {
           type: "userFillsByTime",
           user: this.address,
           startTime: cursor,
-          aggregateByTime: false
+          aggregateByTime: true
         },
         this.demo
       );
@@ -104,7 +103,7 @@ class HyperliquidAccountSyncer extends BaseAccountSyncer {
           type: "userTwapSliceFillsByTime",
           user: this.address,
           startTime: cursor,
-          aggregateByTime: false
+          aggregateByTime: true
         },
         this.demo
       );
@@ -131,12 +130,12 @@ class HyperliquidAccountSyncer extends BaseAccountSyncer {
       const tradeFee = new BigNumber(rawFill.fee).minus(rawFill.builderFee ?? "0");
       if (tradeFee.isNegative()) {
         throw new Error(
-          `Hyperliquid fill ${hyperliquidFillId(rawFill)} has a negative net trade fee (${tradeFee.toFixed()}); the backend external-fill contract does not accept Hyperliquid rebates.`
+          `Hyperliquid fill ${rawFill.tid} has a negative net trade fee (${tradeFee.toFixed()}); the backend external-fill contract does not accept Hyperliquid rebates.`
         );
       }
       fills.push({
         connector: "hyperliquid",
-        exchangeFillId: hyperliquidFillId(rawFill),
+        exchangeFillId: rawFill.tid.toFixed(),
         cloid: rawFill.cloid ?? null,
         symbol: instrumentId,
         price: rawFill.px,
@@ -191,9 +190,6 @@ class HyperliquidAccountSyncer extends BaseAccountSyncer {
     return rawFill.dir.includes("Close");
   }
 }
-function hyperliquidFillId(fill) {
-  return `${fill.time}:${fill.coin}:${fill.tid}`;
-}
 function warnStalledPagination(stream, cursor) {
   console.warn(`Hyperliquid ${stream} pagination stalled at timestamp ${cursor}; returned history may be incomplete.`);
 }

package/dist/syncer/hyperliquid/syncer.test.js

@@ -77,18 +77,18 @@ describe("HyperliquidAccountSyncer fill mapping", () => {
     });
     expect(fills).toEqual([
       expect.objectContaining({
-        exchangeFillId: "1700000000000:BTC:456",
+        exchangeFillId: "456",
         tradeFee: "0.8",
         builderFee: "0.2"
       })
     ]);
     expect(fetchInfoMock).toHaveBeenCalledWith(expect.objectContaining({ type: "userFillsByTime" }), true);
     expect(fetchInfoMock).toHaveBeenCalledWith(
-      expect.objectContaining({ type: "userFillsByTime", aggregateByTime: false }),
+      expect.objectContaining({ type: "userFillsByTime", aggregateByTime: true }),
       true
     );
     expect(fetchInfoMock).toHaveBeenCalledWith(
-      expect.objectContaining({ type: "userTwapSliceFillsByTime", aggregateByTime: false }),
+      expect.objectContaining({ type: "userTwapSliceFillsByTime", aggregateByTime: true }),
       true
     );
   });
@@ -125,7 +125,7 @@ describe("HyperliquidAccountSyncer fill mapping", () => {
         provisionalFills: []
       })
     ).rejects.toThrow(
-      "Hyperliquid fill 1700000000000:BTC:456 has a negative net trade fee (-0.1); the backend external-fill contract does not accept Hyperliquid rebates."
+      "Hyperliquid fill 456 has a negative net trade fee (-0.1); the backend external-fill contract does not accept Hyperliquid rebates."
     );
   });
   it("warns when inclusive fill pagination cannot move past the current timestamp", async () => {
@@ -181,7 +181,7 @@ describe("HyperliquidAccountSyncer fill mapping", () => {
       provisionalFills: []
     });
     expect(fills).toHaveLength(1e4);
-    expect(fetchInfoMock).toHaveBeenCalledWith(expect.objectContaining({ aggregateByTime: false }), true);
+    expect(fetchInfoMock).toHaveBeenCalledWith(expect.objectContaining({ aggregateByTime: true }), true);
   });
   it("pages through a full retention window of fills", async () => {
     let page = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/exchanges-sdk",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Pear Protocol Exchanges SDK",
   "private": false,
   "type": "module",