@lifi/perps-sdk 15.0.0 → 17.0.0

package/dist/cjs/utils/accountSummary.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.summarizeAccount = summarizeAccount;
-const parse_js_1 = require("./parse.js");
-const sumValueUsd = (balances) => balances.reduce((sum, b) => sum + (0, parse_js_1.stringToFloat)(b.valueUsd), 0);
-const sumMarginUsd = (balances) => balances.reduce((sum, b) => sum + (0, parse_js_1.stringToFloat)(b.valueUsd) * (b.collateralWeight ?? 1), 0);
-function summarizeAccount(account, positions, semantics) {
-    let marginUsed = 0;
-    let unrealizedPnl = 0;
-    for (const p of positions) {
-        marginUsed += (0, parse_js_1.stringToFloat)(p.marginUsed);
-        unrealizedPnl += (0, parse_js_1.stringToFloat)(p.unrealizedPnl);
-    }
-    const collateral = sumValueUsd(account.collateralBalances);
-    const marginCollateral = sumMarginUsd(account.collateralBalances);
-    const balances = sumValueUsd(account.balances);
-    const withLocked = semantics === 'free' || semantics === 'net';
-    const grossCollateral = withLocked ? collateral + marginUsed : collateral;
-    const grossMarginCollateral = withLocked
-        ? marginCollateral + marginUsed
-        : marginCollateral;
-    const equity = semantics === 'equity' || semantics === 'net'
-        ? grossCollateral
-        : grossCollateral + unrealizedPnl;
-    const availableMargin = grossMarginCollateral +
-        (semantics === 'gross' ? unrealizedPnl : 0) -
-        marginUsed;
-    return {
-        portfolioValue: (balances + equity).toString(),
-        availableMargin: availableMargin.toString(),
-        marginUsed: marginUsed.toString(),
-        unrealizedPnl: unrealizedPnl.toString(),
-    };
-}
-//# sourceMappingURL=accountSummary.js.map

package/dist/cjs/utils/accountSummary.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"accountSummary.js","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":";;AA8CA,4CA2CC;AApFD,yCAA0C;AAE1C,MAAM,WAAW,GAAG,CAAC,QAAqC,EAAU,EAAE,CACpE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAA,wBAAa,EAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;AAEjE,MAAM,YAAY,GAAG,CAAC,QAAqC,EAAU,EAAE,CACrE,QAAQ,CAAC,MAAM,CACb,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAA,wBAAa,EAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,EACvE,CAAC,CACF,CAAA;AAgCH,SAAgB,gBAAgB,CAC9B,OAAwB,EACxB,SAAqB,EACrB,SAA8B;IAE9B,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,UAAU,IAAI,IAAA,wBAAa,EAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QACzC,aAAa,IAAI,IAAA,wBAAa,EAAC,CAAC,CAAC,aAAa,CAAC,CAAA;IACjD,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAI1D,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACjE,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE9C,MAAM,UAAU,GAAG,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,KAAK,CAAA;IAC9D,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;IACzE,MAAM,qBAAqB,GAAG,UAAU;QACtC,CAAC,CAAC,gBAAgB,GAAG,UAAU;QAC/B,CAAC,CAAC,gBAAgB,CAAA;IACpB,MAAM,MAAM,GACV,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,KAAK;QAC3C,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,eAAe,GAAG,aAAa,CAAA;IAKrC,MAAM,eAAe,GACnB,qBAAqB;QACrB,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,UAAU,CAAA;IAEZ,OAAO;QACL,cAAc,EAAE,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC,QAAQ,EAAE;QAC9C,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE;QAC3C,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;QACjC,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE;KACxC,CAAA;AACH,CAAC"}

package/dist/cjs/utils/transferMargin.d.ts

@@ -1,7 +0,0 @@
-import { type Position, type PositionMarginConstraints } from '@lifi/perps-types';
-export interface RemovableIsolatedMarginParams {
-    position: Position;
-    constraints: PositionMarginConstraints;
-}
-export declare function removableIsolatedMargin({ position, constraints, }: RemovableIsolatedMarginParams): string;
-//# sourceMappingURL=transferMargin.d.ts.map

