@lifi/perps-sdk-provider-lighter 23.0.0 → 24.0.0

package/dist/types/types/index.d.ts

@@ -4,6 +4,7 @@ export * from './activity.js';
 export * from './asset.js';
 export * from './fill.js';
 export * from './order.js';
+export * from './pnl.js';
 export * from './submit.js';
 export * from './ws.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA"}

package/dist/types/types/pnl.d.ts

@@ -0,0 +1,33 @@
+/**
+ * One PnL bucket. `timestamp` is Unix milliseconds. Every other field is a
+ * JSON number in USD for that bucket alone; the endpoint reports no account
+ * value.
+ *
+ * @public
+ */
+export interface LtPnLEntry {
+    timestamp: number;
+    trade_pnl: number;
+    inflow: number;
+    outflow: number;
+    pool_pnl: number;
+    pool_inflow: number;
+    pool_outflow: number;
+    pool_total_shares: number;
+    spot_inflow: number;
+    spot_outflow: number;
+    staked_lit: number;
+    staking_inflow: number;
+    staking_outflow: number;
+    staking_pnl: number;
+    trade_spot_pnl: number;
+    volume: number;
+}
+/** `GET /api/v1/pnl` response envelope. @public */
+export interface LtAccountPnL {
+    code: number;
+    message?: string;
+    resolution: string;
+    pnl: LtPnLEntry[] | null;
+}
+//# sourceMappingURL=pnl.d.ts.map

package/dist/types/types/pnl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnl.d.ts","sourceRoot":"","sources":["../../../src/types/pnl.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,UAAU,EAAE,GAAG,IAAI,CAAA;CACzB"}

package/dist/types/utils/index.d.ts

