@ledgerhq/coin-tester 0.1.0

package/.eslintrc.js

@@ -0,0 +1,20 @@
+module.exports = {
+  env: {
+    browser: true,
+    es6: true,
+  },
+  ignorePatterns: ["lib", "lib-es", ".turbo"],
+  overrides: [
+    {
+      files: ["src/**/*.test.{ts,tsx}"],
+      env: {
+        "jest/globals": true,
+      },
+      plugins: ["jest"],
+    },
+  ],
+  rules: {
+    "@typescript-eslint/no-empty-function": "off",
+    "@typescript-eslint/no-explicit-any": "warn",
+  },
+};

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ledgerhq/coin-tester@0.1.0 build /home/runner/work/ledger-live/ledger-live/libs/coin-tester
+> tsc && tsc -m ES6 --outDir lib-es
+

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,43 @@
+# Coin-tester
+
+## Getting started
+
+### Prerequisites
+
+- [Docker](https://docs.docker.com/engine/install/)
+
+### Build the speculos image
+
+You only have to build speculos locally if you are on a Mac M1. Otherwise you can uncomment the image provided in the docker-compose.yml
+
+1. Clone speculos repo 
+3. docker build -f build.Dockerfile -t speculos-builder:latest .
+4 Patch Dockerfile:
+```Dockerfile
+# before
+FROM ghcr.io/ledgerhq/speculos-builder:latest AS builder
+# after
+FROM speculos-builder:latest AS builder
+```
+
+4. docker build -f Dockerfile -t speculos:latest .
+
+### Environment variables
+
+Go in the coin-module you want to test and create a `.env` in the folder where your test resides.
+For exemple for `coin-evm` create the file should be located in: `src/__test__/coin-test/.env`.
+
+If availble you can copy the `.env.example`.
+
+```bash
+cp .env.example .env
+```
+
+A `.env` should have at the very least the following attributes:
+
+```conf
+SEED=12 words
+```
+
+Generate a new seed using [this tool](https://iancoleman.io/bip39/)
+Generate a Github token as [described here](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)

package/docker-compose.yml

@@ -0,0 +1,15 @@
+version: '2.4'
+
+services:
+  speculos:
+    # Speculos isn't supported for Mac M1 yet. You have to build the image locally as described in the README.
+    # Otherwise you can use the official image
+    # image: ghcr.io/ledgerhq/speculos:latest
+    image: ${SPECULOS_IMAGE:-ghcr.io/ledgerhq/speculos}:latest
+    volumes:
+      - ./lib/signers/tmp:/speculos/apps
+    ports:
+      - "${API_PORT}:${API_PORT}"
+    build:
+      context: /speculos
+    command: --model nanox ./apps/app.elf --seed="${SEED}" --display headless --api-port ${API_PORT}

package/jest.config.js

@@ -0,0 +1,9 @@
+/** @type {import('ts-jest/dist/types').InitialOptionsTsJest} */
+module.exports = {
+  verbose: true,
+  preset: "ts-jest",
+  testEnvironment: "node",
+  testRegex: ".(test|spec).[jt]sx?$",
+  moduleDirectories: ["node_modules"],
+  setupFiles: ["dotenv/config"],
+};

package/lib/main.d.ts

@@ -0,0 +1,30 @@
+import { AccountBridge, Account, TransactionCommon, SignOperationEvent, CurrencyBridge } from "@ledgerhq/types-live";
+export type ScenarioTransaction<T extends TransactionCommon> = Partial<T> & {
+    name: string;
+    /**
+     *
+     * @param previousAccount previousAccount returned by the latest sync before broadcasting this transaction
+     * @param currentAccount currentAccount synced after broadcasting this transaction
+     * @returns void
+     */
+    expect?: (previousAccount: Account, currentAccount: Account) => void;
+};
+export type Scenario<T extends TransactionCommon> = {
+    name: string;
+    setup: () => Promise<{
+        accountBridge: AccountBridge<T>;
+        currencyBridge: CurrencyBridge;
+        account: Account;
+        retryInterval?: number;
+        retryLimit?: number;
+        onSignerConfirmation?: (e?: SignOperationEvent) => Promise<void>;
+    }>;
+    getTransactions: (address: string) => ScenarioTransaction<T>[];
+    beforeAll?: (account: Account) => Promise<void> | void;
+    afterAll?: (account: Account) => Promise<void> | void;
+    beforeEach?: (account: Account) => Promise<void> | void;
+    afterEach?: (account: Account) => Promise<void> | void;
+    teardown?: () => Promise<void> | void;
+};
+export declare function executeScenario<T extends TransactionCommon>(scenario: Scenario<T>): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/lib/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,iBAAiB,IAAI;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC;QACnB,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;QAChC,cAAc,EAAE,cAAc,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAClE,CAAC,CAAC;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF,wBAAsB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,iBAuMvF"}

package/lib/main.js

@@ -0,0 +1,121 @@
+"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.executeScenario = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const rxjs_1 = require("rxjs");
+function executeScenario(scenario) {
+    var _a, _b, _c, _d, _e, _f;
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const { accountBridge, currencyBridge, account, retryInterval, retryLimit, onSignerConfirmation, } = yield scenario.setup();
+            console.log("Setup completed ✓");
+            console.log("\n");
+            console.log(chalk_1.default.bgBlue("     Address     "), " → ", chalk_1.default.bold.blue(account.freshAddress), "\n\n");
+            const data = yield currencyBridge.preload(account.currency);
+            currencyBridge.hydrate(data, account.currency);
+            console.log("Preload + hydrate completed ✓");
+            console.log("Running a synchronization on the account...");
+            let scenarioAccount = yield (0, rxjs_1.firstValueFrom)(accountBridge
+                .sync(account, { paginationConfig: {} })
+                .pipe((0, rxjs_1.reduce)((acc, f) => f(acc), account)));
+            console.log("Synchronization completed ✓");
+            yield ((_a = scenario.beforeAll) === null || _a === void 0 ? void 0 : _a.call(scenario, scenarioAccount));
+            console.log("BeforeAll completed ✓");
+            console.log("\n\n");
+            console.log(chalk_1.default.bgCyan.black.bold(" ✧ "), " ", chalk_1.default.cyan(`Scenario: ${chalk_1.default.italic.bold(scenario.name)}`), " ", chalk_1.default.bgCyan.black.bold(" ✧ "), " → ", chalk_1.default.bold.cyan(" Starting  ◌"));
+            const scenarioTransactions = scenario.getTransactions(account.freshAddress);
+            for (const testTransaction of scenarioTransactions) {
+                console.log("\n");
+                console.log(chalk_1.default.cyan("Transaction:", chalk_1.default.bold(testTransaction.name), "◌"));
+                (_b = scenario.beforeEach) === null || _b === void 0 ? void 0 : _b.call(scenario, scenarioAccount);
+                console.log("Before each ✔️");
+                if (scenarioTransactions.indexOf(testTransaction) > 0) {
+                    scenarioAccount = yield (0, rxjs_1.firstValueFrom)(accountBridge
+                        .sync(scenarioAccount, { paginationConfig: {} })
+                        .pipe((0, rxjs_1.reduce)((acc, f) => f(acc), scenarioAccount)));
+                }
+                const previousAccount = Object.freeze(scenarioAccount);
+                const defaultTransaction = accountBridge.createTransaction(scenarioAccount);
+                const transaction = yield accountBridge.prepareTransaction(scenarioAccount, Object.assign(Object.assign({}, defaultTransaction), testTransaction));
+                console.log(" → ", "🧑‍🍳 ", chalk_1.default.bold("Prepared the transaction"), "✓");
+                const status = yield accountBridge.getTransactionStatus(scenarioAccount, transaction);
+                if (Object.entries(status.errors).length) {
+                    throw new Error(`Error in transaction status: ${JSON.stringify(status.errors, null, 3)}`);
+                }
+                console.log(" → ", "🪲  ", chalk_1.default.bold("No status errors detected"), "✓");
+                const { signedOperation } = yield (0, rxjs_1.firstValueFrom)(accountBridge
+                    .signOperation({
+                    account: scenarioAccount,
+                    transaction,
+                    deviceId: "",
+                })
+                    .pipe((0, rxjs_1.map)(e => {
+                    if (e.type === "device-signature-requested") {
+                        onSignerConfirmation === null || onSignerConfirmation === void 0 ? void 0 : onSignerConfirmation(e);
+                    }
+                    return e;
+                }), (0, rxjs_1.first)((e) => e.type === "signed")));
+                console.log(" → ", "🔏 ", chalk_1.default.bold("Signed the transaction"), "✓");
+                const optimisticOperation = yield accountBridge.broadcast({
+                    account: scenarioAccount,
+                    signedOperation,
+                });
+                console.log(" → ", "🛫 ", chalk_1.default.bold("Broadcasted the transaction"), "✓");
+                const retry_limit = retryLimit !== null && retryLimit !== void 0 ? retryLimit : 10;
+                const expectHandler = (retry) => __awaiter(this, void 0, void 0, function* () {
+                    var _g, _h;
+                    scenarioAccount = yield (0, rxjs_1.firstValueFrom)(accountBridge
+                        .sync(Object.assign(Object.assign({}, scenarioAccount), { pendingOperations: [optimisticOperation] }), { paginationConfig: {} })
+                        .pipe((0, rxjs_1.reduce)((acc, f) => f(acc), scenarioAccount)));
+                    if (!testTransaction.expect) {
+                        console.warn(chalk_1.default.yellow(`No expects in the transaction ${chalk_1.default.bold(testTransaction.name)}. You might want to add tests in this transaction.`));
+                    }
+                    try {
+                        (_g = testTransaction.expect) === null || _g === void 0 ? void 0 : _g.call(testTransaction, previousAccount, scenarioAccount);
+                    }
+                    catch (err) {
+                        if (!((_h = err === null || err === void 0 ? void 0 : err.matcherResult) === null || _h === void 0 ? void 0 : _h.pass)) {
+                            if (retry === 0) {
+                                console.error(chalk_1.default.red(`Retried 10 times and could not assert all expects for transaction ${chalk_1.default.bold(testTransaction.name)}`));
+                                throw err;
+                            }
+                            console.warn(chalk_1.default.magenta("Test asssertion failed. Retrying..."));
+                            yield new Promise(resolve => setTimeout(resolve, retryInterval !== null && retryInterval !== void 0 ? retryInterval : 5000));
+                            yield expectHandler(retry - 1);
+                        }
+                        throw err;
+                    }
+                });
+                yield expectHandler(retry_limit);
+                (_c = scenario.afterEach) === null || _c === void 0 ? void 0 : _c.call(scenario, scenarioAccount);
+                console.log("After each ✔️");
+                console.log(chalk_1.default.green("Transaction:", chalk_1.default.bold(testTransaction.name), "completed  ✓"));
+            }
+            console.log("\n");
+            yield ((_d = scenario.afterAll) === null || _d === void 0 ? void 0 : _d.call(scenario, scenarioAccount));
+            console.log("afterAll completed ✓");
+            console.log("Stopping engine...");
+            yield ((_e = scenario.teardown) === null || _e === void 0 ? void 0 : _e.call(scenario));
+            console.log("\n\n", chalk_1.default.bgGreen.black.bold(" ✧ "), " ", chalk_1.default.green(`Scenario: ${chalk_1.default.italic.bold(scenario.name)}`), " ", chalk_1.default.bgGreen.black.bold(" ✧ "), " → ", chalk_1.default.bold.green(" Completed  🎉"), "\n\n");
+        }
+        catch (err) {
+            console.error("\n\n", chalk_1.default.bgRed.black.bold(" ✧ "), " ", chalk_1.default.red(`Scenario: ${chalk_1.default.italic.bold(scenario.name)}`), " ", chalk_1.default.bgRed.black.bold(" ✧ "), " → ", chalk_1.default.bold.red(" Failed  ❌"), "\n\n");
+            yield ((_f = scenario.teardown) === null || _f === void 0 ? void 0 : _f.call(scenario));
+            throw err;
+        }
+    });
+}
+exports.executeScenario = executeScenario;
+//# sourceMappingURL=main.js.map

