@lifi/perps-sdk-provider-lighter 8.2.1 → 10.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"assetCollateral.d.ts","sourceRoot":"","sources":["../../../src/utils/assetCollateral.ts"],"names":[],"mappings":"AAOA,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE3D;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhE"}
+{"version":3,"file":"assetCollateral.d.ts","sourceRoot":"","sources":["../../../src/utils/assetCollateral.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAS5D,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE3D;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAE3E"}

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

@@ -16,4 +16,5 @@ export { formatOrderPrice, formatOrderSize } from './orderFormatting.js';
 export { toIsoFromMs, toIsoFromSeconds } from './time.js';
 export { positionMarginConstraints } from './transferMargin.js';
 export { leverageToFraction, mapOrderTypeToInt, mapTimeInForceToInt, marginFractionToMaxLeverage, orderExpiryForTif, resolveTimeInForce, } from './wireEncoding.js';
+export { lighterWithdrawableBalances } from './withdrawableBalances.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA"}

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

@@ -0,0 +1,12 @@
+import type { ProviderWithdrawableBalance } from '@lifi/perps-sdk';
+import type { LtAccountAsset } from '../types/account.js';
+/**
+ * Split each held asset into the two routes a Lighter withdrawal can name:
+ * spot draws on `balance` net of `locked_balance`, perps draws on
+ * `margin_balance`. Routes with nothing left to draw are dropped; the
+ * per-asset venue minimum is applied by the caller holding the asset registry.
+ *
+ * @public
+ */
+export declare const lighterWithdrawableBalances: (assets: LtAccountAsset[]) => ProviderWithdrawableBalance[];
+//# sourceMappingURL=withdrawableBalances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGzD;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,cAAc,EAAE,KACvB,2BAA2B,EAgB7B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "8.2.1",
+  "version": "10.0.0",
   "description": "Lighter provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -24,15 +24,12 @@
       "import": "./dist/esm/index.js",
       "default": "./dist/cjs/index.js"
     },
