@lifi/perps-sdk-provider-lighter 8.1.0 → 8.2.0

package/dist/types/constants.d.ts

@@ -5,6 +5,12 @@ import type { FeeTier, LighterProviderKey } from '@lifi/perps-types';
  * @public
  */
 export declare const LIGHTER_PROVIDER_KEY = "lighter";
+/**
+ * Provider key for the Lighter instance running on Robinhood chain.
+ *
+ * @public
+ */
+export declare const LIGHTER_RH_PROVIDER_KEY = "lighter-rh";
 /**
  * Category id for Lighter spot token holdings, matching the backend's Lighter
  * spot asset category. The perps category id is not a constant — it is read
@@ -38,6 +44,27 @@ export declare const DEFAULT_LIGHTER_SIGNER_CHAIN_ID = 304;
  * @public
  */
 export declare const DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL = "https://app.lighter.xyz/explorer/logs/";
+/**
+ * The collateral asset a Lighter deployment settles in: the L2 asset index its
+ * withdrawals, transfers and route moves are signed against, plus the symbol
+ * shown for the collateral balance.
+ *
+ * @public
+ */
+export interface LighterCollateralAsset {
+    /** L2 asset index, as `asset_id` on the deployment's `/api/v1/assetDetails`. */
+    assetIndex: number;
+    displaySymbol: string;
+}
+/**
+ * Collateral asset per Lighter deployment, each read from that deployment's
+ * `/api/v1/assetDetails`: mainnet settles in USDC, Robinhood chain in USDG.
+ * Both sit at asset index 3 of their own registry — the same slot holds a
+ * different token per deployment, so an index alone never identifies the asset.
+ *
+ * @public
+ */
+export declare const LIGHTER_COLLATERAL_ASSETS: Record<LighterProviderKey, LighterCollateralAsset>;
 /**
  * The venue-specific facts that distinguish one Lighter deployment from
  * another. One provider + WS pair is built per instance from these; a client
@@ -55,6 +82,11 @@ export interface LighterInstanceConfig {
      * {@link LighterSigner} with.
      */
     signerChainId: number;
+    /**
+     * Collateral asset this deployment settles in — signed into its withdrawals
+     * and transfers, and reported as its collateral balance.
+     */
+    collateral: LighterCollateralAsset;
     /**
      * Explorer tx base URL for transfer-activity links (`${base}${txHash}`).
      * When omitted, transfer links are not emitted for this instance.
@@ -68,12 +100,6 @@ export interface LighterInstanceConfig {
  * @public
  */
 export declare const LIGHTER_MAINNET_INSTANCE: LighterInstanceConfig;
-/**
- * Provider key for the Lighter instance running on Robinhood chain.
- *
- * @public
- */
-export declare const LIGHTER_RH_PROVIDER_KEY = "lighter-rh";
 /**
  * Default REST base URL for the Lighter Robinhood deployment.
  *

package/dist/types/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,SAAS,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAA;AAC7E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6CAA6C,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,2CACP,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,qBAMtC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAC/D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oCAAoC,CAAA;AAElE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,0BAA0B,KACpC,qBAMD,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAoC,CAAA;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAEvC,gBAAgB;AAChB,QAAA,MAAM,8BAA8B,QAAQ,CAAA;AAE5C;;;;GAIG;AACH,QAAA,MAAM,yBAAyB,QAAQ,CAAA;AAEvC;;;;;;GAMG;AACH,QAAA,MAAM,qBAAqB,aAAoB,CAAA;AAE/C;;;;;;GAMG;AACH,QAAA,MAAM,6BAA6B,MAAM,CAAA;AAEzC,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,qBAAqB,GACtB,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGpE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,SAAS,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAA;AAC7E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6CAA6C,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,2CACP,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,kBAAkB,EAClB,sBAAsB,CAOvB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,UAAU,EAAE,sBAAsB,CAAA;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,qBAOtC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAC/D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oCAAoC,CAAA;AAElE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,0BAA0B,KACpC,qBAOD,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAoC,CAAA;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAEvC,gBAAgB;AAChB,QAAA,MAAM,8BAA8B,QAAQ,CAAA;AAE5C;;;;GAIG;AACH,QAAA,MAAM,yBAAyB,QAAQ,CAAA;AAEvC;;;;;;GAMG;AACH,QAAA,MAAM,qBAAqB,aAAoB,CAAA;AAE/C;;;;;;GAMG;AACH,QAAA,MAAM,6BAA6B,MAAM,CAAA;AAEzC,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,qBAAqB,GACtB,CAAA"}

package/dist/types/index.d.ts

@@ -11,8 +11,8 @@
  */
 export { projectLighterConfigSettings } from './accountConfig.js';
 export { getAccountSummary } from './accountSummary.js';
