@ledgerhq/speculos-transport 0.1.8-nightly.0

package/.eslintrc.js

@@ -0,0 +1,33 @@
+module.exports = {
+  settings: {
+    react: {
+      version: "detect",
+    },
+  },
+  env: {
+    browser: true,
+    es6: true,
+  },
+  globals: {
+    Atomics: "readonly",
+    SharedArrayBuffer: "readonly",
+  },
+  extends: ["plugin:import/typescript", "plugin:jsx-a11y/recommended"],
+  plugins: ["import", "jsx-a11y"],
+  rules: {
+    "no-console": ["error", { allow: ["warn", "error"] }],
+    "linebreak-style": ["error", "unix"],
+    "@typescript-eslint/no-empty-function": "off",
+    "@typescript-eslint/no-namespace": ["error", { allowDeclarations: true }],
+    "@typescript-eslint/no-explicit-any": "warn",
+  },
+  overrides: [
+    {
+      files: ["src/**/*.test.{ts,tsx}"],
+      env: {
+        "jest/globals": true,
+      },
+      plugins: ["jest"],
+    },
+  ],
+};

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ledgerhq/speculos-transport@0.1.8-nightly.0 build /home/runner/work/ledger-live/ledger-live/libs/speculos-transport
+> tsc && tsc -m ES6 --outDir lib-es
+

package/.unimportedrc.json

@@ -0,0 +1,4 @@
+{
+  "entry": ["src/index.ts"],
+  "ignoreUnused": []
+}

package/CHANGELOG.md

