@pear-protocol/exchanges-sdk 0.1.10 → 0.1.11

package/dist/index.d.ts

@@ -470,7 +470,7 @@ declare class LighterAccountSyncer extends BaseAccountSyncer<LighterRawTrade> {
     private getPositionSizeBefore;
     private getTradeFee;
     private getIntegratorFee;
-    private feeTickToDecimal;
+    private feeTickToAmount;
 }
 
 interface OkxRawFill {

package/dist/syncer/lighter/syncer.js

@@ -44,8 +44,8 @@ class LighterAccountSyncer extends BaseAccountSyncer {
         side,
         reduceOnly: this.isReduceOnly(trade),
         timestamp: trade.timestamp,
-        tradeFee: this.feeTickToDecimal(this.getTradeFee(trade, accountSide)),
-        builderFee: this.feeTickToDecimal(this.getIntegratorFee(trade, accountSide)),
+        tradeFee: this.getTradeFee(trade, accountSide),
+        builderFee: this.getIntegratorFee(trade, accountSide),
         liquidation: trade.type === "liquidation" ? { mark: trade.price } : null
       });
       return acc;
@@ -81,13 +81,17 @@ class LighterAccountSyncer extends BaseAccountSyncer {
     return new BigNumber(value ?? 0);
   }
   getTradeFee(trade, side) {
-    return this.isMaker(trade, side) ? trade.maker_fee ?? 0 : trade.taker_fee ?? 0;
+    const rateTick = this.isMaker(trade, side) ? trade.maker_fee : trade.taker_fee;
+    return this.feeTickToAmount(rateTick, trade.usd_amount);
   }
   getIntegratorFee(trade, side) {
-    return this.isMaker(trade, side) ? trade.integrator_maker_fee ?? 0 : trade.integrator_taker_fee ?? 0;
+    const rateTick = this.isMaker(trade, side) ? trade.integrator_maker_fee : trade.integrator_taker_fee;
+    return this.feeTickToAmount(rateTick, trade.usd_amount);
   }
-  feeTickToDecimal(value) {
-    return new BigNumber(value).abs().div(LIGHTER_FEE_TICK_DENOMINATOR).toFixed();
+  // Lighter fees come as ppm rates (÷1e6), not amounts — the charged fee is that rate times the trade's USD notional.
+  feeTickToAmount(rateTick, usdAmount) {
+    const rate = new BigNumber(rateTick ?? 0).abs().div(LIGHTER_FEE_TICK_DENOMINATOR);
+    return rate.times(usdAmount).toFixed();
   }
 }
 

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