@@ -10,6 +10,7 @@ export { mapFill } from './mapFill.js';
 export { mapMarketContext } from './mapMarketContext.js';
 export { mapOpenPositions } from './mapOpenPositions.js';
 export { classifyAndMapOrders, isTriggerOrder, isTriggerType, mapOrder, mapOrderDetail, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { mapPortfolioHistory } from './mapPortfolioHistory.js';
 export { leverageFromImf, mapPosition } from './mapPosition.js';
 export { mapMarketOrderLimits } from './marketLimits.js';
 export { mapInterval } from './ohlcvInterval.js';

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/types/utils/mapPortfolioHistory.d.ts

@@ -0,0 +1,12 @@
+import type { PortfolioHistoryRange, PortfolioHistoryResponse } from '@lifi/perps-types';
+import Big from 'big.js';
+import type { LtPnLEntry } from '../types/pnl.js';
+/**
+ * Build the portfolio series from Lighter PnL buckets and the account's
+ * current value. Lighter reports no historical account value, so each
+ * point's `accountValue` is `currentValue` with every later bucket's
+ * `trade_pnl + trade_spot_pnl + inflow - outflow` removed. `pnl` is the
+ * running `trade_pnl + trade_spot_pnl`, so both series unwind the same PnL.
+ */
+export declare const mapPortfolioHistory: (range: PortfolioHistoryRange, entries: LtPnLEntry[], currentValue: Big) => PortfolioHistoryResponse;
+//# sourceMappingURL=mapPortfolioHistory.d.ts.map

package/dist/types/utils/mapPortfolioHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapPortfolioHistory.d.ts","sourceRoot":"","sources":["../../../src/utils/mapPortfolioHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,GAAG,MAAM,QAAQ,CAAA;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,qBAAqB,EAC5B,SAAS,UAAU,EAAE,EACrB,cAAc,GAAG,KAChB,wBAiCF,CAAA"}

package/dist/types/websocket/LighterWsProvider.d.ts

@@ -41,7 +41,7 @@ export interface LighterWsProviderOptions {
     resolveAuthToken?: LighterAuthTokenResolver;
 }
 /**
- * Lighter realtime WS provider (extends {@link WsProviderBase}): subscribes to
+ * Lighter WebSocket provider (extends {@link WsProviderBase}): subscribes to
  * Lighter's WS channels (orderbook, marketsContext, orders, positions), attaching auth
  * tokens to gated channels. Construct via {@link lighterWsProvider}.
  *

package/dist/types/websocket/LighterWsProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LighterWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/LighterWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAKlB,cAAc,EACd,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AA4EnC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;AAEhC,UAAU,QAAQ;IAChB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAA;CACnB;AAkBD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAA;CAC5C;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAE5B;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,cAAc,CAAoC;IAE1D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2C;IAE9E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqC;gBAGxE,KAAK,GAAE,MAA+B,EACtC,WAAW,GAAE,MAA6B,EAC1C,OAAO,GAAE,wBAA6B,EACtC,MAAM,CAAC,EAAE,cAAc;IAsBzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;OAKG;IACG,cAAc,CAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;cAkBN,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;cAqDhD,OAAO,IAAI,IAAI;cAMlB,aAAa,CAAC,EAC5B,OAAO,EACP,SAAS,EACT,OAAO,GACR,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3B;;;;;;OAMG;YACW,gBAAgB;IAsB9B,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;YA2B5B,cAAc;YAsFd,mBAAmB;YAqBnB,iBAAiB;IAK/B,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAqB1C,OAAO,CAAC,QAAQ;IAkFhB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,eAAe;IAuDvB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,sBAAsB;IAiC9B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,mBAAmB;CAc5B;AAkID;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC3B,UAAU,wBAAwB,KAAG,iBAEmB,CAAA"}
+{"version":3,"file":"LighterWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/LighterWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAKlB,cAAc,EACd,KAAK,iBAAiB,EAGvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AA4EnC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;AAEhC,UAAU,QAAQ;IAChB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAA;CACnB;AAkBD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAA;CAC5C;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAE5B;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,cAAc,CAAoC;IAE1D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2C;IAE9E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqC;gBAGxE,KAAK,GAAE,MAA+B,EACtC,WAAW,GAAE,MAA6B,EAC1C,OAAO,GAAE,wBAA6B,EACtC,MAAM,CAAC,EAAE,cAAc;IAsBzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;OAKG;IACG,cAAc,CAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;cAkBN,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;cA6ChD,OAAO,IAAI,IAAI;cAMlB,aAAa,CAAC,EAC5B,OAAO,EACP,SAAS,EACT,OAAO,GACR,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3B;;;;;;OAMG;YACW,gBAAgB;IAsB9B,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;YAwB5B,cAAc;YAsFd,mBAAmB;YAqBnB,iBAAiB;IAK/B,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAqB1C,OAAO,CAAC,QAAQ;IAkFhB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,eAAe;IAuDvB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,sBAAsB;IAiC9B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,mBAAmB;CAc5B;AAkID;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,wBAAwB,KACjC,iBAKA,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "23.0.0",
+  "version": "24.0.0",
   "description": "Lighter provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -44,10 +44,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.55.18",
-    "@lifi/perps-types": "^12.2.0"
+    "@lifi/perps-types": "^12.3.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^12.1.0"
+    "@lifi/perps-sdk": "^13.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/LighterProvider.ts

@@ -17,6 +17,7 @@ import {
   type ProviderGetMarketSettingsParams,
   type ProviderGetOrderParams,
   type ProviderGetOrdersParams,
+  type ProviderGetPortfolioHistoryParams,
   type ProviderGetPositionsParams,
   type ProviderGetQuoteParams,
   type ProviderGetRunningTwapsParams,
@@ -46,6 +47,8 @@ import type {
   MarketSettings,
   Order,
   OrdersResponse,
+  PortfolioHistoryRange,
+  PortfolioHistoryResponse,
   Position,
   PositionsResponse,
   ProviderAction,
@@ -91,6 +94,7 @@ import type {
   LtAccount,
   LtAccountLimits,
   LtAccountOrdersResponse,
+  LtAccountPnL,
   LtDepositHistoryItem,
   LtDepositHistoryResponse,
   LtDetailedAccountPosition,
@@ -119,6 +123,7 @@ import {
 import {
   LIGHTER_RETRY_DEFAULTS,
   LighterApiClient,
+  LighterAuthRejectedError,
   LighterTokenRevokedError,
 } from './utils/apiClient.js'
 import { isAssetMarginEnabled } from './utils/assetCollateral.js'
@@ -134,6 +139,7 @@ import {
   mapFill,
   mapOpenPositions,
   mapOrderDetail,
+  mapPortfolioHistory,
   positionMarginConstraints,
   toBigOrNull,
   toIsoFromMs,
@@ -181,6 +187,24 @@ const CLIENT_ORDER_INDEX_PATTERN = /^\d+$/
 
 const INACTIVE_ORDERS_LOOKUP_LIMIT = 100
 
+interface PnlWindow {
+  resolution: '1h' | '4h' | '1d'
+  bucketMs: number
+  countBack: number
+}
+
+const HOUR_MS = 60 * 60 * 1000
+const DAY_MS = 24 * HOUR_MS
+
+// `all` has no natural bucket count; 1000 daily buckets reach back past the
+// venue's launch for every account.
+const PNL_WINDOWS: Record<PortfolioHistoryRange, PnlWindow> = {
+  '24h': { resolution: '1h', bucketMs: HOUR_MS, countBack: 24 },
+  '7d': { resolution: '4h', bucketMs: 4 * HOUR_MS, countBack: 42 },
+  '30d': { resolution: '1d', bucketMs: DAY_MS, countBack: 30 },
+  all: { resolution: '1d', bucketMs: DAY_MS, countBack: 1000 },
+}
+
 /** Activity surfaces whose rows name a market, so they need the market registry. */
 const MARKET_BEARING_TYPES: ReadonlySet<ActivityType> = new Set([
   ActivityType.FUNDING,
@@ -1305,6 +1329,71 @@ export const createLighterProvider = (
       }
     },
 
+    async getPortfolioHistory(
+      params: ProviderGetPortfolioHistoryParams,
+      opts?: SDKRequestOptions
+    ): Promise<PortfolioHistoryResponse> {
+      const sdkOwnsToken =
+        opts?.lighterAuthToken === undefined && authTokenSource === undefined
+      const apiKey = sdkOwnsToken ? await keyStore.get(params.address) : null
+      const token = await resolveAuthToken(
+        opts,
+        params.address,
+        apiKey ?? undefined
+      )
+      if (token === undefined) {
+        return { range: params.range, points: [] }
+      }
+
+      const client = apiClient(opts)
+      const account = await fetchDetailedAccount(client, params.address)
+      const window = PNL_WINDOWS[params.range]
+      const endTimestamp = Date.now()
+      const queryParams: Record<string, string | number | boolean> = {
+        by: 'index',
+        value: String(account.index),
+        resolution: window.resolution,
+        start_timestamp:
+          params.range === 'all'
+            ? 0
+            : endTimestamp - window.countBack * window.bucketMs,
+        end_timestamp: endTimestamp,
+        count_back: window.countBack,
+        ignore_transfers: false,
+      }
+      const read = (tok: string) =>
+        client.getAuthed<LtAccountPnL>('/api/v1/pnl', tok, queryParams)
+
+      // The read-only token may not be accepted on `/pnl`; the standard token
+      // is, so a read signed from the SDK's own key retries once with it. The
+      // fallback sits outside `retryOnRevoked`, so a revocation the standard
+      // token reports never replaces the read-only one. The key is re-read at
+      // retry time because `REGISTER_API_KEY` can rotate it.
+      const response = await retryOnRevoked(
+        opts,
+        params.address,
+        token,
+        read
+      ).catch(async (err: unknown) => {
+        if (!(err instanceof LighterAuthRejectedError) || apiKey === null) {
+          throw err
+        }
+        const current = (await keyStore.get(params.address)) ?? apiKey
+        return read(
+          await getStandardAuthToken(params.address, current.apiKeyPrivateKey, {
+            apiKeyIndex: current.apiKeyIndex,
+            accountIndex: current.accountIndex,
+          })
+        )
+      })
+
+      return mapPortfolioHistory(
+        params.range,
+        wireList(response.pnl),
+        toRequiredBig(account.total_asset_value, 'total_asset_value')
+      )
+    },
+
     async getActivity(
       params: ProviderGetActivityParams,
       opts?: SDKRequestOptions

package/src/types/index.ts

@@ -8,5 +8,6 @@ export * from './activity.js'
 export * from './asset.js'
 export * from './fill.js'
 export * from './order.js'
+export * from './pnl.js'
 export * from './submit.js'
 export * from './ws.js'

package/src/types/pnl.ts

@@ -0,0 +1,36 @@
+// Account PnL shapes returned by Lighter's `/api/v1/pnl` endpoint.
+// Lighter serializes an empty list as JSON `null`, so list members are nullable.
+
+/**
+ * One PnL bucket. `timestamp` is Unix milliseconds. Every other field is a
+ * JSON number in USD for that bucket alone; the endpoint reports no account
+ * value.
+ *
+ * @public
+ */
+export interface LtPnLEntry {
+  timestamp: number
+  trade_pnl: number
+  inflow: number
+  outflow: number
+  pool_pnl: number
+  pool_inflow: number
+  pool_outflow: number
+  pool_total_shares: number
+  spot_inflow: number
+  spot_outflow: number
+  staked_lit: number
+  staking_inflow: number
+  staking_outflow: number
+  staking_pnl: number
+  trade_spot_pnl: number
+  volume: number
+}
+
+/** `GET /api/v1/pnl` response envelope. @public */
+export interface LtAccountPnL {
+  code: number
+  message?: string
+  resolution: string
+  pnl: LtPnLEntry[] | null
+}

package/src/utils/index.ts

@@ -25,6 +25,7 @@ export {
   mapStatusReason,
   mapTriggerOrder,
 } from './mapOrder.js'
+export { mapPortfolioHistory } from './mapPortfolioHistory.js'
 export { leverageFromImf, mapPosition } from './mapPosition.js'
 export { mapMarketOrderLimits } from './marketLimits.js'
 export { mapInterval } from './ohlcvInterval.js'

package/src/utils/mapPortfolioHistory.ts

@@ -0,0 +1,52 @@
+import type {
+  PortfolioHistoryRange,
+  PortfolioHistoryResponse,
+} from '@lifi/perps-types'
+import Big from 'big.js'
+import type { LtPnLEntry } from '../types/pnl.js'
+
+/**
+ * Build the portfolio series from Lighter PnL buckets and the account's
+ * current value. Lighter reports no historical account value, so each
+ * point's `accountValue` is `currentValue` with every later bucket's
+ * `trade_pnl + trade_spot_pnl + inflow - outflow` removed. `pnl` is the
+ * running `trade_pnl + trade_spot_pnl`, so both series unwind the same PnL.
+ */
+export const mapPortfolioHistory = (
+  range: PortfolioHistoryRange,
+  entries: LtPnLEntry[],
+  currentValue: Big
+): PortfolioHistoryResponse => {
+  const ordered = [...entries].sort((a, b) => a.timestamp - b.timestamp)
+
+  const accountValues: Big[] = []
+  let value = currentValue
+  for (let i = ordered.length - 1; i >= 0; i -= 1) {
+    accountValues[i] = value
+    const entry = ordered[i]
+    value = value
+      .minus(new Big(entry.trade_pnl))
+      .minus(new Big(entry.trade_spot_pnl))
+      .minus(new Big(entry.inflow))
+      .plus(new Big(entry.outflow))
+  }
+
+  let pnl = new Big(0)
+  let volume = new Big(0)
+  const points = ordered.map((entry, i) => {
+    pnl = pnl.plus(new Big(entry.trade_pnl)).plus(new Big(entry.trade_spot_pnl))
+    volume = volume.plus(new Big(entry.volume))
+    return {
+      timestamp: entry.timestamp,
+      accountValue: accountValues[i].toFixed(),
+      pnl: pnl.toFixed(),
+    }
+  })
+
+  return {
+    range,
+    points,
+    volume: volume.toFixed(),
+    totalPnl: points.at(-1)?.pnl,
+  }
+}

package/src/websocket/LighterWsProvider.ts

@@ -13,6 +13,7 @@ import {
   toPerpsMarketDisplay,
   WsProviderBase,
   type WsProviderFactory,
+  type WsProviderFactoryParams,
   wsLog,
 } from '@lifi/perps-sdk'
 import {
@@ -159,7 +160,7 @@ export interface LighterWsProviderOptions {
 }
 
 /**
- * Lighter realtime WS provider (extends {@link WsProviderBase}): subscribes to
+ * Lighter WebSocket provider (extends {@link WsProviderBase}): subscribes to
  * Lighter's WS channels (orderbook, marketsContext, orders, positions), attaching auth
  * tokens to gated channels. Construct via {@link lighterWsProvider}.
  *
@@ -257,14 +258,6 @@ export class LighterWsProvider extends WsProviderBase<SubState> {
   }
 
   protected async openChannel(sub: Subscription): Promise<() => void> {
-    // Lighter has no live OHLC channel — there's nothing to subscribe to.
-    // Return a no-op unsubscribe so the caller's UX (chart still rendering
-    // from REST history + price-tick mid line) is unaffected, instead of
-    // throwing and surfacing a console error on every chart mount.
-    if (sub.channel === 'candle') {
-      return () => {}
-    }
-
     // Only the auth channels (orders/fills/positions) resolve markets.
     // `marketsContext`/`orderbook` are keyed purely by `String(market_id)`, so
     // gating them on the registry sync would let a failed `/markets` fetch kill
@@ -377,10 +370,7 @@ export class LighterWsProvider extends WsProviderBase<SubState> {
         return `positions:${sub.address.toLowerCase()}`
       case 'accountSummary':
         return `accountSummary:${sub.address.toLowerCase()}`
-      // No live wire sub (openChannel returns a no-op), but a stable key is
-      // still needed so the base's fan-out registry can track/release it.
       case 'candle':
-        return `candle:${sub.marketId}:${sub.interval}`
       case 'spotBalances':
         throw new Error(`Lighter WS does not support channel: ${sub.channel}.`)
     }
@@ -1006,7 +996,11 @@ function collectAuthChannelItems<T>(
  *
  * @public
  */
-export const lighterWsProvider =
-  (options?: LighterWsProviderOptions): WsProviderFactory =>
-  ({ provider, wsUrl, client }) =>
-    new LighterWsProvider(wsUrl, provider, options, client)
+export const lighterWsProvider = (
+  options?: LighterWsProviderOptions
+): WsProviderFactory =>
+  Object.assign(
+    ({ provider, wsUrl, client }: WsProviderFactoryParams) =>
+      new LighterWsProvider(wsUrl, provider, options, client),
+    { streamsCandles: false }
+  )