package/lib/main.js.map

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

package/lib/signers/speculos.d.ts

@@ -0,0 +1,8 @@
+import SpeculosTransportHttp from "@ledgerhq/hw-transport-node-speculos-http";
+import { SignOperationEvent } from "@ledgerhq/types-live";
+export declare const spawnSpeculos: (nanoAppEndpoint: `/${string}`) => Promise<{
+    transport: SpeculosTransportHttp;
+    onSignerConfirmation: (e?: SignOperationEvent) => Promise<void>;
+}>;
+export declare const killSpeculos: () => Promise<void>;
+//# sourceMappingURL=speculos.d.ts.map

package/lib/signers/speculos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculos.d.ts","sourceRoot":"","sources":["../../src/signers/speculos.ts"],"names":[],"mappings":"AAIA,OAAO,qBAAqB,MAAM,2CAA2C,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAO1D,eAAO,MAAM,aAAa,oBACP,IAAI,MAAM,EAAE;eAElB,qBAAqB;+BACL,kBAAkB,KAAK,QAAQ,IAAI,CAAC;EA6DhE,CAAC;AAEF,eAAO,MAAM,YAAY,qBAOxB,CAAC"}

package/lib/signers/speculos.js

@@ -0,0 +1,89 @@
+"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.killSpeculos = exports.spawnSpeculos = void 0;
+const path_1 = __importDefault(require("path"));
+const axios_1 = __importDefault(require("axios"));
+const promises_1 = __importDefault(require("fs/promises"));
+const docker_compose_1 = require("docker-compose");
+const hw_transport_node_speculos_http_1 = __importDefault(require("@ledgerhq/hw-transport-node-speculos-http"));
+const chalk_1 = __importDefault(require("chalk"));
+const { API_PORT } = process.env;
+const cwd = path_1.default.join(__dirname);
+const delay = (timing) => new Promise(resolve => setTimeout(resolve, timing));
+const spawnSpeculos = (nanoAppEndpoint) => __awaiter(void 0, void 0, void 0, function* () {
+    console.log(`Starting speculos...`);
+    const { data: blob } = yield (0, axios_1.default)({
+        url: `https://raw.githubusercontent.com/LedgerHQ/coin-apps/master/nanox${nanoAppEndpoint}`,
+        method: "GET",
+        responseType: "stream",
+        headers: {
+            Authorization: `Bearer ${process.env.GH_TOKEN}`,
+        },
+    });
+    yield promises_1.default.mkdir(path_1.default.resolve(cwd, "tmp"), { recursive: true });
+    yield promises_1.default.writeFile(path_1.default.resolve(cwd, "tmp/app.elf"), blob, "binary");
+    yield docker_compose_1.v2.upOne("speculos", {
+        cwd,
+        log: true,
+        env: process.env,
+    });
+    const checkSpeculosLogs = () => __awaiter(void 0, void 0, void 0, function* () {
+        const { out } = yield docker_compose_1.v2.logs("speculos", { cwd, env: process.env });
+        if (out.includes("Running on all addresses (0.0.0.0)")) {
+            console.log(chalk_1.default.bgYellowBright.black(" -  SPECULOS READY ✅  - "));
+            return hw_transport_node_speculos_http_1.default.open({
+                apiPort: API_PORT,
+            });
+        }
+        yield delay(200);
+        return checkSpeculosLogs();
+    });
+    const onSpeculosConfirmation = (e) => __awaiter(void 0, void 0, void 0, function* () {
+        if ((e === null || e === void 0 ? void 0 : e.type) === "device-signature-requested") {
+            const { data } = yield axios_1.default.get(`http://localhost:${process.env.API_PORT}/events?currentscreenonly=true`);
+            if (data.events[0].text !== "Accept") {
+                yield axios_1.default.post(`http://localhost:${process.env.API_PORT}/button/right`, {
+                    action: "press-and-release",
+                });
+                onSpeculosConfirmation(e);
+            }
+            else {
+                yield axios_1.default.post(`http://localhost:${process.env.API_PORT}/button/both`, {
+                    action: "press-and-release",
+                });
+            }
+        }
+    });
+    return checkSpeculosLogs().then(transport => {
+        return {
+            transport,
+            onSignerConfirmation: onSpeculosConfirmation,
+        };
+    });
+});
+exports.spawnSpeculos = spawnSpeculos;
+const killSpeculos = () => __awaiter(void 0, void 0, void 0, function* () {
+    console.log("Stopping speculos...");
+    yield docker_compose_1.v2.down({
+        cwd,
+        log: true,
+        env: process.env,
+    });
+});
+exports.killSpeculos = killSpeculos;
+["exit", "SIGINT", "SIGQUIT", "SIGTERM", "SIGUSR1", "SIGUSR2", "uncaughtException"].map(e => process.on(e, () => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, exports.killSpeculos)();
+})));
+//# sourceMappingURL=speculos.js.map

