@lifi/perps-sdk 20.1.0 → 21.0.0

package/dist/esm/wire/orderAmounts.d.ts

@@ -0,0 +1,55 @@
+import { type DecimalString, type Market } from '@lifi/perps-types';
+import type { PerpsSDKClient } from '../types/provider.js';
+/** @public */
+export interface OrderAmountsInput {
+    sdk: PerpsSDKClient;
+    market: Market;
+    /** The field the user typed; the other two are calculated from it. */
+    held: 'margin' | 'size' | 'notional';
+    amount: DecimalString;
+    leverage: number;
+    price: DecimalString;
+    /** Decimals for the quote-asset amounts (margin, notional). Default 2. */
+    quoteDecimals?: number;
+}
+/** @public */
+export interface OrderAmounts {
+    /**
+     * On the `quoteDecimals` grid: rounded up when derived, so it funds `size`
+     * at the requested leverage, and truncated when the user holds it.
+     */
+    margin: DecimalString;
+    /** Snapped onto the venue lot grid. */
+    size: DecimalString;
+    /** Truncated to `quoteDecimals`. */
+    notional: DecimalString;
+}
+/**
+ * The three order-entry amounts, derived from whichever one the user typed.
+ *
+ * The held field is normalised first — truncated to `quoteDecimals` for a
+ * margin or notional, snapped onto the venue lot grid for a size — and the
+ * other two are then derived from that normalised value, so the three agree
+ * with each other rather than with an input the user cannot see.
+ *
+ * Rounding is directional, so the result always funds itself:
+ * `size × price ≤ margin × leverage`. A derived size truncates onto the lot
+ * grid and a derived notional truncates onto the quote grid, but a derived
+ * margin rounds **up** onto the quote grid, because it is the one amount that
+ * has to cover the others rather than cap them.
+ *
+ * Formulas: `size = margin × leverage ÷ price`,
+ * `margin = size × price ÷ leverage`, `notional = size × price`
+ * (or `margin × leverage` when the margin is held).
+ *
+ * @returns `null` when `amount` or `price` is not a positive decimal string,
+ *   when `leverage` is not a positive finite number, or when the venue and
+ *   quote grids snap the result to a non-positive amount — a sub-lot size or
+ *   a sub-cent quote amount describes no order a venue can take.
+ * @throws {PerpsError} `ValidationError` when `quoteDecimals` is not a
+ *   non-negative integer, or `SDKError` when `market.providerId` names no
+ *   registered provider plugin.
+ * @public
+ */
+export declare function calculateOrderAmounts(input: OrderAmountsInput): OrderAmounts | null;
+//# sourceMappingURL=orderAmounts.d.ts.map

package/dist/esm/wire/orderAmounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderAmounts.d.ts","sourceRoot":"","sources":["../../../src/wire/orderAmounts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,MAAM,EAEZ,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1D,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,aAAa,CAAA;IACpB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,cAAc;AACd,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,EAAE,aAAa,CAAA;IACrB,uCAAuC;IACvC,IAAI,EAAE,aAAa,CAAA;IACnB,oCAAoC;IACpC,QAAQ,EAAE,aAAa,CAAA;CACxB;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,GACvB,YAAY,GAAG,IAAI,CAqDrB"}

package/dist/esm/wire/orderAmounts.js

