@lifi/perps-sdk-provider-lighter 5.1.1 → 7.0.0

package/src/depositFlow.ts

@@ -0,0 +1,59 @@
+import {
+  type DeclaredDepositAsset,
+  type DepositFlow,
+  ETHEREUM_NATIVE_GAS,
+  ETHEREUM_USDC,
+  LIGHTER_USDC,
+  ROBINHOOD_NATIVE_GAS,
+  ROBINHOOD_USDG,
+} from '@lifi/perps-sdk'
+import { ActionType, type LighterProviderKey } from '@lifi/perps-types'
+import { LIGHTER_PROVIDER_KEY, LIGHTER_RH_PROVIDER_KEY } from './constants.js'
+
+interface LighterDepositAssets {
+  /** Collateral token on the venue chain, credited to an account that exists. */
+  venueCollateral: DeclaredDepositAsset
+  /** Collateral the account-opening deposit is made in, on the chain that deposit runs on. */
+  firstDepositCollateral: DeclaredDepositAsset
+  firstDepositGas: DeclaredDepositAsset
+}
+
+const DEPOSIT_ASSETS: Record<LighterProviderKey, LighterDepositAssets> = {
+  [LIGHTER_PROVIDER_KEY]: {
+    venueCollateral: LIGHTER_USDC,
+    firstDepositCollateral: ETHEREUM_USDC,
+    firstDepositGas: ETHEREUM_NATIVE_GAS,
+  },
+  [LIGHTER_RH_PROVIDER_KEY]: {
+    venueCollateral: ROBINHOOD_USDG,
+    firstDepositCollateral: ROBINHOOD_USDG,
+    firstDepositGas: ROBINHOOD_NATIVE_GAS,
+  },
+}
+
+/**
+ * Resolve one Lighter instance's deposit flow from whether the account already
+ * exists: an existing account takes a swap into the instance's venue collateral,
+ * while an address with no account runs the account-opening deposit on the chain
+ * that instance's collateral is deposited from.
+ *
+ * @public
+ */
+export function lighterDepositFlow(
+  providerKey: LighterProviderKey,
+  accountExists: boolean
+): DepositFlow {
+  const assets = DEPOSIT_ASSETS[providerKey]
+
+  if (accountExists) {
+    return { kind: 'lifiSwap', destination: assets.venueCollateral }
+  }
+
+  return {
+    kind: 'firstDepositPipeline',
+    chainId: assets.firstDepositCollateral.chainId,
+    gasAsset: assets.firstDepositGas,
+    collateral: assets.firstDepositCollateral,
+    bridgeAction: ActionType.DEPOSIT,
+  }
+}

package/src/index.ts

@@ -33,6 +33,7 @@ export {
   LIGHTER_SPOT_CATEGORY_ID,
   lighterRhInstance,
 } from './constants.js'
+export { lighterDepositFlow } from './depositFlow.js'
 export type {
   LighterPerpsProvider,
   LighterProviderOptions,

package/src/utils/index.ts

@@ -28,7 +28,6 @@ export { mapPosition } from './mapPosition.js'
 export { mapInterval } from './ohlcvInterval.js'
 export { formatOrderPrice, formatOrderSize } from './orderFormatting.js'
 export { toIsoFromMs, toIsoFromSeconds } from './time.js'
-export type { ScaleToIntegerPolicy } from './wireEncoding.js'
 export {
   leverageToFraction,
   mapOrderTypeToInt,
@@ -36,5 +35,4 @@ export {
   marginFractionToMaxLeverage,
   orderExpiryForTif,
   resolveTimeInForce,
-  scaleToInteger,
 } from './wireEncoding.js'

package/src/utils/wireEncoding.ts

@@ -6,7 +6,6 @@
 
 import { PerpsError } from '@lifi/perps-sdk'
 import { PerpsErrorCode } from '@lifi/perps-types'
-import Big from 'big.js'
 import {
   LT_DEFAULT_ORDER_EXPIRY,
   LT_ORDER_TYPE_LIMIT,
@@ -46,60 +45,6 @@ export const leverageToFraction = (leverage: number): number => {
   return Math.round(10_000 / leverage)
 }
 
-/**
- * Off-grid resolution for {@link scaleToInteger}:
- * - `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 ScaleToIntegerPolicy = 'truncate' | 'round'
-
-/**
- * Scale a human-readable decimal string to a scaled integer for the WASM
- * signer, 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 `policy`; 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 const scaleToInteger = (
-  value: string,
-  decimals: number,
-  policy: ScaleToIntegerPolicy
-): number => {
-  if (!Number.isInteger(decimals) || decimals < 0) {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Invalid decimals for Lighter integer scaling: ${decimals}`
-    )
-  }
-  let parsed: Big
-  try {
-    parsed = new Big(value)
-  } catch {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Invalid decimal string for Lighter integer scaling: '${value}'`
-    )
-  }
-  const scaled = parsed
-    .times(new Big(10).pow(decimals))
-    .round(0, policy === 'truncate' ? Big.roundDown : Big.roundHalfUp)
-  if (scaled.abs().gt(Number.MAX_SAFE_INTEGER)) {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Scaled value ${scaled.toFixed()} exceeds Number.MAX_SAFE_INTEGER and cannot be encoded exactly.`
-    )
-  }
-  return scaled.toNumber()
-}
-
 /**
  * Map our OrderType enum to Lighter's integer order type.
  * @public