@metamask/eth-ledger-bridge-keyring 2.0.1 → 4.0.0

package/CHANGELOG.md

@@ -6,6 +6,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.0.0]
+### Added
+- Add classes `LedgerMobileBridge`, `LedgerTransportMiddleware`, and `MetaMaskLedgerHwAppEth` to support Bluetooth as a HW Ledger Transport option ([#225](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/225))
+
+### Changed
+- **BREAKING**: The `LedgerKeyring` method `setAccountToUnlock` now only accepts an input of type `number` ([#225](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/225))
+- **BREAKING**: Removed the `chainCode` property from the `GetPublicKeyResponse` type ([#225](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/225))
+
+## [3.0.0]
+### Added
+-  Add `getOptions` and `setOptions` methods to `LedgerBridge` interface ([#210](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/210))
+
+### Changed
+- **BREAKING**: `LedgerIframeBridge` class constructor now takes an options object with `bridgeUrl` ([#210](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/210))
+- **BREAKING**: `LedgerBridge` `init` function now takes no parameters ([#210](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/210))
+- **BREAKING**: `LedgerBridgeKeyringOptions` no longer contain `bridgeUrl` ([#210](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/210))
+- **BREAKING**: `LedgerBridge` interface is now parameterized over its option type ([#210](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/210))
+- Minor performance enhancement ([#211](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/211))
+
+### Fixed
+- **BREAKING**: `IFrameMessageResponse` now has more restrictive typings (#207) ([#207](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/207))
+
 ## [2.0.1]
 ### Fixed
 - Fix `invalid rlp data` error for legacy transactions in `2.0.0` ([#212](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/212))
@@ -85,7 +107,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Support new versions of ethereumjs/tx ([#68](https://github.com/MetaMask/eth-ledger-bridge-keyring/pull/68))
 
-[Unreleased]: https://github.com/MetaMask/eth-ledger-bridge-keyring/compare/v2.0.1...HEAD
+[Unreleased]: https://github.com/MetaMask/eth-ledger-bridge-keyring/compare/v4.0.0...HEAD
+[4.0.0]: https://github.com/MetaMask/eth-ledger-bridge-keyring/compare/v3.0.0...v4.0.0
+[3.0.0]: https://github.com/MetaMask/eth-ledger-bridge-keyring/compare/v2.0.1...v3.0.0
 [2.0.1]: https://github.com/MetaMask/eth-ledger-bridge-keyring/compare/v2.0.0...v2.0.1
 [2.0.0]: https://github.com/MetaMask/eth-ledger-bridge-keyring/compare/v1.0.1...v2.0.0
 [1.0.1]: https://github.com/MetaMask/eth-ledger-bridge-keyring/compare/v1.0.0...v1.0.1

package/dist/index.d.ts

@@ -1,3 +1,7 @@
 export * from './ledger-keyring';
 export * from './ledger-iframe-bridge';
+export * from './ledger-mobile-bridge';
 export * from './ledger-bridge';
+export * from './ledger-transport-middleware';
+export * from './type';
+export * from './ledger-hw-app';

package/dist/index.js

@@ -16,5 +16,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ledger-keyring"), exports);
 __exportStar(require("./ledger-iframe-bridge"), exports);
+__exportStar(require("./ledger-mobile-bridge"), exports);
 __exportStar(require("./ledger-bridge"), exports);
+__exportStar(require("./ledger-transport-middleware"), exports);
+__exportStar(require("./type"), exports);
+__exportStar(require("./ledger-hw-app"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,yDAAuC;AACvC,kDAAgC","sourcesContent":["export * from './ledger-keyring';\nexport * from './ledger-iframe-bridge';\nexport * from './ledger-bridge';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,yDAAuC;AACvC,yDAAuC;AACvC,kDAAgC;AAChC,gEAA8C;AAC9C,yCAAuB;AACvB,kDAAgC","sourcesContent":["export * from './ledger-keyring';\nexport * from './ledger-iframe-bridge';\nexport * from './ledger-mobile-bridge';\nexport * from './ledger-bridge';\nexport * from './ledger-transport-middleware';\nexport * from './type';\nexport * from './ledger-hw-app';\n"]}

package/dist/ledger-bridge.d.ts

@@ -1,10 +1,9 @@
 import type LedgerHwAppEth from '@ledgerhq/hw-app-eth';
+import type Transport from '@ledgerhq/hw-transport';
 export declare type GetPublicKeyParams = {
     hdPath: string;
 };
-export declare type GetPublicKeyResponse = Awaited<ReturnType<LedgerHwAppEth['getAddress']>> & {
-    chainCode: string;
-};
+export declare type GetPublicKeyResponse = Awaited<ReturnType<LedgerHwAppEth['getAddress']>>;
 export declare type LedgerSignTransactionParams = {
     hdPath: string;
     tx: string;
@@ -21,14 +20,25 @@ export declare type LedgerSignTypedDataParams = {
     hashStructMessageHex: string;
 };
 export declare type LedgerSignTypedDataResponse = Awaited<ReturnType<LedgerHwAppEth['signEIP712HashedMessage']>>;
-export interface LedgerBridge {
+export declare type LedgerBridgeOptions = Record<string, unknown>;
+export declare type LedgerBridge<T extends LedgerBridgeOptions> = {
     isDeviceConnected: boolean;
-    init(bridgeUrl: string): Promise<void>;
+    init(): Promise<void>;
     destroy(): Promise<void>;
+    /**
+     * Method to get the current configuration of the ledger bridge keyring.
+     */
+    getOptions(): Promise<T>;
+    /**
+     * Method to set the current configuration of the ledger bridge keyring.
+     *
+     * @param opts - An object contains configuration of the bridge.
+     */
+    setOptions(opts: T): Promise<void>;
     attemptMakeApp(): Promise<boolean>;
-    updateTransportMethod(transportType: string): Promise<boolean>;
+    updateTransportMethod(transportType: string | Transport): Promise<boolean>;
     getPublicKey(params: GetPublicKeyParams): Promise<GetPublicKeyResponse>;
     deviceSignTransaction(params: LedgerSignTransactionParams): Promise<LedgerSignTransactionResponse>;
     deviceSignMessage(params: LedgerSignMessageParams): Promise<LedgerSignMessageResponse>;
     deviceSignTypedData(params: LedgerSignTypedDataParams): Promise<LedgerSignTypedDataResponse>;
-}
+};

package/dist/ledger-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"ledger-bridge.js","sourceRoot":"","sources":["../src/ledger-bridge.ts"],"names":[],"mappings":"","sourcesContent":["import type LedgerHwAppEth from '@ledgerhq/hw-app-eth';\n\nexport type GetPublicKeyParams = { hdPath: string };\nexport type GetPublicKeyResponse = Awaited<\n  ReturnType<LedgerHwAppEth['getAddress']>\n> & {\n  chainCode: string;\n};\n\nexport type LedgerSignTransactionParams = { hdPath: string; tx: string };\nexport type LedgerSignTransactionResponse = Awaited<\n  ReturnType<LedgerHwAppEth['signTransaction']>\n>;\n\nexport type LedgerSignMessageParams = { hdPath: string; message: string };\nexport type LedgerSignMessageResponse = Awaited<\n  ReturnType<LedgerHwAppEth['signPersonalMessage']>\n>;\n\nexport type LedgerSignTypedDataParams = {\n  hdPath: string;\n  domainSeparatorHex: string;\n  hashStructMessageHex: string;\n};\nexport type LedgerSignTypedDataResponse = Awaited<\n  ReturnType<LedgerHwAppEth['signEIP712HashedMessage']>\n>;\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface LedgerBridge {\n  isDeviceConnected: boolean;\n\n  init(bridgeUrl: string): Promise<void>;\n\n  destroy(): Promise<void>;\n\n  attemptMakeApp(): Promise<boolean>;\n\n  updateTransportMethod(transportType: string): Promise<boolean>;\n\n  getPublicKey(params: GetPublicKeyParams): Promise<GetPublicKeyResponse>;\n\n  deviceSignTransaction(\n    params: LedgerSignTransactionParams,\n  ): Promise<LedgerSignTransactionResponse>;\n\n  deviceSignMessage(\n    params: LedgerSignMessageParams,\n  ): Promise<LedgerSignMessageResponse>;\n\n  deviceSignTypedData(\n    params: LedgerSignTypedDataParams,\n  ): Promise<LedgerSignTypedDataResponse>;\n}\n"]}
+{"version":3,"file":"ledger-bridge.js","sourceRoot":"","sources":["../src/ledger-bridge.ts"],"names":[],"mappings":"","sourcesContent":["import type LedgerHwAppEth from '@ledgerhq/hw-app-eth';\nimport type Transport from '@ledgerhq/hw-transport';\n\nexport type GetPublicKeyParams = { hdPath: string };\nexport type GetPublicKeyResponse = Awaited<\n  ReturnType<LedgerHwAppEth['getAddress']>\n>;\n\nexport type LedgerSignTransactionParams = { hdPath: string; tx: string };\nexport type LedgerSignTransactionResponse = Awaited<\n  ReturnType<LedgerHwAppEth['signTransaction']>\n>;\n\nexport type LedgerSignMessageParams = { hdPath: string; message: string };\nexport type LedgerSignMessageResponse = Awaited<\n  ReturnType<LedgerHwAppEth['signPersonalMessage']>\n>;\n\nexport type LedgerSignTypedDataParams = {\n  hdPath: string;\n  domainSeparatorHex: string;\n  hashStructMessageHex: string;\n};\nexport type LedgerSignTypedDataResponse = Awaited<\n  ReturnType<LedgerHwAppEth['signEIP712HashedMessage']>\n>;\n\nexport type LedgerBridgeOptions = Record<string, unknown>;\n\nexport type LedgerBridge<T extends LedgerBridgeOptions> = {\n  isDeviceConnected: boolean;\n\n  init(): Promise<void>;\n\n  destroy(): Promise<void>;\n\n  /**\n   * Method to get the current configuration of the ledger bridge keyring.\n   */\n  getOptions(): Promise<T>;\n\n  /**\n   * Method to set the current configuration of the ledger bridge keyring.\n   *\n   * @param opts - An object contains configuration of the bridge.\n   */\n  setOptions(opts: T): Promise<void>;\n\n  attemptMakeApp(): Promise<boolean>;\n\n  updateTransportMethod(transportType: string | Transport): Promise<boolean>;\n\n  getPublicKey(params: GetPublicKeyParams): Promise<GetPublicKeyResponse>;\n\n  deviceSignTransaction(\n    params: LedgerSignTransactionParams,\n  ): Promise<LedgerSignTransactionResponse>;\n\n  deviceSignMessage(\n    params: LedgerSignMessageParams,\n  ): Promise<LedgerSignMessageResponse>;\n\n  deviceSignTypedData(\n    params: LedgerSignTypedDataParams,\n  ): Promise<LedgerSignTypedDataResponse>;\n};\n"]}

package/dist/ledger-hw-app.d.ts

@@ -0,0 +1,12 @@
+import LedgerHwAppEth from '@ledgerhq/hw-app-eth';
+import { GetAppNameAndVersionResponse } from './type';
+export interface MetaMaskLedgerHwAppEth extends LedgerHwAppEth {
+    openEthApp(): void;
+    closeApps(): void;
+    getAppNameAndVersion(): Promise<GetAppNameAndVersionResponse>;
+}
+export declare class MetaMaskLedgerHwAppEth extends LedgerHwAppEth implements MetaMaskLedgerHwAppEth {
+    readonly mainAppName = "BOLOS";
+    readonly ethAppName = "Ethereum";
+    readonly transportEncoding = "ascii";
+}

package/dist/ledger-hw-app.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaMaskLedgerHwAppEth = void 0;
+const hw_app_eth_1 = __importDefault(require("@ledgerhq/hw-app-eth"));
+// eslint-disable-next-line import/no-nodejs-modules
+const buffer_1 = require("buffer");
+class MetaMaskLedgerHwAppEth extends hw_app_eth_1.default {
+    constructor() {
+        super(...arguments);
+        this.mainAppName = 'BOLOS';
+        this.ethAppName = 'Ethereum';
+        this.transportEncoding = 'ascii';
+    }
+    /**
+     * Method to open ethereum application on ledger device.
+     *
+     */
+    async openEthApp() {
+        await this.transport.send(0xe0, 0xd8, 0x00, 0x00, buffer_1.Buffer.from(this.ethAppName, this.transportEncoding));
+    }
+    /**
+     * Method to close all running application on ledger device.
+     *
+     */
+    async closeApps() {
+        await this.transport.send(0xb0, 0xa7, 0x00, 0x00);
+    }
+    /**
+     * Method to retrieve the name and version of the running application in ledger device.
+     *
+     * @returns An object contains appName and version.
+     */
+    async getAppNameAndVersion() {
+        var _a, _b;
+        const response = await this.transport.send(0xb0, 0x01, 0x00, 0x00);
+        if (response[0] !== 1) {
+            throw new Error('Incorrect format return from getAppNameAndVersion.');
+        }
+        let i = 1;
+        const nameLength = (_a = response[i]) !== null && _a !== void 0 ? _a : 0;
+        i += 1;
+        const appName = response
+            .slice(i, (i += nameLength))
+            .toString(this.transportEncoding);
+        const versionLength = (_b = response[i]) !== null && _b !== void 0 ? _b : 0;
+        i += 1;
+        const version = response
+            .slice(i, (i += versionLength))
+            .toString(this.transportEncoding);
+        return {
+            appName,
+            version,
+        };
+    }
+}
+exports.MetaMaskLedgerHwAppEth = MetaMaskLedgerHwAppEth;
+//# sourceMappingURL=ledger-hw-app.js.map

package/dist/ledger-hw-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-hw-app.js","sourceRoot":"","sources":["../src/ledger-hw-app.ts"],"names":[],"mappings":";;;;;;AAAA,sEAAkD;AAClD,oDAAoD;AACpD,mCAAgC;AAWhC,MAAa,sBACX,SAAQ,oBAAc;IADxB;;QAIW,gBAAW,GAAG,OAAO,CAAC;QAEtB,eAAU,GAAG,UAAU,CAAC;QAExB,sBAAiB,GAAG,OAAO,CAAC;IAuDvC,CAAC;IArDC;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CACvB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,CACrD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,oBAAoB;;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;SACvE;QAED,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,MAAM,UAAU,GAAG,MAAA,QAAQ,CAAC,CAAC,CAAC,mCAAI,CAAC,CAAC;QACpC,CAAC,IAAI,CAAC,CAAC;QAEP,MAAM,OAAO,GAAG,QAAQ;aACrB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC;aAC3B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEpC,MAAM,aAAa,GAAG,MAAA,QAAQ,CAAC,CAAC,CAAC,mCAAI,CAAC,CAAC;QACvC,CAAC,IAAI,CAAC,CAAC;QAEP,MAAM,OAAO,GAAG,QAAQ;aACrB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC;aAC9B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEpC,OAAO;YACL,OAAO;YACP,OAAO;SACR,CAAC;IACJ,CAAC;CACF;AA/DD,wDA+DC","sourcesContent":["import LedgerHwAppEth from '@ledgerhq/hw-app-eth';\n// eslint-disable-next-line import/no-nodejs-modules\nimport { Buffer } from 'buffer';\n\nimport { GetAppNameAndVersionResponse } from './type';\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface MetaMaskLedgerHwAppEth extends LedgerHwAppEth {\n  openEthApp(): void;\n  closeApps(): void;\n  getAppNameAndVersion(): Promise<GetAppNameAndVersionResponse>;\n}\n\nexport class MetaMaskLedgerHwAppEth\n  extends LedgerHwAppEth\n  implements MetaMaskLedgerHwAppEth\n{\n  readonly mainAppName = 'BOLOS';\n\n  readonly ethAppName = 'Ethereum';\n\n  readonly transportEncoding = 'ascii';\n\n  /**\n   * Method to open ethereum application on ledger device.\n   *\n   */\n  async openEthApp(): Promise<void> {\n    await this.transport.send(\n      0xe0,\n      0xd8,\n      0x00,\n      0x00,\n      Buffer.from(this.ethAppName, this.transportEncoding),\n    );\n  }\n\n  /**\n   * Method to close all running application on ledger device.\n   *\n   */\n  async closeApps(): Promise<void> {\n    await this.transport.send(0xb0, 0xa7, 0x00, 0x00);\n  }\n\n  /**\n   * Method to retrieve the name and version of the running application in ledger device.\n   *\n   * @returns An object contains appName and version.\n   */\n  async getAppNameAndVersion(): Promise<GetAppNameAndVersionResponse> {\n    const response = await this.transport.send(0xb0, 0x01, 0x00, 0x00);\n    if (response[0] !== 1) {\n      throw new Error('Incorrect format return from getAppNameAndVersion.');\n    }\n\n    let i = 1;\n    const nameLength = response[i] ?? 0;\n    i += 1;\n\n    const appName = response\n      .slice(i, (i += nameLength))\n      .toString(this.transportEncoding);\n\n    const versionLength = response[i] ?? 0;\n    i += 1;\n\n    const version = response\n      .slice(i, (i += versionLength))\n      .toString(this.transportEncoding);\n\n    return {\n      appName,\n      version,\n    };\n  }\n}\n"]}

package/dist/ledger-iframe-bridge.d.ts

@@ -8,73 +8,75 @@ export declare enum IFrameMessageAction {
     LedgerSignPersonalMessage = "ledger-sign-personal-message",
     LedgerSignTypedData = "ledger-sign-typed-data"
 }
-declare type IFrameMessageResponse<TAction extends IFrameMessageAction> = {
-    action: TAction;
+declare type IFrameMessageResponseStub<SuccessResult extends Record<string, unknown>, FailureResult = Error> = {
     messageId: number;
 } & ({
+    success: true;
+    payload: SuccessResult;
+} | {
+    success: false;
+    payload: {
+        error: FailureResult;
+    };
+});
+declare type LedgerConnectionChangeActionResponse = {
+    messageId: number;
     action: IFrameMessageAction.LedgerConnectionChange;
     payload: {
         connected: boolean;
     };
-} | ({
+};
+declare type LedgerMakeAppActionResponse = {
+    messageId: number;
     action: IFrameMessageAction.LedgerMakeApp;
 } & ({
     success: true;
 } | {
     success: false;
     error?: unknown;
-})) | {
+});
+declare type LedgerUpdateTransportActionResponse = {
+    messageId: number;
     action: IFrameMessageAction.LedgerUpdateTransport;
     success: boolean;
-} | ({
+};
+declare type LedgerUnlockActionResponse = {
     action: IFrameMessageAction.LedgerUnlock;
-} & ({
-    success: true;
-    payload: GetPublicKeyResponse;
-} | {
-    success: false;
-    payload: {
-        error: Error;
-    };
-})) | ({
+} & IFrameMessageResponseStub<GetPublicKeyResponse>;
+declare type LedgerSignTransactionActionResponse = {
     action: IFrameMessageAction.LedgerSignTransaction;
-} & ({
-    success: true;
-    payload: LedgerSignTransactionResponse;
-} | {
-    success: false;
-    payload: {
-        error: Error;
-    };
-})) | ({
-    action: IFrameMessageAction.LedgerSignPersonalMessage | IFrameMessageAction.LedgerSignTypedData;
-} & ({
-    success: true;
-    payload: LedgerSignMessageResponse | LedgerSignTypedDataResponse;
-} | {
-    success: false;
-    payload: {
-        error: Error;
-    };
-})));
-export declare class LedgerIframeBridge implements LedgerBridge {
+} & IFrameMessageResponseStub<LedgerSignTransactionResponse>;
+declare type LedgerSignPersonalMessageActionResponse = {
+    action: IFrameMessageAction.LedgerSignPersonalMessage;
+} & IFrameMessageResponseStub<LedgerSignMessageResponse>;
+declare type LedgerSignTypedDataActionResponse = {
+    action: IFrameMessageAction.LedgerSignTypedData;
+} & IFrameMessageResponseStub<LedgerSignTypedDataResponse>;
+export declare type IFrameMessageResponse = LedgerConnectionChangeActionResponse | LedgerMakeAppActionResponse | LedgerUpdateTransportActionResponse | LedgerUnlockActionResponse | LedgerSignTransactionActionResponse | LedgerSignPersonalMessageActionResponse | LedgerSignTypedDataActionResponse;
+export declare type LedgerIframeBridgeOptions = {
+    bridgeUrl: string;
+};
+export declare class LedgerIframeBridge implements LedgerBridge<LedgerIframeBridgeOptions> {
     #private;
     iframe?: HTMLIFrameElement;
     iframeLoaded: boolean;
     eventListener?: (eventMessage: {
         origin: string;
-        data: IFrameMessageResponse<IFrameMessageAction>;
+        data: IFrameMessageResponse;
     }) => void;
     isDeviceConnected: boolean;
     currentMessageId: number;
-    messageCallbacks: Record<number, (response: IFrameMessageResponse<IFrameMessageAction>) => void>;
+    messageCallbacks: Record<number, (response: IFrameMessageResponse) => void>;
     delayedPromise?: {
         resolve: (value: boolean) => void;
         reject: (error: unknown) => void;
         transportType: string;
     };
-    init(bridgeUrl: string): Promise<void>;
+    constructor(opts?: LedgerIframeBridgeOptions);
+    init(): Promise<void>;
     destroy(): Promise<void>;
+    getOptions(): Promise<LedgerIframeBridgeOptions>;
+    setOptions(opts: LedgerIframeBridgeOptions): Promise<void>;
     attemptMakeApp(): Promise<boolean>;
     updateTransportMethod(transportType: string): Promise<boolean>;
     getPublicKey(params: GetPublicKeyParams): Promise<GetPublicKeyResponse>;

package/dist/ledger-iframe-bridge.js

@@ -4,7 +4,13 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _LedgerIframeBridge_instances, _LedgerIframeBridge_deviceActionMessage, _LedgerIframeBridge_setupIframe, _LedgerIframeBridge_getOrigin, _LedgerIframeBridge_eventListener, _LedgerIframeBridge_sendMessage;
+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 _LedgerIframeBridge_instances, _LedgerIframeBridge_opts, _LedgerIframeBridge_deviceActionMessage, _LedgerIframeBridge_setupIframe, _LedgerIframeBridge_getOrigin, _LedgerIframeBridge_eventListener, _LedgerIframeBridge_sendMessage, _LedgerIframeBridge_validateConfiguration;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LedgerIframeBridge = exports.IFrameMessageAction = void 0;
 const LEDGER_IFRAME_ID = 'LEDGER-IFRAME';
@@ -19,16 +25,23 @@ var IFrameMessageAction;
     IFrameMessageAction["LedgerSignTypedData"] = "ledger-sign-typed-data";
 })(IFrameMessageAction = exports.IFrameMessageAction || (exports.IFrameMessageAction = {}));
 class LedgerIframeBridge {
-    constructor() {
+    constructor(opts = {
+        bridgeUrl: 'https://metamask.github.io/eth-ledger-bridge-keyring',
+    }) {
         _LedgerIframeBridge_instances.add(this);
         this.iframeLoaded = false;
+        _LedgerIframeBridge_opts.set(this, void 0);
         this.isDeviceConnected = false;
         this.currentMessageId = 0;
         this.messageCallbacks = {};
+        __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_validateConfiguration).call(this, opts);
+        __classPrivateFieldSet(this, _LedgerIframeBridge_opts, {
+            bridgeUrl: opts === null || opts === void 0 ? void 0 : opts.bridgeUrl,
+        }, "f");
     }
-    async init(bridgeUrl) {
-        __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_setupIframe).call(this, bridgeUrl);
-        this.eventListener = __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_eventListener).bind(this, bridgeUrl);
+    async init() {
+        __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_setupIframe).call(this, __classPrivateFieldGet(this, _LedgerIframeBridge_opts, "f").bridgeUrl);
+        this.eventListener = __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_eventListener).bind(this, __classPrivateFieldGet(this, _LedgerIframeBridge_opts, "f").bridgeUrl);
         window.addEventListener('message', this.eventListener);
     }
     async destroy() {
@@ -36,17 +49,32 @@ class LedgerIframeBridge {
             window.removeEventListener('message', this.eventListener);
         }
     }
+    async getOptions() {
+        return __classPrivateFieldGet(this, _LedgerIframeBridge_opts, "f");
+    }
+    async setOptions(opts) {
+        var _a;
+        __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_validateConfiguration).call(this, opts);
+        if (((_a = __classPrivateFieldGet(this, _LedgerIframeBridge_opts, "f")) === null || _a === void 0 ? void 0 : _a.bridgeUrl) !== opts.bridgeUrl) {
+            __classPrivateFieldGet(this, _LedgerIframeBridge_opts, "f").bridgeUrl = opts.bridgeUrl;
+            await this.destroy();
+            await this.init();
+        }
+    }
     async attemptMakeApp() {
         return new Promise((resolve, reject) => {
             __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_sendMessage).call(this, {
                 action: IFrameMessageAction.LedgerMakeApp,
             }, (response) => {
-                if (response.success) {
+                if ('success' in response && response.success) {
                     resolve(true);
                 }
-                else {
+                else if ('error' in response) {
                     reject(response.error);
                 }
+                else {
+                    reject(new Error('Unknown error occurred'));
+                }
             });
         });
     }
@@ -65,8 +93,8 @@ class LedgerIframeBridge {
             __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_sendMessage).call(this, {
                 action: IFrameMessageAction.LedgerUpdateTransport,
                 params: { transportType },
-            }, ({ success }) => {
-                if (success) {
+            }, (response) => {
+                if ('success' in response && response.success) {
                     return resolve(true);
                 }
                 return reject(new Error('Ledger transport could not be updated'));
@@ -87,16 +115,21 @@ class LedgerIframeBridge {
     }
 }
 exports.LedgerIframeBridge = LedgerIframeBridge;
-_LedgerIframeBridge_instances = new WeakSet(), _LedgerIframeBridge_deviceActionMessage = async function _LedgerIframeBridge_deviceActionMessage(...[action, params]) {
+_LedgerIframeBridge_opts = new WeakMap(), _LedgerIframeBridge_instances = new WeakSet(), _LedgerIframeBridge_deviceActionMessage = async function _LedgerIframeBridge_deviceActionMessage(...[action, params]) {
     return new Promise((resolve, reject) => {
         __classPrivateFieldGet(this, _LedgerIframeBridge_instances, "m", _LedgerIframeBridge_sendMessage).call(this, {
             action,
             params,
-        }, ({ success, payload }) => {
-            if (success) {
-                return resolve(payload);
+        }, (response) => {
+            if ('payload' in response && response.payload) {
+                if ('success' in response && response.success) {
+                    return resolve(response.payload);
+                }
+                if ('error' in response.payload) {
+                    return reject(response.payload.error);
+                }
             }
-            return reject(payload.error);
+            return reject(new Error('Unknown error occurred'));
         });
     });
 }, _LedgerIframeBridge_setupIframe = function _LedgerIframeBridge_setupIframe(bridgeUrl) {
@@ -146,5 +179,9 @@ _LedgerIframeBridge_instances = new WeakSet(), _LedgerIframeBridge_deviceActionM
         throw new Error('The iframe is not loaded yet');
     }
     this.iframe.contentWindow.postMessage(postMsg, '*');
+}, _LedgerIframeBridge_validateConfiguration = function _LedgerIframeBridge_validateConfiguration(opts) {
+    if (typeof opts.bridgeUrl !== 'string' || opts.bridgeUrl.length === 0) {
+        throw new Error('bridgeURL is not a valid URL');
+    }
 };
 //# sourceMappingURL=ledger-iframe-bridge.js.map

package/dist/ledger-iframe-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"ledger-iframe-bridge.js","sourceRoot":"","sources":["../src/ledger-iframe-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  GetPublicKeyParams,\n  GetPublicKeyResponse,\n  LedgerBridge,\n  LedgerSignMessageParams,\n  LedgerSignMessageResponse,\n  LedgerSignTransactionParams,\n  LedgerSignTransactionResponse,\n  LedgerSignTypedDataParams,\n  LedgerSignTypedDataResponse,\n} from './ledger-bridge';\n\nconst LEDGER_IFRAME_ID = 'LEDGER-IFRAME';\n\nexport enum IFrameMessageAction {\n  LedgerConnectionChange = 'ledger-connection-change',\n  LedgerUnlock = 'ledger-unlock',\n  LedgerMakeApp = 'ledger-make-app',\n  LedgerUpdateTransport = 'ledger-update-transport',\n  LedgerSignTransaction = 'ledger-sign-transaction',\n  LedgerSignPersonalMessage = 'ledger-sign-personal-message',\n  LedgerSignTypedData = 'ledger-sign-typed-data',\n}\n\ntype IFrameMessageResponse<TAction extends IFrameMessageAction> = {\n  action: TAction;\n  messageId: number;\n} & (\n  | {\n      action: IFrameMessageAction.LedgerConnectionChange;\n      payload: { connected: boolean };\n    }\n  | ({\n      action: IFrameMessageAction.LedgerMakeApp;\n    } & ({ success: true } | { success: false; error?: unknown }))\n  | {\n      action: IFrameMessageAction.LedgerUpdateTransport;\n      success: boolean;\n    }\n  | ({\n      action: IFrameMessageAction.LedgerUnlock;\n    } & (\n      | { success: true; payload: GetPublicKeyResponse }\n      | { success: false; payload: { error: Error } }\n    ))\n  | ({\n      action: IFrameMessageAction.LedgerSignTransaction;\n    } & (\n      | { success: true; payload: LedgerSignTransactionResponse }\n      | { success: false; payload: { error: Error } }\n    ))\n  | ({\n      action:\n        | IFrameMessageAction.LedgerSignPersonalMessage\n        | IFrameMessageAction.LedgerSignTypedData;\n    } & (\n      | {\n          success: true;\n          payload: LedgerSignMessageResponse | LedgerSignTypedDataResponse;\n        }\n      | { success: false; payload: { error: Error } }\n    ))\n);\n\ntype IFrameMessage<TAction extends IFrameMessageAction> = {\n  action: TAction;\n  params?: Readonly<Record<string, unknown>>;\n};\n\ntype IFramePostMessage<TAction extends IFrameMessageAction> =\n  IFrameMessage<TAction> & {\n    messageId: number;\n    target: typeof LEDGER_IFRAME_ID;\n  };\n\nexport class LedgerIframeBridge implements LedgerBridge {\n  iframe?: HTMLIFrameElement;\n\n  iframeLoaded = false;\n\n  eventListener?: (eventMessage: {\n    origin: string;\n    data: IFrameMessageResponse<IFrameMessageAction>;\n  }) => void;\n\n  isDeviceConnected = false;\n\n  currentMessageId = 0;\n\n  messageCallbacks: Record<\n    number,\n    (response: IFrameMessageResponse<IFrameMessageAction>) => void\n  > = {};\n\n  delayedPromise?: {\n    resolve: (value: boolean) => void;\n    reject: (error: unknown) => void;\n    transportType: string;\n  };\n\n  async init(bridgeUrl: string) {\n    this.#setupIframe(bridgeUrl);\n\n    this.eventListener = this.#eventListener.bind(this, bridgeUrl);\n\n    window.addEventListener('message', this.eventListener);\n  }\n\n  async destroy() {\n    if (this.eventListener) {\n      window.removeEventListener('message', this.eventListener);\n    }\n  }\n\n  async attemptMakeApp(): Promise<boolean> {\n    return new Promise((resolve, reject) => {\n      this.#sendMessage(\n        {\n          action: IFrameMessageAction.LedgerMakeApp,\n        },\n        (response) => {\n          if (response.success) {\n            resolve(true);\n          } else {\n            reject(response.error);\n          }\n        },\n      );\n    });\n  }\n\n  async updateTransportMethod(transportType: string): Promise<boolean> {\n    return new Promise((resolve, reject) => {\n      // If the iframe isn't loaded yet, let's store the desired transportType value and\n      // optimistically return a successful promise\n      if (!this.iframeLoaded) {\n        this.delayedPromise = {\n          resolve,\n          reject,\n          transportType,\n        };\n        return;\n      }\n\n      this.#sendMessage(\n        {\n          action: IFrameMessageAction.LedgerUpdateTransport,\n          params: { transportType },\n        },\n        ({ success }) => {\n          if (success) {\n            return resolve(true);\n          }\n          return reject(new Error('Ledger transport could not be updated'));\n        },\n      );\n    });\n  }\n\n  async getPublicKey(\n    params: GetPublicKeyParams,\n  ): Promise<GetPublicKeyResponse> {\n    return this.#deviceActionMessage(IFrameMessageAction.LedgerUnlock, params);\n  }\n\n  async deviceSignTransaction(\n    params: LedgerSignTransactionParams,\n  ): Promise<LedgerSignTransactionResponse> {\n    return this.#deviceActionMessage(\n      IFrameMessageAction.LedgerSignTransaction,\n      params,\n    );\n  }\n\n  async deviceSignMessage(\n    params: LedgerSignMessageParams,\n  ): Promise<LedgerSignMessageResponse> {\n    return this.#deviceActionMessage(\n      IFrameMessageAction.LedgerSignPersonalMessage,\n      params,\n    );\n  }\n\n  async deviceSignTypedData(\n    params: LedgerSignTypedDataParams,\n  ): Promise<LedgerSignTypedDataResponse> {\n    return this.#deviceActionMessage(\n      IFrameMessageAction.LedgerSignTypedData,\n      params,\n    );\n  }\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerUnlock,\n    params: GetPublicKeyParams,\n  ): Promise<GetPublicKeyResponse>;\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerSignTransaction,\n    params: LedgerSignTransactionParams,\n  ): Promise<LedgerSignTransactionResponse>;\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerSignPersonalMessage,\n    params: LedgerSignMessageParams,\n  ): Promise<LedgerSignMessageResponse>;\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerSignTypedData,\n    params: LedgerSignTypedDataParams,\n  ): Promise<LedgerSignTypedDataResponse>;\n\n  async #deviceActionMessage(\n    ...[action, params]:\n      | [IFrameMessageAction.LedgerUnlock, GetPublicKeyParams]\n      | [IFrameMessageAction.LedgerSignTransaction, LedgerSignTransactionParams]\n      | [IFrameMessageAction.LedgerSignPersonalMessage, LedgerSignMessageParams]\n      | [IFrameMessageAction.LedgerSignTypedData, LedgerSignTypedDataParams]\n  ) {\n    return new Promise((resolve, reject) => {\n      this.#sendMessage(\n        {\n          action,\n          params,\n        },\n        ({ success, payload }) => {\n          if (success) {\n            return resolve(payload);\n          }\n          return reject(payload.error);\n        },\n      );\n    });\n  }\n\n  #setupIframe(bridgeUrl: string) {\n    this.iframe = document.createElement('iframe');\n    this.iframe.src = bridgeUrl;\n    this.iframe.allow = `hid 'src'`;\n    this.iframe.onload = async () => {\n      // If the ledger live preference was set before the iframe is loaded,\n      // set it after the iframe has loaded\n      this.iframeLoaded = true;\n      if (this.delayedPromise) {\n        try {\n          const result = await this.updateTransportMethod(\n            this.delayedPromise.transportType,\n          );\n          this.delayedPromise.resolve(result);\n        } catch (error) {\n          this.delayedPromise.reject(error);\n        } finally {\n          delete this.delayedPromise;\n        }\n      }\n    };\n    document.head.appendChild(this.iframe);\n  }\n\n  #getOrigin(bridgeUrl: string) {\n    const tmp = bridgeUrl.split('/');\n    tmp.splice(-1, 1);\n    return tmp.join('/');\n  }\n\n  #eventListener(\n    bridgeUrl: string,\n    eventMessage: {\n      origin: string;\n      data: IFrameMessageResponse<IFrameMessageAction>;\n    },\n  ) {\n    if (eventMessage.origin !== this.#getOrigin(bridgeUrl)) {\n      return;\n    }\n\n    if (eventMessage.data) {\n      const messageCallback =\n        this.messageCallbacks[eventMessage.data.messageId];\n      if (messageCallback) {\n        messageCallback(eventMessage.data);\n      } else if (\n        eventMessage.data.action === IFrameMessageAction.LedgerConnectionChange\n      ) {\n        this.isDeviceConnected = eventMessage.data.payload.connected;\n      }\n    }\n  }\n\n  #sendMessage<TAction extends IFrameMessageAction>(\n    message: IFrameMessage<TAction>,\n    callback: (response: IFrameMessageResponse<TAction>) => void,\n  ) {\n    this.currentMessageId += 1;\n\n    const postMsg: IFramePostMessage<TAction> = {\n      ...message,\n      messageId: this.currentMessageId,\n      target: LEDGER_IFRAME_ID,\n    };\n\n    this.messageCallbacks[this.currentMessageId] = callback as (\n      response: IFrameMessageResponse<IFrameMessageAction>,\n    ) => void;\n\n    if (!this.iframeLoaded || !this.iframe || !this.iframe.contentWindow) {\n      throw new Error('The iframe is not loaded yet');\n    }\n\n    this.iframe.contentWindow.postMessage(postMsg, '*');\n  }\n}\n"]}
+{"version":3,"file":"ledger-iframe-bridge.js","sourceRoot":"","sources":["../src/ledger-iframe-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  GetPublicKeyParams,\n  GetPublicKeyResponse,\n  LedgerBridge,\n  LedgerSignMessageParams,\n  LedgerSignMessageResponse,\n  LedgerSignTransactionParams,\n  LedgerSignTransactionResponse,\n  LedgerSignTypedDataParams,\n  LedgerSignTypedDataResponse,\n} from './ledger-bridge';\n\nconst LEDGER_IFRAME_ID = 'LEDGER-IFRAME';\n\nexport enum IFrameMessageAction {\n  LedgerConnectionChange = 'ledger-connection-change',\n  LedgerUnlock = 'ledger-unlock',\n  LedgerMakeApp = 'ledger-make-app',\n  LedgerUpdateTransport = 'ledger-update-transport',\n  LedgerSignTransaction = 'ledger-sign-transaction',\n  LedgerSignPersonalMessage = 'ledger-sign-personal-message',\n  LedgerSignTypedData = 'ledger-sign-typed-data',\n}\n\ntype IFrameMessageResponseStub<\n  SuccessResult extends Record<string, unknown>,\n  FailureResult = Error,\n> = {\n  messageId: number;\n} & (\n  | { success: true; payload: SuccessResult }\n  | { success: false; payload: { error: FailureResult } }\n);\n\ntype LedgerConnectionChangeActionResponse = {\n  messageId: number;\n  action: IFrameMessageAction.LedgerConnectionChange;\n  payload: { connected: boolean };\n};\n\ntype LedgerMakeAppActionResponse = {\n  messageId: number;\n  action: IFrameMessageAction.LedgerMakeApp;\n} & ({ success: true } | { success: false; error?: unknown });\n\ntype LedgerUpdateTransportActionResponse = {\n  messageId: number;\n  action: IFrameMessageAction.LedgerUpdateTransport;\n  success: boolean;\n};\n\ntype LedgerUnlockActionResponse = {\n  action: IFrameMessageAction.LedgerUnlock;\n} & IFrameMessageResponseStub<GetPublicKeyResponse>;\n\ntype LedgerSignTransactionActionResponse = {\n  action: IFrameMessageAction.LedgerSignTransaction;\n} & IFrameMessageResponseStub<LedgerSignTransactionResponse>;\n\ntype LedgerSignPersonalMessageActionResponse = {\n  action: IFrameMessageAction.LedgerSignPersonalMessage;\n} & IFrameMessageResponseStub<LedgerSignMessageResponse>;\n\ntype LedgerSignTypedDataActionResponse = {\n  action: IFrameMessageAction.LedgerSignTypedData;\n} & IFrameMessageResponseStub<LedgerSignTypedDataResponse>;\n\nexport type IFrameMessageResponse =\n  | LedgerConnectionChangeActionResponse\n  | LedgerMakeAppActionResponse\n  | LedgerUpdateTransportActionResponse\n  | LedgerUnlockActionResponse\n  | LedgerSignTransactionActionResponse\n  | LedgerSignPersonalMessageActionResponse\n  | LedgerSignTypedDataActionResponse;\n\ntype IFrameMessage<TAction extends IFrameMessageAction> = {\n  action: TAction;\n  params?: Readonly<Record<string, unknown>>;\n};\n\ntype IFramePostMessage<TAction extends IFrameMessageAction> =\n  IFrameMessage<TAction> & {\n    messageId: number;\n    target: typeof LEDGER_IFRAME_ID;\n  };\n\nexport type LedgerIframeBridgeOptions = {\n  bridgeUrl: string;\n};\n\nexport class LedgerIframeBridge\n  implements LedgerBridge<LedgerIframeBridgeOptions>\n{\n  iframe?: HTMLIFrameElement;\n\n  iframeLoaded = false;\n\n  #opts: LedgerIframeBridgeOptions;\n\n  eventListener?: (eventMessage: {\n    origin: string;\n    data: IFrameMessageResponse;\n  }) => void;\n\n  isDeviceConnected = false;\n\n  currentMessageId = 0;\n\n  messageCallbacks: Record<number, (response: IFrameMessageResponse) => void> =\n    {};\n\n  delayedPromise?: {\n    resolve: (value: boolean) => void;\n    reject: (error: unknown) => void;\n    transportType: string;\n  };\n\n  constructor(\n    opts: LedgerIframeBridgeOptions = {\n      bridgeUrl: 'https://metamask.github.io/eth-ledger-bridge-keyring',\n    },\n  ) {\n    this.#validateConfiguration(opts);\n    this.#opts = {\n      bridgeUrl: opts?.bridgeUrl,\n    };\n  }\n\n  async init() {\n    this.#setupIframe(this.#opts.bridgeUrl);\n\n    this.eventListener = this.#eventListener.bind(this, this.#opts.bridgeUrl);\n\n    window.addEventListener('message', this.eventListener);\n  }\n\n  async destroy() {\n    if (this.eventListener) {\n      window.removeEventListener('message', this.eventListener);\n    }\n  }\n\n  async getOptions(): Promise<LedgerIframeBridgeOptions> {\n    return this.#opts;\n  }\n\n  async setOptions(opts: LedgerIframeBridgeOptions): Promise<void> {\n    this.#validateConfiguration(opts);\n    if (this.#opts?.bridgeUrl !== opts.bridgeUrl) {\n      this.#opts.bridgeUrl = opts.bridgeUrl;\n      await this.destroy();\n      await this.init();\n    }\n  }\n\n  async attemptMakeApp(): Promise<boolean> {\n    return new Promise((resolve, reject) => {\n      this.#sendMessage(\n        {\n          action: IFrameMessageAction.LedgerMakeApp,\n        },\n        (response) => {\n          if ('success' in response && response.success) {\n            resolve(true);\n          } else if ('error' in response) {\n            reject(response.error);\n          } else {\n            reject(new Error('Unknown error occurred'));\n          }\n        },\n      );\n    });\n  }\n\n  async updateTransportMethod(transportType: string): Promise<boolean> {\n    return new Promise((resolve, reject) => {\n      // If the iframe isn't loaded yet, let's store the desired transportType value and\n      // optimistically return a successful promise\n      if (!this.iframeLoaded) {\n        this.delayedPromise = {\n          resolve,\n          reject,\n          transportType,\n        };\n        return;\n      }\n\n      this.#sendMessage(\n        {\n          action: IFrameMessageAction.LedgerUpdateTransport,\n          params: { transportType },\n        },\n        (response) => {\n          if ('success' in response && response.success) {\n            return resolve(true);\n          }\n          return reject(new Error('Ledger transport could not be updated'));\n        },\n      );\n    });\n  }\n\n  async getPublicKey(\n    params: GetPublicKeyParams,\n  ): Promise<GetPublicKeyResponse> {\n    return this.#deviceActionMessage(IFrameMessageAction.LedgerUnlock, params);\n  }\n\n  async deviceSignTransaction(\n    params: LedgerSignTransactionParams,\n  ): Promise<LedgerSignTransactionResponse> {\n    return this.#deviceActionMessage(\n      IFrameMessageAction.LedgerSignTransaction,\n      params,\n    );\n  }\n\n  async deviceSignMessage(\n    params: LedgerSignMessageParams,\n  ): Promise<LedgerSignMessageResponse> {\n    return this.#deviceActionMessage(\n      IFrameMessageAction.LedgerSignPersonalMessage,\n      params,\n    );\n  }\n\n  async deviceSignTypedData(\n    params: LedgerSignTypedDataParams,\n  ): Promise<LedgerSignTypedDataResponse> {\n    return this.#deviceActionMessage(\n      IFrameMessageAction.LedgerSignTypedData,\n      params,\n    );\n  }\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerUnlock,\n    params: GetPublicKeyParams,\n  ): Promise<GetPublicKeyResponse>;\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerSignTransaction,\n    params: LedgerSignTransactionParams,\n  ): Promise<LedgerSignTransactionResponse>;\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerSignPersonalMessage,\n    params: LedgerSignMessageParams,\n  ): Promise<LedgerSignMessageResponse>;\n\n  async #deviceActionMessage(\n    action: IFrameMessageAction.LedgerSignTypedData,\n    params: LedgerSignTypedDataParams,\n  ): Promise<LedgerSignTypedDataResponse>;\n\n  async #deviceActionMessage(\n    ...[action, params]:\n      | [IFrameMessageAction.LedgerUnlock, GetPublicKeyParams]\n      | [IFrameMessageAction.LedgerSignTransaction, LedgerSignTransactionParams]\n      | [IFrameMessageAction.LedgerSignPersonalMessage, LedgerSignMessageParams]\n      | [IFrameMessageAction.LedgerSignTypedData, LedgerSignTypedDataParams]\n  ) {\n    return new Promise((resolve, reject) => {\n      this.#sendMessage(\n        {\n          action,\n          params,\n        },\n        (response) => {\n          if ('payload' in response && response.payload) {\n            if ('success' in response && response.success) {\n              return resolve(response.payload);\n            }\n            if ('error' in response.payload) {\n              return reject(response.payload.error);\n            }\n          }\n          return reject(new Error('Unknown error occurred'));\n        },\n      );\n    });\n  }\n\n  #setupIframe(bridgeUrl: string) {\n    this.iframe = document.createElement('iframe');\n    this.iframe.src = bridgeUrl;\n    this.iframe.allow = `hid 'src'`;\n    this.iframe.onload = async () => {\n      // If the ledger live preference was set before the iframe is loaded,\n      // set it after the iframe has loaded\n      this.iframeLoaded = true;\n      if (this.delayedPromise) {\n        try {\n          const result = await this.updateTransportMethod(\n            this.delayedPromise.transportType,\n          );\n          this.delayedPromise.resolve(result);\n        } catch (error) {\n          this.delayedPromise.reject(error);\n        } finally {\n          delete this.delayedPromise;\n        }\n      }\n    };\n    document.head.appendChild(this.iframe);\n  }\n\n  #getOrigin(bridgeUrl: string) {\n    const tmp = bridgeUrl.split('/');\n    tmp.splice(-1, 1);\n    return tmp.join('/');\n  }\n\n  #eventListener(\n    bridgeUrl: string,\n    eventMessage: {\n      origin: string;\n      data: IFrameMessageResponse;\n    },\n  ) {\n    if (eventMessage.origin !== this.#getOrigin(bridgeUrl)) {\n      return;\n    }\n\n    if (eventMessage.data) {\n      const messageCallback =\n        this.messageCallbacks[eventMessage.data.messageId];\n      if (messageCallback) {\n        messageCallback(eventMessage.data);\n      } else if (\n        eventMessage.data.action === IFrameMessageAction.LedgerConnectionChange\n      ) {\n        this.isDeviceConnected = eventMessage.data.payload.connected;\n      }\n    }\n  }\n\n  #sendMessage<TAction extends IFrameMessageAction>(\n    message: IFrameMessage<TAction>,\n    callback: (response: IFrameMessageResponse) => void,\n  ) {\n    this.currentMessageId += 1;\n\n    const postMsg: IFramePostMessage<TAction> = {\n      ...message,\n      messageId: this.currentMessageId,\n      target: LEDGER_IFRAME_ID,\n    };\n\n    this.messageCallbacks[this.currentMessageId] = callback;\n\n    if (!this.iframeLoaded || !this.iframe || !this.iframe.contentWindow) {\n      throw new Error('The iframe is not loaded yet');\n    }\n\n    this.iframe.contentWindow.postMessage(postMsg, '*');\n  }\n\n  #validateConfiguration(opts: LedgerIframeBridgeOptions): void {\n    if (typeof opts.bridgeUrl !== 'string' || opts.bridgeUrl.length === 0) {\n      throw new Error('bridgeURL is not a valid URL');\n    }\n  }\n}\n"]}

package/dist/ledger-keyring.d.ts

@@ -4,10 +4,10 @@ import type { MessageTypes, TypedMessage } from '@metamask/eth-sig-util';
 import type OldEthJsTransaction from 'ethereumjs-tx';
 import { EventEmitter } from 'events';
 import HDKey from 'hdkey';
-import { LedgerBridge } from './ledger-bridge';
+import { LedgerBridge, LedgerBridgeOptions } from './ledger-bridge';
 declare enum NetworkApiUrls {
-    Ropsten = "http://api-ropsten.etherscan.io",
-    Kovan = "http://api-kovan.etherscan.io",
+    Ropsten = "https://api-ropsten.etherscan.io",
+    Kovan = "https://api-kovan.etherscan.io",
     Rinkeby = "https://api-rinkeby.etherscan.io",
     Mainnet = "https://api.etherscan.io"
 }
@@ -19,14 +19,15 @@ export declare type AccountDetails = {
 export declare type LedgerBridgeKeyringOptions = {
     hdPath: string;
     accounts: readonly string[];
+    deviceId: string;
     accountDetails: Readonly<Record<string, AccountDetails>>;
     accountIndexes: Readonly<Record<string, number>>;
-    bridgeUrl: string;
     implementFullBIP44: boolean;
 };
 export declare class LedgerKeyring extends EventEmitter {
     #private;
     static type: string;
+    deviceId: string;
     readonly type: string;
     page: number;
     perPage: number;
@@ -38,27 +39,29 @@ export declare class LedgerKeyring extends EventEmitter {
     paths: Record<string, number>;
     network: NetworkApiUrls;
     implementFullBIP44: boolean;
-    bridgeUrl: string;
-    bridge: LedgerBridge;
+    bridge: LedgerBridge<LedgerBridgeOptions>;
     constructor({ bridge }: {
-        bridge: LedgerBridge;
+        bridge: LedgerBridge<LedgerBridgeOptions>;
     });
     init(): Promise<void>;
     destroy(): Promise<void>;
     serialize(): Promise<{
         hdPath: string;
         accounts: readonly string[];
+        deviceId: string;
         accountDetails: Record<string, AccountDetails>;
-        bridgeUrl: string;
         implementFullBIP44: boolean;
     }>;
     deserialize(opts?: Partial<LedgerBridgeKeyringOptions>): Promise<void>;
+    setDeviceId(deviceId: string): void;
+    getDeviceId(): string;
     isUnlocked(): boolean;
     isConnected(): boolean;
-    setAccountToUnlock(index: number | string): void;
+    setAccountToUnlock(index: number): void;
     setHdPath(hdPath: string): void;
     unlock(hdPath?: string, updateHdk?: boolean): Promise<string>;
     addAccounts(amount?: number): Promise<string[]>;
+    getName(): string;
     getFirstPage(): Promise<{
         address: string;
         balance: number | null;