package/dist/cjs/utils/transferMargin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAA;AAyC1B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,QAAQ,CAAA;IAClB,WAAW,EAAE,yBAAyB,CAAA;CACvC;AAcD,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,WAAW,GACZ,EAAE,6BAA6B,GAAG,MAAM,CA+BxC"}

package/dist/cjs/utils/transferMargin.js

@@ -1,50 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removableIsolatedMargin = removableIsolatedMargin;
-const perps_types_1 = require("@lifi/perps-types");
-const big_js_1 = __importDefault(require("big.js"));
-const PerpsError_js_1 = require("../errors/PerpsError.js");
-function positionAmount(value, field) {
-    try {
-        return new big_js_1.default(value);
-    }
-    catch {
-        throw new PerpsError_js_1.PerpsError(perps_types_1.PerpsErrorCode.ValidationError, `Invalid decimal string on Position.${field}: '${value}'`);
-    }
-}
-function constraintAmount(value, field) {
-    try {
-        return new big_js_1.default(value);
-    }
-    catch {
-        throw new PerpsError_js_1.PerpsError(perps_types_1.PerpsErrorCode.ValidationError, `Invalid decimal string on PositionMarginConstraints.${field}: '${value}'`);
-    }
-}
-function requirePositive(value, field) {
-    if (value.lte(0)) {
-        throw new PerpsError_js_1.PerpsError(perps_types_1.PerpsErrorCode.ValidationError, `${field} must be greater than zero.`);
-    }
-    return value;
-}
-function removableIsolatedMargin({ position, constraints, }) {
-    if (!(0, perps_types_1.positionSupportsMarginRemoval)(position)) {
-        return '0';
-    }
-    const marginUsed = requirePositive(positionAmount(position.marginUsed, 'marginUsed'), 'Position.marginUsed');
-    const unrealizedPnl = positionAmount(position.unrealizedPnl, 'unrealizedPnl');
-    const minimumMargin = requirePositive(constraintAmount(constraints.minimumMarginRequirement, 'minimumMarginRequirement'), 'PositionMarginConstraints.minimumMarginRequirement');
-    const amountIncrement = requirePositive(constraintAmount(constraints.amountIncrement, 'amountIncrement'), 'PositionMarginConstraints.amountIncrement');
-    const removable = marginUsed.plus(unrealizedPnl).minus(minimumMargin);
-    if (removable.lte(0)) {
-        return '0';
-    }
-    return removable
-        .div(amountIncrement)
-        .round(0, big_js_1.default.roundDown)
-        .times(amountIncrement)
-        .toFixed();
-}
-//# sourceMappingURL=transferMargin.js.map

package/dist/cjs/utils/transferMargin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transferMargin.js","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":";;;;;AA+DA,0DAkCC;AAjGD,mDAK0B;AAC1B,oDAAwB;AACxB,2DAAoD;AAEpD,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,IAAI,CAAC;QACH,OAAO,IAAI,gBAAG,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,0BAAU,CAClB,4BAAc,CAAC,eAAe,EAC9B,sCAAsC,KAAK,MAAM,KAAK,GAAG,CAC1D,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,KAAa;IACpD,IAAI,CAAC;QACH,OAAO,IAAI,gBAAG,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,0BAAU,CAClB,4BAAc,CAAC,eAAe,EAC9B,uDAAuD,KAAK,MAAM,KAAK,GAAG,CAC3E,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAU,EAAE,KAAa;IAChD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,0BAAU,CAClB,4BAAc,CAAC,eAAe,EAC9B,GAAG,KAAK,6BAA6B,CACtC,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAwBD,SAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,WAAW,GACmB;IAC9B,IAAI,CAAC,IAAA,2CAA6B,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAChC,cAAc,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,EACjD,qBAAqB,CACtB,CAAA;IACD,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;IAC7E,MAAM,aAAa,GAAG,eAAe,CACnC,gBAAgB,CACd,WAAW,CAAC,wBAAwB,EACpC,0BAA0B,CAC3B,EACD,oDAAoD,CACrD,CAAA;IACD,MAAM,eAAe,GAAG,eAAe,CACrC,gBAAgB,CAAC,WAAW,CAAC,eAAe,EAAE,iBAAiB,CAAC,EAChE,2CAA2C,CAC5C,CAAA;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IACrE,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,OAAO,SAAS;SACb,GAAG,CAAC,eAAe,CAAC;SACpB,KAAK,CAAC,CAAC,EAAE,gBAAG,CAAC,SAAS,CAAC;SACvB,KAAK,CAAC,eAAe,CAAC;SACtB,OAAO,EAAE,CAAA;AACd,CAAC"}

