@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/services/HyperLiquidWalletService.cjs

@@ -0,0 +1,163 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _HyperLiquidWalletService_instances, _HyperLiquidWalletService_isTestnet, _HyperLiquidWalletService_deps, _HyperLiquidWalletService_messenger, _HyperLiquidWalletService_signTypedMessage;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperLiquidWalletService = void 0;
+const utils_1 = require("@metamask/utils");
+const hyperLiquidConfig_1 = require("../constants/hyperLiquidConfig.cjs");
+const perpsErrorCodes_1 = require("../perpsErrorCodes.cjs");
+const accountUtils_1 = require("../utils/accountUtils.cjs");
+/**
+ * Service for MetaMask wallet integration with HyperLiquid SDK
+ * Provides wallet adapter that implements AbstractWindowEthereum interface
+ */
+class HyperLiquidWalletService {
+    constructor(deps, messenger, options = {}) {
+        _HyperLiquidWalletService_instances.add(this);
+        _HyperLiquidWalletService_isTestnet.set(this, void 0);
+        // Platform dependencies for observability
+        _HyperLiquidWalletService_deps.set(this, void 0);
+        _HyperLiquidWalletService_messenger.set(this, void 0);
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_deps, deps, "f");
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_isTestnet, options.isTestnet ?? false, "f");
+    }
+    /**
+     * Check if the keyring is currently unlocked
+     *
+     * @returns True if the keyring is unlocked and available for signing.
+     */
+    isKeyringUnlocked() {
+        return __classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('KeyringController:getState').isUnlocked;
+    }
+    /**
+     * Create wallet adapter that implements AbstractViemJsonRpcAccount interface
+     * Required by @nktkas/hyperliquid SDK for signing transactions
+     *
+     * @returns The wallet adapter with address, signTypedData, and getChainId methods.
+     */
+    createWalletAdapter() {
+        // Get current EVM account via DI accountTree
+        const evmAccount = (0, accountUtils_1.getSelectedEvmAccount)(__classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('AccountTreeController:getAccountsFromSelectedAccountGroup'));
+        if (!evmAccount?.address) {
+            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);
+        }
+        const address = evmAccount.address;
+        return {
+            address,
+            signTypedData: async (params) => {
+                // Get FRESH account on every sign to handle account switches
+                // This prevents race conditions where wallet adapter was created with old account
+                const currentEvmAccount = (0, accountUtils_1.getSelectedEvmAccount)(__classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('AccountTreeController:getAccountsFromSelectedAccountGroup'));
+                if (!currentEvmAccount?.address) {
+                    throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);
+                }
+                const currentAddress = currentEvmAccount.address;
+                // Construct EIP-712 typed data
+                const typedData = {
+                    domain: params.domain,
+                    types: params.types,
+                    primaryType: params.primaryType,
+                    message: params.message,
+                };
+                __classPrivateFieldGet(this, _HyperLiquidWalletService_deps, "f").debugLogger.log('HyperLiquidWalletService: Signing typed data', {
+                    address: currentAddress,
+                    primaryType: params.primaryType,
+                    domain: params.domain,
+                });
+                // Use messenger to sign typed data
+                const signature = await __classPrivateFieldGet(this, _HyperLiquidWalletService_instances, "m", _HyperLiquidWalletService_signTypedMessage).call(this, {
+                    from: currentAddress,
+                    data: typedData,
+                });
+                return signature;
+            },
+            getChainId: async () => parseInt((0, hyperLiquidConfig_1.getChainId)(__classPrivateFieldGet(this, _HyperLiquidWalletService_isTestnet, "f")), 10),
+        };
+    }
+    /**
+     * Get current account ID using messenger
+     *
+     * @returns The CAIP account ID for the current EVM account.
+     */
+    async getCurrentAccountId() {
+        const evmAccount = (0, accountUtils_1.getSelectedEvmAccount)(__classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('AccountTreeController:getAccountsFromSelectedAccountGroup'));
+        if (!evmAccount?.address) {
+            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);
+        }
+        const chainId = (0, hyperLiquidConfig_1.getChainId)(__classPrivateFieldGet(this, _HyperLiquidWalletService_isTestnet, "f"));
+        const caipAccountId = `eip155:${chainId}:${evmAccount.address}`;
+        return caipAccountId;
+    }
+    /**
+     * Get validated user address as Hex from account ID
+     *
+     * @param accountId - The CAIP account ID to extract the address from.
+     * @returns The validated hex address.
+     */
+    getUserAddress(accountId) {
+        const parsed = (0, utils_1.parseCaipAccountId)(accountId);
+        const address = parsed.address;
+        if (!(0, utils_1.isValidHexAddress)(address)) {
+            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.INVALID_ADDRESS_FORMAT);
+        }
+        return address;
+    }
+    /**
+     * Get user address with default fallback to current account
+     *
+     * @param accountId - Optional CAIP account ID; defaults to current account if omitted.
+     * @returns The validated hex address.
+     */
+    async getUserAddressWithDefault(accountId) {
+        const id = accountId ?? (await this.getCurrentAccountId());
+        return this.getUserAddress(id);
+    }
+    /**
+     * Update testnet mode
+     *
+     * @param isTestnet - Whether to enable testnet mode.
+     */
+    setTestnetMode(isTestnet) {
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_isTestnet, isTestnet, "f");
+    }
+    /**
+     * Check if running on testnet
+     *
+     * @returns True if the service is in testnet mode.
+     */
+    isTestnetMode() {
+        return __classPrivateFieldGet(this, _HyperLiquidWalletService_isTestnet, "f");
+    }
+}
+exports.HyperLiquidWalletService = HyperLiquidWalletService;
+_HyperLiquidWalletService_isTestnet = new WeakMap(), _HyperLiquidWalletService_deps = new WeakMap(), _HyperLiquidWalletService_messenger = new WeakMap(), _HyperLiquidWalletService_instances = new WeakSet(), _HyperLiquidWalletService_signTypedMessage = 
+/**
+ * Sign typed data via DI keyring controller
+ *
+ * @param msgParams - The typed message parameters including data and sender address.
+ * @returns The signature string.
+ */
+async function _HyperLiquidWalletService_signTypedMessage(msgParams) {
+    if (!this.isKeyringUnlocked()) {
+        throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.KEYRING_LOCKED);
+    }
+    // Cast needed: PerpsTypedMessageParams uses loose `data: unknown` type
+    // while KeyringController uses strict TypedMessageParams / SignTypedDataVersion
+    return __classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('KeyringController:signTypedMessage', 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    msgParams, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    'V4');
+};
+//# sourceMappingURL=HyperLiquidWalletService.cjs.map

