@lifi/perps-sdk 16.0.0 → 17.0.1

package/src/client/PerpsClient.ts

@@ -14,7 +14,6 @@ import type {
   OrdersResponse,
   PortfolioHistoryResponse,
   Position,
-  PositionMarginConstraints,
   Provider,
   ProviderAction,
   SignedActionStep,
@@ -89,6 +88,14 @@ import {
 import { createPerpsClient } from './createPerpsClient.js'
 import { requireProvider as resolveProvider } from './requireProvider.js'
 
+function isNonNegativeDecimal(value: string): boolean {
+  try {
+    return new Big(value).gte(0)
+  } catch {
+    return false
+  }
+}
+
 /**
  * Look up an action's descriptor in the provider's metadata. Throws if the
  * action isn't declared — defensive: better to fail loudly than to mis-sign.
@@ -592,17 +599,18 @@ export class PerpsClient {
   }
 
   /**
-   * Resolve the exact venue-owned margin requirements for `position`.
-   * Returns `undefined` when the position has no individual margin adjustment.
+   * Resolve the margin that can be removed from `position`, from the owning
+   * provider's venue margin rules. Returns `undefined` when the position has
+   * no individual margin adjustment and `'0'` when it accepts no removal.
    *
+   * @throws {PerpsError} `ValidationError` when a `Position` decimal that the
+   *   venue formula reads is malformed.
    * @public
    */
-  getPositionMarginConstraints(
-    position: Position
-  ): PositionMarginConstraints | undefined {
+  getPositionRemovableMargin(position: Position): string | undefined {
     return this.requireProvider(
       position.market.providerId
-    ).positionMarginConstraints(position)
+    ).positionRemovableMargin(position)
   }
 
   /**
@@ -663,8 +671,9 @@ export class PerpsClient {
    *
    * @returns `undefined` when the registered plugin declares no withdrawable
    *   read.
-   * @throws {PerpsError} When the provider plugin is not registered, or either
-   *   the plugin read or the asset sync fails.
+   * @throws {PerpsError} When the provider plugin is not registered, when
+   *   either the plugin read or the asset sync fails, or when a row's
+   *   `withdrawalFee` is not a non-negative decimal.
    * @public
    */
   async getWithdrawableBalances(
@@ -700,7 +709,23 @@ export class PerpsClient {
           return []
         }
       }
-      return [{ asset, route: row.route, available: row.available }]
+      if (row.withdrawalFee === undefined) {
+        return [{ asset, route: row.route, available: row.available }]
+      }
+      if (!isNonNegativeDecimal(row.withdrawalFee)) {
+        throw new PerpsError(
+          PerpsErrorCode.SDKError,
+          `Provider '${params.provider}' row for asset '${asset.id}' has a \`withdrawalFee\` that is not a non-negative decimal: '${row.withdrawalFee}'.`
+        )
+      }
+      return [
+        {
+          asset,
+          route: row.route,
+          available: row.available,
+          withdrawalFee: row.withdrawalFee,
+        },
+      ]
     })
   }
 

package/src/index.ts

@@ -252,8 +252,6 @@ export {
   signTypedData,
   signTypedDataWithSigner,
 } from './utils/signTypedData.js'
-export type { RemovableIsolatedMarginParams } from './utils/transferMargin.js'
-export { removableIsolatedMargin } from './utils/transferMargin.js'
 export { fromBaseUnits, fromBaseUnitsNumber } from './utils/units.js'
 export { validateMargin } from './utils/validation.js'
 export { createWarnOnce } from './utils/warnOnce.js'

package/src/types/provider.ts

@@ -21,7 +21,6 @@ import type {
   PortfolioHistoryRange,
   PortfolioHistoryResponse,
   Position,
-  PositionMarginConstraints,
   PositionsResponse,
   ProviderAction,
   Quote,
@@ -457,10 +456,10 @@ export interface PerpsProviderPlugin {
   /**
    * The amounts the account can still buy and sell on one market, in that
    * market's margin asset. Optional because venues expose this unevenly:
-   * Hyperliquid reads it directly (`activeAssetData`), other venues publish
-   * only an account-scoped figure. `undefined` means the venue has nothing
-   * to read for this market, and the caller falls back to the account
-   * summary.
+   * Hyperliquid (`activeAssetData`) and Ondo (`max_order_size`) read it
+   * directly, other venues publish only an account-scoped figure. `undefined`
+   * means the venue has nothing to read for this market, and the caller falls
+   * back to the account summary.
    */
   getAvailableToTrade?(
     params: ProviderGetAvailableToTradeParams,
@@ -563,16 +562,17 @@ export interface PerpsProviderPlugin {
   ): number | undefined
 
   /**
-   * Exact venue-owned constraints for changing `position`'s dedicated margin.
-   * Pure — providers normalize raw venue quantities onto the position before
-   * returning these inputs.
+   * Margin that can be removed from `position` under the venue margin rules,
+   * as an exact decimal string rounded down to the venue amount increment.
+   * Pure — each provider reads its own venue meaning of `Position.marginUsed`.
    *
-   * @returns `undefined` when this position has no individual margin
-   *   adjustment (for example a cross position or a cross-only venue).
+   * @returns `undefined` when the position has no individual margin
+   *   adjustment (for example a cross position or a cross-only venue), and
+   *   `'0'` when the venue accepts no margin removal for it.
+   * @throws {PerpsError} `ValidationError` when a `Position` decimal that the
+   *   venue formula reads is malformed.
    */
-  positionMarginConstraints(
-    position: Position
-  ): PositionMarginConstraints | undefined
+  positionRemovableMargin(position: Position): string | undefined
 
   /**
    * Project a typed {@link AccountConfig} against the provider's `setup`

package/src/types/withdrawal.ts

@@ -22,6 +22,12 @@ export interface ProviderWithdrawableBalance {
   route: WithdrawalRoute
   /** Withdrawable amount in the asset's own units. Always greater than zero. */
   available: string
+  /**
+   * Flat venue fee on a withdrawal from this row, in the asset's own units.
+   * Absent when the venue publishes no fee for the asset. The client rejects a
+   * value that is not a non-negative decimal.
+   */
+  withdrawalFee?: string
 }
 
 /**
@@ -36,4 +42,10 @@ export interface WithdrawableBalance {
   route: WithdrawalRoute
   /** Withdrawable amount in the asset's own units. */
   available: string
+  /**
+   * Flat venue fee on a withdrawal from this row, in the asset's own units. An
+   * amount at or below it delivers nothing. Absent when the venue publishes no
+   * fee for the asset.
+   */
+  withdrawalFee?: string
 }

package/src/version.ts

@@ -10,4 +10,4 @@ export const name = '@lifi/perps-sdk'
  *
  * @public
  */
-export const version = '16.0.0'
+export const version = '17.0.1'

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/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/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/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()
-}