@lifi/perps-sdk 0.1.1-alpha.9 → 0.2.0-alpha.0

package/dist/esm/signers/lighter/wasmLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasmLoader.d.ts","sourceRoot":"","sources":["../../../../src/signers/lighter/wasmLoader.ts"],"names":[],"mappings":"AAwDA,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;IAC5B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;IAC5B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK;QACjC,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,YAAY,EAAE,CACZ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9E;;;;;OAKG;IACH,eAAe,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C;;;;;;;OAOG;IACH,gBAAgB,EAAE,CAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB,UAAU,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD,mBAAmB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACvD,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IAChD,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IAChD,kBAAkB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACtD,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD,gBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;CACrD;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAsFD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAK7B;AA+DD,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/esm/signers/lighter/wasmLoader.js

@@ -0,0 +1,181 @@
+// ---------------------------------------------------------------------------
+// Lighter WASM loader
+//
+// Loads the Go-compiled `lighter-signer.wasm` and its companion `wasm_exec.js`
+// runtime. The Go runtime installs functions (SignCreateOrder, SignCancelOrder,
+// etc.) onto `globalThis` when `go.run(instance)` starts the main goroutine.
+//
+// The default asset URLs resolve relative to this module's emitted JS file:
+//   src/signers/lighter/../../../wasm/lighter-signer.wasm  → repo-root wasm/
+//   dist/{esm,cjs}/signers/lighter/../../../wasm/…         → dist/{esm,cjs}/wasm/
+//
+// The build script copies the wasm assets into both dist subtrees so the same
+// relative path resolves at runtime regardless of which bundle is loaded.
+//
+// To resolve the module's own URL in both ESM (where `__filename` is absent)
+// and CJS (where `import.meta.url` is a syntax error), we parse a stack trace
+// — `currentModuleUrl` always appears as the first frame, and V8 includes the
+// emitting file path regardless of module system. Callers can override both
+// asset URLs via {@link LoadLighterWasmOptions} to bypass this heuristic.
+// ---------------------------------------------------------------------------
+function currentModuleUrl() {
+    const cjsFilename = globalThis.__filename;
+    if (typeof cjsFilename === 'string' && cjsFilename.length > 0) {
+        return `file://${cjsFilename}`;
+    }
+    const stack = new Error().stack ?? '';
+    // Stack frames look like one of:
+    //   "    at currentModuleUrl (file:///abs/path/wasmLoader.js:29:10)"
+    //   "    at currentModuleUrl (/abs/path/wasmLoader.js:29:10)"
+    //   "    at currentModuleUrl (file:///abs/path/wasmLoader.ts:29:10)"  (vitest)
+    //   "    at currentModuleUrl (http://localhost:5173/.../wasmLoader.ts?v=…:29:10)" (vite dev)
+    const match = stack.match(/\(([^)]+wasmLoader\.[tj]s[^)]*)\)/);
+    const frame = match?.[1] ?? '';
+    const withoutPos = frame.replace(/:\d+:\d+$/, '');
+    if (withoutPos.startsWith('file://') ||
+        withoutPos.startsWith('http://') ||
+        withoutPos.startsWith('https://')) {
+        return withoutPos;
+    }
+    if (withoutPos.length > 0) {
+        // Bare absolute path (Node CJS without `file://` prefix in some runners).
+        return `file://${withoutPos}`;
+    }
+    throw new Error('Could not resolve the Lighter WASM loader module URL. Pass an explicit ' +
+        '`wasmBinaryUrl` and `wasmExecJsUrl` to loadLighterWasm().');
+}
+function defaultAssetUrl(filename) {
+    return new URL(`../../../wasm/${filename}`, currentModuleUrl());
+}
+const WASM_FUNCTION_NAMES = [
+    'GenerateAPIKey',
+    'CreateClient',
+    'CheckClient',
+    'CreateAuthToken',
+    'SignChangePubKey',
+    'SignCreateOrder',
+    'SignCancelOrder',
+    'SignCancelAllOrders',
+    'SignTransfer',
+    'SignWithdraw',
+    'SignUpdateLeverage',
+    'SignModifyOrder',
+    'SignUpdateMargin',
+];
+let cachedExports;
+// `node:fs/promises` and `node:url` are Node-only. Static imports force browser
+// bundlers (Vite/Rollup/esbuild) to resolve them up-front, which fails. Dynamic
+// `import('node:...')` lets bundlers leave the branch unreachable in browsers
+// while Node still resolves it at runtime when asked for a `file://` URL.
+async function readNodeFile(url) {
+    const [{ readFile }, { fileURLToPath }] = await Promise.all([
+        import(/* @vite-ignore */ 'node:fs/promises'),
+        import(/* @vite-ignore */ 'node:url'),
+    ]);
+    return readFile(fileURLToPath(url));
+}
+/**
+ * Resolve a possibly-relative URL string against the current document/page
+ * origin. Bundlers like Vite hand out absolute paths (e.g. `/node_modules/…`)
+ * for `?url` imports, which `new URL(string)` rejects without a base.
+ */
+function toResolvedUrl(url) {
+    if (url instanceof URL) {
+        return url;
+    }
+    const base = typeof globalThis !== 'undefined' &&
+        globalThis.location?.href
+        ? globalThis.location.href
+        : undefined;
+    return new URL(url, base);
+}
+async function readUrlBytes(url) {
+    const u = toResolvedUrl(url);
+    if (u.protocol === 'file:') {
+        const buf = await readNodeFile(u);
+        // Copy the view into a fresh ArrayBuffer — `Buffer.buffer` is a shared
+        // ArrayBuffer in Node and the wasm instantiator expects a plain one.
+        return buf.slice().buffer;
+    }
+    const response = await fetch(u);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${u.href}: ${response.status} ${response.statusText}`);
+    }
+    return response.arrayBuffer();
+}
+async function readUrlText(url) {
+    const u = toResolvedUrl(url);
+    if (u.protocol === 'file:') {
+        const buf = await readNodeFile(u);
+        return new TextDecoder('utf-8').decode(buf);
+    }
+    const response = await fetch(u);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${u.href}: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+}
+/**
+ * Load the Lighter WASM signer. Memoized per-process: subsequent calls return
+ * the cached exports. The Go runtime keeps a long-running goroutine to service
+ * JS calls — we start it once and never stop it.
+ */
+export async function loadLighterWasm(options) {
+    if (!cachedExports) {
+        cachedExports = doLoad(options);
+    }
+    return cachedExports;
+}
+async function doLoad(options) {
+    const wasmBinaryUrl = options?.wasmBinaryUrl ?? defaultAssetUrl('lighter-signer.wasm');
+    // Prefer a pre-fetched source string (bundler `?raw` imports) over a URL —
+    // bundlers may transform a `.js` URL on serve, breaking the IIFE that sets
+    // `globalThis.Go`.
+    const wasmExecSourcePromise = options?.wasmExecJsSource !== undefined
+        ? Promise.resolve(options.wasmExecJsSource)
+        : readUrlText(options?.wasmExecJsUrl ?? defaultAssetUrl('wasm_exec.js'));
+    const [wasmExecSource, wasmBytes] = await Promise.all([
+        wasmExecSourcePromise,
+        readUrlBytes(wasmBinaryUrl),
+    ]);
+    // wasm_exec.js is an IIFE that installs `globalThis.Go = class { ... }` plus
+    // fs/process/crypto polyfills. Evaluate it in a Function scope so the class
+    // attaches to globalThis and we read it back from there.
+    const installGo = new Function(`${wasmExecSource}; return globalThis.Go`);
+    const Go = installGo();
+    const go = new Go();
+    const { instance } = await WebAssembly.instantiate(wasmBytes, go.importObject);
+    // Start the Go goroutine — this never resolves until the Go main() returns,
+    // which our signer never does. Intentionally not awaited.
+    void go.run(instance);
+    // Wait microtasks to let Go's init() register JS-bound functions.
+    await yieldToGoRuntime();
+    const exports = {};
+    for (const name of WASM_FUNCTION_NAMES) {
+        const fn = globalThis[name];
+        if (typeof fn !== 'function') {
+            throw new Error(`Lighter WASM did not export expected function: ${name}. ` +
+                'The .wasm binary may be stale or incompatible.');
+        }
+        ;
+        exports[name] = fn;
+    }
+    return exports;
+}
+async function yieldToGoRuntime() {
+    for (let i = 0; i < 2; i++) {
+        await new Promise((resolve) => {
+            if (typeof setImmediate === 'function') {
+                setImmediate(resolve);
+            }
+            else {
+                setTimeout(resolve, 0);
+            }
+        });
+    }
+}
+/** Testing helper — drop the cached WASM instance so the next load reinitializes. */
+export function resetLighterWasmCache() {
+    cachedExports = undefined;
+}
+//# sourceMappingURL=wasmLoader.js.map

package/dist/esm/signers/lighter/wasmLoader.js.map

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

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

@@ -0,0 +1,13 @@
+import type { AccountResponse, Asset, Position } from '@lifi/perps-types';
+export interface AccountSummary {
+    /** Total portfolio value in USD */
+    portfolioValue: number;
+    /** Collateral available for new positions */
+    availableMargin: number;
+    /** Margin locked in open positions */
+    marginUsed: number;
+    /** Unrealized PnL across all positions */
+    unrealizedPnl: number;
+}
+export declare function calculateAccountSummary(account: AccountResponse, positions: Position[], prices: Record<string, string>, assets?: Asset[], collateralCurrencies?: ReadonlySet<string>): AccountSummary;
+//# sourceMappingURL=accountSummary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accountSummary.d.ts","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIzE,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAA;IACvB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAA;CACtB;AAwDD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,CAAC,EAAE,KAAK,EAAE,EAChB,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACzC,cAAc,CAsDhB"}

package/dist/esm/utils/accountSummary.js

@@ -0,0 +1,97 @@
+import { HlAbstractionMode } from '@lifi/perps-types/providers/hyperliquid';
+import { stringToFloat } from './parse.js';
+/**
+ * Build a map of coin name → USD price from spot assets and allMids.
+ * Spot assets have displaySymbol "BASE/QUOTE" and assetId "@N" which keys into prices.
+ */
+function buildSpotCoinPrices(assets, prices) {
+    const map = new Map();
+    for (const asset of assets) {
+        if (asset.market !== 'spot') {
+            continue;
+        }
+        const price = prices[asset.assetId];
+        if (!price) {
+            continue;
+        }
+        const slashIdx = asset.displaySymbol.indexOf('/');
+        if (slashIdx < 0) {
+            continue;
+        }
+        const base = asset.displaySymbol.slice(0, slashIdx);
+        map.set(base, stringToFloat(price));
+    }
+    return map;
+}
+/**
+ * Resolve the USD price of a spot balance currency.
+ *
+ * Looks up the coin in the spot mid prices map first, then tries an exact
+ * match in allMids (e.g. a perps-listed stablecoin). Falls back to $1 for
+ * stablecoins with no market price entry.
+ */
+function getSpotPrice(currency, prices, spotCoinPrices) {
+    const spotPrice = spotCoinPrices.get(currency);
+    if (spotPrice !== undefined) {
+        return spotPrice;
+    }
+    if (prices[currency] !== undefined) {
+        return stringToFloat(prices[currency]);
+    }
+    return 1;
+}
+const UNIFIED_STATUSES = new Set([
+    HlAbstractionMode.UNIFIED_ACCOUNT,
+    HlAbstractionMode.PORTFOLIO_MARGIN,
+]);
+export function calculateAccountSummary(account, positions, prices, assets, collateralCurrencies) {
+    let marginUsed = 0;
+    let unrealizedPnl = 0;
+    for (const p of positions) {
+        marginUsed += stringToFloat(p.marginUsed);
+        unrealizedPnl += stringToFloat(p.unrealizedPnl);
+    }
+    const spotCoinPrices = buildSpotCoinPrices(assets ?? [], prices);
+    // Split spot into margin-eligible (quote assets) and non-margin (HYPE, PURR etc.)
+    let spotMarginValue = 0;
+    let spotNonMarginValue = 0;
+    let perpsBalance = 0;
+    for (const [key, entries] of Object.entries(account.balances)) {
+        if (key === 'spot') {
+            for (const b of entries) {
+                const value = stringToFloat(b.amount) *
+                    getSpotPrice(b.currency, prices, spotCoinPrices);
+                if (!collateralCurrencies || collateralCurrencies.has(b.currency)) {
+                    spotMarginValue += value;
+                }
+                else {
+                    spotNonMarginValue += value;
+                }
+            }
+        }
+        else {
+            for (const b of entries) {
+                perpsBalance += stringToFloat(b.amount);
+            }
+        }
+    }
+    // `abstractionMode` is HL-only; for any other provider variant (today
+    // Lighter) the unified-collateral semantics don't apply, so fall back
+    // to `undefined` and let the non-unified branch below run.
+    const status = account.config.provider === 'hyperliquid'
+        ? (account.config.abstractionMode ?? undefined)
+        : undefined;
+    const isUnified = UNIFIED_STATUSES.has(status ?? '');
+    // Unified: spot balances are total token holdings (margin is NOT subtracted).
+    // Disabled: perps venue balances are free margin (margin IS already subtracted).
+    const marginCollateral = isUnified
+        ? spotMarginValue + perpsBalance
+        : spotMarginValue + perpsBalance + marginUsed;
+    return {
+        portfolioValue: marginCollateral + spotNonMarginValue + unrealizedPnl,
+        availableMargin: marginCollateral - marginUsed,
+        marginUsed,
+        unrealizedPnl,
+    };
+}
+//# sourceMappingURL=accountSummary.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Exhaustiveness helper for discriminated-union switches.
+ *
+ * Use in the `default` arm of a `switch (discriminant)` block: TypeScript
+ * narrows the variable to `never` when every case is handled, so adding a
+ * new variant to the union without a corresponding `case` becomes a
+ * compile error here. At runtime — if reached — throw rather than return
+ * silently; the throw is unreachable in well-typed code but flags
+ * upstream-shape drift loudly.
+ *
+ * @example
+ *   switch (config.provider) {
+ *     case 'hyperliquid': return projectHyperliquid(config)
+ *     case 'lighter': return projectLighter(config)
+ *     default: return assertNever(config)
+ *   }
+ */
+export declare function assertNever(value: never): never;
+//# sourceMappingURL=assertNever.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAI/C"}

package/dist/esm/utils/assertNever.js

@@ -0,0 +1,21 @@
+/**
+ * Exhaustiveness helper for discriminated-union switches.
+ *
+ * Use in the `default` arm of a `switch (discriminant)` block: TypeScript
+ * narrows the variable to `never` when every case is handled, so adding a
+ * new variant to the union without a corresponding `case` becomes a
+ * compile error here. At runtime — if reached — throw rather than return
+ * silently; the throw is unreachable in well-typed code but flags
+ * upstream-shape drift loudly.
+ *
+ * @example
+ *   switch (config.provider) {
+ *     case 'hyperliquid': return projectHyperliquid(config)
+ *     case 'lighter': return projectLighter(config)
+ *     default: return assertNever(config)
+ *   }
+ */
+export function assertNever(value) {
+    throw new Error(`Unreachable: exhaustiveness check failed for value ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=assertNever.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.js","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,IAAI,KAAK,CACb,sDAAsD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAC9E,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,109 @@
+/**
+ * Universal perpetual futures calculation utilities.
+ *
+ * Pure functions for computing position-related values that any consumer
+ * of the perps SDK would need. All parameters are required — no default
+ * values for critical financial parameters.
+ */
+/**
+ * Calculate position size in asset units from margin.
+ *
+ * @param marginUsd - Margin amount in USD
+ * @param leverage - Position leverage
+ * @param price - Current asset price
+ * @returns Position size in asset units
+ */
+export declare function calculatePositionSize(marginUsd: number, leverage: number, price: number): number;
+/**
+ * Calculate notional value of a position.
+ *
+ * @param size - Position size in asset units
+ * @param price - Current asset price
+ * @returns Notional value in USD
+ */
+export declare function calculateNotionalValue(size: number, price: number): number;
+/**
+ * Calculate unrealized PnL.
+ *
+ * @param entryPrice - Position entry price
+ * @param currentPrice - Current market price
+ * @param size - Position size (positive for long, negative for short)
+ * @returns Unrealized PnL in USD
+ */
+export declare function calculateUnrealizedPnl(entryPrice: number, currentPrice: number, size: number): number;
+/**
+ * Calculate return on equity (ROE) percentage.
+ *
+ * @param pnl - Profit/loss in USD
+ * @param margin - Initial margin in USD
+ * @returns ROE as percentage (e.g., 10 for 10%)
+ */
+export declare function calculateRoe(pnl: number, margin: number): number;
+/**
+ * Calculate required margin for a position.
+ *
+ * @param notionalValue - Position notional value in USD
+ * @param leverage - Position leverage
+ * @returns Required margin in USD
+ */
+export declare function calculateRequiredMargin(notionalValue: number, leverage: number): number;
+/**
+ * Estimate trading fees.
+ *
+ * @param sizeUsd - Position size in USD (notional value)
+ * @param feeRate - Fee rate as decimal (e.g., 0.00035 for 0.035%)
+ * @returns Estimated fee in USD
+ */
+export declare function estimateFees(sizeUsd: number, feeRate: number): number;
+/**
+ * Apply slippage to a price for order execution.
+ *
+ * @param price - Base price
+ * @param slippagePercent - Slippage tolerance as percentage (e.g., 0.5 for 0.5%)
+ * @param isBuy - True if buying (price goes up), false if selling (price goes down)
+ * @returns Price adjusted for slippage
+ */
+export declare function applySlippage(price: number, slippagePercent: number, isBuy: boolean): number;
+export interface ExpectedPnl {
+    amount: number;
+    percent: number;
+}
+/**
+ * Calculate expected gain/loss for a TP or SL trigger price.
+ * Returns signed values — positive means profit, negative means loss.
+ *
+ * @param triggerPrice - The TP or SL target price
+ * @param entryPrice - Position entry / current market price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ * @param margin - Margin amount in USD
+ */
+export declare function calculateExpectedPnl(triggerPrice: number, entryPrice: number, leverage: number, isLong: boolean, margin: number): ExpectedPnl | null;
+/**
+ * Convert a percentage gain/loss to a target price.
+ *
+ * @param percent - Target gain/loss percentage (positive = profitable direction)
+ * @param entryPrice - Position entry price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ */
+export declare function priceFromPercent(percent: number, entryPrice: number, leverage: number, isLong: boolean): number;
+/**
+ * Convert a target price to a percentage gain/loss.
+ *
+ * @param price - Target price
+ * @param entryPrice - Position entry price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ */
+export declare function percentFromPrice(price: number, entryPrice: number, leverage: number, isLong: boolean): number;
+/**
+ * Calculate realized PnL as a percentage of position value at close.
+ *
+ * @param realizedPnl - The realized profit/loss in USD
+ * @param size - Position size in asset units at close
+ * @param price - Price at close
+ * @returns PnL as a percentage of position value
+ */
+export declare function calculateRealizedPnlPercent(realizedPnl: number, size: number, price: number): number;
+//# sourceMappingURL=calculations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../../src/utils/calculations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,GACb,MAAM,CAGR;AAMD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,WAAW,GAAG,IAAI,CAUpB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAMD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR"}

package/dist/esm/utils/calculations.js

@@ -0,0 +1,154 @@
+/**
+ * Universal perpetual futures calculation utilities.
+ *
+ * Pure functions for computing position-related values that any consumer
+ * of the perps SDK would need. All parameters are required — no default
+ * values for critical financial parameters.
+ */
+/**
+ * Calculate position size in asset units from margin.
+ *
+ * @param marginUsd - Margin amount in USD
+ * @param leverage - Position leverage
+ * @param price - Current asset price
+ * @returns Position size in asset units
+ */
+export function calculatePositionSize(marginUsd, leverage, price) {
+    return (marginUsd * leverage) / price;
+}
+/**
+ * Calculate notional value of a position.
+ *
+ * @param size - Position size in asset units
+ * @param price - Current asset price
+ * @returns Notional value in USD
+ */
+export function calculateNotionalValue(size, price) {
+    return Math.abs(size) * price;
+}
+/**
+ * Calculate unrealized PnL.
+ *
+ * @param entryPrice - Position entry price
+ * @param currentPrice - Current market price
+ * @param size - Position size (positive for long, negative for short)
+ * @returns Unrealized PnL in USD
+ */
+export function calculateUnrealizedPnl(entryPrice, currentPrice, size) {
+    return (currentPrice - entryPrice) * size;
+}
+/**
+ * Calculate return on equity (ROE) percentage.
+ *
+ * @param pnl - Profit/loss in USD
+ * @param margin - Initial margin in USD
+ * @returns ROE as percentage (e.g., 10 for 10%)
+ */
+export function calculateRoe(pnl, margin) {
+    if (margin === 0) {
+        return 0;
+    }
+    return (pnl / margin) * 100;
+}
+/**
+ * Calculate required margin for a position.
+ *
+ * @param notionalValue - Position notional value in USD
+ * @param leverage - Position leverage
+ * @returns Required margin in USD
+ */
+export function calculateRequiredMargin(notionalValue, leverage) {
+    return notionalValue / leverage;
+}
+/**
+ * Estimate trading fees.
+ *
+ * @param sizeUsd - Position size in USD (notional value)
+ * @param feeRate - Fee rate as decimal (e.g., 0.00035 for 0.035%)
+ * @returns Estimated fee in USD
+ */
+export function estimateFees(sizeUsd, feeRate) {
+    return sizeUsd * feeRate;
+}
+/**
+ * Apply slippage to a price for order execution.
+ *
+ * @param price - Base price
+ * @param slippagePercent - Slippage tolerance as percentage (e.g., 0.5 for 0.5%)
+ * @param isBuy - True if buying (price goes up), false if selling (price goes down)
+ * @returns Price adjusted for slippage
+ */
+export function applySlippage(price, slippagePercent, isBuy) {
+    const multiplier = 1 + slippagePercent / 100;
+    return isBuy ? price * multiplier : price / multiplier;
+}
+/**
+ * Calculate expected gain/loss for a TP or SL trigger price.
+ * Returns signed values — positive means profit, negative means loss.
+ *
+ * @param triggerPrice - The TP or SL target price
+ * @param entryPrice - Position entry / current market price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ * @param margin - Margin amount in USD
+ */
+export function calculateExpectedPnl(triggerPrice, entryPrice, leverage, isLong, margin) {
+    if (!triggerPrice || entryPrice === 0 || margin === 0) {
+        return null;
+    }
+    const priceDiff = isLong
+        ? triggerPrice - entryPrice
+        : entryPrice - triggerPrice;
+    const percent = (priceDiff / entryPrice) * leverage * 100;
+    const amount = margin * (percent / 100);
+    return { amount, percent };
+}
+/**
+ * Convert a percentage gain/loss to a target price.
+ *
+ * @param percent - Target gain/loss percentage (positive = profitable direction)
+ * @param entryPrice - Position entry price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ */
+export function priceFromPercent(percent, entryPrice, leverage, isLong) {
+    if (entryPrice === 0 || leverage === 0) {
+        return 0;
+    }
+    const priceDelta = (percent / 100 / leverage) * entryPrice;
+    return isLong ? entryPrice + priceDelta : entryPrice - priceDelta;
+}
+/**
+ * Convert a target price to a percentage gain/loss.
+ *
+ * @param price - Target price
+ * @param entryPrice - Position entry price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ */
+export function percentFromPrice(price, entryPrice, leverage, isLong) {
+    if (entryPrice === 0 || leverage === 0) {
+        return 0;
+    }
+    const priceDiff = isLong ? price - entryPrice : entryPrice - price;
+    return (priceDiff / entryPrice) * leverage * 100;
+}
+// ---------------------------------------------------------------------------
+// Realized PnL percentage
+// ---------------------------------------------------------------------------
+/**
+ * Calculate realized PnL as a percentage of position value at close.
+ *
+ * @param realizedPnl - The realized profit/loss in USD
+ * @param size - Position size in asset units at close
+ * @param price - Price at close
+ * @returns PnL as a percentage of position value
+ */
+export function calculateRealizedPnlPercent(realizedPnl, size, price) {
+    const positionValue = Math.abs(size) * price;
+    if (positionValue === 0) {
+        return 0;
+    }
+    return (realizedPnl / positionValue) * 100;
+}
+//# sourceMappingURL=calculations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculations.js","sourceRoot":"","sources":["../../../src/utils/calculations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,QAAgB,EAChB,KAAa;IAEb,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,GAAG,KAAK,CAAA;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,KAAa;IAChE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,YAAoB,EACpB,IAAY;IAEZ,OAAO,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,IAAI,CAAA;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAc;IACtD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,GAAG,CAAA;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,aAAqB,EACrB,QAAgB;IAEhB,OAAO,aAAa,GAAG,QAAQ,CAAA;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAe;IAC3D,OAAO,OAAO,GAAG,OAAO,CAAA;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,eAAuB,EACvB,KAAc;IAEd,MAAM,UAAU,GAAG,CAAC,GAAG,eAAe,GAAG,GAAG,CAAA;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAA;AACxD,CAAC;AAWD;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,UAAkB,EAClB,QAAgB,EAChB,MAAe,EACf,MAAc;IAEd,IAAI,CAAC,YAAY,IAAI,UAAU,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,SAAS,GAAG,MAAM;QACtB,CAAC,CAAC,YAAY,GAAG,UAAU;QAC3B,CAAC,CAAC,UAAU,GAAG,YAAY,CAAA;IAC7B,MAAM,OAAO,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,QAAQ,GAAG,GAAG,CAAA;IACzD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,CAAA;IACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,UAAkB,EAClB,QAAgB,EAChB,MAAe;IAEf,IAAI,UAAU,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,CAAA;IACV,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,GAAG,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAA;IAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAA;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,UAAkB,EAClB,QAAgB,EAChB,MAAe;IAEf,IAAI,UAAU,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,CAAA;IACV,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAA;IAClE,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,QAAQ,GAAG,GAAG,CAAA;AAClD,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAmB,EACnB,IAAY,EACZ,KAAa;IAEb,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IAC5C,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC,GAAG,GAAG,CAAA;AAC5C,CAAC"}

package/dist/esm/utils/hyperliquid/index.d.ts

@@ -0,0 +1,3 @@
+export { calculateLiquidationPrice, calculateMaintenanceMarginRate, } from './liquidation.js';
+export { formatOrderPrice, formatOrderSize, getMaxPriceDecimals, } from './orderFormatting.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/utils/hyperliquid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/hyperliquid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA"}

package/dist/esm/utils/hyperliquid/index.js

@@ -0,0 +1,3 @@
+export { calculateLiquidationPrice, calculateMaintenanceMarginRate, } from './liquidation.js';
+export { formatOrderPrice, formatOrderSize, getMaxPriceDecimals, } from './orderFormatting.js';
+//# sourceMappingURL=index.js.map