@@ -0,0 +1,114 @@
+import { isDecimalString, PerpsErrorCode, } from '@lifi/perps-types';
+import Big from 'big.js';
+import { TruncBig } from '../decimal/big.js';
+import { PerpsError } from '../errors/PerpsError.js';
+import { snapOrderSize } from './snap.js';
+const DEFAULT_QUOTE_DECIMALS = 2;
+const TEN = new Big(10);
+/** Round a quote amount down onto its decimal grid, with no trailing zeros. */
+function quoteAmount(value, decimals) {
+    const truncated = value.round(decimals, Big.roundDown);
+    return truncated.eq(0) ? '0' : truncated.toFixed();
+}
+/**
+ * The smallest margin on the `decimals` grid that funds `notional` at
+ * `leverage`, so `margin × leverage ≥ notional` holds. The one derived amount
+ * that rounds up: a margin rounded down under-funds the size it backs.
+ *
+ * The ceiling is exact: the remainder decides the carry, so the result never
+ * leans on a fixed decimal-place limit the way `div` then `round` would.
+ */
+function coveringMargin(notional, leverage, decimals) {
+    const scale = TEN.pow(decimals);
+    const scaled = notional.times(scale);
+    const remainder = scaled.mod(leverage);
+    const whole = scaled.minus(remainder).div(leverage);
+    const covering = remainder.eq(0) ? whole : whole.plus(1);
+    return covering.eq(0) ? '0' : covering.div(scale).toFixed();
+}
+/**
+ * An order needs three positive amounts. A grid that snaps any of them to
+ * zero — a sub-lot size, a sub-cent quote amount — describes no order a venue
+ * can take, so the caller gets `null` instead of a result it has to re-check.
+ */
+function executable(amounts) {
+    const positive = new Big(amounts.size).gt(0) &&
+        new Big(amounts.margin).gt(0) &&
+        new Big(amounts.notional).gt(0);
+    return positive ? amounts : null;
+}
+function positiveDecimal(value) {
+    if (!isDecimalString(value)) {
+        return null;
+    }
+    const parsed = new TruncBig(value);
+    return parsed.gt(0) ? parsed : null;
+}
+/**
+ * The three order-entry amounts, derived from whichever one the user typed.
+ *
+ * The held field is normalised first — truncated to `quoteDecimals` for a
+ * margin or notional, snapped onto the venue lot grid for a size — and the
+ * other two are then derived from that normalised value, so the three agree
+ * with each other rather than with an input the user cannot see.
+ *
+ * Rounding is directional, so the result always funds itself:
+ * `size × price ≤ margin × leverage`. A derived size truncates onto the lot
+ * grid and a derived notional truncates onto the quote grid, but a derived
+ * margin rounds **up** onto the quote grid, because it is the one amount that
+ * has to cover the others rather than cap them.
+ *
+ * Formulas: `size = margin × leverage ÷ price`,
+ * `margin = size × price ÷ leverage`, `notional = size × price`
+ * (or `margin × leverage` when the margin is held).
+ *
+ * @returns `null` when `amount` or `price` is not a positive decimal string,
+ *   when `leverage` is not a positive finite number, or when the venue and
+ *   quote grids snap the result to a non-positive amount — a sub-lot size or
+ *   a sub-cent quote amount describes no order a venue can take.
+ * @throws {PerpsError} `ValidationError` when `quoteDecimals` is not a
+ *   non-negative integer, or `SDKError` when `market.providerId` names no
+ *   registered provider plugin.
+ * @public
+ */
+export function calculateOrderAmounts(input) {
+    const { sdk, market, held, leverage, quoteDecimals = DEFAULT_QUOTE_DECIMALS, } = input;
+    if (!Number.isInteger(quoteDecimals) || quoteDecimals < 0) {
+        throw new PerpsError(PerpsErrorCode.ValidationError, `Invalid quoteDecimals for order amounts: ${quoteDecimals}`);
+    }
+    const amount = positiveDecimal(input.amount);
+    const price = positiveDecimal(input.price);
+    if (amount === null ||
+        price === null ||
+        !Number.isFinite(leverage) ||
+        leverage <= 0) {
+        return null;
+    }
+    const leverageFactor = new TruncBig(leverage);
+    if (held === 'size') {
+        const size = snapOrderSize(sdk, market, amount.toFixed());
+        const notional = new TruncBig(size).times(price);
+        return executable({
+            margin: coveringMargin(notional, leverageFactor, quoteDecimals),
+            size,
+            notional: quoteAmount(notional, quoteDecimals),
+        });
+    }
+    if (held === 'notional') {
+        const notional = quoteAmount(amount, quoteDecimals);
+        const exact = new TruncBig(notional);
+        return executable({
+            margin: coveringMargin(exact, leverageFactor, quoteDecimals),
+            size: snapOrderSize(sdk, market, exact.div(price).toFixed()),
+            notional,
+        });
+    }
+    const margin = quoteAmount(amount, quoteDecimals);
+    const notional = new TruncBig(margin).times(leverage);
+    return executable({
+        margin,
+        size: snapOrderSize(sdk, market, notional.div(price).toFixed()),
+        notional: quoteAmount(notional, quoteDecimals),
+    });
+}
+//# sourceMappingURL=orderAmounts.js.map

