@metamask-previews/perps-controller 18.0.1-preview-c92646a67 → 19.0.0-preview-cdde826

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/CHANGELOG.md +69 -1
  2. package/README.md +69 -0
  3. package/dist/PerpsController-method-action-types.d.ts +65 -1
  4. package/dist/PerpsController-method-action-types.d.ts.map +1 -1
  5. package/dist/PerpsController-method-action-types.js.map +1 -1
  6. package/dist/PerpsController.d.ts +56 -1
  7. package/dist/PerpsController.d.ts.map +1 -1
  8. package/dist/PerpsController.js +181 -2
  9. package/dist/PerpsController.js.map +1 -1
  10. package/dist/constants/hyperLiquidConfig.d.ts +10 -0
  11. package/dist/constants/hyperLiquidConfig.d.ts.map +1 -1
  12. package/dist/constants/hyperLiquidConfig.js +10 -0
  13. package/dist/constants/hyperLiquidConfig.js.map +1 -1
  14. package/dist/constants/orderTypes.d.ts +3 -0
  15. package/dist/constants/orderTypes.d.ts.map +1 -1
  16. package/dist/constants/orderTypes.js +3 -0
  17. package/dist/constants/orderTypes.js.map +1 -1
  18. package/dist/index.d.ts +4 -4
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js +1 -1
  21. package/dist/index.js.map +1 -1
  22. package/dist/perpsErrorCodes.d.ts.map +1 -1
  23. package/dist/perpsErrorCodes.js +3 -0
  24. package/dist/perpsErrorCodes.js.map +1 -1
  25. package/dist/providers/AggregatedPerpsProvider.d.ts +9 -0
  26. package/dist/providers/AggregatedPerpsProvider.d.ts.map +1 -1
  27. package/dist/providers/AggregatedPerpsProvider.js +46 -0
  28. package/dist/providers/AggregatedPerpsProvider.js.map +1 -1
  29. package/dist/providers/HyperLiquidProvider.d.ts +18 -1
  30. package/dist/providers/HyperLiquidProvider.d.ts.map +1 -1
  31. package/dist/providers/HyperLiquidProvider.js +747 -186
  32. package/dist/providers/HyperLiquidProvider.js.map +1 -1
  33. package/dist/providers/LighterProvider.d.ts +10 -0
  34. package/dist/providers/LighterProvider.d.ts.map +1 -1
  35. package/dist/providers/LighterProvider.js +93 -10
  36. package/dist/providers/LighterProvider.js.map +1 -1
  37. package/dist/services/HyperLiquidClientService.d.ts +4 -17
  38. package/dist/services/HyperLiquidClientService.d.ts.map +1 -1
  39. package/dist/services/HyperLiquidClientService.js.map +1 -1
  40. package/dist/services/HyperLiquidWalletService.d.ts +27 -29
  41. package/dist/services/HyperLiquidWalletService.d.ts.map +1 -1
  42. package/dist/services/HyperLiquidWalletService.js +101 -40
  43. package/dist/services/HyperLiquidWalletService.js.map +1 -1
  44. package/dist/services/LighterClientService.js +2 -2
  45. package/dist/services/LighterClientService.js.map +1 -1
  46. package/dist/services/LighterWalletService.d.ts +13 -8
  47. package/dist/services/LighterWalletService.d.ts.map +1 -1
  48. package/dist/services/LighterWalletService.js +41 -22
  49. package/dist/services/LighterWalletService.js.map +1 -1
  50. package/dist/services/MarketDataService.d.ts.map +1 -1
  51. package/dist/services/MarketDataService.js +14 -3
  52. package/dist/services/MarketDataService.js.map +1 -1
  53. package/dist/services/RewardsIntegrationService.d.ts +5 -4
  54. package/dist/services/RewardsIntegrationService.d.ts.map +1 -1
  55. package/dist/services/RewardsIntegrationService.js +35 -20
  56. package/dist/services/RewardsIntegrationService.js.map +1 -1
  57. package/dist/services/TradingReadinessCache.js.map +1 -1
  58. package/dist/services/TradingService.d.ts.map +1 -1
  59. package/dist/services/TradingService.js +37 -21
  60. package/dist/services/TradingService.js.map +1 -1
  61. package/dist/services/accountSigner.d.ts +18 -0
  62. package/dist/services/accountSigner.d.ts.map +1 -0
  63. package/dist/services/accountSigner.js +23 -0
  64. package/dist/services/accountSigner.js.map +1 -0
  65. package/dist/services/agentSigner.d.ts +61 -0
  66. package/dist/services/agentSigner.d.ts.map +1 -0
  67. package/dist/services/agentSigner.js +87 -0
  68. package/dist/services/agentSigner.js.map +1 -0
  69. package/dist/services/causeChain.d.ts +10 -0
  70. package/dist/services/causeChain.d.ts.map +1 -0
  71. package/dist/services/causeChain.js +21 -0
  72. package/dist/services/causeChain.js.map +1 -0
  73. package/dist/services/providerNetwork.d.ts +13 -0
  74. package/dist/services/providerNetwork.d.ts.map +1 -0
  75. package/dist/services/providerNetwork.js +17 -0
  76. package/dist/services/providerNetwork.js.map +1 -0
  77. package/dist/types/hyperliquid-types.d.ts +7 -7
  78. package/dist/types/hyperliquid-types.d.ts.map +1 -1
  79. package/dist/types/hyperliquid-types.js +4 -5
  80. package/dist/types/hyperliquid-types.js.map +1 -1
  81. package/dist/types/index.d.ts +190 -10
  82. package/dist/types/index.d.ts.map +1 -1
  83. package/dist/types/index.js.map +1 -1
  84. package/dist/types/lighter-types.d.ts +7 -17
  85. package/dist/types/lighter-types.d.ts.map +1 -1
  86. package/dist/types/lighter-types.js.map +1 -1
  87. package/dist/utils/accountUtils.js +1 -1
  88. package/dist/utils/accountUtils.js.map +1 -1
  89. package/dist/utils/errorUtils.d.ts +1 -1
  90. package/dist/utils/errorUtils.d.ts.map +1 -1
  91. package/dist/utils/errorUtils.js +3 -11
  92. package/dist/utils/errorUtils.js.map +1 -1
  93. package/dist/utils/hyperLiquidAbstraction.d.ts.map +1 -1
  94. package/dist/utils/hyperLiquidAbstraction.js +0 -1
  95. package/dist/utils/hyperLiquidAbstraction.js.map +1 -1
  96. package/dist/utils/lighterAdapter.d.ts +2 -2
  97. package/dist/utils/lighterAdapter.d.ts.map +1 -1
  98. package/dist/utils/lighterAdapter.js +23 -17
  99. package/dist/utils/lighterAdapter.js.map +1 -1
  100. package/package.json +6 -7