@@ -0,0 +1,132 @@
+# @ledgerhq/speculos-transport
+
+## 0.1.8-nightly.0
+
+### Patch Changes
+
+- Updated dependencies [[`5c13c7b`](https://github.com/LedgerHQ/ledger-live/commit/5c13c7bf743333f09cbfee720d275dfae7e157d2)]:
+  - @ledgerhq/live-env@2.4.1-nightly.0
+
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies [[`ced792c`](https://github.com/LedgerHQ/ledger-live/commit/ced792c37b42135f2b7596228c14ccd0783a803f)]:
+  - @ledgerhq/live-env@2.4.0
+
+## 0.1.7-next.0
+
+### Patch Changes
+
+- Updated dependencies [[`ced792c`](https://github.com/LedgerHQ/ledger-live/commit/ced792c37b42135f2b7596228c14ccd0783a803f)]:
+  - @ledgerhq/live-env@2.4.0-next.0
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [[`f805d14`](https://github.com/LedgerHQ/ledger-live/commit/f805d1470f927824233f94eaba065b00d7af18cf)]:
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.4
+  - @ledgerhq/devices@8.4.4
+  - @ledgerhq/hw-transport-node-speculos@6.29.4
+
+## 0.1.6-next.1
+
+### Patch Changes
+
+- Updated dependencies [[`f805d14`](https://github.com/LedgerHQ/ledger-live/commit/f805d1470f927824233f94eaba065b00d7af18cf)]:
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.4-next.1
+
+## 0.1.6-next.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @ledgerhq/devices@8.4.4-next.0
+  - @ledgerhq/hw-transport-node-speculos@6.29.4-next.0
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.4-next.0
+
+## 0.1.5
+
+### Patch Changes
+
+- [#7672](https://github.com/LedgerHQ/ledger-live/pull/7672) [`fb9466a`](https://github.com/LedgerHQ/ledger-live/commit/fb9466a4d7827fd4759c726ad3ae0b43dddcacd3) Thanks [@hzheng-ledger](https://github.com/hzheng-ledger)! - Add support for jettons
+
+- Updated dependencies [[`187293c`](https://github.com/LedgerHQ/ledger-live/commit/187293c6cf6093f15f07d5effc1ded0843a9e6ab), [`5758950`](https://github.com/LedgerHQ/ledger-live/commit/5758950841fbf8018dd848e745017484aec67333), [`4799d5d`](https://github.com/LedgerHQ/ledger-live/commit/4799d5de3fb1dcef2b01de31fe29b59e76922576), [`eb9a36f`](https://github.com/LedgerHQ/ledger-live/commit/eb9a36f6ee8487c9ffbb841c3e6c0ca84f68bb0a)]:
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.3
+  - @ledgerhq/live-env@2.3.0
+  - @ledgerhq/devices@8.4.3
+  - @ledgerhq/hw-transport-node-speculos@6.29.3
+
+## 0.1.5-next.0
+
+### Patch Changes
+
+- [#7672](https://github.com/LedgerHQ/ledger-live/pull/7672) [`fb9466a`](https://github.com/LedgerHQ/ledger-live/commit/fb9466a4d7827fd4759c726ad3ae0b43dddcacd3) Thanks [@hzheng-ledger](https://github.com/hzheng-ledger)! - Add support for jettons
+
+- Updated dependencies [[`187293c`](https://github.com/LedgerHQ/ledger-live/commit/187293c6cf6093f15f07d5effc1ded0843a9e6ab), [`5758950`](https://github.com/LedgerHQ/ledger-live/commit/5758950841fbf8018dd848e745017484aec67333), [`4799d5d`](https://github.com/LedgerHQ/ledger-live/commit/4799d5de3fb1dcef2b01de31fe29b59e76922576), [`eb9a36f`](https://github.com/LedgerHQ/ledger-live/commit/eb9a36f6ee8487c9ffbb841c3e6c0ca84f68bb0a)]:
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.3-next.0
+  - @ledgerhq/live-env@2.3.0-next.0
+  - @ledgerhq/devices@8.4.3-next.0
+  - @ledgerhq/hw-transport-node-speculos@6.29.3-next.0
+
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies [[`4bd91de`](https://github.com/LedgerHQ/ledger-live/commit/4bd91de13442d12acce3ee83d5f2fd5f087570cf), [`52daa39`](https://github.com/LedgerHQ/ledger-live/commit/52daa3998709ac3538afd447fe771faa3e3441be), [`60f1b5c`](https://github.com/LedgerHQ/ledger-live/commit/60f1b5c6cab125f5281468bb3e36f1abfae2d70c)]:
+  - @ledgerhq/live-env@2.2.0
+
+## 0.1.4-next.0
+
+### Patch Changes
+
+- Updated dependencies [[`4bd91de`](https://github.com/LedgerHQ/ledger-live/commit/4bd91de13442d12acce3ee83d5f2fd5f087570cf), [`52daa39`](https://github.com/LedgerHQ/ledger-live/commit/52daa3998709ac3538afd447fe771faa3e3441be), [`60f1b5c`](https://github.com/LedgerHQ/ledger-live/commit/60f1b5c6cab125f5281468bb3e36f1abfae2d70c)]:
+  - @ledgerhq/live-env@2.2.0-next.0
+
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies [[`0b12c90`](https://github.com/LedgerHQ/ledger-live/commit/0b12c9040d6ee0a326b1d5effd261ddee2db452f)]:
+  - @ledgerhq/devices@8.4.2
+  - @ledgerhq/hw-transport-node-speculos@6.29.2
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.2
+
+## 0.1.3-hotfix.0
+
+### Patch Changes
+
+- Updated dependencies [[`5d508e5`](https://github.com/LedgerHQ/ledger-live/commit/5d508e5cfd296e458746adf176dd292aa884f7ea)]:
+  - @ledgerhq/devices@8.4.2-hotfix.0
+  - @ledgerhq/hw-transport-node-speculos@6.29.2-hotfix.0
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.2-hotfix.0
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @ledgerhq/devices@8.4.1
+  - @ledgerhq/hw-transport-node-speculos@6.29.1
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.1
+
+## 0.1.2-next.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @ledgerhq/devices@8.4.1-next.0
+  - @ledgerhq/hw-transport-node-speculos@6.29.1-next.0
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.1-next.0
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [[`77fa530`](https://github.com/LedgerHQ/ledger-live/commit/77fa530c8626df94fa7f9c0a8b3a99f2efa7cb11), [`6d44f25`](https://github.com/LedgerHQ/ledger-live/commit/6d44f255c5b2f453c61d0b754807db1f76d7174e), [`3b9c93c`](https://github.com/LedgerHQ/ledger-live/commit/3b9c93c0de8ceff2af96a6ee8e42b8d9c2ab7af0), [`6623cd1`](https://github.com/LedgerHQ/ledger-live/commit/6623cd13102bd8340bd7d4dfdd469934527985c3), [`f363430`](https://github.com/LedgerHQ/ledger-live/commit/f363430fe1a261f8adb79d3bf30e457cba839783), [`6552679`](https://github.com/LedgerHQ/ledger-live/commit/65526794bb4d1fbc7e286c0e1c0b6d021413fc8c)]:
+  - @ledgerhq/hw-transport-node-speculos-http@6.29.0
+  - @ledgerhq/hw-transport-node-speculos@6.29.0
+  - @ledgerhq/devices@8.4.0
+  - @ledgerhq/live-promise@0.1.0
+  - @ledgerhq/live-env@2.1.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2017-present Ledger https://www.ledger.com/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+## speculos-transport
+
+Ledger Live speculos transport test helper
+
+## API
+
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+#### Table of Contents
+
+*   [releaseSpeculosDevice](#releasespeculosdevice)
+    *   [Parameters](#parameters)
+*   [closeAllSpeculosDevices](#closeallspeculosdevices)
+*   [createSpeculosDevice](#createspeculosdevice)
+    *   [Parameters](#parameters-1)
+
+### releaseSpeculosDevice
+
+Release a speculos device
+
+#### Parameters
+
+*   `id` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
+
+### closeAllSpeculosDevices
+
+Close all speculos devices
+
+### createSpeculosDevice
+
+instanciate a speculos device that runs through docker
+
+#### Parameters
+
+*   `arg` **{model: DeviceModelId, firmware: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), appName: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), appVersion: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), dependency: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?, seed: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), coinapps: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), overridesAppPath: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?, onSpeculosDeviceCreated: function (device: SpeculosDevice): [Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<void>?}**&#x20;
+*   `maxRetry`   (optional, default `3`)
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<SpeculosDevice>**&#x20;

package/lib/index.d.ts

@@ -0,0 +1,69 @@
+/// <reference types="node" />
+import { ChildProcessWithoutNullStreams } from "child_process";
+import { DeviceModelId } from "@ledgerhq/devices";
+import SpeculosTransportHttp from "@ledgerhq/hw-transport-node-speculos-http";
+import SpeculosTransportWebsocket from "@ledgerhq/hw-transport-node-speculos";
+export type SpeculosDevice = {
+    transport: SpeculosTransport;
+    id: string;
+    appPath: string;
+    ports: ReturnType<typeof getPorts>;
+};
+export type SpeculosTransport = SpeculosTransportHttp | SpeculosTransportWebsocket;
+export { DeviceModelId };
+export type SpeculosDeviceInternal = {
+    process: ChildProcessWithoutNullStreams;
+    apduPort: number;
+    buttonPort: number;
+    automationPort: number;
+    transport: SpeculosTransportWebsocket;
+    destroy: () => void;
+} | {
+    process: ChildProcessWithoutNullStreams;
+    apiPort: string | undefined;
+    transport: SpeculosTransportHttp;
+    destroy: () => void;
+};
+export declare function getMemorySpeculosDeviceInternal(id: string): SpeculosDeviceInternal | undefined;
+export declare const modelMap: Record<string, DeviceModelId>;
+/**
+ * Release a speculos device
+ */
+export declare function releaseSpeculosDevice(id: string): Promise<void>;
+/**
+ * Close all speculos devices
+ */
+export declare function closeAllSpeculosDevices(): Promise<void[]>;
+declare const getPorts: (idCounter: number, isSpeculosWebsocket?: boolean) => {
+    apduPort: number;
+    vncPort: number;
+    buttonPort: number;
+    automationPort: number;
+    apiPort?: undefined;
+} | {
+    apiPort: number;
+    vncPort: number;
+    apduPort?: undefined;
+    buttonPort?: undefined;
+    automationPort?: undefined;
+};
+interface Dependency {
+    name: string;
+    appVersion?: string;
+}
+/**
+ * instanciate a speculos device that runs through docker
+ */
+export declare function createSpeculosDevice(arg: {
+    model: DeviceModelId;
+    firmware: string;
+    appName: string;
+    appVersion: string;
+    dependency?: string;
+    dependencies?: Dependency[];
+    seed: string;
+    coinapps: string;
+    overridesAppPath?: string;
+    onSpeculosDeviceCreated?: (device: SpeculosDevice) => Promise<void>;
+}, maxRetry?: number): Promise<SpeculosDevice>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,OAAO,EAAe,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,qBAAqB,MAAM,2CAA2C,CAAC;AAC9E,OAAO,0BAA0B,MAAM,sCAAsC,CAAC;AAI9E,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,0BAA0B,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,MAAM,sBAAsB,GAC9B;IACE,OAAO,EAAE,8BAA8B,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,0BAA0B,CAAC;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,GACD;IACE,OAAO,EAAE,8BAA8B,CAAC;IACxC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,qBAAqB,CAAC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAON,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAE9F;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAKlD,CAAC;AAMF;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,iBAOrD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,oBAEtC;AAmBD,QAAA,MAAM,QAAQ,cAAe,MAAM,wBAAwB,OAAO;;;;;;;;;;;;CAcjE,CAAC;AAWF,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE;IACH,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IAEjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE,EACD,QAAQ,SAAI,GACX,OAAO,CAAC,cAAc,CAAC,CAuMzB"}

package/lib/index.js

@@ -0,0 +1,280 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpeculosDevice = exports.closeAllSpeculosDevices = exports.releaseSpeculosDevice = exports.modelMap = exports.getMemorySpeculosDeviceInternal = exports.DeviceModelId = void 0;
+const child_process_1 = require("child_process");
+const logs_1 = require("@ledgerhq/logs");
+const devices_1 = require("@ledgerhq/devices");
+Object.defineProperty(exports, "DeviceModelId", { enumerable: true, get: function () { return devices_1.DeviceModelId; } });
+const hw_transport_node_speculos_http_1 = __importDefault(require("@ledgerhq/hw-transport-node-speculos-http"));
+const hw_transport_node_speculos_1 = __importDefault(require("@ledgerhq/hw-transport-node-speculos"));
+const live_env_1 = require("@ledgerhq/live-env");
+const live_promise_1 = require("@ledgerhq/live-promise");
+// FIXME we need to figure out a better system, using a filesystem file?
+let idCounter;
+const isSpeculosWebsocket = (0, live_env_1.getEnv)("SPECULOS_USE_WEBSOCKET");
+const data = {};
+function getMemorySpeculosDeviceInternal(id) {
+    return data[id];
+}
+exports.getMemorySpeculosDeviceInternal = getMemorySpeculosDeviceInternal;
+exports.modelMap = {
+    nanos: devices_1.DeviceModelId.nanoS,
+    "nanos+": devices_1.DeviceModelId.nanoSP,
+    nanox: devices_1.DeviceModelId.nanoX,
+    blue: devices_1.DeviceModelId.blue,
+};
+const reverseModelMap = {};
+for (const k in exports.modelMap) {
+    reverseModelMap[exports.modelMap[k]] = k;
+}
+/**
+ * Release a speculos device
+ */
+function releaseSpeculosDevice(id) {
+    return __awaiter(this, void 0, void 0, function* () {
+        (0, logs_1.log)("speculos", "release " + id);
+        const obj = data[id];
+        if (obj) {
+            yield obj.destroy();
+        }
+    });
+}
+exports.releaseSpeculosDevice = releaseSpeculosDevice;
+/**
+ * Close all speculos devices
+ */
+function closeAllSpeculosDevices() {
+    return Promise.all(Object.keys(data).map(releaseSpeculosDevice));
+}
+exports.closeAllSpeculosDevices = closeAllSpeculosDevices;
+// to keep in sync from https://github.com/LedgerHQ/speculos/tree/master/speculos/cxlib
+const existingSdks = [
+    "nanos-cx-2.0.elf",
+    "nanos-cx-2.1.elf",
+    "nanosp-cx-1.0.3.elf",
+    "nanosp-cx-1.0.elf",
+    "nanox-cx-2.0.2.elf",
+    "nanox-cx-2.0.elf",
+];
+function inferSDK(firmware, model) {
+    const begin = `${model.toLowerCase()}-cx-`;
+    if (existingSdks.includes(begin + firmware + ".elf"))
+        return firmware;
+    const shortVersion = firmware.slice(0, 3);
+    if (existingSdks.includes(begin + shortVersion + ".elf"))
+        return shortVersion;
+}
+const getPorts = (idCounter, isSpeculosWebsocket) => {
+    if (isSpeculosWebsocket) {
+        const apduPort = 30000 + idCounter;
+        const vncPort = 35000 + idCounter;
+        const buttonPort = 40000 + idCounter;
+        const automationPort = 45000 + idCounter;
+        return { apduPort, vncPort, buttonPort, automationPort };
+    }
+    else {
+        const apiPort = 30000 + idCounter;
+        const vncPort = 35000 + idCounter;
+        return { apiPort, vncPort };
+    }
+};
+function conventionalAppSubpath(model, firmware, appName, appVersion) {
+    return `${reverseModelMap[model]}/${firmware}/${appName.replace(/ /g, "")}/app_${appVersion}.elf`;
+}
+/**
+ * instanciate a speculos device that runs through docker
+ */
+function createSpeculosDevice(arg_1) {
+    return __awaiter(this, arguments, void 0, function* (arg, maxRetry = 3) {
+        var _a, _b, _c;
+        const { overridesAppPath, model, firmware, appName, appVersion, seed, coinapps, dependency, dependencies, } = arg;
+        idCounter = idCounter !== null && idCounter !== void 0 ? idCounter : (0, live_env_1.getEnv)("SPECULOS_PID_OFFSET");
+        const speculosID = `speculosID-${++idCounter}`;
+        const ports = getPorts(idCounter, isSpeculosWebsocket);
+        const sdk = inferSDK(firmware, model);
+        const subpath = overridesAppPath || conventionalAppSubpath(model, firmware, appName, appVersion);
+        const appPath = `./apps/${subpath}`;
+        const params = [
+            "run",
+            "-v",
+            `${coinapps}:/speculos/apps`,
+            ...(isSpeculosWebsocket
+                ? [
+                    // websocket ports
+                    "-p",
+                    `${ports.apduPort}:40000`,
+                    "-p",
+                    `${ports.vncPort}:41000`,
+                    "-p",
+                    `${ports.buttonPort}:42000`,
+                    "-p",
+                    `${ports.automationPort}:43000`,
+                ]
+                : [
+                    // http ports
+                    "-p",
+                    `${ports.apiPort}:40000`,
+                    "-p",
+                    `${ports.vncPort}:41000`,
+                ]),
+            "-e",
+            `SPECULOS_APPNAME=${appName}:${appVersion}`,
+            "--name",
+            `${speculosID}`,
+            (_a = process.env.SPECULOS_IMAGE_TAG) !== null && _a !== void 0 ? _a : "ghcr.io/ledgerhq/speculos:sha-e262a0c",
+            "--model",
+            model.toLowerCase(),
+            appPath,
+            ...(dependency
+                ? [
+                    "-l",
+                    `${dependency}:./apps/${conventionalAppSubpath(model, firmware, dependency, appVersion)}`,
+                ]
+                : []),
+            ...(dependencies !== undefined
+                ? dependencies.flatMap(dependency => [
+                    "-l",
+                    `${dependency.name}:./apps/${conventionalAppSubpath(model, firmware, dependency.name, dependency.appVersion ? dependency.appVersion : "1.0.0")}`,
+                ])
+                : []),
+            ...(sdk ? ["--sdk", sdk] : []),
+            "--display",
+            "headless",
+            ...(process.env.CI ? ["--vnc-password", "live", "--vnc-port", "41000"] : []),
+            ...(isSpeculosWebsocket
+                ? [
+                    // websocket ports
+                    "--apdu-port",
+                    "40000",
+                    "--button-port",
+                    "42000",
+                    "--automation-port",
+                    "43000",
+                ]
+                : [
+                    // http ports
+                    "--api-port",
+                    "40000",
+                ]),
+        ];
+        (0, logs_1.log)("speculos", `${speculosID}: spawning = ${params.join(" ")}`);
+        const p = (0, child_process_1.spawn)("docker", [...params, "--seed", `${seed}`]);
+        let resolveReady;
+        let rejectReady;
+        const ready = new Promise((resolve, reject) => {
+            resolveReady = resolve;
+            rejectReady = reject;
+        });
+        let destroyed = false;
+        const destroy = () => {
+            if (destroyed)
+                return;
+            destroyed = true;
+            new Promise((resolve, reject) => {
+                if (!data[speculosID])
+                    return;
+                delete data[speculosID];
+                (0, child_process_1.exec)(`docker rm -f ${speculosID}`, (error, stdout, stderr) => {
+                    if (error) {
+                        (0, logs_1.log)("speculos-error", `${speculosID} not destroyed ${error} ${stderr}`);
+                        reject(error);
+                    }
+                    else {
+                        (0, logs_1.log)("speculos", `destroyed ${speculosID}`);
+                        resolve(undefined);
+                    }
+                });
+            });
+        };
+        p.stdout.on("data", data => {
+            if (data) {
+                (0, logs_1.log)("speculos-stdout", `${speculosID}: ${String(data).trim()}`);
+            }
+        });
+        let latestStderr;
+        p.stderr.on("data", data => {
+            if (!data)
+                return;
+            latestStderr = data;
+            if (!data.includes("apdu: ")) {
+                (0, logs_1.log)("speculos-stderr", `${speculosID}: ${String(data).trim()}`);
+            }
+            if (/using\s(?:SDK|API_LEVEL)/.test(data)) {
+                setTimeout(() => resolveReady(true), 500);
+            }
+            else if (data.includes("is already in use by container")) {
+                rejectReady(new Error("speculos already in use! Try `ledger-live cleanSpeculos` or check logs"));
+            }
+            else if (data.includes("address already in use")) {
+                if (maxRetry > 0) {
+                    (0, logs_1.log)("speculos", "retrying speculos connection");
+                    destroy();
+                    resolveReady(false);
+                }
+            }
+        });
+        p.on("close", () => {
+            (0, logs_1.log)("speculos", `${speculosID} closed`);
+            if (!destroyed) {
+                destroy();
+                rejectReady(new Error(`speculos process failure. ${latestStderr || ""}`));
+            }
+        });
+        const hasSucceed = yield ready;
+        if (!hasSucceed) {
+            yield (0, live_promise_1.delay)(1000);
+            return createSpeculosDevice(arg, maxRetry - 1);
+        }
+        let transport;
+        if (isSpeculosWebsocket) {
+            transport = yield hw_transport_node_speculos_1.default.open({
+                apduPort: ports === null || ports === void 0 ? void 0 : ports.apduPort,
+                buttonPort: ports === null || ports === void 0 ? void 0 : ports.buttonPort,
+                automationPort: ports === null || ports === void 0 ? void 0 : ports.automationPort,
+            });
+            data[speculosID] = {
+                process: p,
+                apduPort: ports.apduPort,
+                buttonPort: ports.buttonPort,
+                automationPort: ports.automationPort,
+                transport,
+                destroy,
+            };
+        }
+        else {
+            transport = yield hw_transport_node_speculos_http_1.default.open({
+                apiPort: (_b = ports.apiPort) === null || _b === void 0 ? void 0 : _b.toString(),
+            });
+            data[speculosID] = {
+                process: p,
+                apiPort: (_c = ports.apiPort) === null || _c === void 0 ? void 0 : _c.toString(),
+                transport,
+                destroy,
+            };
+        }
+        const device = {
+            id: speculosID,
+            transport,
+            appPath,
+            ports,
+        };
+        if (arg.onSpeculosDeviceCreated != null) {
+            yield arg.onSpeculosDeviceCreated(device);
+        }
+        return device;
+    });
+}
+exports.createSpeculosDevice = createSpeculosDevice;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}