@onekeyfe/hwk-ledger-connector-webhid 1.1.26-alpha.100

package/dist/index.d.mts

@@ -0,0 +1,38 @@
+import { DeviceDescriptor, IConnector } from '@onekeyfe/hwk-adapter-core';
+import { DeviceManagementKit } from '@ledgerhq/device-management-kit';
+import { LedgerConnectorBase } from '@onekeyfe/hwk-ledger-adapter';
+
+interface LedgerWebHidConnectorOptions {
+    /**
+     * Pre-built DMK instance. If not provided, a DMK will be created
+     * lazily on first use via `@ledgerhq/device-management-kit` and
+     * `@ledgerhq/device-transport-kit-web-hid`.
+     */
+    dmk?: DeviceManagementKit;
+}
+/**
+ * IConnector implementation for Ledger hardware wallets via WebHID.
+ *
+ * Extends LedgerConnectorBase with the WebHID transport factory.
+ * Overrides connectId resolution to handle BLE devices that may appear
+ * via a WebHID+BLE combo transport.
+ */
+declare class LedgerWebHidConnector extends LedgerConnectorBase {
+    constructor(options?: LedgerWebHidConnectorOptions);
+    /**
+     * Override connectId resolution for BLE devices discovered via WebHID+BLE combo.
+     * For USB devices, the DMK path (ephemeral UUID) is used as-is.
+     */
+    protected _resolveConnectId(descriptor: DeviceDescriptor): string;
+}
+
+/**
+ * Create a LedgerWebHidConnector.
+ *
+ * @param dmk - Optional pre-built DMK instance. If omitted, the connector
+ *              will lazily create one using `@ledgerhq/device-management-kit`
+ *              and `@ledgerhq/device-transport-kit-web-hid`.
+ */
+declare function createLedgerWebHidConnector(dmk?: DeviceManagementKit): IConnector;
+
+export { LedgerWebHidConnector, type LedgerWebHidConnectorOptions, createLedgerWebHidConnector };

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { DeviceDescriptor, IConnector } from '@onekeyfe/hwk-adapter-core';
+import { DeviceManagementKit } from '@ledgerhq/device-management-kit';
+import { LedgerConnectorBase } from '@onekeyfe/hwk-ledger-adapter';
+
+interface LedgerWebHidConnectorOptions {
+    /**
+     * Pre-built DMK instance. If not provided, a DMK will be created
+     * lazily on first use via `@ledgerhq/device-management-kit` and
+     * `@ledgerhq/device-transport-kit-web-hid`.
+     */
+    dmk?: DeviceManagementKit;
+}
+/**
+ * IConnector implementation for Ledger hardware wallets via WebHID.
+ *
+ * Extends LedgerConnectorBase with the WebHID transport factory.
+ * Overrides connectId resolution to handle BLE devices that may appear
+ * via a WebHID+BLE combo transport.
+ */
+declare class LedgerWebHidConnector extends LedgerConnectorBase {
+    constructor(options?: LedgerWebHidConnectorOptions);
+    /**
+     * Override connectId resolution for BLE devices discovered via WebHID+BLE combo.
+     * For USB devices, the DMK path (ephemeral UUID) is used as-is.
+     */
+    protected _resolveConnectId(descriptor: DeviceDescriptor): string;
+}
+
+/**
+ * Create a LedgerWebHidConnector.
+ *
+ * @param dmk - Optional pre-built DMK instance. If omitted, the connector
+ *              will lazily create one using `@ledgerhq/device-management-kit`
+ *              and `@ledgerhq/device-transport-kit-web-hid`.
+ */
+declare function createLedgerWebHidConnector(dmk?: DeviceManagementKit): IConnector;
+
+export { LedgerWebHidConnector, type LedgerWebHidConnectorOptions, createLedgerWebHidConnector };

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LedgerWebHidConnector: () => LedgerWebHidConnector,
+  createLedgerWebHidConnector: () => createLedgerWebHidConnector
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/LedgerWebHidConnector.ts
+var import_hwk_ledger_adapter = require("@onekeyfe/hwk-ledger-adapter");
+function extractBleHexId(name) {
+  if (!name) return void 0;
+  const match = name.match(/\b([0-9A-Fa-f]{4})$/);
+  return match ? match[1].toUpperCase() : void 0;
+}
+var LedgerWebHidConnector = class extends import_hwk_ledger_adapter.LedgerConnectorBase {
+  constructor(options) {
+    super(
+      async () => {
+        const { webHidTransportFactory } = await import("@ledgerhq/device-transport-kit-web-hid");
+        return webHidTransportFactory;
+      },
+      { connectionType: "usb", dmk: options?.dmk }
+    );
+  }
+  /**
+   * Override connectId resolution for BLE devices discovered via WebHID+BLE combo.
+   * For USB devices, the DMK path (ephemeral UUID) is used as-is.
+   */
+  _resolveConnectId(descriptor) {
+    if (descriptor.transport === "BLE") {
+      return extractBleHexId(descriptor.name) || descriptor.path;
+    }
+    return descriptor.path;
+  }
+};
+
+// src/index.ts
+function createLedgerWebHidConnector(dmk) {
+  return new LedgerWebHidConnector({ dmk });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LedgerWebHidConnector,
+  createLedgerWebHidConnector
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/LedgerWebHidConnector.ts"],"sourcesContent":["import type { IConnector } from '@onekeyfe/hwk-adapter-core';\nimport type { DeviceManagementKit } from '@ledgerhq/device-management-kit';\n\nimport { LedgerWebHidConnector } from './LedgerWebHidConnector';\nimport type { LedgerWebHidConnectorOptions } from './LedgerWebHidConnector';\n\nexport { LedgerWebHidConnector };\nexport type { LedgerWebHidConnectorOptions };\n\n/**\n * Create a LedgerWebHidConnector.\n *\n * @param dmk - Optional pre-built DMK instance. If omitted, the connector\n *              will lazily create one using `@ledgerhq/device-management-kit`\n *              and `@ledgerhq/device-transport-kit-web-hid`.\n */\nexport function createLedgerWebHidConnector(dmk?: DeviceManagementKit): IConnector {\n  return new LedgerWebHidConnector({ dmk });\n}\n","import type { DeviceDescriptor } from '@onekeyfe/hwk-adapter-core';\nimport type { DeviceManagementKit } from '@ledgerhq/device-management-kit';\nimport { LedgerConnectorBase } from '@onekeyfe/hwk-ledger-adapter';\n\n// ---------------------------------------------------------------------------\n// Utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Extract the stable 4-digit HEX identifier from a Ledger BLE device name.\n * e.g., \"Nano X 123A\" -> \"123A\", \"Ledger Nano X AB12\" -> \"AB12\"\n * Returns undefined if no valid HEX suffix found.\n */\nfunction extractBleHexId(name?: string): string | undefined {\n  if (!name) return undefined;\n  const match = name.match(/\\b([0-9A-Fa-f]{4})$/);\n  return match ? match[1].toUpperCase() : undefined;\n}\n\n// ---------------------------------------------------------------------------\n// LedgerWebHidConnector\n// ---------------------------------------------------------------------------\n\nexport interface LedgerWebHidConnectorOptions {\n  /**\n   * Pre-built DMK instance. If not provided, a DMK will be created\n   * lazily on first use via `@ledgerhq/device-management-kit` and\n   * `@ledgerhq/device-transport-kit-web-hid`.\n   */\n  dmk?: DeviceManagementKit;\n}\n\n/**\n * IConnector implementation for Ledger hardware wallets via WebHID.\n *\n * Extends LedgerConnectorBase with the WebHID transport factory.\n * Overrides connectId resolution to handle BLE devices that may appear\n * via a WebHID+BLE combo transport.\n */\nexport class LedgerWebHidConnector extends LedgerConnectorBase {\n  constructor(options?: LedgerWebHidConnectorOptions) {\n    super(\n      async () => {\n        const { webHidTransportFactory } = await import('@ledgerhq/device-transport-kit-web-hid');\n        return webHidTransportFactory;\n      },\n      { connectionType: 'usb', dmk: options?.dmk }\n    );\n  }\n\n  /**\n   * Override connectId resolution for BLE devices discovered via WebHID+BLE combo.\n   * For USB devices, the DMK path (ephemeral UUID) is used as-is.\n   */\n  protected override _resolveConnectId(descriptor: DeviceDescriptor): string {\n    if (descriptor.transport === 'BLE') {\n      return extractBleHexId(descriptor.name) || descriptor.path;\n    }\n    return descriptor.path;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,gCAAoC;AAWpC,SAAS,gBAAgB,MAAmC;AAC1D,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,QAAQ,KAAK,MAAM,qBAAqB;AAC9C,SAAO,QAAQ,MAAM,CAAC,EAAE,YAAY,IAAI;AAC1C;AAsBO,IAAM,wBAAN,cAAoC,8CAAoB;AAAA,EAC7D,YAAY,SAAwC;AAClD;AAAA,MACE,YAAY;AACV,cAAM,EAAE,uBAAuB,IAAI,MAAM,OAAO,wCAAwC;AACxF,eAAO;AAAA,MACT;AAAA,MACA,EAAE,gBAAgB,OAAO,KAAK,SAAS,IAAI;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMmB,kBAAkB,YAAsC;AACzE,QAAI,WAAW,cAAc,OAAO;AAClC,aAAO,gBAAgB,WAAW,IAAI,KAAK,WAAW;AAAA,IACxD;AACA,WAAO,WAAW;AAAA,EACpB;AACF;;;AD5CO,SAAS,4BAA4B,KAAuC;AACjF,SAAO,IAAI,sBAAsB,EAAE,IAAI,CAAC;AAC1C;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,38 @@
+// src/LedgerWebHidConnector.ts
+import { LedgerConnectorBase } from "@onekeyfe/hwk-ledger-adapter";
+function extractBleHexId(name) {
+  if (!name) return void 0;
+  const match = name.match(/\b([0-9A-Fa-f]{4})$/);
+  return match ? match[1].toUpperCase() : void 0;
+}
+var LedgerWebHidConnector = class extends LedgerConnectorBase {
+  constructor(options) {
+    super(
+      async () => {
+        const { webHidTransportFactory } = await import("@ledgerhq/device-transport-kit-web-hid");
+        return webHidTransportFactory;
+      },
+      { connectionType: "usb", dmk: options?.dmk }
+    );
+  }
+  /**
+   * Override connectId resolution for BLE devices discovered via WebHID+BLE combo.
+   * For USB devices, the DMK path (ephemeral UUID) is used as-is.
+   */
+  _resolveConnectId(descriptor) {
+    if (descriptor.transport === "BLE") {
+      return extractBleHexId(descriptor.name) || descriptor.path;
+    }
+    return descriptor.path;
+  }
+};
+
+// src/index.ts
+function createLedgerWebHidConnector(dmk) {
+  return new LedgerWebHidConnector({ dmk });
+}
+export {
+  LedgerWebHidConnector,
+  createLedgerWebHidConnector
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/LedgerWebHidConnector.ts","../src/index.ts"],"sourcesContent":["import type { DeviceDescriptor } from '@onekeyfe/hwk-adapter-core';\nimport type { DeviceManagementKit } from '@ledgerhq/device-management-kit';\nimport { LedgerConnectorBase } from '@onekeyfe/hwk-ledger-adapter';\n\n// ---------------------------------------------------------------------------\n// Utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Extract the stable 4-digit HEX identifier from a Ledger BLE device name.\n * e.g., \"Nano X 123A\" -> \"123A\", \"Ledger Nano X AB12\" -> \"AB12\"\n * Returns undefined if no valid HEX suffix found.\n */\nfunction extractBleHexId(name?: string): string | undefined {\n  if (!name) return undefined;\n  const match = name.match(/\\b([0-9A-Fa-f]{4})$/);\n  return match ? match[1].toUpperCase() : undefined;\n}\n\n// ---------------------------------------------------------------------------\n// LedgerWebHidConnector\n// ---------------------------------------------------------------------------\n\nexport interface LedgerWebHidConnectorOptions {\n  /**\n   * Pre-built DMK instance. If not provided, a DMK will be created\n   * lazily on first use via `@ledgerhq/device-management-kit` and\n   * `@ledgerhq/device-transport-kit-web-hid`.\n   */\n  dmk?: DeviceManagementKit;\n}\n\n/**\n * IConnector implementation for Ledger hardware wallets via WebHID.\n *\n * Extends LedgerConnectorBase with the WebHID transport factory.\n * Overrides connectId resolution to handle BLE devices that may appear\n * via a WebHID+BLE combo transport.\n */\nexport class LedgerWebHidConnector extends LedgerConnectorBase {\n  constructor(options?: LedgerWebHidConnectorOptions) {\n    super(\n      async () => {\n        const { webHidTransportFactory } = await import('@ledgerhq/device-transport-kit-web-hid');\n        return webHidTransportFactory;\n      },\n      { connectionType: 'usb', dmk: options?.dmk }\n    );\n  }\n\n  /**\n   * Override connectId resolution for BLE devices discovered via WebHID+BLE combo.\n   * For USB devices, the DMK path (ephemeral UUID) is used as-is.\n   */\n  protected override _resolveConnectId(descriptor: DeviceDescriptor): string {\n    if (descriptor.transport === 'BLE') {\n      return extractBleHexId(descriptor.name) || descriptor.path;\n    }\n    return descriptor.path;\n  }\n}\n","import type { IConnector } from '@onekeyfe/hwk-adapter-core';\nimport type { DeviceManagementKit } from '@ledgerhq/device-management-kit';\n\nimport { LedgerWebHidConnector } from './LedgerWebHidConnector';\nimport type { LedgerWebHidConnectorOptions } from './LedgerWebHidConnector';\n\nexport { LedgerWebHidConnector };\nexport type { LedgerWebHidConnectorOptions };\n\n/**\n * Create a LedgerWebHidConnector.\n *\n * @param dmk - Optional pre-built DMK instance. If omitted, the connector\n *              will lazily create one using `@ledgerhq/device-management-kit`\n *              and `@ledgerhq/device-transport-kit-web-hid`.\n */\nexport function createLedgerWebHidConnector(dmk?: DeviceManagementKit): IConnector {\n  return new LedgerWebHidConnector({ dmk });\n}\n"],"mappings":";AAEA,SAAS,2BAA2B;AAWpC,SAAS,gBAAgB,MAAmC;AAC1D,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,QAAQ,KAAK,MAAM,qBAAqB;AAC9C,SAAO,QAAQ,MAAM,CAAC,EAAE,YAAY,IAAI;AAC1C;AAsBO,IAAM,wBAAN,cAAoC,oBAAoB;AAAA,EAC7D,YAAY,SAAwC;AAClD;AAAA,MACE,YAAY;AACV,cAAM,EAAE,uBAAuB,IAAI,MAAM,OAAO,wCAAwC;AACxF,eAAO;AAAA,MACT;AAAA,MACA,EAAE,gBAAgB,OAAO,KAAK,SAAS,IAAI;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMmB,kBAAkB,YAAsC;AACzE,QAAI,WAAW,cAAc,OAAO;AAClC,aAAO,gBAAgB,WAAW,IAAI,KAAK,WAAW;AAAA,IACxD;AACA,WAAO,WAAW;AAAA,EACpB;AACF;;;AC5CO,SAAS,4BAA4B,KAAuC;AACjF,SAAO,IAAI,sBAAsB,EAAE,IAAI,CAAC;AAC1C;","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@onekeyfe/hwk-ledger-connector-webhid",
+  "version": "1.1.26-alpha.100",
+  "description": "IConnector implementation for Ledger hardware wallets via WebHID (DMK)",
+  "author": "OneKey",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rimraf dist",
+    "test": "vitest run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OneKeyHQ/hardware-wallet-kit.git",
+    "directory": "packages/hwk-ledger-connector-webhid"
+  },
+  "keywords": [
+    "ledger",
+    "webhid",
+    "hardware-wallet",
+    "onekey",
+    "connector"
+  ],
+  "dependencies": {
+    "@ledgerhq/device-management-kit": "^1.1.0",
+    "@ledgerhq/device-signer-kit-bitcoin": "^1.0.0",
+    "@ledgerhq/device-signer-kit-ethereum": "^1.9.0",
+    "@ledgerhq/device-signer-kit-solana": "^1.7.0",
+    "@ledgerhq/device-transport-kit-web-hid": "^1.0.0",
+    "@onekeyfe/hwk-adapter-core": "1.1.26-alpha.100",
+    "@onekeyfe/hwk-ledger-adapter": "1.1.26-alpha.100"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "gitHead": "02e9376cb38df57b5743b674326c742fa74d1e8b"
+}