@@ -66,6 +66,16 @@ export declare class LighterProvider implements PerpsProvider {
66
66
  disconnect(): Promise<DisconnectResult>;
67
67
  ping(_timeoutMs?: number): Promise<void>;
68
68
  toggleTestnet(): Promise<ToggleTestnetResult>;
69
+ /**
70
+ * Register the venue key ahead of the first order, so its main-account
71
+ * `personal_sign` happens in a guided session. A read-only provider (no
72
+ * signer bridge) has nothing to prepare and resolves `ready: true` while an
73
+ * account is selected and the main-account signer is ready.
74
+ *
75
+ * @returns The readiness result described on
76
+ * `PerpsController.prepareTradingWallet`.
77
+ */
78
+ prepareTradingWallet(): Promise<ReadyToTradeResult>;
69
79
  isReadyToTrade(): Promise<ReadyToTradeResult>;
70
80
  /**
71
81
  * List TP/SL obligations parked in DURABLE manual-recovery state: the
@@ -1 +1 @@
1
- {"version":3,"file":"LighterProvider.d.ts","sourceRoot":"","sources":["../../src/providers/LighterProvider.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"LighterProvider.d.ts","sourceRoot":"","sources":["../../src/providers/LighterProvider.ts"],"names":[],"mappings":"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"}
@@ -16,10 +16,11 @@
16
16
  import { computeLighterMinOrderSize, fromLighterInteger, getLighterChainId, getLighterTransactionOutcome, LIGHTER_RESOLUTION_MS, LIGHTER_SUPPORTED_RESOLUTIONS, LIGHTER_DEFAULT_API_KEY_INDEX, LIGHTER_NO_TRIGGER_PRICE, LIGHTER_ORDER_EXPIRY_NONE, LIGHTER_ORDER_TYPE_LIMIT, LIGHTER_ORDER_TYPE_MARKET, LIGHTER_TIME_IN_FORCE_GOOD_TILL_TIME, getLighterWsEndpoint, LIGHTER_PRICE_POLLING_INTERVAL_MS, LIGHTER_TIME_IN_FORCE_IMMEDIATE_OR_CANCEL, LIGHTER_BRIDGE_CONFIG, LIGHTER_TX_TYPE_CANCEL_ORDER, LIGHTER_TX_TYPE_CHANGE_PUB_KEY, LIGHTER_GROUPING_ONE_CANCELS_THE_OTHER, LIGHTER_ORDER_TYPE_STOP_LOSS, LIGHTER_ORDER_TYPE_TAKE_PROFIT, LIGHTER_TX_TYPE_CREATE_GROUPED_ORDERS, LIGHTER_TX_TYPE_CREATE_ORDER, LIGHTER_TX_TYPE_UPDATE_LEVERAGE, LIGHTER_TX_TYPE_UPDATE_MARGIN, LIGHTER_TX_TYPE_WITHDRAW, LIGHTER_MARGIN_MODE_CROSS, LIGHTER_MARGIN_MODE_ISOLATED, LIGHTER_UNSUPPORTED_CAPABILITY_PREFIX, LIGHTER_USDC_ASSET_INDEX, LIGHTER_DATA_INTEGRITY_PREFIX, LIGHTER_MARGIN_METADATA_TTL_MS, parseLighterStrictDecimal, toLighterInteger, } from '../constants/lighterConfig.js';
17
17
  import { PERPS_CONSTANTS } from '../constants/perpsConfig.js';
18
18
  import { PERPS_ERROR_CODES } from '../perpsErrorCodes.js';
19
+ import { hasErrorInCauseChain } from '../services/causeChain.js';
19
20
  import { convertKeysToCamelCase, LighterApiError, LighterClientService, } from '../services/LighterClientService.js';
20
21
  import { LighterWalletService } from '../services/LighterWalletService.js';
21
22
  import { WebSocketConnectionState } from '../types/index.js';
22
- import { ensureError } from '../utils/errorUtils.js';
23
+ import { ensureError, isKeyringLockedError } from '../utils/errorUtils.js';
23
24
  import { adaptAccountStateFromLighter, adaptAccountStateFromLighterUserStats, adaptFillFromLighterTrade, adaptMarketDataFromLighter, adaptMarketFromLighter, adaptOrderFromLighter, adaptPositionFromLighter, adaptPriceUpdateFromLighter, adaptPriceUpdateFromLighterWsStat, } from '../utils/lighterAdapter.js';
24
25
  const NOOP_UNSUBSCRIBE = () => undefined;
25
26
  const LIGHTER_INACTIVE_HISTORY_ROW_LIMIT = 10_000;
@@ -514,6 +515,30 @@ class LighterAccountNotFoundError extends Error {
514
515
  this.name = 'LighterAccountNotFoundError';
515
516
  }
516
517
  }
518
+ /**
519
+ * Session-bound work stopped because the provider disconnected or the wallet
520
+ * switched accounts while it ran.
521
+ */
522
+ class LighterSessionCancelledError extends Error {
523
+ constructor(reason) {
524
+ super(`Operation cancelled: ${reason}`);
525
+ this.name = 'LighterSessionCancelledError';
526
+ }
527
+ }
528
+ // EIP-1193 `userRejectedRequest` error code.
529
+ const USER_REJECTED_REQUEST_CODE = 4001;
530
+ // How wallets word a declined signature when they set no code (the same
531
+ // wordings the controller's deposit flow treats as a cancellation).
532
+ const USER_REJECTED_MESSAGE_PATTERN = /user (rejected|denied|cancell?ed)/iu;
533
+ /**
534
+ * Whether the user declined the venue-key signature; the order path asks
535
+ * again.
536
+ *
537
+ * @param error - The caught error.
538
+ * @returns True for a declined signature.
539
+ */
540
+ const isDeclinedRegistration = (error) => hasErrorInCauseChain(error, (current) => current.code === USER_REJECTED_REQUEST_CODE ||
541
+ USER_REJECTED_MESSAGE_PATTERN.test(current.message));
517
542
  /**
518
543
  * Empty account state returned when reads fail or no account exists.
519
544
  */
@@ -635,8 +660,6 @@ export class LighterProvider {
635
660
  this.#walletService = new LighterWalletService(this.#deps, {
636
661
  isTestnet: this.#isTestnet,
637
662
  messenger: options.messenger,
638
- personalSigner: options.lighterAuthConfig?.personalSigner,
639
- l1Address: options.lighterAuthConfig?.l1Address,
640
663
  });