-    "./wasm/*": "./wasm/*",
     "./package.json": "./package.json"
   },
   "files": [
     "dist/**",
     "!dist/**/*.tsbuildinfo",
     "src/**/*.ts",
-    "wasm/lighter-signer.wasm",
-    "wasm/wasm_exec.js",
     "!src/**/*.spec.ts",
     "!src/**/*.test.ts",
     "!src/**/*.mock.ts",
@@ -47,10 +44,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.48.8",
-    "@lifi/perps-types": "^5.0.0"
+    "@lifi/perps-types": "^5.1.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^6.2.1"
+    "@lifi/perps-sdk": "^6.3.0"
   },
   "publishConfig": {
     "access": "public"

package/src/LighterProvider.ts

@@ -4,6 +4,7 @@ import {
   getAssetRegistry,
   getMarketRegistry,
   getProviders,
+  localStorageAdapter,
   PerpsError,
   type PerpsProviderPlugin,
   type PerpsSDKClient,
@@ -17,10 +18,13 @@ import {
   type ProviderGetOrdersParams,
   type ProviderGetPositionsParams,
   type ProviderGetQuoteParams,
+  type ProviderGetWithdrawableBalancesParams,
+  type ProviderWithdrawableBalance,
   resolveQuote,
   resolveRetryPolicy,
   type SDKRequestOptions,
   type SignActionsContext,
+  type StorageAdapter,
   toPerpsMarketDisplay,
 } from '@lifi/perps-sdk'
 import type {
@@ -34,7 +38,6 @@ import type {
   Balance,
   FillsResponse,
   LighterAccountConfig,
-  LighterProviderKey,
   MarketSettings,
   Order,
   OrdersResponse,
@@ -56,23 +59,21 @@ import { projectLighterConfigSettings } from './accountConfig.js'
 import { getAccountSummary } from './accountSummary.js'
 import {
   DEFAULT_API_KEY_INDEX,
-  DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL,
-  DEFAULT_LIGHTER_REST_URL,
   DEFAULT_TRADES_LIMIT,
   LIGHTER_ALL_MARKETS_WILDCARD,
   LIGHTER_BASE_FEE_TIER,
-  LIGHTER_COLLATERAL_ASSETS,
   LIGHTER_FEE_TICK_SCALE,
   LIGHTER_HISTORY_PAGE_SIZE,
-  LIGHTER_PROVIDER_KEY,
+  LIGHTER_MAINNET_DEPLOYMENT,
+  LIGHTER_RH_DEPLOYMENT,
   LIGHTER_SPOT_CATEGORY_ID,
+  type LighterDeployment,
 } from './constants.js'
 import { lighterDepositFlow } from './depositFlow.js'
 import { createAuthToken } from './signers/createAuthToken.js'
-import type { LighterKeyStore } from './signers/LighterKeyStore.js'
-import type { LighterReadOnlyTokenManagerOptions } from './signers/LighterReadOnlyTokenManager.js'
+import { LighterKeyStore } from './signers/LighterKeyStore.js'
 import { LighterReadOnlyTokenManager } from './signers/LighterReadOnlyTokenManager.js'
-import type { LighterSigner } from './signers/LighterSigner.js'
+import { LighterSigner } from './signers/LighterSigner.js'
 import { lighterSignActions } from './signers/signActions.js'
 import type {
   LtAccountLimits,
@@ -106,6 +107,7 @@ import {
   formatOrderSize,
   leverageFromImf,
   lighterAsset,
+  lighterWithdrawableBalances,
   mapFill,
   mapOpenPositions,
   mapOrderDetail,
@@ -170,67 +172,42 @@ const normalizeLighterPublicKey = (key: string): string =>
   key.replace(/^0x/i, '').toLowerCase()
 
 /**
- * Construction options for the Lighter {@link PerpsProviderPlugin}.
- *
- * `restUrl` defaults to Lighter mainnet; pass a testnet URL or a self-hosted
- * mirror to override.
+ * Consumer-level overrides for a ready-made Lighter provider plugin. Every
+ * deployment fact — provider key, endpoints, signing chain id, collateral
+ * asset, explorer — belongs to the SDK's {@link LighterDeployment} descriptor
+ * and is not settable here; the signer, API-key store and read-only token
+ * manager are created per plugin instance.
  *
  * Auth-token resolution order for the auth-gated reads:
  *   1. Per-call `options.lighterAuthToken`
  *   2. Constructor `authToken` (string or async factory)
- *   3. Persisted long-lived read-only token (via `readOnlyTokenOptions`'s
- *      storage), keyed on the resolved Lighter `accountIndex`
- *   4. Fresh 1h create via the WASM signer + the user's registered API key
- *      from `keyStore`
+ *   3. Persisted long-lived read-only token, keyed on the resolved Lighter
+ *      `accountIndex`
+ *   4. Fresh 1h create via this instance's WASM signer + the user's registered
+ *      API key
  *
  * When none of these yields a token the auth-gated reads degrade gracefully:
  *   - `getOrders`, `getActivity` return empty results (mirrors backend behaviour)
  *   - `getOrder` throws `Unauthorized`
  *   - `getAccount` returns zero fee tier rather than failing
  *
- * `WASM_BLOB` write actions (`signActions`) require `signer` and `keyStore` to
- * be supplied; the `EVM_TX` arm signs with the end-user wallet alone.
- *
  * @public
  */
 export interface LighterProviderOptions {
   /**
-   * Provider key: the plugin `type`, the `Provider.key` matched against the
-   * backend `/providers` response, and the namespace for this instance's market
-   * / asset registries and retry policy. Defaults to `'lighter'` (mainnet).
-   * Set a distinct key (e.g. `'lighter-rh'`) to register a second Lighter
-   * instance on the same client.
+   * Persistence backend for this instance's Lighter API keypair and read-only
+   * token. Defaults to browser `localStorage` (encrypted at rest). Pass a
+   * custom adapter for SSR / non-browser hosts or another storage backend.
    */
-  providerKey?: LighterProviderKey
-  /** Lighter REST base URL. Defaults to mainnet. */
-  restUrl?: string
+  storage?: StorageAdapter
   /**
-   * Explorer tx base URL for transfer-activity links (`${base}${txHash}`).
-   * Defaults to the mainnet Lighter explorer for the default provider key, and
-   * to `undefined` (no transfer links) for any other key unless supplied.
+   * Lighter REST base URL. Defaults to the deployment's own endpoint; override
+   * to point at a reverse proxy, self-hosted mirror or rate-limit gateway. The
+   * instance's signer and read-only token manager follow this URL.
    */
-  explorerTxBaseUrl?: string
-  /** Pre-created Lighter read-only bearer. */
+  restUrl?: string
+  /** Pre-created Lighter read-only bearer, bypassing SDK token resolution. */
   authToken?: string | (() => string | Promise<string>)
-  /**
-   * WASM signer instance. Required for the `WASM_BLOB` arm of `signActions`
-   * and for on-demand auth-token creating from the user's API key. The default
-   * configuration loads the WASM blob shipped with this package.
-   */
-  signer?: LighterSigner
-  /**
-   * Store for the user's per-address Lighter API keypair. Required for the
-   * `WASM_BLOB` arm of `signActions` and for on-demand auth-token creating.
-   */
-  keyStore?: LighterKeyStore
-  /**
-   * Injection overrides (storage, fetcher, clock, host) for the read-only
-   * token manager, which is always active — Lighter reads create a long-lived
-   * read-only token on first use and reuse it thereafter. The host defaults to
-   * `restUrl`. This does not enable or disable the manager; it only overrides
-   * its dependencies (primarily for tests / non-browser storage).
-   */
-  readOnlyTokenOptions?: LighterReadOnlyTokenManagerOptions
   /** Token lifetime for on-demand standard-token creates (Lighter caps at 8h). Default 1h. */
   tokenLifetimeSeconds?: number
   /** Re-create when the cached standard token's remaining life is below this. Default 60s. */
@@ -270,27 +247,14 @@ export interface LighterPerpsProvider extends PerpsProviderPlugin {
 }
 
 /**
- * Lighter provider plugin factory. Returns an object implementing
- * {@link PerpsProviderPlugin}, mirroring the `EthereumProvider()` / `hyperliquidProvider()`
- * shape used by the rest of the LI.FI SDK family.
- *
- * Read functions call Lighter's REST API directly with no LI.FI backend hop.
- * Auth-gated reads resolve their token via the order documented on
- * {@link LighterProviderOptions}.
- *
- * Write actions (`WASM_BLOB` and `EVM_TX` signing) are dispatched via
- * `signActions` — `PerpsClient.execute` delegates those arms here.
+ * Build a Lighter provider plugin for one deployment. The deployment
+ * descriptor is SDK-owned, so this stays package-internal: consumers reach it
+ * through {@link lighterProvider} / {@link lighterRhProvider}.
  *
- * @example
- * ```ts
- * const client = createPerpsClient({
- *   integrator: 'my-app',
- *   providers: [lighterProvider()],
- * })
- * ```
- * @public
+ * @internal
  */
-export const lighterProvider = (
+export const createLighterProvider = (
+  deployment: LighterDeployment,
   options: LighterProviderOptions = {}
 ): LighterPerpsProvider => {
   // Late-bind slot: the factory runs before the client exists, so `bind`
@@ -301,34 +265,34 @@ export const lighterProvider = (
     if (boundClient === undefined) {
       throw new PerpsError(
         PerpsErrorCode.SDKError,
-        'lighterProvider used before binding. Register it via ' +
-          'createPerpsClient({ providers: [lighterProvider()] }).'
+        `${deployment.providerKey} provider used before binding. Register it ` +
+          'via createPerpsClient({ providers: [lighterProvider()] }).'
       )
     }
     return boundClient
   }
 
-  const providerKey = options.providerKey ?? LIGHTER_PROVIDER_KEY
-  const restUrl = options.restUrl ?? DEFAULT_LIGHTER_REST_URL
-  const explorerTxBaseUrl =
-    options.explorerTxBaseUrl ??
-    (providerKey === LIGHTER_PROVIDER_KEY
-      ? DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL
-      : undefined)
-  const collateral = LIGHTER_COLLATERAL_ASSETS[providerKey]
+  const providerKey = deployment.providerKey
+  const restUrl = options.restUrl ?? deployment.restUrl
+  const explorerTxBaseUrl = deployment.explorerTxBaseUrl
+  const collateral = deployment.collateral
   const authTokenSource: (() => string | Promise<string>) | undefined =
     typeof options.authToken === 'function'
       ? options.authToken
       : options.authToken !== undefined
         ? () => options.authToken as string
         : undefined
-  const signer = options.signer
-  const keyStore = options.keyStore
-  keyStore?.bindProviderKey(providerKey)
+  const storage = options.storage ?? localStorageAdapter
+  const signer = new LighterSigner({
+    apiUrl: restUrl,
+    signerChainId: deployment.signerChainId,
+    collateralAssetIndex: collateral.assetIndex,
+  })
+  const keyStore = new LighterKeyStore(storage, providerKey)
   const readOnlyTokenManager = new LighterReadOnlyTokenManager({
+    storage,
     providerKey,
     lighterApiUrl: restUrl,
-    ...options.readOnlyTokenOptions,
   })
   const tokenLifetimeSeconds = options.tokenLifetimeSeconds ?? 60 * 60
   const tokenRenewBufferSeconds = options.tokenRenewBufferSeconds ?? 60
@@ -360,12 +324,6 @@ export const lighterProvider = (
     apiKeyPrivateKey: string,
     indices: { apiKeyIndex: number; accountIndex: number }
   ): Promise<string> => {
-    if (signer === undefined) {
-      throw new PerpsError(
-        PerpsErrorCode.SDKError,
-        'lighterProvider: getStandardAuthToken called without a configured signer.'
-      )
-    }
     const cacheKey = address.toLowerCase()
     const nowSec = Math.floor(Date.now() / 1000)
     const cached = standardTokenByAddress.get(cacheKey)
@@ -414,11 +372,11 @@ export const lighterProvider = (
     if (authTokenSource !== undefined) {
       return authTokenSource()
     }
-    if (address === undefined || keyStore === undefined) {
+    if (address === undefined) {
       return undefined
     }
     const apiKey = await keyStore.get(address)
-    if (apiKey === null || signer === undefined) {
+    if (apiKey === null) {
       return undefined
     }
 
@@ -496,7 +454,7 @@ export const lighterProvider = (
     // rides reads during the creation-failure fallback and authorises
     // read-only token creation — so a revocation must re-sign it too.
     standardTokenByAddress.delete(cacheKey)
-    const apiKey = keyStore ? await keyStore.get(address) : null
+    const apiKey = await keyStore.get(address)
     if (apiKey !== null) {
       await readOnlyTokenManager.remove(address, apiKey.accountIndex)
     }
@@ -748,7 +706,7 @@ export const lighterProvider = (
           : retryOnRevoked(opts, params.address, token, (t) =>
               fetchAccountLimits(client, account.index, t)
             ),
-        keyStore ? keyStore.get(params.address) : Promise.resolve(null),
+        keyStore.get(params.address),
         readOnlyTokenManager.get(params.address, account.index),
         // No referral code to compare against, or no token to authenticate the
         // read → undefined → `referralPresent: false`.
@@ -891,6 +849,17 @@ export const lighterProvider = (
       )
     },
 
+    async getWithdrawableBalances(
+      params: ProviderGetWithdrawableBalancesParams,
+      opts?: SDKRequestOptions
+    ): Promise<ProviderWithdrawableBalance[]> {
+      const account = await fetchDetailedAccount(
+        apiClient(opts),
+        params.address
+      )
+      return lighterWithdrawableBalances(account.assets)
+    },
+
     async getPositions(
       params: ProviderGetPositionsParams,
       opts?: SDKRequestOptions
@@ -1349,9 +1318,8 @@ export const lighterProvider = (
 
     /**
      * Hand the backend the local pubkey for REGISTER_API_KEY so its
-     * idempotency check can compare against the on-chain slot. No keystore
-     * configured, or no key stored for this address → omit the field;
-     * backend stages a fresh registration.
+     * idempotency check can compare against the on-chain slot. No key stored
+     * for this address → omit the field; backend stages a fresh registration.
      */
     async resolveSetupParams(
       action: ActionType,
@@ -1360,9 +1328,6 @@ export const lighterProvider = (
       if (action !== ActionType.REGISTER_API_KEY) {
         return {}
       }
-      if (keyStore === undefined) {
-        return {}
-      }
       const local = await keyStore.get(address)
       if (local === null) {
         return {}
@@ -1390,7 +1355,7 @@ export const lighterProvider = (
           keyStore,
           apiClient: apiClient(),
           resolveAccountIndex: async (addr) => {
-            const apiKey = keyStore ? await keyStore.get(addr) : null
+            const apiKey = await keyStore.get(addr)
             if (apiKey !== null) {
               return apiKey.accountIndex
             }
@@ -1407,6 +1372,52 @@ export const lighterProvider = (
   }
 }
 
+/**
+ * Lighter mainnet provider plugin. Returns an object implementing
+ * {@link PerpsProviderPlugin}, mirroring the `EthereumProvider()` /
+ * `hyperliquidProvider()` shape used by the rest of the LI.FI SDK family.
+ *
+ * Read functions call Lighter's REST API directly with no LI.FI backend hop;
+ * auth-gated reads resolve their token via the order documented on
+ * {@link LighterProviderOptions}. Write actions (`WASM_BLOB` and `EVM_TX`
+ * signing) are dispatched via `signActions` — `PerpsClient.execute` delegates
+ * those arms here. The instance owns its WASM signer, API-key store and
+ * read-only token manager.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   providers: [lighterProvider()],
+ * })
+ * ```
+ * @public
+ */
+export const lighterProvider = (
+  options: LighterProviderOptions = {}
+): LighterPerpsProvider =>
+  createLighterProvider(LIGHTER_MAINNET_DEPLOYMENT, options)
+
+/**
+ * Lighter-on-Robinhood-chain provider plugin. Same contract as
+ * {@link lighterProvider}, bound to the RH deployment: its own endpoints,
+ * zkLighter signing chain id, USDG collateral, and its own signer, API-key
+ * store and read-only token manager. Registering both factories on one client
+ * keeps their credentials and caches separate.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   providers: [lighterProvider(), lighterRhProvider()],
+ * })
+ * ```
+ * @public
+ */
+export const lighterRhProvider = (
+  options: LighterProviderOptions = {}
+): LighterPerpsProvider => createLighterProvider(LIGHTER_RH_DEPLOYMENT, options)
+
 /**
  * Alias matching `@lifi/sdk`'s capitalised factory naming (`EVM()`, `EthereumProvider()`).
  *

package/src/constants.ts

@@ -38,11 +38,12 @@ export const DEFAULT_LIGHTER_REST_URL = 'https://mainnet.zklighter.elliot.ai'
 export const DEFAULT_LIGHTER_WS_URL = 'wss://mainnet.zklighter.elliot.ai/stream'
 
 /**
- * zkLighter L2 signing chain id fed to {@link LighterSigner} on mainnet.
+ * zkLighter L2 signing chain id for the Lighter mainnet deployment, from
+ * `elliottech/lighter-python` v1.1.2 `lighter/endpoint_profiles.py`.
  *
  * @public
  */
-export const DEFAULT_LIGHTER_SIGNER_CHAIN_ID = 304
+export const LIGHTER_MAINNET_SIGNER_CHAIN_ID = 304
 
 /**
  * Base URL the mainnet Lighter zkLighter explorer resolves a tx hash against
@@ -78,29 +79,30 @@ export const LIGHTER_COLLATERAL_ASSETS: Record<
   LighterProviderKey,
   LighterCollateralAsset
 > = {
-  [LIGHTER_PROVIDER_KEY]: {
+  [LIGHTER_PROVIDER_KEY]: Object.freeze({
     assetIndex: LT_ASSET_ID_USDC,
     displaySymbol: 'USDC',
-  },
-  [LIGHTER_RH_PROVIDER_KEY]: { assetIndex: 3, displaySymbol: 'USDG' },
+  }),
+  [LIGHTER_RH_PROVIDER_KEY]: Object.freeze({
+    assetIndex: 3,
+    displaySymbol: 'USDG',
+  }),
 }
 
 /**
- * The venue-specific facts that distinguish one Lighter deployment from
- * another. One provider + WS pair is built per instance from these; a client
- * may register several so long as their `providerKey`s differ.
+ * The immutable venue facts that distinguish one Lighter deployment from
+ * another. The SDK owns one descriptor per supported deployment; consumers
+ * select a deployment by picking its provider factory, never by assembling
+ * these fields.
  *
  * @public
  */
-export interface LighterInstanceConfig {
-  /** Wire-visible `Provider.key` and the plugin `type`; unique per instance. */
+export interface LighterDeployment {
+  /** Wire-visible `Provider.key` and the plugin `type`; unique per deployment. */
   providerKey: LighterProviderKey
   restUrl: string
   wsUrl: string
-  /**
-   * zkLighter L2 signing chain id to construct this instance's
-   * {@link LighterSigner} with.
-   */
+  /** zkLighter L2 signing chain id this deployment's transactions are signed against. */
   signerChainId: number
   /**
    * Collateral asset this deployment settles in — signed into its withdrawals
@@ -109,75 +111,63 @@ export interface LighterInstanceConfig {
   collateral: LighterCollateralAsset
   /**
    * Explorer tx base URL for transfer-activity links (`${base}${txHash}`).
-   * When omitted, transfer links are not emitted for this instance.
+   * When omitted, transfer links are not emitted for this deployment.
    */
   explorerTxBaseUrl?: string
 }
 
 /**
- * The built-in mainnet Lighter instance — the defaults `lighterProvider()` and
- * `lighterWsProvider()` apply when constructed with no instance overrides.
+ * Lighter mainnet, as served by `lighterProvider()`.
  *
  * @public
  */
-export const LIGHTER_MAINNET_INSTANCE: LighterInstanceConfig = {
+export const LIGHTER_MAINNET_DEPLOYMENT: LighterDeployment = Object.freeze({
   providerKey: LIGHTER_PROVIDER_KEY,
   restUrl: DEFAULT_LIGHTER_REST_URL,
   wsUrl: DEFAULT_LIGHTER_WS_URL,
-  signerChainId: DEFAULT_LIGHTER_SIGNER_CHAIN_ID,
+  signerChainId: LIGHTER_MAINNET_SIGNER_CHAIN_ID,
   collateral: LIGHTER_COLLATERAL_ASSETS[LIGHTER_PROVIDER_KEY],
   explorerTxBaseUrl: DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL,
-}
+})
 
 /**
- * Default REST base URL for the Lighter Robinhood deployment.
+ * REST base URL for the Lighter Robinhood deployment.
  *
  * @public
  */
 export const LIGHTER_RH_REST_URL = 'https://api.rh.lighter.xyz'
 /**
- * Default WebSocket URL for the Lighter Robinhood deployment.
+ * WebSocket URL for the Lighter Robinhood deployment.
  *
  * @public
  */
 export const LIGHTER_RH_WS_URL = 'wss://api.rh.lighter.xyz/stream'
 
 /**
- * Deployment-supplied facts the RH instance cannot source from public
- * documentation and the caller must confirm.
+ * zkLighter L2 signing chain id for the Lighter Robinhood deployment, from
+ * `elliottech/lighter-python` v1.1.2 `lighter/endpoint_profiles.py`
+ * (`ROBINHOOD.chain_id`) and its `signer_client.py` host fallback. Distinct
+ * from mainnet's 304 and from Robinhood's L1 chain id 4663 — signing with
+ * either yields a venue-rejected transaction.
  *
  * @public
  */
-export interface LighterRhInstanceOverrides {
-  /**
-   * zkLighter L2 signing chain id for the RH instance. Unverified from public
-   * sources — must be the value confirmed against lighter-go / RH support, not
-   * mainnet's 304 nor the RH L1 chain id 4663.
-   */
-  signerChainId: number
-  /**
-   * RH zkLighter explorer tx base URL. Omit until confirmed; transfer links are
-   * then left unset rather than pointed at the mainnet explorer.
-   */
-  explorerTxBaseUrl?: string
-}
+export const LIGHTER_RH_SIGNER_CHAIN_ID = 466324
 
 /**
- * Build the `lighter-rh` {@link LighterInstanceConfig}. The signing chain id is
- * a required argument because it is not verifiable from public sources — the
- * caller must pass the value confirmed against lighter-go / RH support.
+ * Lighter on Robinhood chain, as served by `lighterRhProvider()`. No explorer
+ * base URL: the RH zkLighter explorer is unpublished, so transfer links are
+ * left unset rather than pointed at the mainnet explorer.
  *
  * @public
  */
-export const lighterRhInstance = (
-  overrides: LighterRhInstanceOverrides
-): LighterInstanceConfig => ({
+export const LIGHTER_RH_DEPLOYMENT: LighterDeployment = Object.freeze({
   providerKey: LIGHTER_RH_PROVIDER_KEY,
   restUrl: LIGHTER_RH_REST_URL,
   wsUrl: LIGHTER_RH_WS_URL,
-  signerChainId: overrides.signerChainId,
+  signerChainId: LIGHTER_RH_SIGNER_CHAIN_ID,
   collateral: LIGHTER_COLLATERAL_ASSETS[LIGHTER_RH_PROVIDER_KEY],
-  explorerTxBaseUrl: overrides.explorerTxBaseUrl,
+  explorerTxBaseUrl: undefined,
 })
 
 /** @internal */

package/src/index.ts

@@ -5,9 +5,9 @@
  * Lighter provider plugin for `@lifi/perps-sdk`. Serves `PerpsProvider` reads
  * directly from Lighter's REST API (no LI.FI backend hop); auth-gated reads
  * use the user's Lighter read-only token. Also owns `signActions` (the
- * `WASM_BLOB` / `EVM_TX` arms of `PerpsClient.execute`) — `LighterSigner`,
- * `LighterKeyStore`, `LighterReadOnlyTokenManager`, and the WASM blob ship
- * with this package.
+ * `WASM_BLOB` / `EVM_TX` arms of `PerpsClient.execute`): each provider
+ * instance creates its own WASM signer, API-key store and read-only token
+ * manager, and the Go signer binary ships with this package.
  *
  * @packageDocumentation
  * @public
@@ -17,32 +17,35 @@ export { projectLighterConfigSettings } from './accountConfig.js'
 export { getAccountSummary } from './accountSummary.js'
 export type {
   LighterCollateralAsset,
-  LighterInstanceConfig,
-  LighterRhInstanceOverrides,
+  LighterDeployment,
 } from './constants.js'
 export {
   DEFAULT_API_KEY_INDEX,
   DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL,
   DEFAULT_LIGHTER_REST_URL,
-  DEFAULT_LIGHTER_SIGNER_CHAIN_ID,
   DEFAULT_LIGHTER_WS_URL,
   LIGHTER_COLLATERAL_ASSETS,
-  LIGHTER_MAINNET_INSTANCE,
+  LIGHTER_MAINNET_DEPLOYMENT,
+  LIGHTER_MAINNET_SIGNER_CHAIN_ID,
   LIGHTER_PROVIDER_KEY,
+  LIGHTER_RH_DEPLOYMENT,
   LIGHTER_RH_PROVIDER_KEY,
   LIGHTER_RH_REST_URL,
+  LIGHTER_RH_SIGNER_CHAIN_ID,
   LIGHTER_RH_WS_URL,
   LIGHTER_SPOT_CATEGORY_ID,
-  lighterRhInstance,
 } from './constants.js'
 export { lighterDepositFlow } from './depositFlow.js'
 export type {
   LighterPerpsProvider,
   LighterProviderOptions,
 } from './LighterProvider.js'
-export { Lighter, lighterProvider } from './LighterProvider.js'
+export {
+  Lighter,
+  lighterProvider,
+  lighterRhProvider,
+} from './LighterProvider.js'
 
-export * from './signers/index.js'
 export * from './types/index.js'
 export * from './utils/index.js'
 export type { LighterAuthTokenResolver } from './websocket/LighterWsProvider.js'