@lifi/perps-sdk-provider-lighter 31.0.1 → 32.0.0

package/dist/esm/utils/orderFormatting.js

@@ -1,40 +1,40 @@
 /**
- * Lighter order size and price formatting for exchange submission.
+ * Lighter order size and price snapping for exchange submission.
  *
  * Lighter publishes a flat per-market decimal budget on its order books
  * (`supported_price_decimals` / `supported_size_decimals`), surfaced on the
- * generic {@link Market} as `priceDecimals` / `szDecimals`. Prices round to
- * the tick grid; sizes truncate to the lot grid.
+ * generic {@link Market} as `priceDecimals` / `szDecimals`. Prices round onto
+ * the tick grid; sizes truncate onto the lot grid.
  */
 import { PerpsError } from '@lifi/perps-sdk';
-import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsErrorCode, } from '@lifi/perps-types';
 import Big from 'big.js';
 /**
- * Format a price onto a Lighter market's tick grid: rounded to the market's
- * `priceDecimals` (Lighter's `supported_price_decimals`), trailing zeros
- * stripped.
+ * Snap a price onto a Lighter market's tick grid: rounded half-up to the
+ * market's `priceDecimals` (Lighter's `supported_price_decimals`), trailing
+ * zeros stripped.
  *
  * @throws {PerpsError} `ValidationError` when `market.priceDecimals` is
  *   absent — without the venue's tick grid no correct price can be produced.
  * @public
  */
-export function formatOrderPrice(market, price) {
+export function snapOrderPrice(market, price) {
     if (market.priceDecimals === undefined) {
         throw new PerpsError(PerpsErrorCode.ValidationError, `Market '${market.id}' carries no priceDecimals; Lighter order prices ` +
-            `cannot be formatted without the market's tick grid.`);
+            `cannot be snapped without the market's tick grid.`);
     }
     const rounded = new Big(price).round(market.priceDecimals, Big.roundHalfUp);
     return rounded.eq(0) ? '0' : rounded.toFixed();
 }
 /**
- * Format a size onto a Lighter market's lot grid: truncated (never rounded
- * up, so the size cannot exceed the user's balance) to the market's
+ * Snap a size onto a Lighter market's lot grid: truncated toward zero (never
+ * rounded up, so the size cannot exceed the user's balance) to the market's
  * `szDecimals` (Lighter's `supported_size_decimals`), trailing zeros stripped.
  *
  * @param size - Size in base-asset units as a non-negative magnitude.
  * @public
  */