package/dist/esm/utils/accountSummary.d.ts

@@ -1,32 +0,0 @@
-import type { AccountResponse, AccountSummary, Position } from '@lifi/perps-types';
-/**
- * What the summed `collateralBalances` rows already contain, relative to the
- * positions' locked margin and unrealized PnL:
- *
- * - `'free'` — free collateral only; locked margin and unrealized PnL are
- *   both carried by the positions. Available margin is the free collateral
- *   as-is; unrealized PnL is not counted toward it.
- * - `'net'` — free collateral with unrealized PnL already marked in; only
- *   the locked margin is carried by the positions (e.g. a venue-reported
- *   available balance).
- * - `'gross'` — locked margin included, unrealized PnL carried by the
- *   positions (e.g. spot holdings backing a unified account). The venue
- *   counts unrealized PnL toward buying power, so it is added to available
- *   margin on top of the gross collateral.
- * - `'equity'` — total equity: locked margin AND unrealized PnL included
- *   (e.g. a venue-reported account value). Unrealized PnL is thus already
- *   counted toward available margin.
- *
- * @public
- */
-export type CollateralSemantics = 'free' | 'net' | 'gross' | 'equity';
-/**
- * Roll an {@link AccountResponse} and its open positions up into an
- * {@link AccountSummary}.
- *
- * @param semantics - How the collateral rows relate to the positions'
- * locked margin and unrealized PnL; see {@link CollateralSemantics}.
- * @public
- */
-export declare function summarizeAccount(account: AccountResponse, positions: Position[], semantics: CollateralSemantics): AccountSummary;
-//# sourceMappingURL=accountSummary.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"accountSummary.d.ts","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAY1B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAErE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,EACrB,SAAS,EAAE,mBAAmB,GAC7B,cAAc,CAuChB"}

package/dist/esm/utils/accountSummary.js