641
664
  this.#deps.debugLogger.log('[LighterProvider] Constructor complete', {
642
665
  protocolId: this.protocolId,
@@ -719,6 +742,66 @@ export class LighterProvider {
719
742
  error: 'Lighter network is fixed at construction',
720
743
  };
721
744
  }
745
+ /**
746
+ * Register the venue key ahead of the first order, so its main-account
747
+ * `personal_sign` happens in a guided session. A read-only provider (no
748
+ * signer bridge) has nothing to prepare and resolves `ready: true` while an
749
+ * account is selected and the main-account signer is ready.
750
+ *
751
+ * @returns The readiness result described on
752
+ * `PerpsController.prepareTradingWallet`.
753
+ */
754
+ async prepareTradingWallet() {
755
+ if (!this.#walletService.isMainAccountSignerReady()) {
756
+ return { ready: false, error: PERPS_ERROR_CODES.KEYRING_LOCKED };
757
+ }
758
+ try {
759
+ this.#walletService.getUserAddress();
760
+ }
761
+ catch {
762
+ return { ready: false, error: PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED };
763
+ }
764
+ if (!this.#signerBridge) {
765
+ return { ready: true };
766
+ }
767
+ try {
768
+ await this.#ensureSignerReady();
769
+ // The signer can lock while the venue key is being registered.
770
+ if (!this.#walletService.isMainAccountSignerReady()) {
771
+ return { ready: false, error: PERPS_ERROR_CODES.KEYRING_LOCKED };
772
+ }
773
+ return { ready: true };
774
+ }
775
+ catch (caughtError) {
776
+ // A locked signer, or one that locked while registration ran.
777
+ if (isKeyringLockedError(caughtError) ||
778
+ !this.#walletService.isMainAccountSignerReady()) {
779
+ return { ready: false, error: PERPS_ERROR_CODES.KEYRING_LOCKED };
780
+ }
781
+ if (isDeclinedRegistration(caughtError)) {
782
+ return { ready: false };
783
+ }
784
+ // Nothing can be registered before the wallet has a Lighter account.
785
+ if (caughtError instanceof LighterAccountNotFoundError) {
786
+ return {
787
+ ready: false,
788
+ error: PERPS_ERROR_CODES.EXCHANGE_ACCOUNT_NOT_FOUND,
789
+ };
790
+ }
791
+ // The session moved on while registering; the next preparation
792
+ // starts over for the current account.
793
+ if (caughtError instanceof LighterSessionCancelledError) {
794
+ this.#deps.debugLogger.log('[prepareTradingWallet] Session changed during preparation', { reason: caughtError.message });
795
+ return {
796
+ ready: false,
797
+ error: PERPS_ERROR_CODES.PROVIDER_LIFECYCLE_STALE,
798
+ };
799
+ }
800
+ const error = ensureError(caughtError, 'LighterProvider.prepareTradingWallet');
801
+ this.#deps.logger.error(error, this.#getErrorContext('prepareTradingWallet'));
802
+ return { ready: false, error: error.message };
803
+ }
804
+ }
722
805
  async isReadyToTrade() {
723
806
  try {
724
807
  if (!this.#signerBridge) {
@@ -2924,19 +3007,19 @@ export class LighterProvider {
2924
3007
  */
2925
3008
  #assertSession = (generation) => {
2926
3009
  if (this.#isDisconnected) {
2927
- throw new Error('Operation cancelled: the Lighter provider was disconnected');
3010
+ throw new LighterSessionCancelledError('the Lighter provider was disconnected');
2928
3011
  }
2929
3012
  if (generation !== this.#sessionGeneration) {
2930
- throw new Error('Operation cancelled: the wallet switched accounts (or the signer reset) while this operation was in flight');
3013
+ throw new LighterSessionCancelledError('the wallet switched accounts (or the signer reset) while this operation was in flight');
2931
3014
  }
2932
3015
  // The generation only advances when some provider call rebinds; also
2933
3016
  // notice a wallet switch nothing has observed yet. Account-bound work
2934
3017
  // must never run without a binding: every legitimate flow (including
2935
- // headless l1Address and configured-index setups) binds first, so a
2936
- // null binding here means the wallet was deselected — fail closed even
2937
- // when a configured account index could still resolve.
3018
+ // configured-index setups) binds first, so a null binding here means the
3019
+ // wallet was deselected — fail closed even when a configured account
3020
+ // index could still resolve.
2938
3021
  if (this.#boundAddress === null) {
2939
- throw new Error('Operation cancelled: no wallet account is bound to the venue session');
3022
+ throw new LighterSessionCancelledError('no wallet account is bound to the venue session');
2940
3023
  }
2941
3024
  let address = null;
2942
3025
  try {
@@ -2957,7 +3040,7 @@ export class LighterProvider {
2957
3040
  // the stale operation.
2958
3041
  this.#ensureSessionBinding();
2959
3042
  }
2960
- throw new Error('Operation cancelled: the wallet switched accounts (or the signer reset) while this operation was in flight');
3043
+ throw new LighterSessionCancelledError('the wallet switched accounts (or the signer reset) while this operation was in flight');
2961
3044
  }
2962
3045
  };
2963
3046
  /** Drop every cache derived from the previously bound account. */