package/dist/services/HyperLiquidWalletService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HyperLiquidWalletService.cjs","sourceRoot":"","sources":["../../src/services/HyperLiquidWalletService.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseCaipAccountId, isValidHexAddress } from '@metamask/utils';\nimport type { CaipAccountId, Hex } from '@metamask/utils';\n\nimport { getChainId } from '../constants/hyperLiquidConfig';\nimport { PERPS_ERROR_CODES } from '../perpsErrorCodes';\nimport type {\n  PerpsPlatformDependencies,\n  PerpsTypedMessageParams,\n} from '../types';\nimport type { PerpsControllerMessengerBase } from '../types/messenger';\nimport { getSelectedEvmAccount } from '../utils/accountUtils';\n\n/**\n * Service for MetaMask wallet integration with HyperLiquid SDK\n * Provides wallet adapter that implements AbstractWindowEthereum interface\n */\nexport class HyperLiquidWalletService {\n  #isTestnet: boolean;\n\n  // Platform dependencies for observability\n  readonly #deps: PerpsPlatformDependencies;\n\n  readonly #messenger: PerpsControllerMessengerBase;\n\n  constructor(\n    deps: PerpsPlatformDependencies,\n    messenger: PerpsControllerMessengerBase,\n    options: { isTestnet?: boolean } = {},\n  ) {\n    this.#deps = deps;\n    this.#messenger = messenger;\n    this.#isTestnet = options.isTestnet ?? false;\n  }\n\n  /**\n   * Check if the keyring is currently unlocked\n   *\n   * @returns True if the keyring is unlocked and available for signing.\n   */\n  public isKeyringUnlocked(): boolean {\n    return this.#messenger.call('KeyringController:getState').isUnlocked;\n  }\n\n  /**\n   * Sign typed data via DI keyring controller\n   *\n   * @param msgParams - The typed message parameters including data and sender address.\n   * @returns The signature string.\n   */\n  async #signTypedMessage(msgParams: PerpsTypedMessageParams): Promise<string> {\n    if (!this.isKeyringUnlocked()) {\n      throw new Error(PERPS_ERROR_CODES.KEYRING_LOCKED);\n    }\n    // Cast needed: PerpsTypedMessageParams uses loose `data: unknown` type\n    // while KeyringController uses strict TypedMessageParams / SignTypedDataVersion\n    return this.#messenger.call(\n      'KeyringController:signTypedMessage',\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      msgParams as any,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      'V4' as any,\n    );\n  }\n\n  /**\n   * Create wallet adapter that implements AbstractViemJsonRpcAccount interface\n   * Required by @nktkas/hyperliquid SDK for signing transactions\n   *\n   * @returns The wallet adapter with address, signTypedData, and getChainId methods.\n   */\n  public createWalletAdapter(): {\n    address: Hex;\n    signTypedData: (params: {\n      domain: {\n        name: string;\n        version: string;\n        chainId: number;\n        verifyingContract: Hex;\n      };\n      types: {\n        [key: string]: { name: string; type: string }[];\n      };\n      primaryType: string;\n      message: Record<string, unknown>;\n    }) => Promise<Hex>;\n    getChainId?: () => Promise<number>;\n  } {\n    // Get current EVM account via DI accountTree\n    const evmAccount = getSelectedEvmAccount(\n      this.#messenger.call(\n        'AccountTreeController:getAccountsFromSelectedAccountGroup',\n      ),\n    );\n\n    if (!evmAccount?.address) {\n      throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);\n    }\n\n    const address = evmAccount.address as Hex;\n\n    return {\n      address,\n      signTypedData: async (params: {\n        domain: {\n          name: string;\n          version: string;\n          chainId: number;\n          verifyingContract: Hex;\n        };\n        types: {\n          [key: string]: { name: string; type: string }[];\n        };\n        primaryType: string;\n        message: Record<string, unknown>;\n      }): Promise<Hex> => {\n        // Get FRESH account on every sign to handle account switches\n        // This prevents race conditions where wallet adapter was created with old account\n        const currentEvmAccount = getSelectedEvmAccount(\n          this.#messenger.call(\n            'AccountTreeController:getAccountsFromSelectedAccountGroup',\n          ),\n        );\n\n        if (!currentEvmAccount?.address) {\n          throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);\n        }\n\n        const currentAddress = currentEvmAccount.address as Hex;\n\n        // Construct EIP-712 typed data\n        const typedData = {\n          domain: params.domain,\n          types: params.types,\n          primaryType: params.primaryType,\n          message: params.message,\n        };\n\n        this.#deps.debugLogger.log(\n          'HyperLiquidWalletService: Signing typed data',\n          {\n            address: currentAddress,\n            primaryType: params.primaryType,\n            domain: params.domain,\n          },\n        );\n\n        // Use messenger to sign typed data\n        const signature = await this.#signTypedMessage({\n          from: currentAddress,\n          data: typedData,\n        });\n\n        return signature as Hex;\n      },\n      getChainId: async (): Promise<number> =>\n        parseInt(getChainId(this.#isTestnet), 10),\n    };\n  }\n\n  /**\n   * Get current account ID using messenger\n   *\n   * @returns The CAIP account ID for the current EVM account.\n   */\n  public async getCurrentAccountId(): Promise<CaipAccountId> {\n    const evmAccount = getSelectedEvmAccount(\n      this.#messenger.call(\n        'AccountTreeController:getAccountsFromSelectedAccountGroup',\n      ),\n    );\n\n    if (!evmAccount?.address) {\n      throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);\n    }\n\n    const chainId = getChainId(this.#isTestnet);\n    const caipAccountId: CaipAccountId = `eip155:${chainId}:${evmAccount.address}`;\n\n    return caipAccountId;\n  }\n\n  /**\n   * Get validated user address as Hex from account ID\n   *\n   * @param accountId - The CAIP account ID to extract the address from.\n   * @returns The validated hex address.\n   */\n  public getUserAddress(accountId: CaipAccountId): Hex {\n    const parsed = parseCaipAccountId(accountId);\n    const address = parsed.address as Hex;\n\n    if (!isValidHexAddress(address)) {\n      throw new Error(PERPS_ERROR_CODES.INVALID_ADDRESS_FORMAT);\n    }\n\n    return address;\n  }\n\n  /**\n   * Get user address with default fallback to current account\n   *\n   * @param accountId - Optional CAIP account ID; defaults to current account if omitted.\n   * @returns The validated hex address.\n   */\n  public async getUserAddressWithDefault(\n    accountId?: CaipAccountId,\n  ): Promise<Hex> {\n    const id = accountId ?? (await this.getCurrentAccountId());\n    return this.getUserAddress(id);\n  }\n\n  /**\n   * Update testnet mode\n   *\n   * @param isTestnet - Whether to enable testnet mode.\n   */\n  public setTestnetMode(isTestnet: boolean): void {\n    this.#isTestnet = isTestnet;\n  }\n\n  /**\n   * Check if running on testnet\n   *\n   * @returns True if the service is in testnet mode.\n   */\n  public isTestnetMode(): boolean {\n    return this.#isTestnet;\n  }\n}\n"]}

package/dist/services/HyperLiquidWalletService.d.cts

@@ -0,0 +1,78 @@
+import type { CaipAccountId, Hex } from "@metamask/utils";
+import type { PerpsPlatformDependencies } from "../types/index.cjs";
+import type { PerpsControllerMessengerBase } from "../types/messenger.cjs";
+/**
+ * Service for MetaMask wallet integration with HyperLiquid SDK
+ * Provides wallet adapter that implements AbstractWindowEthereum interface
+ */
+export declare class HyperLiquidWalletService {
+    #private;
+    constructor(deps: PerpsPlatformDependencies, messenger: PerpsControllerMessengerBase, options?: {
+        isTestnet?: boolean;
+    });
+    /**
+     * Check if the keyring is currently unlocked
+     *
+     * @returns True if the keyring is unlocked and available for signing.
+     */
+    isKeyringUnlocked(): boolean;
+    /**
+     * Create wallet adapter that implements AbstractViemJsonRpcAccount interface
+     * Required by @nktkas/hyperliquid SDK for signing transactions
+     *
+     * @returns The wallet adapter with address, signTypedData, and getChainId methods.
+     */
+    createWalletAdapter(): {
+        address: Hex;
+        signTypedData: (params: {
+            domain: {
+                name: string;
+                version: string;
+                chainId: number;
+                verifyingContract: Hex;
+            };
+            types: {
+                [key: string]: {
+                    name: string;
+                    type: string;
+                }[];
+            };
+            primaryType: string;
+            message: Record<string, unknown>;
+        }) => Promise<Hex>;
+        getChainId?: () => Promise<number>;
+    };
+    /**
+     * Get current account ID using messenger
+     *
+     * @returns The CAIP account ID for the current EVM account.
+     */
+    getCurrentAccountId(): Promise<CaipAccountId>;
+    /**
+     * Get validated user address as Hex from account ID
+     *
+     * @param accountId - The CAIP account ID to extract the address from.
+     * @returns The validated hex address.
+     */
+    getUserAddress(accountId: CaipAccountId): Hex;
+    /**
+     * Get user address with default fallback to current account
+     *
+     * @param accountId - Optional CAIP account ID; defaults to current account if omitted.
+     * @returns The validated hex address.
+     */
+    getUserAddressWithDefault(accountId?: CaipAccountId): Promise<Hex>;
+    /**
+     * Update testnet mode
+     *
+     * @param isTestnet - Whether to enable testnet mode.
+     */
+    setTestnetMode(isTestnet: boolean): void;
+    /**
+     * Check if running on testnet
+     *
+     * @returns True if the service is in testnet mode.
+     */
+    isTestnetMode(): boolean;
+}
+//# sourceMappingURL=HyperLiquidWalletService.d.cts.map

package/dist/services/HyperLiquidWalletService.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HyperLiquidWalletService.d.cts","sourceRoot":"","sources":["../../src/services/HyperLiquidWalletService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,wBAAwB;AAI1D,OAAO,KAAK,EACV,yBAAyB,EAE1B,2BAAiB;AAClB,OAAO,KAAK,EAAE,4BAA4B,EAAE,+BAA2B;AAGvE;;;GAGG;AACH,qBAAa,wBAAwB;;gBASjC,IAAI,EAAE,yBAAyB,EAC/B,SAAS,EAAE,4BAA4B,EACvC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;IAOvC;;;;OAIG;IACI,iBAAiB,IAAI,OAAO;IAyBnC;;;;;OAKG;IACI,mBAAmB,IAAI;QAC5B,OAAO,EAAE,GAAG,CAAC;QACb,aAAa,EAAE,CAAC,MAAM,EAAE;YACtB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,CAAC;gBAChB,OAAO,EAAE,MAAM,CAAC;gBAChB,iBAAiB,EAAE,GAAG,CAAC;aACxB,CAAC;YACF,KAAK,EAAE;gBACL,CAAC,GAAG,EAAE,MAAM,GAAG;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAC;aACjD,CAAC;YACF,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAClC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;KACpC;IAyED;;;;OAIG;IACU,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC;IAiB1D;;;;;OAKG;IACI,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,GAAG;IAWpD;;;;;OAKG;IACU,yBAAyB,CACpC,SAAS,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,GAAG,CAAC;IAKf;;;;OAIG;IACI,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAI/C;;;;OAIG;IACI,aAAa,IAAI,OAAO;CAGhC"}

package/dist/services/HyperLiquidWalletService.d.mts

@@ -0,0 +1,78 @@
+import type { CaipAccountId, Hex } from "@metamask/utils";
+import type { PerpsPlatformDependencies } from "../types/index.mjs";
+import type { PerpsControllerMessengerBase } from "../types/messenger.mjs";
+/**
+ * Service for MetaMask wallet integration with HyperLiquid SDK
+ * Provides wallet adapter that implements AbstractWindowEthereum interface
+ */
+export declare class HyperLiquidWalletService {
+    #private;
+    constructor(deps: PerpsPlatformDependencies, messenger: PerpsControllerMessengerBase, options?: {
+        isTestnet?: boolean;
+    });
+    /**
+     * Check if the keyring is currently unlocked
+     *
+     * @returns True if the keyring is unlocked and available for signing.
+     */
+    isKeyringUnlocked(): boolean;
+    /**
+     * Create wallet adapter that implements AbstractViemJsonRpcAccount interface
+     * Required by @nktkas/hyperliquid SDK for signing transactions
+     *
+     * @returns The wallet adapter with address, signTypedData, and getChainId methods.
+     */
+    createWalletAdapter(): {
+        address: Hex;
+        signTypedData: (params: {
+            domain: {
+                name: string;
+                version: string;
+                chainId: number;
+                verifyingContract: Hex;
+            };
+            types: {
+                [key: string]: {
+                    name: string;
+                    type: string;
+                }[];
+            };
+            primaryType: string;
+            message: Record<string, unknown>;
+        }) => Promise<Hex>;
+        getChainId?: () => Promise<number>;
+    };
+    /**
+     * Get current account ID using messenger
+     *
+     * @returns The CAIP account ID for the current EVM account.
+     */
+    getCurrentAccountId(): Promise<CaipAccountId>;
+    /**
+     * Get validated user address as Hex from account ID
+     *
+     * @param accountId - The CAIP account ID to extract the address from.
+     * @returns The validated hex address.
+     */
+    getUserAddress(accountId: CaipAccountId): Hex;
+    /**
+     * Get user address with default fallback to current account
+     *
+     * @param accountId - Optional CAIP account ID; defaults to current account if omitted.
+     * @returns The validated hex address.
+     */
+    getUserAddressWithDefault(accountId?: CaipAccountId): Promise<Hex>;
+    /**
+     * Update testnet mode
+     *
+     * @param isTestnet - Whether to enable testnet mode.
+     */
+    setTestnetMode(isTestnet: boolean): void;
+    /**
+     * Check if running on testnet
+     *
+     * @returns True if the service is in testnet mode.
+     */
+    isTestnetMode(): boolean;
+}
+//# sourceMappingURL=HyperLiquidWalletService.d.mts.map

package/dist/services/HyperLiquidWalletService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HyperLiquidWalletService.d.mts","sourceRoot":"","sources":["../../src/services/HyperLiquidWalletService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,wBAAwB;AAI1D,OAAO,KAAK,EACV,yBAAyB,EAE1B,2BAAiB;AAClB,OAAO,KAAK,EAAE,4BAA4B,EAAE,+BAA2B;AAGvE;;;GAGG;AACH,qBAAa,wBAAwB;;gBASjC,IAAI,EAAE,yBAAyB,EAC/B,SAAS,EAAE,4BAA4B,EACvC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;IAOvC;;;;OAIG;IACI,iBAAiB,IAAI,OAAO;IAyBnC;;;;;OAKG;IACI,mBAAmB,IAAI;QAC5B,OAAO,EAAE,GAAG,CAAC;QACb,aAAa,EAAE,CAAC,MAAM,EAAE;YACtB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,CAAC;gBAChB,OAAO,EAAE,MAAM,CAAC;gBAChB,iBAAiB,EAAE,GAAG,CAAC;aACxB,CAAC;YACF,KAAK,EAAE;gBACL,CAAC,GAAG,EAAE,MAAM,GAAG;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAC;aACjD,CAAC;YACF,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAClC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;KACpC;IAyED;;;;OAIG;IACU,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC;IAiB1D;;;;;OAKG;IACI,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,GAAG;IAWpD;;;;;OAKG;IACU,yBAAyB,CACpC,SAAS,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,GAAG,CAAC;IAKf;;;;OAIG;IACI,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAI/C;;;;OAIG;IACI,aAAa,IAAI,OAAO;CAGhC"}

package/dist/services/HyperLiquidWalletService.mjs

@@ -0,0 +1,159 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _HyperLiquidWalletService_instances, _HyperLiquidWalletService_isTestnet, _HyperLiquidWalletService_deps, _HyperLiquidWalletService_messenger, _HyperLiquidWalletService_signTypedMessage;
+import { parseCaipAccountId, isValidHexAddress } from "@metamask/utils";
+import { getChainId } from "../constants/hyperLiquidConfig.mjs";
+import { PERPS_ERROR_CODES } from "../perpsErrorCodes.mjs";
+import { getSelectedEvmAccount } from "../utils/accountUtils.mjs";
+/**
+ * Service for MetaMask wallet integration with HyperLiquid SDK
+ * Provides wallet adapter that implements AbstractWindowEthereum interface
+ */
+export class HyperLiquidWalletService {
+    constructor(deps, messenger, options = {}) {
+        _HyperLiquidWalletService_instances.add(this);
+        _HyperLiquidWalletService_isTestnet.set(this, void 0);
+        // Platform dependencies for observability
+        _HyperLiquidWalletService_deps.set(this, void 0);
+        _HyperLiquidWalletService_messenger.set(this, void 0);
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_deps, deps, "f");
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_isTestnet, options.isTestnet ?? false, "f");
+    }
+    /**
+     * Check if the keyring is currently unlocked
+     *
+     * @returns True if the keyring is unlocked and available for signing.
+     */
+    isKeyringUnlocked() {
+        return __classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('KeyringController:getState').isUnlocked;
+    }
+    /**
+     * Create wallet adapter that implements AbstractViemJsonRpcAccount interface
+     * Required by @nktkas/hyperliquid SDK for signing transactions
+     *
+     * @returns The wallet adapter with address, signTypedData, and getChainId methods.
+     */
+    createWalletAdapter() {
+        // Get current EVM account via DI accountTree
+        const evmAccount = getSelectedEvmAccount(__classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('AccountTreeController:getAccountsFromSelectedAccountGroup'));
+        if (!evmAccount?.address) {
+            throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);
+        }
+        const address = evmAccount.address;
+        return {
+            address,
+            signTypedData: async (params) => {
+                // Get FRESH account on every sign to handle account switches
+                // This prevents race conditions where wallet adapter was created with old account
+                const currentEvmAccount = getSelectedEvmAccount(__classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('AccountTreeController:getAccountsFromSelectedAccountGroup'));
+                if (!currentEvmAccount?.address) {
+                    throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);
+                }
+                const currentAddress = currentEvmAccount.address;
+                // Construct EIP-712 typed data
+                const typedData = {
+                    domain: params.domain,
+                    types: params.types,
+                    primaryType: params.primaryType,
+                    message: params.message,
+                };
+                __classPrivateFieldGet(this, _HyperLiquidWalletService_deps, "f").debugLogger.log('HyperLiquidWalletService: Signing typed data', {
+                    address: currentAddress,
+                    primaryType: params.primaryType,
+                    domain: params.domain,
+                });
+                // Use messenger to sign typed data
+                const signature = await __classPrivateFieldGet(this, _HyperLiquidWalletService_instances, "m", _HyperLiquidWalletService_signTypedMessage).call(this, {
+                    from: currentAddress,
+                    data: typedData,
+                });
+                return signature;
+            },
+            getChainId: async () => parseInt(getChainId(__classPrivateFieldGet(this, _HyperLiquidWalletService_isTestnet, "f")), 10),
+        };
+    }
+    /**
+     * Get current account ID using messenger
+     *
+     * @returns The CAIP account ID for the current EVM account.
+     */
+    async getCurrentAccountId() {
+        const evmAccount = getSelectedEvmAccount(__classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('AccountTreeController:getAccountsFromSelectedAccountGroup'));
+        if (!evmAccount?.address) {
+            throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);
+        }
+        const chainId = getChainId(__classPrivateFieldGet(this, _HyperLiquidWalletService_isTestnet, "f"));
+        const caipAccountId = `eip155:${chainId}:${evmAccount.address}`;
+        return caipAccountId;
+    }
+    /**
+     * Get validated user address as Hex from account ID
+     *
+     * @param accountId - The CAIP account ID to extract the address from.
+     * @returns The validated hex address.
+     */
+    getUserAddress(accountId) {
+        const parsed = parseCaipAccountId(accountId);
+        const address = parsed.address;
+        if (!isValidHexAddress(address)) {
+            throw new Error(PERPS_ERROR_CODES.INVALID_ADDRESS_FORMAT);
+        }
+        return address;
+    }
+    /**
+     * Get user address with default fallback to current account
+     *
+     * @param accountId - Optional CAIP account ID; defaults to current account if omitted.
+     * @returns The validated hex address.
+     */
+    async getUserAddressWithDefault(accountId) {
+        const id = accountId ?? (await this.getCurrentAccountId());
+        return this.getUserAddress(id);
+    }
+    /**
+     * Update testnet mode
+     *
+     * @param isTestnet - Whether to enable testnet mode.
+     */
+    setTestnetMode(isTestnet) {
+        __classPrivateFieldSet(this, _HyperLiquidWalletService_isTestnet, isTestnet, "f");
+    }
+    /**
+     * Check if running on testnet
+     *
+     * @returns True if the service is in testnet mode.
+     */
+    isTestnetMode() {
+        return __classPrivateFieldGet(this, _HyperLiquidWalletService_isTestnet, "f");
+    }
+}
+_HyperLiquidWalletService_isTestnet = new WeakMap(), _HyperLiquidWalletService_deps = new WeakMap(), _HyperLiquidWalletService_messenger = new WeakMap(), _HyperLiquidWalletService_instances = new WeakSet(), _HyperLiquidWalletService_signTypedMessage = 
+/**
+ * Sign typed data via DI keyring controller
+ *
+ * @param msgParams - The typed message parameters including data and sender address.
+ * @returns The signature string.
+ */
+async function _HyperLiquidWalletService_signTypedMessage(msgParams) {
+    if (!this.isKeyringUnlocked()) {
+        throw new Error(PERPS_ERROR_CODES.KEYRING_LOCKED);
+    }
+    // Cast needed: PerpsTypedMessageParams uses loose `data: unknown` type
+    // while KeyringController uses strict TypedMessageParams / SignTypedDataVersion
+    return __classPrivateFieldGet(this, _HyperLiquidWalletService_messenger, "f").call('KeyringController:signTypedMessage', 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    msgParams, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    'V4');
+};
+//# sourceMappingURL=HyperLiquidWalletService.mjs.map