-export function formatOrderSize(market, size) {
+export function snapOrderSize(market, size) {
     const truncated = new Big(size).round(market.szDecimals, Big.roundDown);
     return truncated.eq(0) ? '0' : truncated.toFixed();
 }

package/dist/esm/utils/orderFormatting.js.map

@@ -1 +1 @@
-{"version":3,"file":"orderFormatting.js","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAe,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAa;IAC5D,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,WAAW,MAAM,CAAC,EAAE,mDAAmD;YACrE,qDAAqD,CACxD,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;IAC3E,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAY;IAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACvE,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;AACpD,CAAC"}
+{"version":3,"file":"orderFormatting.js","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAGL,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,KAAoB;IAEpB,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,WAAW,MAAM,CAAC,EAAE,mDAAmD;YACrE,mDAAmD,CACtD,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;IAC3E,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACvE,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;AACpD,CAAC"}

package/dist/esm/utils/withdrawableBalances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,mBAAmB,CAAC,EACxD,sBAAsB,MAAM,KAC3B,2BAA2B,EA0B7B,CAAA"}
+{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,mBAAmB,CAAC,EACxD,sBAAsB,MAAM,KAC3B,2BAA2B,EAqC7B,CAAA"}

package/dist/esm/utils/withdrawableBalances.js

@@ -1,4 +1,4 @@
-import { maxOf, minOf } from '@lifi/perps-sdk';
+import { calculateTransferable, calculateWithdrawMax, } from '@lifi/perps-sdk';
 import Big from 'big.js';
 import { toRequiredBig } from './decimal.js';
 /**
@@ -22,14 +22,25 @@ export const lighterWithdrawableBalances = (account, settlementAssetIndex) => {
         const assetId = String(asset.asset_id);
         const spot = toRequiredBig(asset.balance, 'balance').minus(toRequiredBig(asset.locked_balance, 'locked_balance'));
         if (spot.gt(0)) {
-            rows.push({ assetId, route: 'spot', available: spot.toFixed() });
+            const available = spot.toFixed();
+            rows.push({
+                assetId,
+                route: 'spot',
+                available,
+                max: calculateWithdrawMax({ available }),
+            });
         }
         const marginBalance = toRequiredBig(asset.margin_balance, 'margin_balance');
         const perps = asset.asset_id === settlementAssetIndex
-            ? minOf(maxOf(toRequiredBig(account.available_balance, 'available_balance'), new Big(0)), marginBalance)
-            : marginBalance;
-        if (perps.gt(0)) {
-            rows.push({ assetId, route: 'perps', available: perps.toFixed() });
+            ? calculateTransferable(toRequiredBig(account.available_balance, 'available_balance').toFixed(), marginBalance.toFixed())
+            : marginBalance.toFixed();
+        if (new Big(perps).gt(0)) {
+            rows.push({
+                assetId,
+                route: 'perps',
+                available: perps,
+                max: calculateWithdrawMax({ available: perps }),
+            });
         }
     }
     return rows;

package/dist/esm/utils/withdrawableBalances.js.map

@@ -1 +1 @@
-{"version":3,"file":"withdrawableBalances.js","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAoC,MAAM,iBAAiB,CAAA;AAChF,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,OAAwD,EACxD,oBAA4B,EACG,EAAE;IACjC,MAAM,IAAI,GAAkC,EAAE,CAAA;IAC9C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACtC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,KAAK,CACxD,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACtD,CAAA;QACD,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAClE,CAAC;QACD,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAA;QAC3E,MAAM,KAAK,GACT,KAAK,CAAC,QAAQ,KAAK,oBAAoB;YACrC,CAAC,CAAC,KAAK,CACH,KAAK,CACH,aAAa,CAAC,OAAO,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,EAC7D,IAAI,GAAG,CAAC,CAAC,CAAC,CACX,EACD,aAAa,CACd;YACH,CAAC,CAAC,aAAa,CAAA;QACnB,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}
+{"version":3,"file":"withdrawableBalances.js","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,iBAAiB,CAAA;AACxB,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,OAAwD,EACxD,oBAA4B,EACG,EAAE;IACjC,MAAM,IAAI,GAAkC,EAAE,CAAA;IAC9C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACtC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,KAAK,CACxD,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACtD,CAAA;QACD,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAChC,IAAI,CAAC,IAAI,CAAC;gBACR,OAAO;gBACP,KAAK,EAAE,MAAM;gBACb,SAAS;gBACT,GAAG,EAAE,oBAAoB,CAAC,EAAE,SAAS,EAAE,CAAC;aACzC,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAA;QAC3E,MAAM,KAAK,GACT,KAAK,CAAC,QAAQ,KAAK,oBAAoB;YACrC,CAAC,CAAC,qBAAqB,CACnB,aAAa,CACX,OAAO,CAAC,iBAAiB,EACzB,mBAAmB,CACpB,CAAC,OAAO,EAAE,EACX,aAAa,CAAC,OAAO,EAAE,CACxB;YACH,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,CAAA;QAC7B,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC;gBACR,OAAO;gBACP,KAAK,EAAE,OAAO;gBACd,SAAS,EAAE,KAAK;gBAChB,GAAG,EAAE,oBAAoB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;aAChD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"LighterProvider.d.ts","sourceRoot":"","sources":["../../src/LighterProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAcL,KAAK,mBAAmB,EAqBxB,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAA;AAmCxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAQnC,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AA2KvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,4FAA4F;IAC5F,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAcD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAChE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,iBAAiB,EAC7B,UAAS,sBAA2B,KACnC,oBA+gDF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAS,sBAA2B,KACnC,oBACyD,CAAA;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,sBAA2B,KACnC,oBAA6E,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,OAAO,aA7BT,sBAAsB,KAC9B,oBA4BmC,CAAA"}
+{"version":3,"file":"LighterProvider.d.ts","sourceRoot":"","sources":["../../src/LighterProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAaL,KAAK,mBAAmB,EAqBxB,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAA;AAoCxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAQnC,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AA2KvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,4FAA4F;IAC5F,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAcD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAChE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,iBAAiB,EAC7B,UAAS,sBAA2B,KACnC,oBA+gDF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAS,sBAA2B,KACnC,oBACyD,CAAA;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,sBAA2B,KACnC,oBAA6E,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,OAAO,aA7BT,sBAAsB,KAC9B,oBA4BmC,CAAA"}

package/dist/types/constants.d.ts

@@ -14,8 +14,10 @@ export declare const LIGHTER_PROVIDER_KEY = "lighter";
 export declare const LIGHTER_RH_PROVIDER_KEY = "lighter-rh";
 /**
  * Category id for Lighter spot token holdings, matching the backend's Lighter
- * spot asset category. The perps category id is not a constant — it is read
- * from the fetched markets so it tracks the backend taxonomy.
+ * spot asset category. Every Lighter call site, REST and WebSocket, uses this
+ * constant for the spot category. The perps category id is not a constant:
+ * `LighterProvider.getAccount` reads it from the `/providers` category whose
+ * `quoteAsset` is not null.
  *
  * @public
  */

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGpE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,SAAS,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAA;AAC7E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6CAA6C,CAAA;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,2CACP,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,kBAAkB,EAClB,sBAAsB,CAUvB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,UAAU,EAAE,sBAAsB,CAAA;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,aAAa,EAAE,eAAe,CAAA;CAC/B;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAQvC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAC/D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oCAAoC,CAAA;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,SAAS,CAAA;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAQlC,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAoC,CAAA;AAExE;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,oCAAoC,wBAAwB,CAAA;AAEzE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,gBAAgB;AAChB,QAAA,MAAM,8BAA8B,QAAQ,CAAA;AAE5C;;;;GAIG;AACH,QAAA,MAAM,yBAAyB,QAAQ,CAAA;AAEvC;;;;GAIG;AACH,QAAA,MAAM,0BAA0B,QAAQ,CAAA;AAExC;;;;;;;GAOG;AACH,QAAA,MAAM,8BAA8B,QAAQ,CAAA;AAE5C;;;;;;GAMG;AACH,QAAA,MAAM,qBAAqB,aAAoB,CAAA;AAE/C;;;;;;GAMG;AACH,QAAA,MAAM,6BAA6B,MAAM,CAAA;AAEzC;;;;;;;GAOG;AACH,QAAA,MAAM,kCAAkC,QAAQ,CAAA;AAEhD,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,8BAA8B,EAC9B,6BAA6B,EAC7B,kCAAkC,EAClC,qBAAqB,EACrB,0BAA0B,GAC3B,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGpE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,SAAS,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAA;AAC7E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6CAA6C,CAAA;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,2CACP,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,kBAAkB,EAClB,sBAAsB,CAUvB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,UAAU,EAAE,sBAAsB,CAAA;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,aAAa,EAAE,eAAe,CAAA;CAC/B;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAQvC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAC/D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oCAAoC,CAAA;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,SAAS,CAAA;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAQlC,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAoC,CAAA;AAExE;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,oCAAoC,wBAAwB,CAAA;AAEzE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,gBAAgB;AAChB,QAAA,MAAM,8BAA8B,QAAQ,CAAA;AAE5C;;;;GAIG;AACH,QAAA,MAAM,yBAAyB,QAAQ,CAAA;AAEvC;;;;GAIG;AACH,QAAA,MAAM,0BAA0B,QAAQ,CAAA;AAExC;;;;;;;GAOG;AACH,QAAA,MAAM,8BAA8B,QAAQ,CAAA;AAE5C;;;;;;GAMG;AACH,QAAA,MAAM,qBAAqB,aAAoB,CAAA;AAE/C;;;;;;GAMG;AACH,QAAA,MAAM,6BAA6B,MAAM,CAAA;AAEzC;;;;;;;GAOG;AACH,QAAA,MAAM,kCAAkC,QAAQ,CAAA;AAEhD,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,8BAA8B,EAC9B,6BAA6B,EAC7B,kCAAkC,EAClC,qBAAqB,EACrB,0BAA0B,GAC3B,CAAA"}

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

@@ -14,7 +14,7 @@ export { mapPortfolioHistory } from './mapPortfolioHistory.js';
 export { leverageFromImf, mapPosition } from './mapPosition.js';
 export { mapMarketOrderLimits } from './marketLimits.js';
 export { mapInterval } from './ohlcvInterval.js';
-export { formatOrderPrice, formatOrderSize } from './orderFormatting.js';
+export { snapOrderPrice, snapOrderSize } from './orderFormatting.js';
 export { toIsoFromMs, toIsoFromSeconds } from './time.js';
 export { positionRemovableMargin } from './transferMargin.js';
 export { leverageToFraction, mapOrderTypeToInt, mapTimeInForceToInt, marginFractionToMaxLeverage, orderExpiryForTif, resolveTimeInForce, } from './wireEncoding.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,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACzD,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,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,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,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACzD,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,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,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/mapMarketContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapMarketContext.d.ts","sourceRoot":"","sources":["../../../src/utils/mapMarketContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAQ7E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,eAAe,GAAG,mBAAmB,KAC3C,aAyBF,CAAA"}
+{"version":3,"file":"mapMarketContext.d.ts","sourceRoot":"","sources":["../../../src/utils/mapMarketContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AA6B7E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,eAAe,GAAG,mBAAmB,KAC3C,aAuBF,CAAA"}

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

@@ -1,29 +1,29 @@
 /**
- * Lighter order size and price formatting for exchange submission.
+ * Lighter order size and price snapping for exchange submission.
  *
  * Lighter publishes a flat per-market decimal budget on its order books
  * (`supported_price_decimals` / `supported_size_decimals`), surfaced on the
- * generic {@link Market} as `priceDecimals` / `szDecimals`. Prices round to
- * the tick grid; sizes truncate to the lot grid.
+ * generic {@link Market} as `priceDecimals` / `szDecimals`. Prices round onto
+ * the tick grid; sizes truncate onto the lot grid.
  */
-import { type Market } from '@lifi/perps-types';
+import { type DecimalString, type Market } from '@lifi/perps-types';
 /**
- * Format a price onto a Lighter market's tick grid: rounded to the market's
- * `priceDecimals` (Lighter's `supported_price_decimals`), trailing zeros
- * stripped.
+ * Snap a price onto a Lighter market's tick grid: rounded half-up to the
+ * market's `priceDecimals` (Lighter's `supported_price_decimals`), trailing
+ * zeros stripped.
  *
  * @throws {PerpsError} `ValidationError` when `market.priceDecimals` is
  *   absent — without the venue's tick grid no correct price can be produced.
  * @public
  */
-export declare function formatOrderPrice(market: Market, price: number): string;
+export declare function snapOrderPrice(market: Market, price: DecimalString): DecimalString;
 /**
- * Format a size onto a Lighter market's lot grid: truncated (never rounded
- * up, so the size cannot exceed the user's balance) to the market's
+ * Snap a size onto a Lighter market's lot grid: truncated toward zero (never
+ * rounded up, so the size cannot exceed the user's balance) to the market's
  * `szDecimals` (Lighter's `supported_size_decimals`), trailing zeros stripped.
  *
  * @param size - Size in base-asset units as a non-negative magnitude.
  * @public
  */
-export declare function formatOrderSize(market: Market, size: number): string;
+export declare function snapOrderSize(market: Market, size: DecimalString): DecimalString;
 //# sourceMappingURL=orderFormatting.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"orderFormatting.d.ts","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,mBAAmB,CAAA;AAG/D;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpE"}
+{"version":3,"file":"orderFormatting.d.ts","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,MAAM,EAEZ,MAAM,mBAAmB,CAAA;AAG1B;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,GACnB,aAAa,CAUf;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,GAClB,aAAa,CAGf"}

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

@@ -1 +1 @@
-{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,mBAAmB,CAAC,EACxD,sBAAsB,MAAM,KAC3B,2BAA2B,EA0B7B,CAAA"}
+{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,mBAAmB,CAAC,EACxD,sBAAsB,MAAM,KAC3B,2BAA2B,EAqC7B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "31.0.1",
+  "version": "32.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": "^18.0.0"
+    "@lifi/perps-types": "^19.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^20.1.0"
+    "@lifi/perps-sdk": "^21.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/LighterProvider.ts

@@ -1,5 +1,6 @@
 import {
   ACTIVE_ORDER_STATUSES,
+  calculateTransferable,
   type DepositFlow,
   explorerTxUrl,
   explorerTxUrlFromBase,
@@ -9,8 +10,6 @@ import {
   getProviders,
   isActiveOrderStatus,
   localStorageAdapter,
-  maxOf,
-  minOf,
   PerpsError,
   type PerpsProviderPlugin,
   type PerpsSDKClient,
@@ -66,6 +65,7 @@ import type {
 import {
   ActionType,
   ActivityType,
+  isDecimalString,
   MarginMode,
   PerpsErrorCode,
 } from '@lifi/perps-types'
@@ -142,8 +142,6 @@ import { isAssetMarginEnabled } from './utils/assetCollateral.js'
 import {
   estimateLiquidationPrice,
   fetchDetailedAccount,
-  formatOrderPrice,
-  formatOrderSize,
   leverageFromImf,
   lighterAsset,
   lighterWithdrawableBalances,
@@ -152,6 +150,8 @@ import {
   mapOrder,
   mapPortfolioHistory,
   positionRemovableMargin,
+  snapOrderPrice,
+  snapOrderSize,
   toBigOrNull,
   toIsoFromMs,
   toIsoFromSeconds,
@@ -1042,37 +1042,37 @@ export const createLighterProvider = (
       // account's free margin; every other perps-route asset releases none.
       const collateralBalances: Balance[] = marginAssets.map((a) => {
         const isSettlement = a.asset_id === collateral.assetIndex
+        const marginBalance = toRequiredBig(
+          a.margin_balance,
+          'margin_balance'
+        ).toFixed()
         return {
           ...toBalance(
             a,
             perpsCategory?.id ?? providerKey,
             isSettlement ? settlementAsset : registryAsset(a),
-            a.margin_balance
+            isDecimalString(a.margin_balance) ? a.margin_balance : marginBalance
           ),
           transferable: isSettlement
-            ? minOf(
-                maxOf(availableBalance, new Big(0)),
-                new Big(a.margin_balance)
-              ).toFixed()
+            ? calculateTransferable(availableBalance.toFixed(), marginBalance)
             : '0',
         }
       })
       const balances: Balance[] = heldAssets.map((a) => {
-        const balance = new Big(a.balance)
+        const balance = toRequiredBig(a.balance, 'balance')
         return {
           ...toBalance(
             a,
             LIGHTER_SPOT_CATEGORY_ID,
             registryAsset(a),
-            a.balance
+            isDecimalString(a.balance) ? a.balance : balance.toFixed()
           ),
-          transferable: minOf(
-            maxOf(
-              balance.minus(toRequiredBig(a.locked_balance, 'locked_balance')),
-              new Big(0)
-            ),
+          transferable: calculateTransferable(
             balance
-          ).toFixed(),
+              .minus(toRequiredBig(a.locked_balance, 'locked_balance'))
+              .toFixed(),
+            balance.toFixed()
+          ),
         }
       })
 
@@ -1814,9 +1814,9 @@ export const createLighterProvider = (
       return getAccountSummary(account, positions)
     },
 
-    formatOrderPrice,
+    snapOrderPrice,
 
-    formatOrderSize,
+    snapOrderSize,
 
     estimateLiquidationPrice,
 

package/src/constants.ts

@@ -18,8 +18,10 @@ export const LIGHTER_RH_PROVIDER_KEY = 'lighter-rh'
 
 /**
  * Category id for Lighter spot token holdings, matching the backend's Lighter
- * spot asset category. The perps category id is not a constant — it is read
- * from the fetched markets so it tracks the backend taxonomy.
+ * spot asset category. Every Lighter call site, REST and WebSocket, uses this
+ * constant for the spot category. The perps category id is not a constant:
+ * `LighterProvider.getAccount` reads it from the `/providers` category whose
+ * `quoteAsset` is not null.
  *
  * @public
  */

package/src/signers/LighterSigner.ts

@@ -1,4 +1,4 @@
-import { PerpsError, scaleToInteger } from '@lifi/perps-sdk'
+import { decimalToBaseUnits, PerpsError } from '@lifi/perps-sdk'
 import { ActionType, PerpsErrorCode } from '@lifi/perps-types'
 import Big from 'big.js'
 import { LT_ROUTE_PERP, LT_ROUTE_SPOT } from '../types/action.js'
@@ -632,7 +632,7 @@ export class LighterSigner {
         return wasm.SignWithdraw(
           numberField(p, 'asset_index'),
           routeType,
-          scaleToInteger(amount, numberField(p, 'decimals'), 'truncate'),
+          decimalToBaseUnits(amount, numberField(p, 'decimals'), 'truncate'),
           SKIP_NONCE_DISABLED,
           nonce,
           ctx.apiKeyIndex,

package/src/utils/index.ts

@@ -21,7 +21,7 @@ export { mapPortfolioHistory } from './mapPortfolioHistory.js'
 export { leverageFromImf, mapPosition } from './mapPosition.js'
 export { mapMarketOrderLimits } from './marketLimits.js'
 export { mapInterval } from './ohlcvInterval.js'
-export { formatOrderPrice, formatOrderSize } from './orderFormatting.js'
+export { snapOrderPrice, snapOrderSize } from './orderFormatting.js'
 export { toIsoFromMs, toIsoFromSeconds } from './time.js'
 export { positionRemovableMargin } from './transferMargin.js'
 export {

package/src/utils/liquidation.ts

@@ -8,7 +8,7 @@
  */
 
 import {
-  estimateIsolatedLiquidationPrice,
+  estimateLiquidationPrice as estimateIsolatedLiquidationPrice,
   type LiquidationEstimateParams,
 } from '@lifi/perps-sdk'
 import type { PerpsMarket } from '@lifi/perps-types'

package/src/utils/mapMarketContext.ts

@@ -1,3 +1,4 @@
+import { numberToDecimalString } from '@lifi/perps-sdk'
 import type { MarketContext } from '@lifi/perps-types'
 import type { LtWsMarketStats, LtWsSpotMarketStats } from '../types/index.js'
 
@@ -7,6 +8,27 @@ const isPerpStats = (
   stats: LtWsMarketStats | LtWsSpotMarketStats
 ): stats is LtWsMarketStats => 'mark_price' in stats
 
+const isFiniteFigure = (value: number | null | undefined): value is number =>
+  typeof value === 'number' && Number.isFinite(value)
+
+/**
+ * The 24h figures of one record, omitted where the frame carries no finite
+ * number. The venue publishes them as unvalidated JSON, and `market_stats/all`
+ * maps every market in one pass, so a single absent figure must not cost the
+ * whole frame.
+ */
+const dailyFigures = (stats: {
+  daily_price_change?: number | null
+  daily_quote_token_volume?: number | null
+}): Pick<MarketContext, 'priceChange24h' | 'volume24h'> => ({
+  ...(isFiniteFigure(stats.daily_price_change)
+    ? { priceChange24h: numberToDecimalString(stats.daily_price_change) }
+    : {}),
+  ...(isFiniteFigure(stats.daily_quote_token_volume)
+    ? { volume24h: numberToDecimalString(stats.daily_quote_token_volume) }
+    : {}),
+})
+
 /**
  * Map a Lighter market-stats record to a {@link MarketContext}: `index_price`
  * is the oracle, `mid_price` the mid. Perp records carry the venue
@@ -24,8 +46,7 @@ export const mapMarketContext = (
       midPrice: stats.mid_price,
       markPrice: stats.mark_price,
       oraclePrice: stats.index_price,
-      priceChange24h: String(stats.daily_price_change),
-      volume24h: String(stats.daily_quote_token_volume),
+      ...dailyFigures(stats),
       openInterest: stats.open_interest,
       funding: {
         rate: stats.current_funding_rate,
@@ -38,7 +59,6 @@ export const mapMarketContext = (
     midPrice: stats.mid_price,
     markPrice: stats.mid_price,
     oraclePrice: stats.index_price,
-    priceChange24h: String(stats.daily_price_change),
-    volume24h: String(stats.daily_quote_token_volume),
+    ...dailyFigures(stats),
   }
 }

package/src/utils/orderFormatting.ts

@@ -1,31 +1,38 @@
 /**
- * Lighter order size and price formatting for exchange submission.
+ * Lighter order size and price snapping for exchange submission.
  *
  * Lighter publishes a flat per-market decimal budget on its order books
  * (`supported_price_decimals` / `supported_size_decimals`), surfaced on the
- * generic {@link Market} as `priceDecimals` / `szDecimals`. Prices round to
- * the tick grid; sizes truncate to the lot grid.
+ * generic {@link Market} as `priceDecimals` / `szDecimals`. Prices round onto
+ * the tick grid; sizes truncate onto the lot grid.
  */
 
 import { PerpsError } from '@lifi/perps-sdk'
-import { type Market, PerpsErrorCode } from '@lifi/perps-types'
+import {
+  type DecimalString,
+  type Market,
+  PerpsErrorCode,
+} from '@lifi/perps-types'
 import Big from 'big.js'
 
 /**
- * Format a price onto a Lighter market's tick grid: rounded to the market's
- * `priceDecimals` (Lighter's `supported_price_decimals`), trailing zeros
- * stripped.
+ * Snap a price onto a Lighter market's tick grid: rounded half-up to the
+ * market's `priceDecimals` (Lighter's `supported_price_decimals`), trailing
+ * zeros stripped.
  *
  * @throws {PerpsError} `ValidationError` when `market.priceDecimals` is
  *   absent — without the venue's tick grid no correct price can be produced.
  * @public
  */
-export function formatOrderPrice(market: Market, price: number): string {
+export function snapOrderPrice(
+  market: Market,
+  price: DecimalString
+): DecimalString {
   if (market.priceDecimals === undefined) {
     throw new PerpsError(
       PerpsErrorCode.ValidationError,
       `Market '${market.id}' carries no priceDecimals; Lighter order prices ` +
-        `cannot be formatted without the market's tick grid.`
+        `cannot be snapped without the market's tick grid.`
     )
   }
   const rounded = new Big(price).round(market.priceDecimals, Big.roundHalfUp)
@@ -33,14 +40,17 @@ export function formatOrderPrice(market: Market, price: number): string {
 }
 
 /**
- * Format a size onto a Lighter market's lot grid: truncated (never rounded
- * up, so the size cannot exceed the user's balance) to the market's
+ * Snap a size onto a Lighter market's lot grid: truncated toward zero (never
+ * rounded up, so the size cannot exceed the user's balance) to the market's
  * `szDecimals` (Lighter's `supported_size_decimals`), trailing zeros stripped.
  *
  * @param size - Size in base-asset units as a non-negative magnitude.
  * @public
  */
-export function formatOrderSize(market: Market, size: number): string {
+export function snapOrderSize(
+  market: Market,
+  size: DecimalString
+): DecimalString {
   const truncated = new Big(size).round(market.szDecimals, Big.roundDown)
   return truncated.eq(0) ? '0' : truncated.toFixed()
 }

package/src/utils/withdrawableBalances.ts

@@ -1,4 +1,8 @@
-import { maxOf, minOf, type ProviderWithdrawableBalance } from '@lifi/perps-sdk'
+import {
+  calculateTransferable,
+  calculateWithdrawMax,
+  type ProviderWithdrawableBalance,
+} from '@lifi/perps-sdk'
 import Big from 'big.js'
 import type { LtAccount } from '../types/account.js'
 import { toRequiredBig } from './decimal.js'
@@ -29,21 +33,32 @@ export const lighterWithdrawableBalances = (
       toRequiredBig(asset.locked_balance, 'locked_balance')
     )
     if (spot.gt(0)) {
-      rows.push({ assetId, route: 'spot', available: spot.toFixed() })
+      const available = spot.toFixed()
+      rows.push({
+        assetId,
+        route: 'spot',
+        available,
+        max: calculateWithdrawMax({ available }),
+      })
     }
     const marginBalance = toRequiredBig(asset.margin_balance, 'margin_balance')
     const perps =
       asset.asset_id === settlementAssetIndex
-        ? minOf(
-            maxOf(
-              toRequiredBig(account.available_balance, 'available_balance'),
-              new Big(0)
-            ),
-            marginBalance
+        ? calculateTransferable(
+            toRequiredBig(
+              account.available_balance,
+              'available_balance'
+            ).toFixed(),
+            marginBalance.toFixed()
           )
-        : marginBalance
-    if (perps.gt(0)) {
-      rows.push({ assetId, route: 'perps', available: perps.toFixed() })
+        : marginBalance.toFixed()
+    if (new Big(perps).gt(0)) {
+      rows.push({
+        assetId,
+        route: 'perps',
+        available: perps,
+        max: calculateWithdrawMax({ available: perps }),
+      })
     }
   }
   return rows