package/dist/esm/wire/orderAmounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderAmounts.js","sourceRoot":"","sources":["../../../src/wire/orderAmounts.ts"],"names":[],"mappings":"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"}

package/dist/esm/wire/refuel.d.ts

@@ -0,0 +1,28 @@
+import { type DecimalString } from '@lifi/perps-types';
+/** @public */
+export interface RefuelAmountInput {
+    /** USD value of the gas the route recommends. */
+    gasUsd: DecimalString;
+    /** USD price of one whole source token. */
+    priceUsd: DecimalString;
+    /** Decimals of the source token, which the result is spelled to exactly. */
+    decimals: number;
+}
+/**
+ * Source-token amount whose USD value covers `gasUsd`, rounded **up** onto
+ * the token's decimal grid so a refuel never lands short of the
+ * recommendation. The result keeps trailing zeros to `decimals`, so it seeds
+ * an amount input at the token's own precision.
+ *
+ * The quotient does not terminate for most prices, which is why this is a
+ * big.js primitive: an 18-decimal token needs a ceiling at 10^-18, far past
+ * what a `number` can carry.
+ *
+ * @returns `undefined` when `gasUsd` or `priceUsd` is not greater than zero,
+ *   which is a route with nothing to refuel rather than a failure.
+ * @throws {PerpsError} `ValidationError` when `gasUsd` or `priceUsd` is not a
+ *   {@link DecimalString}, or when `decimals` is not a non-negative integer.
+ * @public
+ */
+export declare function calculateRefuelAmount(input: RefuelAmountInput): DecimalString | undefined;
+//# sourceMappingURL=refuel.d.ts.map

package/dist/esm/wire/refuel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refuel.d.ts","sourceRoot":"","sources":["../../../src/wire/refuel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,mBAAmB,CAAA;AAKtE,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,MAAM,EAAE,aAAa,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,aAAa,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,GACvB,aAAa,GAAG,SAAS,CAiB3B"}

package/dist/esm/wire/refuel.js

@@ -0,0 +1,36 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { DivBig } from '../decimal/big.js';
+import { PerpsError } from '../errors/PerpsError.js';
+import { requireDecimal } from './requireDecimal.js';
+/**
+ * Source-token amount whose USD value covers `gasUsd`, rounded **up** onto
+ * the token's decimal grid so a refuel never lands short of the
+ * recommendation. The result keeps trailing zeros to `decimals`, so it seeds
+ * an amount input at the token's own precision.
+ *
+ * The quotient does not terminate for most prices, which is why this is a
+ * big.js primitive: an 18-decimal token needs a ceiling at 10^-18, far past
+ * what a `number` can carry.
+ *
+ * @returns `undefined` when `gasUsd` or `priceUsd` is not greater than zero,
+ *   which is a route with nothing to refuel rather than a failure.
+ * @throws {PerpsError} `ValidationError` when `gasUsd` or `priceUsd` is not a
+ *   {@link DecimalString}, or when `decimals` is not a non-negative integer.
+ * @public
+ */
+export function calculateRefuelAmount(input) {
+    const { decimals } = input;
+    if (!Number.isInteger(decimals) || decimals < 0) {
+        throw new PerpsError(PerpsErrorCode.ValidationError, `Invalid \`decimals\` for a refuel amount: ${decimals}`);
+    }
+    const gasUsd = requireDecimal(input.gasUsd, 'gasUsd');
+    const priceUsd = requireDecimal(input.priceUsd, 'priceUsd');
+    if (!gasUsd.gt(0) || !priceUsd.gt(0)) {
+        return undefined;
+    }
+    return new DivBig(gasUsd)
+        .div(priceUsd)
+        .round(decimals, DivBig.roundUp)
+        .toFixed(decimals);
+}
+//# sourceMappingURL=refuel.js.map

package/dist/esm/wire/refuel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refuel.js","sourceRoot":"","sources":["../../../src/wire/refuel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAYpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAwB;IAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,6CAA6C,QAAQ,EAAE,CACxD,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACrD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IAC3D,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;SACtB,GAAG,CAAC,QAAQ,CAAC;SACb,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;SAC/B,OAAO,CAAC,QAAQ,CAAC,CAAA;AACtB,CAAC"}

package/dist/esm/wire/requireDecimal.d.ts