-export type { LighterInstanceConfig, LighterRhInstanceOverrides, } 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_MAINNET_INSTANCE, LIGHTER_PROVIDER_KEY, LIGHTER_RH_PROVIDER_KEY, LIGHTER_RH_REST_URL, LIGHTER_RH_WS_URL, LIGHTER_SPOT_CATEGORY_ID, lighterRhInstance, } from './constants.js';
+export type { LighterCollateralAsset, LighterInstanceConfig, LighterRhInstanceOverrides, } 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_PROVIDER_KEY, LIGHTER_RH_PROVIDER_KEY, LIGHTER_RH_REST_URL, 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';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EACV,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,qBAAqB,EACrB,oCAAoC,EACpC,wBAAwB,EACxB,+BAA+B,EAC/B,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE/D,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAChF,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,iBAAiB,GAClB,MAAM,kCAAkC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,qBAAqB,EACrB,oCAAoC,EACpC,wBAAwB,EACxB,+BAA+B,EAC/B,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE/D,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAChF,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,iBAAiB,GAClB,MAAM,kCAAkC,CAAA"}

package/dist/types/signers/LighterSigner.d.ts

@@ -16,8 +16,8 @@ export interface LighterSignerContext {
     accountIndex: number;
 }
 /**
- * Configuration for {@link LighterSigner}, including optional WASM asset
- * overrides and the Lighter REST base URL and signing chain ID.
+ * Configuration for {@link LighterSigner}: optional WASM asset overrides plus
+ * the per-instance REST base URL, signing chain id and collateral asset index.
  *
  * @public
  */
@@ -26,6 +26,12 @@ export interface LighterSignerConfig extends LoadLighterWasmOptions {
     apiUrl?: string;
     /** Lighter chain ID (304 = mainnet). */
     chainId?: number;
+    /**
+     * L2 asset index this instance's withdrawals and transfers are signed
+     * against — pass the instance's `collateral.assetIndex`. Defaults to
+     * mainnet's USDC slot.
+     */
+    collateralAssetIndex?: number;
 }
 /**
  * Signed Lighter transaction blob returned by the WASM signer. `txType`,
@@ -79,6 +85,7 @@ export interface ApiKeyPair {
 export declare class LighterSigner {
     private readonly apiUrl;
     private readonly chainId;
+    private readonly collateralAssetIndex;
     private readonly loaderOptions;
     private wasm;
     private readonly registeredClients;

package/dist/types/signers/LighterSigner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LighterSigner.d.ts","sourceRoot":"","sources":["../../../src/signers/LighterSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAW9C,OAAO,EAEL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAA;AAOxB;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAA;IACxB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,qHAAqH;IACrH,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAgCD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAE1C,MAAM,GAAE,mBAAwB;IAU5C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAY3C;;;;;;;;;OASG;IACG,IAAI,CACR,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC;IAmB7B;;;;;;;;;;;OAWG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,CAAC,GAAG,CAAK,GACnB,OAAO,CAAC,kBAAkB,CAAC;IAsC9B;;;;;;;OAOG;IACG,qBAAqB,CACzB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,CAAC;IA8BnC;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAa7D;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC;YAiBJ,YAAY;YAOZ,YAAY;IAmB1B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;CA+MjB"}
+{"version":3,"file":"LighterSigner.d.ts","sourceRoot":"","sources":["../../../src/signers/LighterSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAW9C,OAAO,EAEL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAA;AAOxB;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAA;IACxB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,qHAAqH;IACrH,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AA+BD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAE1C,MAAM,GAAE,mBAAwB;IAW5C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAY3C;;;;;;;;;OASG;IACG,IAAI,CACR,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC;IAmB7B;;;;;;;;;;;OAWG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,CAAC,GAAG,CAAK,GACnB,OAAO,CAAC,kBAAkB,CAAC;IAsC9B;;;;;;;OAOG;IACG,qBAAqB,CACzB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,CAAC;IA8BnC;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAa7D;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC;YAiBJ,YAAY;YAOZ,YAAY;IAmB1B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;CA+MjB"}

package/dist/types/types/action.d.ts

@@ -178,7 +178,9 @@ export declare const LT_ROUTE_PERP = 0;
  */
 export declare const LT_ROUTE_SPOT = 1;
 /**
- * Lighter spot USDC asset id.
+ * L2 asset index of USDC on Lighter mainnet — the collateral slot mainnet
+ * withdrawals, transfers and L1 bridge deposits address. Other deployments
+ * settle in their own asset; see `LIGHTER_COLLATERAL_ASSETS`.
  * @public
  */
 export declare const LT_ASSET_ID_USDC = 3;

