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

package/dist/types/index.d.ts

@@ -2,21 +2,20 @@
  * 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
  */
 export { projectLighterConfigSettings } from './accountConfig.js';
 export { getAccountSummary } from './accountSummary.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 type { LighterCollateralAsset, LighterDeployment, } from './constants.js';
+export { DEFAULT_API_KEY_INDEX, DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL, DEFAULT_LIGHTER_REST_URL, DEFAULT_LIGHTER_WS_URL, LIGHTER_COLLATERAL_ASSETS, 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, } from './constants.js';
 export { lighterDepositFlow } from './depositFlow.js';
 export type { LighterPerpsProvider, LighterProviderOptions, } from './LighterProvider.js';
-export { Lighter, lighterProvider } from './LighterProvider.js';
-export * from './signers/index.js';
+export { Lighter, lighterProvider, lighterRhProvider, } from './LighterProvider.js';
 export * from './types/index.js';
 export * from './utils/index.js';
 export type { LighterAuthTokenResolver } from './websocket/LighterWsProvider.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,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"}
+{"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,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,qBAAqB,EACrB,oCAAoC,EACpC,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,OAAO,EACP,eAAe,EACf,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAE7B,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

@@ -1,5 +1,4 @@
 import { ActionType } from '@lifi/perps-types';
-import { type LoadLighterWasmOptions } from './wasmLoader.js';
 /**
  * Credentials needed to initialize the Lighter WASM client for one account
  * and API-key slot. The private key is Lighter-native signing material; the
@@ -16,22 +15,16 @@ export interface LighterSignerContext {
     accountIndex: number;
 }
 /**
- * Configuration for {@link LighterSigner}: optional WASM asset overrides plus
- * the per-instance REST base URL, signing chain id and collateral asset index.
+ * Deployment facts {@link LighterSigner} signs against: the venue's REST base
+ * URL, its zkLighter L2 signing chain id, and the L2 asset index its
+ * withdrawals and transfers settle in.
  *
- * @public
+ * @internal
  */
-export interface LighterSignerConfig extends LoadLighterWasmOptions {
-    /** Lighter REST API base URL. */
-    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;
+export interface LighterSignerConfig {
+    apiUrl: string;
+    signerChainId: number;
+    collateralAssetIndex: number;
 }
 /**
  * Signed Lighter transaction blob returned by the WASM signer. `txType`,
@@ -80,16 +73,15 @@ export interface ApiKeyPair {
  * hybrid flows. The instance memoizes WASM initialization and registered
  * `(apiKeyIndex, accountIndex)` clients.
  *
- * @public
+ * @internal
  */
 export declare class LighterSigner {
     private readonly apiUrl;
     private readonly chainId;
     private readonly collateralAssetIndex;
-    private readonly loaderOptions;
     private wasm;
     private readonly registeredClients;
-    constructor(config?: LighterSignerConfig);
+    constructor(config: LighterSignerConfig);
     /**
      * Load and cache the Go WASM signer exports. Most signing methods initialize
      * lazily, so callers only need this method when they want an explicit warm-up.

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;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"}
+{"version":3,"file":"LighterSigner.d.ts","sourceRoot":"","sources":["../../../src/signers/LighterSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAc9C;;;;;;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;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,oBAAoB,EAAE,MAAM,CAAA;CAC7B;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,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAE1C,MAAM,EAAE,mBAAmB;IAMvC;;;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/signers/generated/wasmExecRuntime.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Go's canonical `wasm_exec.js`, verbatim, as opaque runtime text. Evaluated by
+ * the WASM loader to install `globalThis.Go`.
+ *
+ * @internal
+ */
+export declare const WASM_EXEC_JS: string;
+//# sourceMappingURL=wasmExecRuntime.d.ts.map

package/dist/types/signers/generated/wasmExecRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasmExecRuntime.d.ts","sourceRoot":"","sources":["../../../../src/signers/generated/wasmExecRuntime.ts"],"names":[],"mappings":"AAwjBA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,MAAmC,CAAA"}

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

@@ -7,18 +7,16 @@ import type { LighterKeyStore } from './LighterKeyStore.js';
 import type { LighterSigner } from './LighterSigner.js';
 /**
  * Per-batch dependencies the Lighter `signActions` implementation needs:
- * a WASM signer (`LighterSigner`), the API-key store keyed on L1 address,
+ * the provider instance's WASM signer, its API-key store keyed on L1 address,
  * a REST client for the token-authenticated venue mutations that execute
  * client-side, and an `accountIndex` resolver for the REGISTER_API_KEY
  * hybrid flow.
  *
- * `signer` and `keyStore` are optional because only the `WASM_BLOB` arm signs
- * with them — `EVM_TX` broadcasts through the end-user wallet in `ctx`.
  * @internal
  */
 export interface LighterSignActionsDeps {
-    signer?: LighterSigner;
-    keyStore?: LighterKeyStore;
+    signer: LighterSigner;
+    keyStore: LighterKeyStore;
     /** REST client bound to the user's Lighter base URL, used for the direct
      * `changeAccountTier` / `referral/use` POSTs so their auth token never
      * transits the LI.FI backend. */

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

@@ -1 +1 @@
-{"version":3,"file":"signActions.d.ts","sourceRoot":"","sources":["../../../src/signers/signActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAA8B,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B;;qCAEiC;IACjC,SAAS,EAAE,gBAAgB,CAAA;IAC3B;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvD;AAuBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,GAAG,EAAE,kBAAkB,GAAG,SAAS,GAClC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CA0BrC;AA2QD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EAAE,EACxB,GAAG,EAAE,kBAAkB,GAAG,SAAS,GAClC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA6ElC;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB7B"}
+{"version":3,"file":"signActions.d.ts","sourceRoot":"","sources":["../../../src/signers/signActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAA8B,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,eAAe,CAAA;IACzB;;qCAEiC;IACjC,SAAS,EAAE,gBAAgB,CAAA;IAC3B;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvD;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,GAAG,EAAE,kBAAkB,GAAG,SAAS,GAClC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAgBrC;AA2QD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EAAE,EACxB,GAAG,EAAE,kBAAkB,GAAG,SAAS,GAClC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA6ElC;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB7B"}

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

@@ -1,28 +1,3 @@
-/**
- * Overrides for locating the Lighter Go WASM binary and its runtime loader.
- * Supplying explicit URLs or source is useful when a bundler does not preserve
- * the package's relative asset layout.
- *
- * @public
- */
-export interface LoadLighterWasmOptions {
-    /** Override URL for the `.wasm` binary (browser: fetch; Node: fs). */
-    wasmBinaryUrl?: string | URL;
-    /** Override URL for Go's `wasm_exec.js` runtime. */
-    wasmExecJsUrl?: string | URL;
-    /**
-     * Pre-fetched source of Go's `wasm_exec.js`. Preferred over
-     * `wasmExecJsUrl` for bundlers (Vite/webpack) that may transform a `.js`
-     * URL on serve, breaking the IIFE that installs `globalThis.Go`. Pass via
-     * a `?raw` import (Vite) or equivalent so the original source survives
-     * intact.
-     *
-     * @security This string is evaluated via `new Function(...)`. The caller is
-     * responsible for ensuring it originates from the bundled `wasm_exec.js`;
-     * attacker-controlled content would execute arbitrary code in the host.
-     */
-    wasmExecJsSource?: string;
-}
 /**
  * Function table installed by the Lighter Go WASM runtime. Methods mirror the
  * venue signer ABI and return a result containing either signed transaction
@@ -145,16 +120,17 @@ export interface SignResult {
     error?: string;
 }
 /**
- * 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.
- * @public
+ * Load the Lighter WASM signer from the binary shipped with this package.
+ * 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.
+ * @internal
  */
-export declare function loadLighterWasm(options?: LoadLighterWasmOptions): Promise<LighterWasmExports>;
+export declare function loadLighterWasm(): Promise<LighterWasmExports>;
 /**
  * Testing helper — drop the cached WASM instance so the next load reinitializes.
  *
- * @public
+ * @internal
  */
 export declare function resetLighterWasmCache(): void;
 //# sourceMappingURL=wasmLoader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wasmLoader.d.ts","sourceRoot":"","sources":["../../../src/signers/wasmLoader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wasmLoader.d.ts","sourceRoot":"","sources":["../../../src/signers/wasmLoader.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM;QACpB,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;;;;;;;;;;;;;;;OAeG;IACH,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD,2EAA2E;IAC3E,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD;;;OAGG;IACH,mBAAmB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACvD;;;;;OAKG;IACH,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IAChD,iFAAiF;IACjF,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IAChD;;;OAGG;IACH,kBAAkB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACtD;;;;;OAKG;IACH,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD;;;OAGG;IACH,gBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACpD;;;;;;;OAOG;IACH,qBAAqB,EAAE,CACrB,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,UAAU,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C;;;;OAIG;IACH,uBAAuB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IAC3D;;;;OAIG;IACH,4BAA4B,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;CACjE;AAED,gBAAgB;AAChB,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;AAyDD;;;;;;GAMG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAKnE;AAmDD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "8.2.1",
+  "version": "9.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",

package/src/LighterProvider.ts

@@ -4,6 +4,7 @@ import {
   getAssetRegistry,
   getMarketRegistry,
   getProviders,
+  localStorageAdapter,
   PerpsError,
   type PerpsProviderPlugin,
   type PerpsSDKClient,
@@ -21,6 +22,7 @@ import {
   resolveRetryPolicy,
   type SDKRequestOptions,
   type SignActionsContext,
+  type StorageAdapter,
   toPerpsMarketDisplay,
 } from '@lifi/perps-sdk'
 import type {
@@ -34,7 +36,6 @@ import type {
   Balance,
   FillsResponse,
   LighterAccountConfig,
-  LighterProviderKey,
   MarketSettings,
   Order,
   OrdersResponse,
@@ -56,23 +57,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,
@@ -170,67 +169,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 +244,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}.
+ * 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}.
  *
- * Write actions (`WASM_BLOB` and `EVM_TX` signing) are dispatched via
- * `signActions` — `PerpsClient.execute` delegates those arms here.
- *
- * @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 +262,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 +321,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 +369,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 +451,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 +703,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`.
@@ -1349,9 +1304,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 +1314,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 +1341,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 +1358,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()`).
  *