@@ -0,0 +1,11 @@
+import { type DecimalString } from '@lifi/perps-types';
+import Big from 'big.js';
+/**
+ * Parse a wire-tier decimal input, naming the field it came from when the
+ * value breaks the {@link DecimalString} contract, so a malformed amount
+ * fails at the SDK boundary instead of inside big.js.
+ *
+ * @throws {PerpsError} `ValidationError` naming `field`.
+ */
+export declare function requireDecimal(value: DecimalString, field: string): Big;
+//# sourceMappingURL=requireDecimal.d.ts.map

package/dist/esm/wire/requireDecimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireDecimal.d.ts","sourceRoot":"","sources":["../../../src/wire/requireDecimal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,GAAG,MAAM,QAAQ,CAAA;AAGxB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAQvE"}

package/dist/esm/wire/requireDecimal.js

@@ -0,0 +1,17 @@
+import { isDecimalString, PerpsErrorCode, } from '@lifi/perps-types';
+import Big from 'big.js';
+import { PerpsError } from '../errors/PerpsError.js';
+/**
+ * Parse a wire-tier decimal input, naming the field it came from when the
+ * value breaks the {@link DecimalString} contract, so a malformed amount
+ * fails at the SDK boundary instead of inside big.js.
+ *
+ * @throws {PerpsError} `ValidationError` naming `field`.
+ */
+export function requireDecimal(value, field) {
+    if (!isDecimalString(value)) {
+        throw new PerpsError(PerpsErrorCode.ValidationError, `Invalid \`${field}\`: '${value}' is not a decimal string.`);
+    }
+    return new Big(value);
+}
+//# sourceMappingURL=requireDecimal.js.map

package/dist/esm/wire/requireDecimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireDecimal.js","sourceRoot":"","sources":["../../../src/wire/requireDecimal.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,GAAG,MAAM,QAAQ,CAAA;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoB,EAAE,KAAa;IAChE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,aAAa,KAAK,QAAQ,KAAK,4BAA4B,CAC5D,CAAA;IACH,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC"}

package/dist/esm/wire/snap.d.ts

@@ -0,0 +1,24 @@
+import type { DecimalString, Market } from '@lifi/perps-types';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Snap `size` onto the lot grid of `market`'s venue, truncating toward zero,
+ * through the market's own provider. Takes and gives a {@link DecimalString},
+ * so a caller never converts an order size to a `number`.
+ *
+ * @throws {PerpsError} `SDKError` when `market.providerId` names no registered
+ *   provider plugin.
+ * @public
+ */
+export declare function snapOrderSize(sdk: PerpsSDKClient, market: Market, size: DecimalString): DecimalString;
+/**
+ * Snap `price` onto the tick grid of `market`'s venue, rounding half-up,
+ * through the market's own provider. Takes and gives a {@link DecimalString},
+ * so a caller never converts an order price to a `number`.
+ *
+ * @throws {PerpsError} `SDKError` when `market.providerId` names no registered
+ *   provider plugin, or `ValidationError` when the market lacks the tick
+ *   metadata the venue's rules need.
+ * @public
+ */
+export declare function snapOrderPrice(sdk: PerpsSDKClient, market: Market, price: DecimalString): DecimalString;
+//# sourceMappingURL=snap.d.ts.map

package/dist/esm/wire/snap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap.d.ts","sourceRoot":"","sources":["../../../src/wire/snap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,GAClB,aAAa,CAEf;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,GACnB,aAAa,CAEf"}

package/dist/esm/wire/snap.js

@@ -0,0 +1,27 @@
+import { requireProvider } from '../client/requireProvider.js';
+/**
+ * Snap `size` onto the lot grid of `market`'s venue, truncating toward zero,
+ * through the market's own provider. Takes and gives a {@link DecimalString},
+ * so a caller never converts an order size to a `number`.
+ *
+ * @throws {PerpsError} `SDKError` when `market.providerId` names no registered
+ *   provider plugin.
+ * @public
+ */
+export function snapOrderSize(sdk, market, size) {
+    return requireProvider(sdk, market.providerId).snapOrderSize(market, size);
+}
+/**
+ * Snap `price` onto the tick grid of `market`'s venue, rounding half-up,
+ * through the market's own provider. Takes and gives a {@link DecimalString},
+ * so a caller never converts an order price to a `number`.
+ *
+ * @throws {PerpsError} `SDKError` when `market.providerId` names no registered
+ *   provider plugin, or `ValidationError` when the market lacks the tick
+ *   metadata the venue's rules need.
+ * @public
+ */
+export function snapOrderPrice(sdk, market, price) {
+    return requireProvider(sdk, market.providerId).snapOrderPrice(market, price);
+}
+//# sourceMappingURL=snap.js.map