package/lib/signers/speculos.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,6 @@
+export type ENV = {
+    GH_TOKEN: string;
+    SEED: string;
+    API_PORT: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib-es/main.d.ts

@@ -0,0 +1,30 @@
+import { AccountBridge, Account, TransactionCommon, SignOperationEvent, CurrencyBridge } from "@ledgerhq/types-live";
+export type ScenarioTransaction<T extends TransactionCommon> = Partial<T> & {
+    name: string;
+    /**
+     *
+     * @param previousAccount previousAccount returned by the latest sync before broadcasting this transaction
+     * @param currentAccount currentAccount synced after broadcasting this transaction
+     * @returns void
+     */
+    expect?: (previousAccount: Account, currentAccount: Account) => void;
+};
+export type Scenario<T extends TransactionCommon> = {
+    name: string;
+    setup: () => Promise<{
+        accountBridge: AccountBridge<T>;
+        currencyBridge: CurrencyBridge;
+        account: Account;
+        retryInterval?: number;
+        retryLimit?: number;
+        onSignerConfirmation?: (e?: SignOperationEvent) => Promise<void>;
+    }>;
+    getTransactions: (address: string) => ScenarioTransaction<T>[];
+    beforeAll?: (account: Account) => Promise<void> | void;
+    afterAll?: (account: Account) => Promise<void> | void;
+    beforeEach?: (account: Account) => Promise<void> | void;
+    afterEach?: (account: Account) => Promise<void> | void;
+    teardown?: () => Promise<void> | void;
+};
+export declare function executeScenario<T extends TransactionCommon>(scenario: Scenario<T>): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/lib-es/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,iBAAiB,IAAI;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC;QACnB,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;QAChC,cAAc,EAAE,cAAc,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAClE,CAAC,CAAC;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF,wBAAsB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,iBAuMvF"}

package/lib-es/main.js

@@ -0,0 +1,114 @@
+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());
+    });
+};
+import chalk from "chalk";
+import { first, firstValueFrom, map, reduce } from "rxjs";
+export function executeScenario(scenario) {
+    var _a, _b, _c, _d, _e, _f;
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const { accountBridge, currencyBridge, account, retryInterval, retryLimit, onSignerConfirmation, } = yield scenario.setup();
+            console.log("Setup completed ✓");
+            console.log("\n");
+            console.log(chalk.bgBlue("     Address     "), " → ", chalk.bold.blue(account.freshAddress), "\n\n");
+            const data = yield currencyBridge.preload(account.currency);
+            currencyBridge.hydrate(data, account.currency);
+            console.log("Preload + hydrate completed ✓");
+            console.log("Running a synchronization on the account...");
+            let scenarioAccount = yield firstValueFrom(accountBridge
+                .sync(account, { paginationConfig: {} })
+                .pipe(reduce((acc, f) => f(acc), account)));
+            console.log("Synchronization completed ✓");
+            yield ((_a = scenario.beforeAll) === null || _a === void 0 ? void 0 : _a.call(scenario, scenarioAccount));
+            console.log("BeforeAll completed ✓");
+            console.log("\n\n");
+            console.log(chalk.bgCyan.black.bold(" ✧ "), " ", chalk.cyan(`Scenario: ${chalk.italic.bold(scenario.name)}`), " ", chalk.bgCyan.black.bold(" ✧ "), " → ", chalk.bold.cyan(" Starting  ◌"));
+            const scenarioTransactions = scenario.getTransactions(account.freshAddress);
+            for (const testTransaction of scenarioTransactions) {
+                console.log("\n");
+                console.log(chalk.cyan("Transaction:", chalk.bold(testTransaction.name), "◌"));
+                (_b = scenario.beforeEach) === null || _b === void 0 ? void 0 : _b.call(scenario, scenarioAccount);
+                console.log("Before each ✔️");
+                if (scenarioTransactions.indexOf(testTransaction) > 0) {
+                    scenarioAccount = yield firstValueFrom(accountBridge
+                        .sync(scenarioAccount, { paginationConfig: {} })
+                        .pipe(reduce((acc, f) => f(acc), scenarioAccount)));
+                }
+                const previousAccount = Object.freeze(scenarioAccount);
+                const defaultTransaction = accountBridge.createTransaction(scenarioAccount);
+                const transaction = yield accountBridge.prepareTransaction(scenarioAccount, Object.assign(Object.assign({}, defaultTransaction), testTransaction));
+                console.log(" → ", "🧑‍🍳 ", chalk.bold("Prepared the transaction"), "✓");
+                const status = yield accountBridge.getTransactionStatus(scenarioAccount, transaction);
+                if (Object.entries(status.errors).length) {
+                    throw new Error(`Error in transaction status: ${JSON.stringify(status.errors, null, 3)}`);
+                }
+                console.log(" → ", "🪲  ", chalk.bold("No status errors detected"), "✓");
+                const { signedOperation } = yield firstValueFrom(accountBridge
+                    .signOperation({
+                    account: scenarioAccount,
+                    transaction,
+                    deviceId: "",
+                })
+                    .pipe(map(e => {
+                    if (e.type === "device-signature-requested") {
+                        onSignerConfirmation === null || onSignerConfirmation === void 0 ? void 0 : onSignerConfirmation(e);
+                    }
+                    return e;
+                }), first((e) => e.type === "signed")));
+                console.log(" → ", "🔏 ", chalk.bold("Signed the transaction"), "✓");
+                const optimisticOperation = yield accountBridge.broadcast({
+                    account: scenarioAccount,
+                    signedOperation,
+                });
+                console.log(" → ", "🛫 ", chalk.bold("Broadcasted the transaction"), "✓");
+                const retry_limit = retryLimit !== null && retryLimit !== void 0 ? retryLimit : 10;
+                const expectHandler = (retry) => __awaiter(this, void 0, void 0, function* () {
+                    var _g, _h;
+                    scenarioAccount = yield firstValueFrom(accountBridge
+                        .sync(Object.assign(Object.assign({}, scenarioAccount), { pendingOperations: [optimisticOperation] }), { paginationConfig: {} })
+                        .pipe(reduce((acc, f) => f(acc), scenarioAccount)));
+                    if (!testTransaction.expect) {
+                        console.warn(chalk.yellow(`No expects in the transaction ${chalk.bold(testTransaction.name)}. You might want to add tests in this transaction.`));
+                    }
+                    try {
+                        (_g = testTransaction.expect) === null || _g === void 0 ? void 0 : _g.call(testTransaction, previousAccount, scenarioAccount);
+                    }
+                    catch (err) {
+                        if (!((_h = err === null || err === void 0 ? void 0 : err.matcherResult) === null || _h === void 0 ? void 0 : _h.pass)) {
+                            if (retry === 0) {
+                                console.error(chalk.red(`Retried 10 times and could not assert all expects for transaction ${chalk.bold(testTransaction.name)}`));
+                                throw err;
+                            }
+                            console.warn(chalk.magenta("Test asssertion failed. Retrying..."));
+                            yield new Promise(resolve => setTimeout(resolve, retryInterval !== null && retryInterval !== void 0 ? retryInterval : 5000));
+                            yield expectHandler(retry - 1);
+                        }
+                        throw err;
+                    }
+                });
+                yield expectHandler(retry_limit);
+                (_c = scenario.afterEach) === null || _c === void 0 ? void 0 : _c.call(scenario, scenarioAccount);
+                console.log("After each ✔️");
+                console.log(chalk.green("Transaction:", chalk.bold(testTransaction.name), "completed  ✓"));
+            }
+            console.log("\n");
+            yield ((_d = scenario.afterAll) === null || _d === void 0 ? void 0 : _d.call(scenario, scenarioAccount));
+            console.log("afterAll completed ✓");
+            console.log("Stopping engine...");
+            yield ((_e = scenario.teardown) === null || _e === void 0 ? void 0 : _e.call(scenario));
+            console.log("\n\n", chalk.bgGreen.black.bold(" ✧ "), " ", chalk.green(`Scenario: ${chalk.italic.bold(scenario.name)}`), " ", chalk.bgGreen.black.bold(" ✧ "), " → ", chalk.bold.green(" Completed  🎉"), "\n\n");
+        }
+        catch (err) {
+            console.error("\n\n", chalk.bgRed.black.bold(" ✧ "), " ", chalk.red(`Scenario: ${chalk.italic.bold(scenario.name)}`), " ", chalk.bgRed.black.bold(" ✧ "), " → ", chalk.bold.red(" Failed  ❌"), "\n\n");
+            yield ((_f = scenario.teardown) === null || _f === void 0 ? void 0 : _f.call(scenario));
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=main.js.map

package/lib-es/main.js.map

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

package/lib-es/signers/speculos.d.ts

@@ -0,0 +1,8 @@
+import SpeculosTransportHttp from "@ledgerhq/hw-transport-node-speculos-http";
+import { SignOperationEvent } from "@ledgerhq/types-live";
+export declare const spawnSpeculos: (nanoAppEndpoint: `/${string}`) => Promise<{
+    transport: SpeculosTransportHttp;
+    onSignerConfirmation: (e?: SignOperationEvent) => Promise<void>;
+}>;
+export declare const killSpeculos: () => Promise<void>;
+//# sourceMappingURL=speculos.d.ts.map

package/lib-es/signers/speculos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculos.d.ts","sourceRoot":"","sources":["../../src/signers/speculos.ts"],"names":[],"mappings":"AAIA,OAAO,qBAAqB,MAAM,2CAA2C,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAO1D,eAAO,MAAM,aAAa,oBACP,IAAI,MAAM,EAAE;eAElB,qBAAqB;+BACL,kBAAkB,KAAK,QAAQ,IAAI,CAAC;EA6DhE,CAAC;AAEF,eAAO,MAAM,YAAY,qBAOxB,CAAC"}

package/lib-es/signers/speculos.js

@@ -0,0 +1,81 @@
+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());
+    });
+};
+import path from "path";
+import axios from "axios";
+import fs from "fs/promises";
+import { v2 as compose } from "docker-compose";
+import SpeculosTransportHttp from "@ledgerhq/hw-transport-node-speculos-http";
+import chalk from "chalk";
+const { API_PORT } = process.env;
+const cwd = path.join(__dirname);
+const delay = (timing) => new Promise(resolve => setTimeout(resolve, timing));
+export const spawnSpeculos = (nanoAppEndpoint) => __awaiter(void 0, void 0, void 0, function* () {
+    console.log(`Starting speculos...`);
+    const { data: blob } = yield axios({
+        url: `https://raw.githubusercontent.com/LedgerHQ/coin-apps/master/nanox${nanoAppEndpoint}`,
+        method: "GET",
+        responseType: "stream",
+        headers: {
+            Authorization: `Bearer ${process.env.GH_TOKEN}`,
+        },
+    });
+    yield fs.mkdir(path.resolve(cwd, "tmp"), { recursive: true });
+    yield fs.writeFile(path.resolve(cwd, "tmp/app.elf"), blob, "binary");
+    yield compose.upOne("speculos", {
+        cwd,
+        log: true,
+        env: process.env,
+    });
+    const checkSpeculosLogs = () => __awaiter(void 0, void 0, void 0, function* () {
+        const { out } = yield compose.logs("speculos", { cwd, env: process.env });
+        if (out.includes("Running on all addresses (0.0.0.0)")) {
+            console.log(chalk.bgYellowBright.black(" -  SPECULOS READY ✅  - "));
+            return SpeculosTransportHttp.open({
+                apiPort: API_PORT,
+            });
+        }
+        yield delay(200);
+        return checkSpeculosLogs();
+    });
+    const onSpeculosConfirmation = (e) => __awaiter(void 0, void 0, void 0, function* () {
+        if ((e === null || e === void 0 ? void 0 : e.type) === "device-signature-requested") {
+            const { data } = yield axios.get(`http://localhost:${process.env.API_PORT}/events?currentscreenonly=true`);
+            if (data.events[0].text !== "Accept") {
+                yield axios.post(`http://localhost:${process.env.API_PORT}/button/right`, {
+                    action: "press-and-release",
+                });
+                onSpeculosConfirmation(e);
+            }
+            else {
+                yield axios.post(`http://localhost:${process.env.API_PORT}/button/both`, {
+                    action: "press-and-release",
+                });
+            }
+        }
+    });
+    return checkSpeculosLogs().then(transport => {
+        return {
+            transport,
+            onSignerConfirmation: onSpeculosConfirmation,
+        };
+    });
+});
+export const killSpeculos = () => __awaiter(void 0, void 0, void 0, function* () {
+    console.log("Stopping speculos...");
+    yield compose.down({
+        cwd,
+        log: true,
+        env: process.env,
+    });
+});
+["exit", "SIGINT", "SIGQUIT", "SIGTERM", "SIGUSR1", "SIGUSR2", "uncaughtException"].map(e => process.on(e, () => __awaiter(void 0, void 0, void 0, function* () {
+    yield killSpeculos();
+})));
+//# sourceMappingURL=speculos.js.map

