@lifi/perps-sdk-provider-lighter 13.0.1 → 14.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"LighterProvider.d.ts","sourceRoot":"","sources":["../../src/LighterProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,mBAAmB,EAmBxB,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAA;AA6BxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AAwGvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,4FAA4F;IAC5F,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAQD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAChE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,iBAAiB,EAC7B,UAAS,sBAA2B,KACnC,oBA6rCF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAS,sBAA2B,KACnC,oBACyD,CAAA;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,sBAA2B,KACnC,oBAA6E,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,OAAO,aA7BT,sBAAsB,KAC9B,oBA4BmC,CAAA"}
+{"version":3,"file":"LighterProvider.d.ts","sourceRoot":"","sources":["../../src/LighterProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,mBAAmB,EAmBxB,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAA;AA6BxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,OAAO,EASL,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AA2GvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACrD,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,4FAA4F;IAC5F,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAQD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAChE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,iBAAiB,EAC7B,UAAS,sBAA2B,KACnC,oBA4rCF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAS,sBAA2B,KACnC,oBACyD,CAAA;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,sBAA2B,KACnC,oBAA6E,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,OAAO,aA7BT,sBAAsB,KAC9B,oBA4BmC,CAAA"}

package/dist/types/constants.d.ts

@@ -161,16 +161,6 @@ export declare const LIGHTER_ALL_MARKETS_WILDCARD = 255;
  * @internal
  */
 export declare const LIGHTER_HISTORY_PAGE_SIZE = 100;
-/**
- * Default API key slot — reused per account. Lighter's docs reserve indexes
- * `{0,1,2,3}` for its own desktop/mobile interfaces; user keys start at 4
- * (max 254, with 255 reserved as `NilApiKeyIndex`). 42 is the LI.FI-wide
- * identifier so a user running both the Lighter app and the widget never
- * collides with the app's session key.
- *
- * @public
- */
-export declare const DEFAULT_API_KEY_INDEX = 42;
 /** @internal */
 declare const LIGHTER_CODE_ACCOUNT_NOT_FOUND = 21100;
 /**

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;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;;;;;GAKG;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,CAUvB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,UAAU,EAAE,sBAAsB,CAAA;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAOvC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAC/D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oCAAoC,CAAA;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,SAAS,CAAA;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAOlC,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;;;;;GAKG;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,CAUvB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,UAAU,EAAE,sBAAsB,CAAA;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAOvC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAC/D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oCAAoC,CAAA;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,SAAS,CAAA;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAOlC,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,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

@@ -12,7 +12,7 @@
 export { projectLighterConfigSettings } from './accountConfig.js';
 export { getAccountSummary } from './accountSummary.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 { 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, lighterRhProvider, } 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,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;AAC7B,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,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,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;AAC7B,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,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/LighterKeyStore.d.ts

@@ -11,7 +11,7 @@ import type { Address } from 'viem';
 export interface LighterApiKey {
     /** Lighter account index, looked up once via accountsByL1Address. */
     accountIndex: number;
-    /** API key slot (0-255). Defaults to {@link DEFAULT_API_KEY_INDEX}. */
+    /** API key slot (0-255), as named by the backend registration payload. */
     apiKeyIndex: number;
     /** Lighter-native private key (0x-prefixed hex). */
     apiKeyPrivateKey: string;

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

@@ -1 +1 @@
-{"version":3,"file":"LighterKeyStore.d.ts","sourceRoot":"","sources":["../../../src/signers/LighterKeyStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAWnC;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAA;CACxB;AAoBD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,WAAW,CAAoB;IAEvC;;;;OAIG;gBAED,OAAO,EAAE,cAAc,EACvB,WAAW,GAAE,kBAAyC;IAMxD;;;;;OAKG;IACH,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAMtD,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAc1D;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}
+{"version":3,"file":"LighterKeyStore.d.ts","sourceRoot":"","sources":["../../../src/signers/LighterKeyStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAWnC;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAA;CACxB;AAoBD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,WAAW,CAAoB;IAEvC;;;;OAIG;gBAED,OAAO,EAAE,cAAc,EACvB,WAAW,GAAE,kBAAyC;IAMxD;;;;;OAKG;IACH,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAMtD,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAc1D;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}

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

@@ -3,7 +3,7 @@ import type { ActionStep, EvmTxActionStep, EvmTxSignedActionStep, SignedActionSt
 import { SigningMethod } from '@lifi/perps-types';
 import type { Address } from 'viem';
 import type { LighterApiClient } from '../utils/apiClient.js';
-import type { LighterKeyStore } from './LighterKeyStore.js';
+import type { LighterApiKey, LighterKeyStore } from './LighterKeyStore.js';
 import type { LighterSigner } from './LighterSigner.js';
 /**
  * Per-batch dependencies the Lighter `signActions` implementation needs:
@@ -21,6 +21,11 @@ export interface LighterSignActionsDeps {
      * `changeAccountTier` / `referral/use` POSTs so their auth token never
      * transits the LI.FI backend. */
     apiClient: LighterApiClient;
+    /**
+     * Pre-sign guard that the stored API key still occupies its venue slot.
+     * Created once per provider instance so its freshness window spans batches.
+     */
+    apiKeyFreshness: LighterApiKeyFreshness;
     /**
      * Resolve the user's Lighter `accountIndex` for an L1 address. Required
      * by REGISTER_API_KEY so the ChangePubKey blob carries the right
@@ -29,6 +34,22 @@ export interface LighterSignActionsDeps {
      */
     resolveAccountIndex(address: Address): Promise<number>;
 }
+/**
+ * Pre-sign guard that the stored Lighter API key is still the key registered
+ * in its venue slot. Owns the freshness window, so one instance is created per
+ * provider instance and shared by every batch that instance signs.
+ *
+ * @internal
+ */
+export interface LighterApiKeyFreshness {
+    assertStillRegistered(client: LighterApiClient, address: Address, apiKey: LighterApiKey): Promise<void>;
+}
+/**
+ * Build the guard {@link LighterSignActionsDeps.apiKeyFreshness} needs.
+ *
+ * @internal
+ */
+export declare const createLighterApiKeyFreshness: () => LighterApiKeyFreshness;
 /**
  * Sign a `WASM_BLOB` batch (Lighter). Ensures the user's API keypair is
  * registered first — generating one and running the REGISTER_API_KEY

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,EAEV,aAAa,EAEd,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;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,CAkBrC;AAgUD;;;;;;;;;;;;;;;;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;AAInC,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAMxE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAEV,aAAa,EAEd,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,eAAe,CAAA;IACzB;;qCAEiC;IACjC,SAAS,EAAE,gBAAgB,CAAA;IAC3B;;;OAGG;IACH,eAAe,EAAE,sBAAsB,CAAA;IACvC;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvD;AAyBD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,QAAO,sBAqD/C,CAAA;AAED;;;;;;;;;;;;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,CAkCrC;AAsUD;;;;;;;;;;;;;;;;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/utils/registeredApiKey.d.ts

@@ -0,0 +1,21 @@
+import type { LighterApiClient } from './apiClient.js';
+/**
+ * One entry of Lighter's `/api/v1/apikeys` response: the public key the venue
+ * holds in an API-key slot.
+ *
+ * @internal
+ */
+export interface LighterRegisteredApiKey {
+    api_key_index: number;
+    public_key: string;
+}
+/** Compare Lighter public keys irrespective of `0x` prefix / casing. */
+export declare const normalizeLighterPublicKey: (key: string) => string;
+/**
+ * Read the public key Lighter holds in one API-key slot. Returns `undefined`
+ * when the response carries no entry for `apiKeyIndex`.
+ *
+ * @internal
+ */
+export declare const fetchRegisteredApiKey: (client: LighterApiClient, accountIndex: number, apiKeyIndex: number) => Promise<LighterRegisteredApiKey | undefined>;
+//# sourceMappingURL=registeredApiKey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registeredApiKey.d.ts","sourceRoot":"","sources":["../../../src/utils/registeredApiKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MACjB,CAAA;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,gBAAgB,EACxB,cAAc,MAAM,EACpB,aAAa,MAAM,KAClB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAM7C,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "13.0.1",
+  "version": "14.0.0",
   "description": "Lighter provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -44,10 +44,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.55.18",
-    "@lifi/perps-types": "^7.0.0"
+    "@lifi/perps-types": "^8.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^7.0.0"
+    "@lifi/perps-sdk": "^7.0.1"
   },
   "publishConfig": {
     "access": "public"

package/src/LighterProvider.ts

@@ -60,7 +60,6 @@ import type { Address } from 'viem'
 import { projectLighterConfigSettings } from './accountConfig.js'
 import { getAccountSummary } from './accountSummary.js'
 import {
-  DEFAULT_API_KEY_INDEX,
   DEFAULT_TRADES_LIMIT,
   LIGHTER_ALL_MARKETS_WILDCARD,
   LIGHTER_BASE_FEE_TIER,
@@ -76,7 +75,10 @@ import { createAuthToken } from './signers/createAuthToken.js'
 import { LighterKeyStore } from './signers/LighterKeyStore.js'
 import { LighterReadOnlyTokenManager } from './signers/LighterReadOnlyTokenManager.js'
 import { LighterSigner } from './signers/LighterSigner.js'
-import { lighterSignActions } from './signers/signActions.js'
+import {
+  createLighterApiKeyFreshness,
+  lighterSignActions,
+} from './signers/signActions.js'
 import type {
   LtAccountLimits,
   LtDepositHistoryResponse,
@@ -119,6 +121,10 @@ import {
   toRequiredBig,
 } from './utils/index.js'
 import { mapRunningTwap } from './utils/mapTwap.js'
+import {
+  fetchRegisteredApiKey,
+  normalizeLighterPublicKey,
+} from './utils/registeredApiKey.js'
 
 const ZERO_FEE_TIER = { maker: '0', taker: '0' }
 
@@ -170,10 +176,6 @@ interface ReadOnlyCreationBackoff {
   attempt: number
 }
 
-/** Compare Lighter public keys irrespective of `0x` prefix / casing. */
-const normalizeLighterPublicKey = (key: string): string =>
-  key.replace(/^0x/i, '').toLowerCase()
-
 /**
  * Consumer-level overrides for a ready-made Lighter provider plugin. Every
  * deployment fact — provider key, endpoints, signing chain id, collateral
@@ -285,6 +287,7 @@ export const createLighterProvider = (
     collateralAssetIndex: collateral.assetIndex,
   })
   const keyStore = new LighterKeyStore(storage, providerKey)
+  const apiKeyFreshness = createLighterApiKeyFreshness()
   const readOnlyTokenManager = new LighterReadOnlyTokenManager({
     storage,
     providerKey,
@@ -518,18 +521,6 @@ export const createLighterProvider = (
     }
   }
 
-  const fetchRegisteredApiKey = async (
-    client: LighterApiClient,
-    accountIndex: number,
-    apiKeyIndex: number
-  ): Promise<{ api_key_index: number; public_key: string } | undefined> => {
-    const response = await client.get<{
-      code: number
-      api_keys: Array<{ api_key_index: number; public_key: string }>
-    }>('/api/v1/apikeys', { account_index: accountIndex })
-    return response.api_keys?.find((k) => k.api_key_index === apiKeyIndex)
-  }
-
   const fetchAccountLimits = (
     client: LighterApiClient,
     accountIndex: number,
@@ -714,6 +705,9 @@ export const createLighterProvider = (
       // Shared promise: the referral read below awaits this instance's runtime
       // metadata off the same `/providers` fetch — no second request.
       const providersPromise = getProviders(requireClient())
+      // Shared promise: the registered-key read names the slot off the local
+      // record, and the config readout reports the record — one storage read.
+      const localKeyPromise = keyStore.get(params.address)
       const [
         { providers },
         ,
@@ -727,7 +721,13 @@ export const createLighterProvider = (
         providersPromise,
         registry.sync(),
         assetRegistry.sync(),
-        fetchRegisteredApiKey(client, account.index, DEFAULT_API_KEY_INDEX),
+        // The local record names the only slot worth reading: no record means
+        // nothing to compare the registered key against, so the read is skipped.
+        localKeyPromise.then((key) =>
+          key === null
+            ? undefined
+            : fetchRegisteredApiKey(client, account.index, key.apiKeyIndex)
+        ),
         // No token is a legitimate unauthenticated read → undefined → zero fee
         // tier. A generic fetch error is NOT: it must propagate, never be
         // coerced to a fabricated 0%/0% fee tier. One carve-out: a token the
@@ -742,7 +742,7 @@ export const createLighterProvider = (
                 fetchAccountLimits(client, account.index, t)
               )
             ),
-        keyStore.get(params.address),
+        localKeyPromise,
         readOnlyTokenManager.get(params.address, account.index),
         // The expected code is backend-owned runtime metadata on this
         // instance's own provider descriptor (keyed by `providerKey`, so the
@@ -850,7 +850,7 @@ export const createLighterProvider = (
       const config: LighterAccountConfig = {
         provider: providerKey,
         accountIndex: account.index,
-        apiKeyIndex: DEFAULT_API_KEY_INDEX,
+        apiKeyIndex: localKey?.apiKeyIndex,
         apiKeyRegistered,
         accountType: account.account_type,
         accountTradingMode: account.account_trading_mode,
@@ -1449,6 +1449,7 @@ export const createLighterProvider = (
           signer,
           keyStore,
           apiClient: apiClient(),
+          apiKeyFreshness,
           resolveAccountIndex: async (addr) => {
             const apiKey = await keyStore.get(addr)
             if (apiKey !== null) {

package/src/constants.ts

@@ -208,17 +208,6 @@ export const LIGHTER_ALL_MARKETS_WILDCARD = 255
  */
 export const LIGHTER_HISTORY_PAGE_SIZE = 100
 
-/**
- * Default API key slot — reused per account. Lighter's docs reserve indexes
- * `{0,1,2,3}` for its own desktop/mobile interfaces; user keys start at 4
- * (max 254, with 255 reserved as `NilApiKeyIndex`). 42 is the LI.FI-wide
- * identifier so a user running both the Lighter app and the widget never
- * collides with the app's session key.
- *
- * @public
- */
-export const DEFAULT_API_KEY_INDEX = 42
-
 /** @internal */
 const LIGHTER_CODE_ACCOUNT_NOT_FOUND = 21100
 

package/src/index.ts

@@ -20,7 +20,6 @@ export type {
   LighterDeployment,
 } from './constants.js'
 export {
-  DEFAULT_API_KEY_INDEX,
   DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL,
   DEFAULT_LIGHTER_REST_URL,
   DEFAULT_LIGHTER_WS_URL,

package/src/signers/LighterKeyStore.ts

@@ -21,7 +21,7 @@ const STORAGE_PREFIX = 'lifi-perps-lighter-key'
 export interface LighterApiKey {
   /** Lighter account index, looked up once via accountsByL1Address. */
   accountIndex: number
-  /** API key slot (0-255). Defaults to {@link DEFAULT_API_KEY_INDEX}. */
+  /** API key slot (0-255), as named by the backend registration payload. */
   apiKeyIndex: number
   /** Lighter-native private key (0x-prefixed hex). */
   apiKeyPrivateKey: string

package/src/signers/signActions.ts

@@ -11,11 +11,13 @@ import { ActionType, PerpsErrorCode, SigningMethod } from '@lifi/perps-types'
 import type { Address } from 'viem'
 import { parseAbi } from 'viem'
 import { waitForTransactionReceipt } from 'viem/actions'
-import {
-  DEFAULT_API_KEY_INDEX,
-  LIGHTER_MUTATION_SUCCESS_CODE,
-} from '../constants.js'
+import { LIGHTER_MUTATION_SUCCESS_CODE } from '../constants.js'
 import type { ApiParams, LighterApiClient } from '../utils/apiClient.js'
+import {
+  fetchRegisteredApiKey,
+  type LighterRegisteredApiKey,
+  normalizeLighterPublicKey,
+} from '../utils/registeredApiKey.js'
 import type { LighterApiKey, LighterKeyStore } from './LighterKeyStore.js'
 import type {
   LighterSignedBlob,
@@ -39,6 +41,11 @@ export interface LighterSignActionsDeps {
    * `changeAccountTier` / `referral/use` POSTs so their auth token never
    * transits the LI.FI backend. */
   apiClient: LighterApiClient
+  /**
+   * Pre-sign guard that the stored API key still occupies its venue slot.
+   * Created once per provider instance so its freshness window spans batches.
+   */
+  apiKeyFreshness: LighterApiKeyFreshness
   /**
    * Resolve the user's Lighter `accountIndex` for an L1 address. Required
    * by REGISTER_API_KEY so the ChangePubKey blob carries the right
@@ -63,6 +70,89 @@ const TOKEN_AUTH_MUTATION_KINDS = new Set(['changeAccountTier', 'referralUse'])
  */
 const TOKEN_AUTH_MUTATION_DEADLINE_SECONDS = 5 * 60
 
+/**
+ * Window in which one `/apikeys` read stands for the next. 30s keeps a burst
+ * of batches — several orders submitted back to back, a close-then-reduce
+ * sequence — at one read, and still surfaces a key rotated on another device
+ * on the user's next action instead of after a venue rejection.
+ */
+const API_KEY_FRESHNESS_WINDOW_MS = 30_000
+
+/**
+ * Pre-sign guard that the stored Lighter API key is still the key registered
+ * in its venue slot. Owns the freshness window, so one instance is created per
+ * provider instance and shared by every batch that instance signs.
+ *
+ * @internal
+ */
+export interface LighterApiKeyFreshness {
+  assertStillRegistered(
+    client: LighterApiClient,
+    address: Address,
+    apiKey: LighterApiKey
+  ): Promise<void>
+}
+
+/**
+ * Build the guard {@link LighterSignActionsDeps.apiKeyFreshness} needs.
+ *
+ * @internal
+ */
+export const createLighterApiKeyFreshness = (): LighterApiKeyFreshness => {
+  const checkedAtMs = new Map<string, number>()
+  return {
+    async assertStillRegistered(client, address, apiKey) {
+      const storedKey = normalizeLighterPublicKey(apiKey.apiKeyPublicKey)
+      // Keyed on the stored key, so a rotation retires the entry by itself.
+      const windowKey = `${apiKey.accountIndex}:${apiKey.apiKeyIndex}:${storedKey}`
+      const checkedAt = checkedAtMs.get(windowKey)
+      if (
+        checkedAt !== undefined &&
+        Date.now() - checkedAt < API_KEY_FRESHNESS_WINDOW_MS
+      ) {
+        return
+      }
+
+      let registered: LighterRegisteredApiKey | undefined
+      try {
+        registered = await fetchRegisteredApiKey(
+          client,
+          apiKey.accountIndex,
+          apiKey.apiKeyIndex
+        )
+      } catch (err) {
+        // A transport failure or a non-success body proves nothing about the
+        // slot, so the venue decides. A failed check never blocks a signature.
+        // The code names the failure without the response body, which lists
+        // the account's other key slots.
+        console.warn(
+          '[lighter] could not read the registered API key before signing; ' +
+            'signing anyway and letting the venue decide.',
+          err instanceof PerpsError ? err.code : String(err)
+        )
+        checkedAtMs.set(windowKey, Date.now())
+        return
+      }
+      // A slot carrying no entry leaves nothing to compare against.
+      if (
+        registered !== undefined &&
+        normalizeLighterPublicKey(registered.public_key) !== storedKey
+      ) {
+        throw new PerpsError(
+          PerpsErrorCode.SDKError,
+          `The Lighter API key stored for ${address} is no longer registered: ` +
+            `API-key slot ${apiKey.apiKeyIndex} now holds a different key. ` +
+            'Run prepareAccount / REGISTER_API_KEY to register a fresh key.'
+        )
+      }
+      // Every read the venue answered counts against the window, so a burst
+      // costs one read whatever the verdict. A mismatch throws above, so it
+      // never records and the next batch reads again.
+      checkedAtMs.set(windowKey, Date.now())
+    },
+  }
+}
+
 /**
  * Sign a `WASM_BLOB` batch (Lighter). Ensures the user's API keypair is
  * registered first — generating one and running the REGISTER_API_KEY
@@ -82,6 +172,22 @@ export async function signWasmBlobActions(
   steps: WasmBlobActionStep[],
   ctx: SignActionsContext | undefined
 ): Promise<WasmBlobSignedActionStep[]> {
+  // REGISTER_API_KEY replaces the slot's key, so for such a batch the stored
+  // key is expected to differ from the registered one.
+  const replacesApiKey = steps.some(
+    (step) => step.action === ActionType.REGISTER_API_KEY
+  )
+  if (!replacesApiKey) {
+    const storedKey = await deps.keyStore.get(address)
+    if (storedKey !== null) {
+      await deps.apiKeyFreshness.assertStillRegistered(
+        deps.apiClient,
+        address,
+        storedKey
+      )
+    }
+  }
+
   const signed: WasmBlobSignedActionStep[] = []
   for (const step of steps) {
     if (step.action === ActionType.REGISTER_API_KEY) {
@@ -151,7 +257,13 @@ async function signRegisterApiKey(
     nonce?: number
     skip_nonce?: 0 | 1
   }
-  const apiKeyIndex = params.api_key_index ?? DEFAULT_API_KEY_INDEX
+  const apiKeyIndex = params.api_key_index
+  if (typeof apiKeyIndex !== 'number') {
+    throw new PerpsError(
+      PerpsErrorCode.SDKError,
+      'REGISTER_API_KEY wasmSignParams is missing `api_key_index`.'
+    )
+  }
   const nonce = params.nonce
   if (typeof nonce !== 'number') {
     throw new PerpsError(

package/src/utils/registeredApiKey.ts

@@ -0,0 +1,34 @@
+import type { LighterApiClient } from './apiClient.js'
+
+/**
+ * One entry of Lighter's `/api/v1/apikeys` response: the public key the venue
+ * holds in an API-key slot.
+ *
+ * @internal
+ */
+export interface LighterRegisteredApiKey {
+  api_key_index: number
+  public_key: string
+}
+
+/** Compare Lighter public keys irrespective of `0x` prefix / casing. */
+export const normalizeLighterPublicKey = (key: string): string =>
+  key.replace(/^0x/i, '').toLowerCase()
+
+/**
+ * Read the public key Lighter holds in one API-key slot. Returns `undefined`
+ * when the response carries no entry for `apiKeyIndex`.
+ *
+ * @internal
+ */
+export const fetchRegisteredApiKey = async (
+  client: LighterApiClient,
+  accountIndex: number,
+  apiKeyIndex: number
+): Promise<LighterRegisteredApiKey | undefined> => {
+  const response = await client.get<{
+    code: number
+    api_keys: LighterRegisteredApiKey[]
+  }>('/api/v1/apikeys', { account_index: accountIndex })
+  return response.api_keys?.find((k) => k.api_key_index === apiKeyIndex)
+}