package/dist/esm/wire/snap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap.js","sourceRoot":"","sources":["../../../src/wire/snap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAmB,EACnB,MAAc,EACd,IAAmB;IAEnB,OAAO,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAC5E,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAmB,EACnB,MAAc,EACd,KAAoB;IAEpB,OAAO,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC9E,CAAC"}

package/dist/esm/wire/transferable.d.ts

@@ -0,0 +1,15 @@
+import type { DecimalString } from '@lifi/perps-types';
+/**
+ * The part of `units` that a venue-wide free figure releases: never below
+ * zero, never above the units held. `Balance.transferable` on every provider
+ * is this clamp over the venue's own free-margin or unlocked-balance figure.
+ *
+ * @param venueFigure - The venue's free figure for the category, which can
+ *   exceed `units` or fall below zero.
+ * @param units - Units held in the category, the upper bound of the clamp.
+ * @throws {PerpsError} `ValidationError` when either input is not a
+ *   {@link DecimalString}, naming the field.
+ * @public
+ */
+export declare function calculateTransferable(venueFigure: DecimalString, units: DecimalString): DecimalString;
+//# sourceMappingURL=transferable.d.ts.map

package/dist/esm/wire/transferable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transferable.d.ts","sourceRoot":"","sources":["../../../src/wire/transferable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGtD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,aAAa,EAC1B,KAAK,EAAE,aAAa,GACnB,aAAa,CAOf"}

package/dist/esm/wire/transferable.js

@@ -0,0 +1,22 @@
+import { requireDecimal } from './requireDecimal.js';
+/**
+ * The part of `units` that a venue-wide free figure releases: never below
+ * zero, never above the units held. `Balance.transferable` on every provider
+ * is this clamp over the venue's own free-margin or unlocked-balance figure.
+ *
+ * @param venueFigure - The venue's free figure for the category, which can
+ *   exceed `units` or fall below zero.
+ * @param units - Units held in the category, the upper bound of the clamp.
+ * @throws {PerpsError} `ValidationError` when either input is not a
+ *   {@link DecimalString}, naming the field.
+ * @public
+ */
+export function calculateTransferable(venueFigure, units) {
+    const figure = requireDecimal(venueFigure, 'venueFigure');
+    const held = requireDecimal(units, 'units');
+    if (figure.lt(0)) {
+        return '0';
+    }
+    return (figure.gt(held) ? held : figure).toFixed();
+}
+//# sourceMappingURL=transferable.js.map

package/dist/esm/wire/transferable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transferable.js","sourceRoot":"","sources":["../../../src/wire/transferable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAA0B,EAC1B,KAAoB;IAEpB,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;IACzD,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC3C,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAA;AACpD,CAAC"}

package/dist/esm/wire/withdraw.d.ts

@@ -0,0 +1,14 @@
+import type { DecimalString } from '@lifi/perps-types';
+import type { WithdrawableBalance } from '../types/withdrawal.js';
+/**
+ * Largest `amount` a withdrawable row can fund: `available` when the venue
+ * deducts the fee from the amount or publishes no fee, and
+ * `available − withdrawalFee` floored at zero when the venue charges the fee
+ * on top (`isFeeDeducted === false`).
+ *
+ * @throws {PerpsError} `ValidationError` when `available` or `withdrawalFee`
+ *   is not a {@link DecimalString}, naming the field.
+ * @public
+ */
+export declare function calculateWithdrawMax(row: Pick<WithdrawableBalance, 'available' | 'withdrawalFee' | 'isFeeDeducted'>): DecimalString;
+//# sourceMappingURL=withdraw.d.ts.map

package/dist/esm/wire/withdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw.d.ts","sourceRoot":"","sources":["../../../src/wire/withdraw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAGjE;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,CACP,mBAAmB,EACnB,WAAW,GAAG,eAAe,GAAG,eAAe,CAChD,GACA,aAAa,CASf"}