@@ -1,46 +0,0 @@
-import { stringToFloat } from './parse.js';
-const sumValueUsd = (balances) => balances.reduce((sum, b) => sum + stringToFloat(b.valueUsd), 0);
-const sumMarginUsd = (balances) => balances.reduce((sum, b) => sum + stringToFloat(b.valueUsd) * (b.collateralWeight ?? 1), 0);
-/**
- * Roll an {@link AccountResponse} and its open positions up into an
- * {@link AccountSummary}.
- *
- * @param semantics - How the collateral rows relate to the positions'
- * locked margin and unrealized PnL; see {@link CollateralSemantics}.
- * @public
- */
-export function summarizeAccount(account, positions, semantics) {
-    let marginUsed = 0;
-    let unrealizedPnl = 0;
-    for (const p of positions) {
-        marginUsed += stringToFloat(p.marginUsed);
-        unrealizedPnl += stringToFloat(p.unrealizedPnl);
-    }
-    const collateral = sumValueUsd(account.collateralBalances);
-    // Margin-eligible collateral: each row's value scaled by its loan-to-value
-    // weight (1 when unset), so a haircut asset backs buying power at less than
-    // face while `portfolioValue` still reflects its full value.
-    const marginCollateral = sumMarginUsd(account.collateralBalances);
-    const balances = sumValueUsd(account.balances);
-    const withLocked = semantics === 'free' || semantics === 'net';
-    const grossCollateral = withLocked ? collateral + marginUsed : collateral;
-    const grossMarginCollateral = withLocked
-        ? marginCollateral + marginUsed
-        : marginCollateral;
-    const equity = semantics === 'equity' || semantics === 'net'
-        ? grossCollateral
-        : grossCollateral + unrealizedPnl;
-    // Buying power is equity net of locked margin, so unrealized PnL counts
-    // toward it. The `'free'` rows exclude uPnL from available margin, holding
-    // it purely as free collateral.
-    const availableMargin = grossMarginCollateral +
-        (semantics === 'gross' ? unrealizedPnl : 0) -
-        marginUsed;
-    return {
-        portfolioValue: (balances + equity).toString(),
-        availableMargin: availableMargin.toString(),
-        marginUsed: marginUsed.toString(),
-        unrealizedPnl: unrealizedPnl.toString(),
-    };
-}
-//# sourceMappingURL=accountSummary.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"accountSummary.js","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,WAAW,GAAG,CAAC,QAAqC,EAAU,EAAE,CACpE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;AAEjE,MAAM,YAAY,GAAG,CAAC,QAAqC,EAAU,EAAE,CACrE,QAAQ,CAAC,MAAM,CACb,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,EACvE,CAAC,CACF,CAAA;AAwBH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAwB,EACxB,SAAqB,EACrB,SAA8B;IAE9B,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,UAAU,IAAI,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QACzC,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;IACjD,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC1D,2EAA2E;IAC3E,4EAA4E;IAC5E,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACjE,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE9C,MAAM,UAAU,GAAG,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,KAAK,CAAA;IAC9D,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;IACzE,MAAM,qBAAqB,GAAG,UAAU;QACtC,CAAC,CAAC,gBAAgB,GAAG,UAAU;QAC/B,CAAC,CAAC,gBAAgB,CAAA;IACpB,MAAM,MAAM,GACV,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,KAAK;QAC3C,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,eAAe,GAAG,aAAa,CAAA;IAErC,wEAAwE;IACxE,2EAA2E;IAC3E,gCAAgC;IAChC,MAAM,eAAe,GACnB,qBAAqB;QACrB,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,UAAU,CAAA;IAEZ,OAAO;QACL,cAAc,EAAE,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC,QAAQ,EAAE;QAC9C,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE;QAC3C,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;QACjC,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE;KACxC,CAAA;AACH,CAAC"}

package/dist/esm/utils/transferMargin.d.ts

@@ -1,24 +0,0 @@
-import { type Position, type PositionMarginConstraints } from '@lifi/perps-types';
-/**
- * Exact inputs for {@link removableIsolatedMargin}.
- *
- * @public
- */
-export interface RemovableIsolatedMarginParams {
-    position: Position;
-    constraints: PositionMarginConstraints;
-}
-/**
- * Calculate margin that can be removed from an isolated position using the
- * provider's exact retained-margin requirement. Position equity is allocated
- * margin plus unrealized PnL.
- *
- * The result snaps down to the provider's accepted amount increment. Markets
- * that are add-only and cross-margined positions return `'0'`.
- *
- * @throws {PerpsError} `ValidationError` for malformed, non-positive, or
- *   inconsistent risk inputs.
- * @public
- */
-export declare function removableIsolatedMargin({ position, constraints, }: RemovableIsolatedMarginParams): string;
-//# sourceMappingURL=transferMargin.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAA;AAoC1B;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,QAAQ,CAAA;IAClB,WAAW,EAAE,yBAAyB,CAAA;CACvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,WAAW,GACZ,EAAE,6BAA6B,GAAG,MAAM,CA+BxC"}

package/dist/esm/utils/transferMargin.js