package/lib-es/signers/speculos.js.map

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

package/lib-es/types.d.ts

@@ -0,0 +1,6 @@
+export type ENV = {
+    GH_TOKEN: string;
+    SEED: string;
+    API_PORT: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib-es/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/lib-es/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib-es/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@ledgerhq/coin-tester",
+  "version": "0.1.0",
+  "description": "Deterministic testing of Ledger coin-modules",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "axios": "^1.5.0",
+    "chalk": "^4.1.2",
+    "docker-compose": "^0.24.2",
+    "lodash": "^4.17.21",
+    "rxjs": "7.8.1",
+    "@ledgerhq/hw-transport-node-speculos-http": "^6.28.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^28.1.8",
+    "@types/node": "^18.15.7",
+    "jest": "^28.1.3",
+    "ts-jest": "^28.0.8",
+    "typescript": "^5.1.3",
+    "@ledgerhq/types-cryptoassets": "^7.11.0",
+    "@ledgerhq/types-live": "^6.46.1-nightly.2"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib/*"
+      ],
+      "lib-es/*": [
+        "lib-es/*"
+      ],
+      "*": [
+        "lib/*"
+      ]
+    }
+  },
+  "exports": {
+    "./lib/*": "./lib/*.js",
+    "./lib-es/*": "./lib-es/*.js",
+    "./*": {
+      "require": "./lib/*.js",
+      "default": "./lib-es/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "Ledger",
+    "LedgerWallet",
+    "evm",
+    "Ethereum",
+    "Hardware Wallet"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LedgerHQ/ledger-live.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LedgerHQ/ledger-live/issues"
+  },
+  "homepage": "https://github.com/LedgerHQ/ledger-live/tree/develop/libs/coin-tester",
+  "scripts": {
+    "clean": "rimraf lib lib-es",
+    "build": "tsc && tsc -m ES6 --outDir lib-es",
+    "prewatch": "pnpm build",
+    "watch": "tsc --watch",
+    "lint": "eslint .",
+    "lint:fix": "pnpm lint --fix"
+  }
+}

package/src/main.ts

@@ -0,0 +1,239 @@
+import {
+  AccountBridge,
+  Account,
+  TransactionCommon,
+  SignOperationEvent,
+  CurrencyBridge,
+} from "@ledgerhq/types-live";
+import chalk from "chalk";
+import { first, firstValueFrom, map, reduce } from "rxjs";
+
+export type ScenarioTransaction<T extends TransactionCommon> = Partial<T> & {
+  name: string;
+  /**
+   *
+   * @param previousAccount previousAccount returned by the latest sync before broadcasting this transaction
+   * @param currentAccount currentAccount synced after broadcasting this transaction
+   * @returns void
+   */
+  expect?: (previousAccount: Account, currentAccount: Account) => void;
+};
+
+export type Scenario<T extends TransactionCommon> = {
+  name: string;
+  setup: () => Promise<{
+    accountBridge: AccountBridge<T>;
+    currencyBridge: CurrencyBridge;
+    account: Account;
+    retryInterval?: number;
+    retryLimit?: number;
+    onSignerConfirmation?: (e?: SignOperationEvent) => Promise<void>;
+  }>;
+  getTransactions: (address: string) => ScenarioTransaction<T>[];
+  beforeAll?: (account: Account) => Promise<void> | void;
+  afterAll?: (account: Account) => Promise<void> | void;
+  beforeEach?: (account: Account) => Promise<void> | void;
+  afterEach?: (account: Account) => Promise<void> | void;
+  teardown?: () => Promise<void> | void;
+};
+
+export async function executeScenario<T extends TransactionCommon>(scenario: Scenario<T>) {
+  try {
+    const {
+      accountBridge,
+      currencyBridge,
+      account,
+      retryInterval,
+      retryLimit,
+      onSignerConfirmation,
+    } = await scenario.setup();
+
+    console.log("Setup completed ✓");
+
+    console.log("\n");
+    console.log(
+      chalk.bgBlue("     Address     "),
+      " → ",
+      chalk.bold.blue(account.freshAddress),
+      "\n\n",
+    );
+
+    const data = await currencyBridge.preload(account.currency);
+    currencyBridge.hydrate(data, account.currency);
+    console.log("Preload + hydrate completed ✓");
+
+    console.log("Running a synchronization on the account...");
+    let scenarioAccount = await firstValueFrom(
+      accountBridge
+        .sync(account, { paginationConfig: {} })
+        .pipe(reduce((acc, f) => f(acc), account)),
+    );
+    console.log("Synchronization completed ✓");
+
+    await scenario.beforeAll?.(scenarioAccount);
+    console.log("BeforeAll completed ✓");
+
+    console.log("\n\n");
+    console.log(
+      chalk.bgCyan.black.bold(" ✧ "),
+      " ",
+      chalk.cyan(`Scenario: ${chalk.italic.bold(scenario.name)}`),
+
+      " ",
+      chalk.bgCyan.black.bold(" ✧ "),
+      " → ",
+      chalk.bold.cyan(" Starting  ◌"),
+    );
+
+    const scenarioTransactions = scenario.getTransactions(account.freshAddress);
+
+    for (const testTransaction of scenarioTransactions) {
+      console.log("\n");
+      console.log(chalk.cyan("Transaction:", chalk.bold(testTransaction.name), "◌"));
+
+      scenario.beforeEach?.(scenarioAccount);
+      console.log("Before each ✔️");
+
+      if (scenarioTransactions.indexOf(testTransaction) > 0) {
+        scenarioAccount = await firstValueFrom(
+          accountBridge
+            .sync(scenarioAccount, { paginationConfig: {} })
+            .pipe(reduce((acc, f) => f(acc), scenarioAccount)),
+        );
+      }
+
+      const previousAccount = Object.freeze(scenarioAccount);
+
+      const defaultTransaction = accountBridge.createTransaction(scenarioAccount);
+      const transaction = await accountBridge.prepareTransaction(scenarioAccount, {
+        ...defaultTransaction,
+        ...testTransaction,
+      } as T);
+
+      console.log(" → ", "🧑‍🍳 ", chalk.bold("Prepared the transaction"), "✓");
+
+      const status = await accountBridge.getTransactionStatus(scenarioAccount, transaction);
+      if (Object.entries(status.errors).length) {
+        throw new Error(`Error in transaction status: ${JSON.stringify(status.errors, null, 3)}`);
+      }
+
+      console.log(" → ", "🪲  ", chalk.bold("No status errors detected"), "✓");
+
+      const { signedOperation } = await firstValueFrom(
+        accountBridge
+          .signOperation({
+            account: scenarioAccount,
+            transaction,
+            deviceId: "",
+          })
+          .pipe(
+            map(e => {
+              if (e.type === "device-signature-requested") {
+                onSignerConfirmation?.(e);
+              }
+
+              return e;
+            }),
+            first((e): e is SignOperationEvent & { type: "signed" } => e.type === "signed"),
+          ),
+      );
+
+      console.log(" → ", "🔏 ", chalk.bold("Signed the transaction"), "✓");
+
+      const optimisticOperation = await accountBridge.broadcast({
+        account: scenarioAccount,
+        signedOperation,
+      });
+
+      console.log(" → ", "🛫 ", chalk.bold("Broadcasted the transaction"), "✓");
+
+      const retry_limit = retryLimit ?? 10;
+
+      const expectHandler = async (retry: number) => {
+        scenarioAccount = await firstValueFrom(
+          accountBridge
+            .sync(
+              { ...scenarioAccount, pendingOperations: [optimisticOperation] },
+              { paginationConfig: {} },
+            )
+            .pipe(reduce((acc, f) => f(acc), scenarioAccount)),
+        );
+
+        if (!testTransaction.expect) {
+          console.warn(
+            chalk.yellow(
+              `No expects in the transaction ${chalk.bold(
+                testTransaction.name,
+              )}. You might want to add tests in this transaction.`,
+            ),
+          );
+        }
+
+        try {
+          testTransaction.expect?.(previousAccount, scenarioAccount);
+        } catch (err) {
+          if (!(err as { matcherResult?: { pass: boolean } })?.matcherResult?.pass) {
+            if (retry === 0) {
+              console.error(
+                chalk.red(
+                  `Retried 10 times and could not assert all expects for transaction ${chalk.bold(
+                    testTransaction.name,
+                  )}`,
+                ),
+              );
+
+              throw err;
+            }
+
+            console.warn(chalk.magenta("Test asssertion failed. Retrying..."));
+            await new Promise(resolve => setTimeout(resolve, retryInterval ?? 5000));
+            await expectHandler(retry - 1);
+          }
+
+          throw err;
+        }
+      };
+
+      await expectHandler(retry_limit);
+
+      scenario.afterEach?.(scenarioAccount);
+      console.log("After each ✔️");
+      console.log(chalk.green("Transaction:", chalk.bold(testTransaction.name), "completed  ✓"));
+    }
+
+    console.log("\n");
+
+    await scenario.afterAll?.(scenarioAccount);
+    console.log("afterAll completed ✓");
+    console.log("Stopping engine...");
+    await scenario.teardown?.();
+
+    console.log(
+      "\n\n",
+      chalk.bgGreen.black.bold(" ✧ "),
+      " ",
+      chalk.green(`Scenario: ${chalk.italic.bold(scenario.name)}`),
+      " ",
+      chalk.bgGreen.black.bold(" ✧ "),
+      " → ",
+      chalk.bold.green(" Completed  🎉"),
+      "\n\n",
+    );
+  } catch (err) {
+    console.error(
+      "\n\n",
+      chalk.bgRed.black.bold(" ✧ "),
+      " ",
+      chalk.red(`Scenario: ${chalk.italic.bold(scenario.name)}`),
+      " ",
+      chalk.bgRed.black.bold(" ✧ "),
+      " → ",
+      chalk.bold.red(" Failed  ❌"),
+      "\n\n",
+    );
+
+    await scenario.teardown?.();
+
+    throw err;
+  }
+}