@@ -0,0 +1,148 @@
+import { vi, describe, beforeEach, it, expect } from 'vitest';
+import { fetchTradesSince } from '../../client/lighter/rest';
+import { LighterAccountSyncer } from './syncer';
+
+vi.mock("../../client/lighter/rest", () => ({
+  fetchTradesSince: vi.fn()
+}));
+const ACCOUNT_INDEX = 87440;
+const TRADES = [
+  {
+    // Real /trades row — account is taker via bid, integrator fee only:
+    // builderFee = 200/1e6 × 49.279769, tradeFee = 0.
+    trade_id: 23432371018,
+    trade_id_str: "23432371018",
+    type: "trade",
+    market_id: 1,
+    size: "0.00077",
+    price: "63999.7",
+    usd_amount: "49.279769",
+    ask_account_id: 281474976656674,
+    bid_account_id: ACCOUNT_INDEX,
+    is_maker_ask: true,
+    timestamp: 1782044759045,
+    taker_position_size_before: "0.00000",
+    maker_position_size_before: "0.00000",
+    integrator_taker_fee: 200
+  },
+  {
+    // Real /trades row — account is taker via ask, base taker fee only:
+    // tradeFee = 280/1e6 × 11.896090, builderFee = 0.
+    trade_id: 22207283246,
+    trade_id_str: "22207283246",
+    type: "trade",
+    market_id: 1,
+    size: "0.00019",
+    price: "62611.0",
+    usd_amount: "11.896090",
+    ask_account_id: ACCOUNT_INDEX,
+    bid_account_id: 587622,
+    is_maker_ask: false,
+    timestamp: 1781010160339,
+    taker_fee: 280,
+    taker_position_size_before: "0.00019",
+    maker_position_size_before: "0.00000"
+  },
+  {
+    // Real /trades row — no fee fields at all, so both fees resolve to 0.
+    trade_id: 23432472386,
+    trade_id_str: "23432472386",
+    type: "trade",
+    market_id: 1,
+    size: "0.00079",
+    price: "63973.6",
+    usd_amount: "50.539144",
+    ask_account_id: 726722,
+    bid_account_id: ACCOUNT_INDEX,
+    is_maker_ask: true,
+    timestamp: 1782044888766,
+    taker_position_size_before: "-0.00079",
+    maker_position_size_before: "0.00000"
+  },
+  {
+    // Synthetic row — the real payload only carries taker-side fees, so we construct a
+    // maker fill (account is the resting ask) to cover the maker_fee / integrator_maker_fee branch:
+    // tradeFee = 100/1e6 × 100, builderFee = 50/1e6 × 100.
+    trade_id: 90000000001,
+    trade_id_str: "90000000001",
+    type: "trade",
+    market_id: 1,
+    size: "0.00100",
+    price: "65000.0",
+    usd_amount: "100.000000",
+    ask_account_id: ACCOUNT_INDEX,
+    bid_account_id: 726722,
+    is_maker_ask: true,
+    timestamp: 178205e7,
+    maker_fee: 100,
+    taker_position_size_before: "0.00000",
+    maker_position_size_before: "0.00000",
+    integrator_maker_fee: 50
+  }
+];
+function createSyncer() {
+  const sdk = {
+    core: { misc: { lighter: { createAuthToken: vi.fn().mockResolvedValue({ token: "test-token" }) } } }
+  };
+  const config = {
+    sdk,
+    connector: "lighter",
+    account: { exchangeIdentifier: String(ACCOUNT_INDEX) },
+    credentials: { api_key_index: 0, api_private_key: "test-key" },
+    ws: {},
+    demo: false
+  };
+  return new LighterAccountSyncer(config);
+}
+async function listFills() {
+  const syncer = createSyncer();
+  const params = {
+    since: /* @__PURE__ */ new Date(0),
+    instruments: [{ id: "1" }],
+    openPositions: [],
+    provisionalFills: []
+  };
+  return syncer.listExternalFills(params);
+}
+const byId = (fills, id) => fills.find((fill) => fill.exchangeFillId === id);
+describe("LighterAccountSyncer fee mapping", () => {
+  beforeEach(() => {
+    vi.mocked(fetchTradesSince).mockResolvedValue(TRADES);
+  });
+  it("computes the integrator (builder) fee as the taker ppm rate times the USD notional", async () => {
+    const fills = await listFills();
+    expect(byId(fills, "23432371018")).toMatchObject({
+      symbol: "1",
+      side: "BUY",
+      tradeFee: "0",
+      builderFee: "0.0098559538"
+    });
+  });
+  it("computes the trade fee as the base taker ppm rate times the USD notional", async () => {
+    const fills = await listFills();
+    expect(byId(fills, "22207283246")).toMatchObject({
+      symbol: "1",
+      side: "SELL",
+      tradeFee: "0.0033309052",
+      builderFee: "0"
+    });
+  });
+  it("emits zero fees when the trade carries no fee fields", async () => {
+    const fills = await listFills();
+    expect(byId(fills, "23432472386")).toMatchObject({
+      symbol: "1",
+      side: "BUY",
+      tradeFee: "0",
+      builderFee: "0"
+    });
+  });
+  it("reads the maker-side fee fields when the account is the maker", async () => {
+    const fills = await listFills();
+    expect(byId(fills, "90000000001")).toMatchObject({
+      symbol: "1",
+      side: "SELL",
+      tradeFee: "0.01",
+      builderFee: "0.005"
+    });
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/exchanges-sdk",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Pear Protocol Exchanges SDK",
   "private": false,
   "type": "module",
@@ -22,6 +22,7 @@
   "scripts": {
     "build": "tsup",
     "clean": "rm -rf dist .turbo",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
@@ -35,6 +36,7 @@
   "devDependencies": {
     "@backend/typescript-config": "workspace:*",
     "tsup": "8.5.1",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "vitest": "4.1.2"
   }
 }