@@ -1,56 +0,0 @@
-import { PerpsErrorCode, positionSupportsMarginRemoval, } from '@lifi/perps-types';
-import Big from 'big.js';
-import { PerpsError } from '../errors/PerpsError.js';
-function positionAmount(value, field) {
-    try {
-        return new Big(value);
-    }
-    catch {
-        throw new PerpsError(PerpsErrorCode.ValidationError, `Invalid decimal string on Position.${field}: '${value}'`);
-    }
-}
-function constraintAmount(value, field) {
-    try {
-        return new Big(value);
-    }
-    catch {
-        throw new PerpsError(PerpsErrorCode.ValidationError, `Invalid decimal string on PositionMarginConstraints.${field}: '${value}'`);
-    }
-}
-function requirePositive(value, field) {
-    if (value.lte(0)) {
-        throw new PerpsError(PerpsErrorCode.ValidationError, `${field} must be greater than zero.`);
-    }
-    return value;
-}
-/**
- * Calculate margin that can be removed from an isolated position using the
- * provider's exact retained-margin requirement. Position equity is allocated
- * margin plus unrealized PnL.
- *
- * The result snaps down to the provider's accepted amount increment. Markets
- * that are add-only and cross-margined positions return `'0'`.
- *
- * @throws {PerpsError} `ValidationError` for malformed, non-positive, or
- *   inconsistent risk inputs.
- * @public
- */
-export function removableIsolatedMargin({ position, constraints, }) {
-    if (!positionSupportsMarginRemoval(position)) {
-        return '0';
-    }
-    const marginUsed = requirePositive(positionAmount(position.marginUsed, 'marginUsed'), 'Position.marginUsed');
-    const unrealizedPnl = positionAmount(position.unrealizedPnl, 'unrealizedPnl');
-    const minimumMargin = requirePositive(constraintAmount(constraints.minimumMarginRequirement, 'minimumMarginRequirement'), 'PositionMarginConstraints.minimumMarginRequirement');
-    const amountIncrement = requirePositive(constraintAmount(constraints.amountIncrement, 'amountIncrement'), 'PositionMarginConstraints.amountIncrement');
-    const removable = marginUsed.plus(unrealizedPnl).minus(minimumMargin);
-    if (removable.lte(0)) {
-        return '0';
-    }
-    return removable
-        .div(amountIncrement)
-        .round(0, Big.roundDown)
-        .times(amountIncrement)
-        .toFixed();
-}
-//# sourceMappingURL=transferMargin.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"transferMargin.js","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAGd,6BAA6B,GAC9B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,GAAG,MAAM,QAAQ,CAAA;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,sCAAsC,KAAK,MAAM,KAAK,GAAG,CAC1D,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,KAAa;IACpD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,uDAAuD,KAAK,MAAM,KAAK,GAAG,CAC3E,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAU,EAAE,KAAa;IAChD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,GAAG,KAAK,6BAA6B,CACtC,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAYD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,EACR,WAAW,GACmB;IAC9B,IAAI,CAAC,6BAA6B,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAChC,cAAc,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,EACjD,qBAAqB,CACtB,CAAA;IACD,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;IAC7E,MAAM,aAAa,GAAG,eAAe,CACnC,gBAAgB,CACd,WAAW,CAAC,wBAAwB,EACpC,0BAA0B,CAC3B,EACD,oDAAoD,CACrD,CAAA;IACD,MAAM,eAAe,GAAG,eAAe,CACrC,gBAAgB,CAAC,WAAW,CAAC,eAAe,EAAE,iBAAiB,CAAC,EAChE,2CAA2C,CAC5C,CAAA;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IACrE,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,OAAO,SAAS;SACb,GAAG,CAAC,eAAe,CAAC;SACpB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC;SACvB,KAAK,CAAC,eAAe,CAAC;SACtB,OAAO,EAAE,CAAA;AACd,CAAC"}

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

@@ -1,32 +0,0 @@
-import type { AccountResponse, AccountSummary, Position } from '@lifi/perps-types';
-/**
- * What the summed `collateralBalances` rows already contain, relative to the
- * positions' locked margin and unrealized PnL:
- *
- * - `'free'` — free collateral only; locked margin and unrealized PnL are
- *   both carried by the positions. Available margin is the free collateral
- *   as-is; unrealized PnL is not counted toward it.
- * - `'net'` — free collateral with unrealized PnL already marked in; only
- *   the locked margin is carried by the positions (e.g. a venue-reported
- *   available balance).
- * - `'gross'` — locked margin included, unrealized PnL carried by the
- *   positions (e.g. spot holdings backing a unified account). The venue
- *   counts unrealized PnL toward buying power, so it is added to available
- *   margin on top of the gross collateral.
- * - `'equity'` — total equity: locked margin AND unrealized PnL included
- *   (e.g. a venue-reported account value). Unrealized PnL is thus already
- *   counted toward available margin.
- *
- * @public
- */
-export type CollateralSemantics = 'free' | 'net' | 'gross' | 'equity';
-/**
- * Roll an {@link AccountResponse} and its open positions up into an
- * {@link AccountSummary}.
- *
- * @param semantics - How the collateral rows relate to the positions'
- * locked margin and unrealized PnL; see {@link CollateralSemantics}.
- * @public
- */
-export declare function summarizeAccount(account: AccountResponse, positions: Position[], semantics: CollateralSemantics): AccountSummary;
-//# sourceMappingURL=accountSummary.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"accountSummary.d.ts","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAY1B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAErE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,EACrB,SAAS,EAAE,mBAAmB,GAC7B,cAAc,CAuChB"}

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