package/dist/esm/wire/withdraw.js

@@ -0,0 +1,20 @@
+import { requireDecimal } from './requireDecimal.js';
+/**
+ * Largest `amount` a withdrawable row can fund: `available` when the venue
+ * deducts the fee from the amount or publishes no fee, and
+ * `available − withdrawalFee` floored at zero when the venue charges the fee
+ * on top (`isFeeDeducted === false`).
+ *
+ * @throws {PerpsError} `ValidationError` when `available` or `withdrawalFee`
+ *   is not a {@link DecimalString}, naming the field.
+ * @public
+ */
+export function calculateWithdrawMax(row) {
+    const available = requireDecimal(row.available, 'available');
+    if (row.isFeeDeducted !== false || row.withdrawalFee === undefined) {
+        return available.toFixed();
+    }
+    const funded = available.minus(requireDecimal(row.withdrawalFee, 'withdrawalFee'));
+    return funded.gt(0) ? funded.toFixed() : '0';
+}
+//# sourceMappingURL=withdraw.js.map

package/dist/esm/wire/withdraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw.js","sourceRoot":"","sources":["../../../src/wire/withdraw.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAGC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IAC5D,IAAI,GAAG,CAAC,aAAa,KAAK,KAAK,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACnE,OAAO,SAAS,CAAC,OAAO,EAAE,CAAA;IAC5B,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAC5B,cAAc,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,CACnD,CAAA;IACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;AAC9C,CAAC"}

package/dist/types/client/PerpsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/PerpsClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/PerpsClient.ts"],"names":[],"mappings":"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"}

package/dist/types/{utils/decimal.d.ts → decimal/big.d.ts}

@@ -11,4 +11,4 @@ export declare const DivBig: Big.BigConstructor;
 export declare const TruncBig: Big.BigConstructor;
 /** True when every value is a finite number, so `new DivBig(value)` cannot throw. */
 export declare function areFinite(...values: number[]): boolean;
-//# sourceMappingURL=decimal.d.ts.map
+//# sourceMappingURL=big.d.ts.map

package/dist/types/decimal/big.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"big.d.ts","sourceRoot":"","sources":["../../../src/decimal/big.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB;;;GAGG;AACH,eAAO,MAAM,MAAM,oBAAQ,CAAA;AAG3B;;;GAGG;AACH,eAAO,MAAM,QAAQ,oBAAQ,CAAA;AAI7B,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAEtD"}

package/dist/types/decimal/convert.d.ts