package/dist/services/HyperLiquidWalletService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HyperLiquidWalletService.mjs","sourceRoot":"","sources":["../../src/services/HyperLiquidWalletService.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseCaipAccountId, isValidHexAddress } from '@metamask/utils';\nimport type { CaipAccountId, Hex } from '@metamask/utils';\n\nimport { getChainId } from '../constants/hyperLiquidConfig';\nimport { PERPS_ERROR_CODES } from '../perpsErrorCodes';\nimport type {\n  PerpsPlatformDependencies,\n  PerpsTypedMessageParams,\n} from '../types';\nimport type { PerpsControllerMessengerBase } from '../types/messenger';\nimport { getSelectedEvmAccount } from '../utils/accountUtils';\n\n/**\n * Service for MetaMask wallet integration with HyperLiquid SDK\n * Provides wallet adapter that implements AbstractWindowEthereum interface\n */\nexport class HyperLiquidWalletService {\n  #isTestnet: boolean;\n\n  // Platform dependencies for observability\n  readonly #deps: PerpsPlatformDependencies;\n\n  readonly #messenger: PerpsControllerMessengerBase;\n\n  constructor(\n    deps: PerpsPlatformDependencies,\n    messenger: PerpsControllerMessengerBase,\n    options: { isTestnet?: boolean } = {},\n  ) {\n    this.#deps = deps;\n    this.#messenger = messenger;\n    this.#isTestnet = options.isTestnet ?? false;\n  }\n\n  /**\n   * Check if the keyring is currently unlocked\n   *\n   * @returns True if the keyring is unlocked and available for signing.\n   */\n  public isKeyringUnlocked(): boolean {\n    return this.#messenger.call('KeyringController:getState').isUnlocked;\n  }\n\n  /**\n   * Sign typed data via DI keyring controller\n   *\n   * @param msgParams - The typed message parameters including data and sender address.\n   * @returns The signature string.\n   */\n  async #signTypedMessage(msgParams: PerpsTypedMessageParams): Promise<string> {\n    if (!this.isKeyringUnlocked()) {\n      throw new Error(PERPS_ERROR_CODES.KEYRING_LOCKED);\n    }\n    // Cast needed: PerpsTypedMessageParams uses loose `data: unknown` type\n    // while KeyringController uses strict TypedMessageParams / SignTypedDataVersion\n    return this.#messenger.call(\n      'KeyringController:signTypedMessage',\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      msgParams as any,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      'V4' as any,\n    );\n  }\n\n  /**\n   * Create wallet adapter that implements AbstractViemJsonRpcAccount interface\n   * Required by @nktkas/hyperliquid SDK for signing transactions\n   *\n   * @returns The wallet adapter with address, signTypedData, and getChainId methods.\n   */\n  public createWalletAdapter(): {\n    address: Hex;\n    signTypedData: (params: {\n      domain: {\n        name: string;\n        version: string;\n        chainId: number;\n        verifyingContract: Hex;\n      };\n      types: {\n        [key: string]: { name: string; type: string }[];\n      };\n      primaryType: string;\n      message: Record<string, unknown>;\n    }) => Promise<Hex>;\n    getChainId?: () => Promise<number>;\n  } {\n    // Get current EVM account via DI accountTree\n    const evmAccount = getSelectedEvmAccount(\n      this.#messenger.call(\n        'AccountTreeController:getAccountsFromSelectedAccountGroup',\n      ),\n    );\n\n    if (!evmAccount?.address) {\n      throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);\n    }\n\n    const address = evmAccount.address as Hex;\n\n    return {\n      address,\n      signTypedData: async (params: {\n        domain: {\n          name: string;\n          version: string;\n          chainId: number;\n          verifyingContract: Hex;\n        };\n        types: {\n          [key: string]: { name: string; type: string }[];\n        };\n        primaryType: string;\n        message: Record<string, unknown>;\n      }): Promise<Hex> => {\n        // Get FRESH account on every sign to handle account switches\n        // This prevents race conditions where wallet adapter was created with old account\n        const currentEvmAccount = getSelectedEvmAccount(\n          this.#messenger.call(\n            'AccountTreeController:getAccountsFromSelectedAccountGroup',\n          ),\n        );\n\n        if (!currentEvmAccount?.address) {\n          throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);\n        }\n\n        const currentAddress = currentEvmAccount.address as Hex;\n\n        // Construct EIP-712 typed data\n        const typedData = {\n          domain: params.domain,\n          types: params.types,\n          primaryType: params.primaryType,\n          message: params.message,\n        };\n\n        this.#deps.debugLogger.log(\n          'HyperLiquidWalletService: Signing typed data',\n          {\n            address: currentAddress,\n            primaryType: params.primaryType,\n            domain: params.domain,\n          },\n        );\n\n        // Use messenger to sign typed data\n        const signature = await this.#signTypedMessage({\n          from: currentAddress,\n          data: typedData,\n        });\n\n        return signature as Hex;\n      },\n      getChainId: async (): Promise<number> =>\n        parseInt(getChainId(this.#isTestnet), 10),\n    };\n  }\n\n  /**\n   * Get current account ID using messenger\n   *\n   * @returns The CAIP account ID for the current EVM account.\n   */\n  public async getCurrentAccountId(): Promise<CaipAccountId> {\n    const evmAccount = getSelectedEvmAccount(\n      this.#messenger.call(\n        'AccountTreeController:getAccountsFromSelectedAccountGroup',\n      ),\n    );\n\n    if (!evmAccount?.address) {\n      throw new Error(PERPS_ERROR_CODES.NO_ACCOUNT_SELECTED);\n    }\n\n    const chainId = getChainId(this.#isTestnet);\n    const caipAccountId: CaipAccountId = `eip155:${chainId}:${evmAccount.address}`;\n\n    return caipAccountId;\n  }\n\n  /**\n   * Get validated user address as Hex from account ID\n   *\n   * @param accountId - The CAIP account ID to extract the address from.\n   * @returns The validated hex address.\n   */\n  public getUserAddress(accountId: CaipAccountId): Hex {\n    const parsed = parseCaipAccountId(accountId);\n    const address = parsed.address as Hex;\n\n    if (!isValidHexAddress(address)) {\n      throw new Error(PERPS_ERROR_CODES.INVALID_ADDRESS_FORMAT);\n    }\n\n    return address;\n  }\n\n  /**\n   * Get user address with default fallback to current account\n   *\n   * @param accountId - Optional CAIP account ID; defaults to current account if omitted.\n   * @returns The validated hex address.\n   */\n  public async getUserAddressWithDefault(\n    accountId?: CaipAccountId,\n  ): Promise<Hex> {\n    const id = accountId ?? (await this.getCurrentAccountId());\n    return this.getUserAddress(id);\n  }\n\n  /**\n   * Update testnet mode\n   *\n   * @param isTestnet - Whether to enable testnet mode.\n   */\n  public setTestnetMode(isTestnet: boolean): void {\n    this.#isTestnet = isTestnet;\n  }\n\n  /**\n   * Check if running on testnet\n   *\n   * @returns True if the service is in testnet mode.\n   */\n  public isTestnetMode(): boolean {\n    return this.#isTestnet;\n  }\n}\n"]}