@@ -1,24 +0,0 @@
-import { type Position, type PositionMarginConstraints } from '@lifi/perps-types';
-/**
- * Exact inputs for {@link removableIsolatedMargin}.
- *
- * @public
- */
-export interface RemovableIsolatedMarginParams {
-    position: Position;
-    constraints: PositionMarginConstraints;
-}
-/**
- * Calculate margin that can be removed from an isolated position using the
- * provider's exact retained-margin requirement. Position equity is allocated
- * margin plus unrealized PnL.
- *
- * The result snaps down to the provider's accepted amount increment. Markets
- * that are add-only and cross-margined positions return `'0'`.
- *
- * @throws {PerpsError} `ValidationError` for malformed, non-positive, or
- *   inconsistent risk inputs.
- * @public
- */
-export declare function removableIsolatedMargin({ position, constraints, }: RemovableIsolatedMarginParams): string;
-//# sourceMappingURL=transferMargin.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAA;AAoC1B;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,QAAQ,CAAA;IAClB,WAAW,EAAE,yBAAyB,CAAA;CACvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,WAAW,GACZ,EAAE,6BAA6B,GAAG,MAAM,CA+BxC"}

package/src/utils/accountSummary.ts

@@ -1,90 +0,0 @@
-import type {
-  AccountResponse,
-  AccountSummary,
-  Position,
-} from '@lifi/perps-types'
-import { stringToFloat } from './parse.js'
-
-const sumValueUsd = (balances: AccountResponse['balances']): number =>
-  balances.reduce((sum, b) => sum + stringToFloat(b.valueUsd), 0)
-
-const sumMarginUsd = (balances: AccountResponse['balances']): number =>
-  balances.reduce(
-    (sum, b) => sum + stringToFloat(b.valueUsd) * (b.collateralWeight ?? 1),
-    0
-  )
-
-/**
- * What the summed `collateralBalances` rows already contain, relative to the
- * positions' locked margin and unrealized PnL:
- *
- * - `'free'` — free collateral only; locked margin and unrealized PnL are
- *   both carried by the positions. Available margin is the free collateral
- *   as-is; unrealized PnL is not counted toward it.
- * - `'net'` — free collateral with unrealized PnL already marked in; only
- *   the locked margin is carried by the positions (e.g. a venue-reported
- *   available balance).
- * - `'gross'` — locked margin included, unrealized PnL carried by the
- *   positions (e.g. spot holdings backing a unified account). The venue
- *   counts unrealized PnL toward buying power, so it is added to available
- *   margin on top of the gross collateral.
- * - `'equity'` — total equity: locked margin AND unrealized PnL included
- *   (e.g. a venue-reported account value). Unrealized PnL is thus already
- *   counted toward available margin.
- *
- * @public
- */
-export type CollateralSemantics = 'free' | 'net' | 'gross' | 'equity'
-
-/**
- * Roll an {@link AccountResponse} and its open positions up into an
- * {@link AccountSummary}.
- *
- * @param semantics - How the collateral rows relate to the positions'
- * locked margin and unrealized PnL; see {@link CollateralSemantics}.
- * @public
- */
-export function summarizeAccount(
-  account: AccountResponse,
-  positions: Position[],
-  semantics: CollateralSemantics
-): AccountSummary {
-  let marginUsed = 0
-  let unrealizedPnl = 0
-  for (const p of positions) {
-    marginUsed += stringToFloat(p.marginUsed)
-    unrealizedPnl += stringToFloat(p.unrealizedPnl)
-  }
-
-  const collateral = sumValueUsd(account.collateralBalances)
-  // Margin-eligible collateral: each row's value scaled by its loan-to-value
-  // weight (1 when unset), so a haircut asset backs buying power at less than
-  // face while `portfolioValue` still reflects its full value.
-  const marginCollateral = sumMarginUsd(account.collateralBalances)
-  const balances = sumValueUsd(account.balances)
-
-  const withLocked = semantics === 'free' || semantics === 'net'
-  const grossCollateral = withLocked ? collateral + marginUsed : collateral
-  const grossMarginCollateral = withLocked
-    ? marginCollateral + marginUsed
-    : marginCollateral
-  const equity =
-    semantics === 'equity' || semantics === 'net'
-      ? grossCollateral
-      : grossCollateral + unrealizedPnl
-
-  // Buying power is equity net of locked margin, so unrealized PnL counts
-  // toward it. The `'free'` rows exclude uPnL from available margin, holding
-  // it purely as free collateral.
-  const availableMargin =
-    grossMarginCollateral +
-    (semantics === 'gross' ? unrealizedPnl : 0) -
-    marginUsed
-
-  return {
-    portfolioValue: (balances + equity).toString(),
-    availableMargin: availableMargin.toString(),
-    marginUsed: marginUsed.toString(),
-    unrealizedPnl: unrealizedPnl.toString(),
-  }
-}