package/dist/types/types/action.d.ts.map

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

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

@@ -1,10 +1,11 @@
-import type { Asset } from '@lifi/perps-types';
+import type { Asset, LighterProviderKey } from '@lifi/perps-types';
 /**
  * Create the SDK asset descriptor for a Lighter asset identifier and display
  * symbol. Lighter assets do not provide a package-level logo URI, so this
  * helper leaves that field empty.
  *
+ * @param providerId - Instance the asset belongs to; defaults to mainnet.
  * @public
  */
-export declare const lighterAsset: (id: string, displaySymbol: string) => Asset;
+export declare const lighterAsset: (id: string, displaySymbol: string, providerId?: LighterProviderKey) => Asset;
 //# sourceMappingURL=lighterAsset.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"lighterAsset.d.ts","sourceRoot":"","sources":["../../../src/utils/lighterAsset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAG9C;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,EAAE,eAAe,MAAM,KAAG,KAK/D,CAAA"}
+{"version":3,"file":"lighterAsset.d.ts","sourceRoot":"","sources":["../../../src/utils/lighterAsset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGlE;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,IAAI,MAAM,EACV,eAAe,MAAM,EACrB,aAAY,kBAAyC,KACpD,KAKD,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "8.1.0",
+  "version": "8.2.0",
   "description": "Lighter provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -46,10 +46,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.48.8",
-    "@lifi/perps-types": "^4.2.0"
+    "@lifi/perps-types": "^5.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^6.2.0"
+    "@lifi/perps-sdk": "^6.2.1"
   },
   "publishConfig": {
     "access": "public"

package/src/LighterProvider.ts

@@ -61,6 +61,7 @@ import {
   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,
@@ -314,6 +315,7 @@ export const lighterProvider = (
     (providerKey === LIGHTER_PROVIDER_KEY
       ? DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL
       : undefined)
+  const collateral = LIGHTER_COLLATERAL_ASSETS[providerKey]
   const authTokenSource: (() => string | Promise<string>) | undefined =
     typeof options.authToken === 'function'
       ? options.authToken
@@ -801,20 +803,29 @@ export const lighterProvider = (
       const collateralBalances: Balance[] = [
         {
           categoryId: perpsCategory?.id ?? providerKey,
-          asset: perpsCategory?.quoteAsset ?? lighterAsset('USDC', 'USDC'),
+          asset:
+            perpsCategory?.quoteAsset ??
+            lighterAsset(
+              collateral.displaySymbol,
+              collateral.displaySymbol,
+              providerKey
+            ),
           units: availableMargin.toString(),
           valueUsd: availableMargin.toString(),
         },
       ]
-      // Spot token holdings — non-collateral. USDC value is 1:1; other tokens
-      // have no price source at this boundary, so their USD value is unknown.
+      // Spot token holdings — non-collateral. The instance's settlement asset
+      // is valued 1:1; other tokens have no price source at this boundary, so
+      // their USD value is unknown.
       const balances: Balance[] = account.assets.map((a) => {
         const assetId = String(a.asset_id)
         return {
           categoryId: spotCategoryId,
-          asset: assetRegistry.get(assetId) ?? lighterAsset(assetId, a.symbol),
+          asset:
+            assetRegistry.get(assetId) ??
+            lighterAsset(assetId, a.symbol, providerKey),
           units: a.balance,
-          valueUsd: a.symbol === 'USDC' ? a.balance : '0',
+          valueUsd: a.asset_id === collateral.assetIndex ? a.balance : '0',
         }
       })
 

package/src/constants.ts

@@ -1,4 +1,5 @@
 import type { FeeTier, LighterProviderKey } from '@lifi/perps-types'
+import { LT_ASSET_ID_USDC } from './types/action.js'
 
 /**
  * Lighter provider key as it appears on `Provider.key` from the backend.
@@ -7,6 +8,13 @@ import type { FeeTier, LighterProviderKey } from '@lifi/perps-types'
  */
 export const LIGHTER_PROVIDER_KEY = 'lighter'
 
+/**
+ * Provider key for the Lighter instance running on Robinhood chain.
+ *
+ * @public
+ */
+export const LIGHTER_RH_PROVIDER_KEY = 'lighter-rh'
+
 /**
  * Category id for Lighter spot token holdings, matching the backend's Lighter
  * spot asset category. The perps category id is not a constant — it is read
@@ -45,6 +53,38 @@ export const DEFAULT_LIGHTER_SIGNER_CHAIN_ID = 304
 export const DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL =
   'https://app.lighter.xyz/explorer/logs/'
 
+/**
+ * The collateral asset a Lighter deployment settles in: the L2 asset index its
+ * withdrawals, transfers and route moves are signed against, plus the symbol
+ * shown for the collateral balance.
+ *
+ * @public
+ */
+export interface LighterCollateralAsset {
+  /** L2 asset index, as `asset_id` on the deployment's `/api/v1/assetDetails`. */
+  assetIndex: number
+  displaySymbol: string
+}
+
+/**
+ * Collateral asset per Lighter deployment, each read from that deployment's
+ * `/api/v1/assetDetails`: mainnet settles in USDC, Robinhood chain in USDG.
+ * Both sit at asset index 3 of their own registry — the same slot holds a
+ * different token per deployment, so an index alone never identifies the asset.
+ *
+ * @public
+ */
+export const LIGHTER_COLLATERAL_ASSETS: Record<
+  LighterProviderKey,
+  LighterCollateralAsset
+> = {
+  [LIGHTER_PROVIDER_KEY]: {
+    assetIndex: LT_ASSET_ID_USDC,
+    displaySymbol: 'USDC',
+  },
+  [LIGHTER_RH_PROVIDER_KEY]: { 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
@@ -62,6 +102,11 @@ export interface LighterInstanceConfig {
    * {@link LighterSigner} with.
    */
   signerChainId: number
+  /**
+   * Collateral asset this deployment settles in — signed into its withdrawals
+   * and transfers, and reported as its collateral balance.
+   */
+  collateral: LighterCollateralAsset
   /**
    * Explorer tx base URL for transfer-activity links (`${base}${txHash}`).
    * When omitted, transfer links are not emitted for this instance.
@@ -80,16 +125,10 @@ export const LIGHTER_MAINNET_INSTANCE: LighterInstanceConfig = {
   restUrl: DEFAULT_LIGHTER_REST_URL,
   wsUrl: DEFAULT_LIGHTER_WS_URL,
   signerChainId: DEFAULT_LIGHTER_SIGNER_CHAIN_ID,
+  collateral: LIGHTER_COLLATERAL_ASSETS[LIGHTER_PROVIDER_KEY],
   explorerTxBaseUrl: DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL,
 }
 
-/**
- * Provider key for the Lighter instance running on Robinhood chain.
- *
- * @public
- */
-export const LIGHTER_RH_PROVIDER_KEY = 'lighter-rh'
-
 /**
  * Default REST base URL for the Lighter Robinhood deployment.
  *
@@ -137,6 +176,7 @@ export const lighterRhInstance = (
   restUrl: LIGHTER_RH_REST_URL,
   wsUrl: LIGHTER_RH_WS_URL,
   signerChainId: overrides.signerChainId,
+  collateral: LIGHTER_COLLATERAL_ASSETS[LIGHTER_RH_PROVIDER_KEY],
   explorerTxBaseUrl: overrides.explorerTxBaseUrl,
 })
 

package/src/index.ts

@@ -16,6 +16,7 @@
 export { projectLighterConfigSettings } from './accountConfig.js'
 export { getAccountSummary } from './accountSummary.js'
 export type {
+  LighterCollateralAsset,
   LighterInstanceConfig,
   LighterRhInstanceOverrides,
 } from './constants.js'
@@ -25,6 +26,7 @@ export {
   DEFAULT_LIGHTER_REST_URL,
   DEFAULT_LIGHTER_SIGNER_CHAIN_ID,
   DEFAULT_LIGHTER_WS_URL,
+  LIGHTER_COLLATERAL_ASSETS,
   LIGHTER_MAINNET_INSTANCE,
   LIGHTER_PROVIDER_KEY,
   LIGHTER_RH_PROVIDER_KEY,

package/src/signers/LighterSigner.ts

@@ -38,8 +38,8 @@ export interface LighterSignerContext {
 }
 
 /**
- * Configuration for {@link LighterSigner}, including optional WASM asset
- * overrides and the Lighter REST base URL and signing chain ID.
+ * Configuration for {@link LighterSigner}: optional WASM asset overrides plus
+ * the per-instance REST base URL, signing chain id and collateral asset index.
  *
  * @public
  */
@@ -48,6 +48,12 @@ export interface LighterSignerConfig extends LoadLighterWasmOptions {
   apiUrl?: string
   /** Lighter chain ID (304 = mainnet). */
   chainId?: number
+  /**
+   * L2 asset index this instance's withdrawals and transfers are signed
+   * against — pass the instance's `collateral.assetIndex`. Defaults to
+   * mainnet's USDC slot.
+   */
+  collateralAssetIndex?: number
 }
 
 /**
@@ -108,12 +114,11 @@ const SKIP_NONCE_DISABLED = 0
 // CancelAll across every market (lighter-go `NilMarketIndex`); a real index
 // scopes the cancel to a single market.
 const NIL_MARKET_INDEX = 255
-// Withdrawals/transfers are USDC on the perps route (lighter-go `USDCAssetIndex`
-// / `AssetRouteType_Perps`). The signer rejects an asset index < 1.
-const USDC_ASSET_INDEX = 3
+// Collateral withdrawals and transfers ride the perps route (lighter-go
+// `AssetRouteType_Perps`). The signer rejects an asset index < 1.
 const ASSET_ROUTE_TYPE_PERPS = 0
 
-// SEND_ASSET is a same-account route→route USDC move (spot↔perp): no counterparty
+// SEND_ASSET is a same-account route→route collateral move (spot↔perp): no
 // fee, and no memo. `SignTransfer` requires a 32-byte memo, so we pass 32 zero
 // bytes in the `0x`-prefixed 64-hex form the WASM signer decodes.
 const SEND_ASSET_NO_FEE = 0
@@ -136,6 +141,7 @@ const LIGHTER_ROUTE_BY_DEX: Record<string, number> = {
 export class LighterSigner {
   private readonly apiUrl: string
   private readonly chainId: number
+  private readonly collateralAssetIndex: number
   private readonly loaderOptions: LoadLighterWasmOptions
   private wasm: LighterWasmExports | undefined
   private readonly registeredClients = new Set<string>()
@@ -143,6 +149,7 @@ export class LighterSigner {
   constructor(config: LighterSignerConfig = {}) {
     this.apiUrl = config.apiUrl ?? DEFAULT_LIGHTER_REST_URL
     this.chainId = config.chainId ?? DEFAULT_LIGHTER_SIGNER_CHAIN_ID
+    this.collateralAssetIndex = config.collateralAssetIndex ?? LT_ASSET_ID_USDC
     this.loaderOptions = {
       wasmBinaryUrl: config.wasmBinaryUrl,
       wasmExecJsUrl: config.wasmExecJsUrl,
@@ -499,7 +506,7 @@ export class LighterSigner {
         )
       case ActionType.WITHDRAWAL:
         return wasm.SignWithdraw(
-          USDC_ASSET_INDEX,
+          this.collateralAssetIndex,
           ASSET_ROUTE_TYPE_PERPS,
           numberField(p, 'amount'),
           SKIP_NONCE_DISABLED,
@@ -517,7 +524,7 @@ export class LighterSigner {
         // long".
         return wasm.SignTransfer(
           numberField(p, 'to_account'),
-          USDC_ASSET_INDEX,
+          this.collateralAssetIndex,
           ASSET_ROUTE_TYPE_PERPS,
           ASSET_ROUTE_TYPE_PERPS,
           numberField(p, 'usdc_amount'),
@@ -529,9 +536,9 @@ export class LighterSigner {
           ctx.accountIndex
         )
       case ActionType.SEND_ASSET: {
-        // Same-account USDC self-transfer between the perp and spot routes.
-        // `toAccountIndex` is the signer's own account; the routes come from
-        // the backend-passed `sourceDex`/`destinationDex` wire strings.
+        // Same-account collateral self-transfer between the perp and spot
+        // routes. `toAccountIndex` is the signer's own account; the routes come
+        // from the backend-passed `sourceDex`/`destinationDex` wire strings.
         const fromRouteType = routeFromDex(stringField(p, 'sourceDex'))
         const toRouteType = routeFromDex(stringField(p, 'destinationDex'))
         if (fromRouteType === toRouteType) {
@@ -542,7 +549,7 @@ export class LighterSigner {
         }
         return wasm.SignTransfer(
           ctx.accountIndex,
-          LT_ASSET_ID_USDC,
+          this.collateralAssetIndex,
           fromRouteType,
           toRouteType,
           numberField(p, 'amount'),

package/src/types/action.ts

@@ -195,7 +195,9 @@ export const LT_ROUTE_PERP = 0
 export const LT_ROUTE_SPOT = 1
 
 /**
- * Lighter spot USDC asset id.
+ * L2 asset index of USDC on Lighter mainnet — the collateral slot mainnet
+ * withdrawals, transfers and L1 bridge deposits address. Other deployments
+ * settle in their own asset; see `LIGHTER_COLLATERAL_ASSETS`.
  * @public
  */
 export const LT_ASSET_ID_USDC = 3

package/src/utils/lighterAsset.ts

@@ -1,4 +1,4 @@
-import type { Asset } from '@lifi/perps-types'
+import type { Asset, LighterProviderKey } from '@lifi/perps-types'
 import { LIGHTER_PROVIDER_KEY } from '../constants.js'
 
 /**
@@ -6,10 +6,15 @@ import { LIGHTER_PROVIDER_KEY } from '../constants.js'
  * symbol. Lighter assets do not provide a package-level logo URI, so this
  * helper leaves that field empty.
  *
+ * @param providerId - Instance the asset belongs to; defaults to mainnet.
  * @public
  */
-export const lighterAsset = (id: string, displaySymbol: string): Asset => ({
-  providerId: LIGHTER_PROVIDER_KEY,
+export const lighterAsset = (
+  id: string,
+  displaySymbol: string,
+  providerId: LighterProviderKey = LIGHTER_PROVIDER_KEY
+): Asset => ({
+  providerId,
   id,
   displaySymbol,
   logoURI: '',