@@ -0,0 +1,80 @@
+import { type DecimalString } from '@lifi/perps-types';
+/**
+ * Off-grid resolution for {@link decimalToBaseUnits}:
+ * - `truncate` — toward zero, for sizes and collateral amounts. The wire
+ *   value never exceeds the caller's intent.
+ * - `round` — half away from zero, for prices, which snap to the nearest
+ *   tick.
+ * @public
+ */
+export type BaseUnitsRounding = 'truncate' | 'round';
+/**
+ * @deprecated Use `BaseUnitsRounding`. Removed in the next major.
+ */
+export type ScaleToIntegerPolicy = BaseUnitsRounding;
+/**
+ * Scale a decimal string to a scaled integer in exact decimal arithmetic — an
+ * on-grid input maps to its exact scaled integer with no binary float
+ * artifacts (`'0.29'` at 2 decimals is 29, never 28). Off-grid input resolves
+ * per `rounding`; there is no silent default.
+ *
+ * @throws {PerpsError} `ValidationError` when `value` is not a decimal
+ *   numeric string, `decimals` is not a non-negative integer, or the scaled
+ *   result's magnitude exceeds `Number.MAX_SAFE_INTEGER`.
+ * @public
+ */
+export declare const decimalToBaseUnits: (value: DecimalString, decimals: number, rounding: BaseUnitsRounding) => number;
+/**
+ * @deprecated Use `decimalToBaseUnits`. Removed in the next major.
+ */
+export declare const scaleToInteger: (value: DecimalString, decimals: number, rounding: BaseUnitsRounding) => number;
+/**
+ * Convert a base-unit amount (bigint string) to a decimal string.
+ *
+ * @param amount - Amount in base units (e.g. "1000000" for 1 USDC)
+ * @param decimals - Token decimals (e.g. 6 for USDC)
+ * @returns Decimal string; `"0"` when `amount` is not a valid bigint
+ * @example
+ * ```ts
+ * baseUnitsToDecimal('1000000', 6) // '1'
+ * ```
+ * @public
+ */
+export declare function baseUnitsToDecimal(amount: string, decimals: number): DecimalString;
+/**
+ * @deprecated Use `baseUnitsToDecimal`. Removed in the next major.
+ */
+export declare const fromBaseUnits: typeof baseUnitsToDecimal;
+/**
+ * @deprecated Compose `parseDecimal(baseUnitsToDecimal(...))`. Removed in the
+ * next major.
+ */
+export declare function fromBaseUnitsNumber(amount: string, decimals: number): number;
+/**
+ * Round `value` down to `decimals` and pad the result to exactly that many
+ * decimal places. The padding is the point: this seeds a fixed-decimal input,
+ * where `'500.00'` and `'500'` are two renderings of one amount and the field
+ * wants the first. For a canonical wire amount with no trailing zeros, read
+ * the amount off `calculateOrderAmounts` or a provider snap instead.
+ *
+ * Exact decimal arithmetic throughout, so there is no 2^53 ceiling and no
+ * float artifact: `'0.01'` at 18 decimals gives
+ * `'0.010000000000000000'`, which `Number#toFixed` cannot.
+ *
+ * @throws {PerpsError} `ValidationError` when `value` is not a decimal
+ *   numeric string, or `decimals` is not a non-negative integer.
+ * @public
+ */
+export declare function truncateDecimal(value: DecimalString, decimals: number): DecimalString;
+/**
+ * Spell a `number` as a {@link DecimalString} in plain notation: `1e-7`
+ * becomes `'0.0000001'`, never `'1e-7'`. The boundary helper for a venue or
+ * browser API that hands out numbers; a value already spelled as a decimal
+ * string must not round-trip through here, because above 15 significant
+ * digits the `number` has already lost digits.
+ *
+ * @throws {PerpsError} `ValidationError` when `value` is `NaN` or infinite.
+ * @public
+ */
+export declare function numberToDecimalString(value: number): DecimalString;
+//# sourceMappingURL=convert.d.ts.map

package/dist/types/decimal/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/decimal/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,mBAAmB,CAAA;AAMtE;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,CAAA;AAEpD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,aAAa,EACpB,UAAU,MAAM,EAChB,UAAU,iBAAiB,KAC1B,MA0BF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,UAlClB,aAAa,YACV,MAAM,YACN,iBAAiB,KAC1B,MA+B6C,CAAA;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,aAAa,CAMf;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,2BAAqB,CAAA;AAE/C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,GACf,aAAa,CAmBf;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CASlE"}

package/dist/types/decimal/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/decimal/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAA;AAI7C,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAyFrD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkBR"}

package/dist/types/decimal/parse.d.ts

@@ -0,0 +1,29 @@
+import type { DecimalString } from '@lifi/perps-types';
+/**
+ * Parse a string to a float, stripping common formatting artefacts.
+ *
+ * Handles:
+ * - Currency prefixes/suffixes ($, USD, etc.)
+ * - Explicit sign prefixes (+/-)
+ * - Thousands separators (commas)
+ * - Percentage suffixes (%)
+ * - Whitespace
+ *
+ * @returns Parsed number; `0` for empty/blank input, `NaN` when a non-empty
+ *   string contains no parseable number
+ */
+declare function toFloat(value: string): number;
+/**
+ * @deprecated Use `parseDecimal`. Removed in the next major.
+ */
+export declare const stringToFloat: typeof toFloat;
+/**
+ * Parse an optional decimal field, tolerating currency symbols, grouping
+ * separators and a percentage suffix around the number.
+ * Gives back `undefined` for a missing, malformed or non-finite value, and `0` for an empty string.
+ *
+ * @public
+ */
+export declare function parseDecimal(value: DecimalString | string | null | undefined): number | undefined;
+export {};
+//# sourceMappingURL=parse.d.ts.map

package/dist/types/decimal/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/decimal/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD;;;;;;;;;;;;GAYG;AACH,iBAAS,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAStC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,gBAAU,CAAA;AAKpC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,GAAG,SAAS,CAYpB"}