package/src/utils/transferMargin.ts

@@ -1,98 +0,0 @@
-import {
-  PerpsErrorCode,
-  type Position,
-  type PositionMarginConstraints,
-  positionSupportsMarginRemoval,
-} from '@lifi/perps-types'
-import Big from 'big.js'
-import { PerpsError } from '../errors/PerpsError.js'
-
-function positionAmount(value: string, field: string): Big {
-  try {
-    return new Big(value)
-  } catch {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Invalid decimal string on Position.${field}: '${value}'`
-    )
-  }
-}
-
-function constraintAmount(value: string, field: string): Big {
-  try {
-    return new Big(value)
-  } catch {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Invalid decimal string on PositionMarginConstraints.${field}: '${value}'`
-    )
-  }
-}
-
-function requirePositive(value: Big, field: string): Big {
-  if (value.lte(0)) {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `${field} must be greater than zero.`
-    )
-  }
-  return value
-}
-
-/**
- * Exact inputs for {@link removableIsolatedMargin}.
- *
- * @public
- */
-export interface RemovableIsolatedMarginParams {
-  position: Position
-  constraints: PositionMarginConstraints
-}
-
-/**
- * Calculate margin that can be removed from an isolated position using the
- * provider's exact retained-margin requirement. Position equity is allocated
- * margin plus unrealized PnL.
- *
- * The result snaps down to the provider's accepted amount increment. Markets
- * that are add-only and cross-margined positions return `'0'`.
- *
- * @throws {PerpsError} `ValidationError` for malformed, non-positive, or
- *   inconsistent risk inputs.
- * @public
- */
-export function removableIsolatedMargin({
-  position,
-  constraints,
-}: RemovableIsolatedMarginParams): string {
-  if (!positionSupportsMarginRemoval(position)) {
-    return '0'
-  }
-
-  const marginUsed = requirePositive(
-    positionAmount(position.marginUsed, 'marginUsed'),
-    'Position.marginUsed'
-  )
-  const unrealizedPnl = positionAmount(position.unrealizedPnl, 'unrealizedPnl')
-  const minimumMargin = requirePositive(
-    constraintAmount(
-      constraints.minimumMarginRequirement,
-      'minimumMarginRequirement'
-    ),
-    'PositionMarginConstraints.minimumMarginRequirement'
-  )
-  const amountIncrement = requirePositive(
-    constraintAmount(constraints.amountIncrement, 'amountIncrement'),
-    'PositionMarginConstraints.amountIncrement'
-  )
-
-  const removable = marginUsed.plus(unrealizedPnl).minus(minimumMargin)
-  if (removable.lte(0)) {
-    return '0'
-  }
-  return removable
-    .div(amountIncrement)
-    .round(0, Big.roundDown)
-    .times(amountIncrement)
-    .toFixed()
-}