package/src/signers/speculos.ts

@@ -0,0 +1,95 @@
+import path from "path";
+import axios from "axios";
+import fs from "fs/promises";
+import { v2 as compose } from "docker-compose";
+import SpeculosTransportHttp from "@ledgerhq/hw-transport-node-speculos-http";
+import { ENV } from "../types";
+import chalk from "chalk";
+import { SignOperationEvent } from "@ledgerhq/types-live";
+
+const { API_PORT } = process.env as ENV;
+const cwd = path.join(__dirname);
+
+const delay = (timing: number) => new Promise(resolve => setTimeout(resolve, timing));
+
+export const spawnSpeculos = async (
+  nanoAppEndpoint: `/${string}`,
+): Promise<{
+  transport: SpeculosTransportHttp;
+  onSignerConfirmation: (e?: SignOperationEvent) => Promise<void>;
+}> => {
+  console.log(`Starting speculos...`);
+
+  const { data: blob } = await axios({
+    url: `https://raw.githubusercontent.com/LedgerHQ/coin-apps/master/nanox${nanoAppEndpoint}`,
+    method: "GET",
+    responseType: "stream",
+    headers: {
+      Authorization: `Bearer ${process.env.GH_TOKEN}`,
+    },
+  });
+
+  await fs.mkdir(path.resolve(cwd, "tmp"), { recursive: true });
+  await fs.writeFile(path.resolve(cwd, "tmp/app.elf"), blob, "binary");
+
+  await compose.upOne("speculos", {
+    cwd,
+    log: true,
+    env: process.env,
+  });
+
+  const checkSpeculosLogs = async (): Promise<SpeculosTransportHttp> => {
+    const { out } = await compose.logs("speculos", { cwd, env: process.env });
+
+    if (out.includes("Running on all addresses (0.0.0.0)")) {
+      console.log(chalk.bgYellowBright.black(" -  SPECULOS READY ✅  - "));
+      return SpeculosTransportHttp.open({
+        apiPort: API_PORT,
+      });
+    }
+
+    await delay(200);
+    return checkSpeculosLogs();
+  };
+
+  const onSpeculosConfirmation = async (e?: SignOperationEvent): Promise<void> => {
+    if (e?.type === "device-signature-requested") {
+      const { data } = await axios.get(
+        `http://localhost:${process.env.API_PORT}/events?currentscreenonly=true`,
+      );
+
+      if (data.events[0].text !== "Accept") {
+        await axios.post(`http://localhost:${process.env.API_PORT}/button/right`, {
+          action: "press-and-release",
+        });
+        onSpeculosConfirmation(e);
+      } else {
+        await axios.post(`http://localhost:${process.env.API_PORT}/button/both`, {
+          action: "press-and-release",
+        });
+      }
+    }
+  };
+
+  return checkSpeculosLogs().then(transport => {
+    return {
+      transport,
+      onSignerConfirmation: onSpeculosConfirmation,
+    };
+  });
+};
+
+export const killSpeculos = async () => {
+  console.log("Stopping speculos...");
+  await compose.down({
+    cwd,
+    log: true,
+    env: process.env,
+  });
+};
+
+["exit", "SIGINT", "SIGQUIT", "SIGTERM", "SIGUSR1", "SIGUSR2", "uncaughtException"].map(e =>
+  process.on(e, async () => {
+    await killSpeculos();
+  }),
+);

package/src/types.ts

@@ -0,0 +1,5 @@
+export type ENV = {
+  GH_TOKEN: string;
+  SEED: string;
+  API_PORT: string;
+};

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.base",
+  "compilerOptions": {
+    "declaration": true,
+    "declarationMap": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "downlevelIteration": true,
+    "lib": ["es2020", "dom"],
+    "outDir": "lib",
+    "typeRoots": ["./types", "./node_modules/@types"],
+    "types": ["node", "jest"]
+  },
+  "include": ["src/**/*"],
+}