@ledgerhq/hw-app-multiversx 6.22.0-next.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ledgerhq/hw-app-multiversx@6.21.1 build /home/runner/work/ledger-live/ledger-live/libs/ledgerjs/packages/hw-app-multiversx
+> tsc && tsc -m esnext --moduleResolution bundler --outDir lib-es
+

package/.unimportedrc.json

@@ -0,0 +1,5 @@
+{
+  "entry": ["src/MultiversX.ts"],
+  "ignoreUnimported": [],
+  "ignoreUnused": ["axios"]
+}

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# @ledgerhq/hw-app-elrond
+
+## 6.22.0-next.0
+
+### Minor Changes
+
+- [#8757](https://github.com/LedgerHQ/ledger-live/pull/8757) [`1461449`](https://github.com/LedgerHQ/ledger-live/commit/146144941c13e60182da8d79592f706d12a6f00e) Thanks [@Wozacosta](https://github.com/Wozacosta)! - chore: Rebranding from 'Elrond' to 'MultiversX'
+
+## 6.21.1
+
+### Patch Changes
+
+- [#7750](https://github.com/LedgerHQ/ledger-live/pull/7750) [`8679584`](https://github.com/LedgerHQ/ledger-live/commit/86795841982e06058294528bd8d2847fc4f62513) Thanks [@Wozacosta](https://github.com/Wozacosta)! - Move Multiversx/Elrond to its own module
+
+- Updated dependencies []:
+  - @ledgerhq/hw-transport@6.31.4
+
+## 6.21.1-next.0
+
+### Patch Changes
+
+- [#7750](https://github.com/LedgerHQ/ledger-live/pull/7750) [`8679584`](https://github.com/LedgerHQ/ledger-live/commit/86795841982e06058294528bd8d2847fc4f62513) Thanks [@Wozacosta](https://github.com/Wozacosta)! - Move Multiversx/Elrond to its own module
+
+- Updated dependencies []:
+  - @ledgerhq/hw-transport@6.31.4-next.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,105 @@
+<img src="https://user-images.githubusercontent.com/4631227/191834116-59cf590e-25cc-4956-ae5c-812ea464f324.png" height="100" />
+
+[GitHub](https://github.com/LedgerHQ/ledger-live/),
+[Ledger Devs Discord](https://developers.ledger.com/discord-pro),
+[Developer Portal](https://developers.ledger.com/)
+
+## @ledgerhq/hw-app-multiversx
+
+Ledger Hardware Wallet Multiversx JavaScript bindings.
+
+***
+
+## Are you adding Ledger support to your software wallet?
+
+You may be using this package to communicate with the Multiversx Nano App.
+
+For a smooth and quick integration:
+
+*   See the developers’ documentation on the [Developer Portal](https://developers.ledger.com/docs/transport/overview/) and
+*   Go on [Discord](https://developers.ledger.com/discord-pro/) to chat with developer support and the developer community.
+
+***
+
+## API
+
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+#### Table of Contents
+
+*   [MultiversX](#multiversx)
+    *   [Parameters](#parameters)
+    *   [Examples](#examples)
+    *   [getAppConfiguration](#getappconfiguration)
+        *   [Examples](#examples-1)
+    *   [getAddress](#getaddress)
+        *   [Parameters](#parameters-1)
+        *   [Examples](#examples-2)
+    *   [setAddress](#setaddress)
+        *   [Parameters](#parameters-2)
+        *   [Examples](#examples-3)
+
+### MultiversX
+
+MultiversX API
+
+#### Parameters
+
+*   `transport` **Transport**&#x20;
+*   `scrambleKey`   (optional, default `"eGLD"`)
+
+#### Examples
+
+```javascript
+import MultiversX from "@ledgerhq/hw-app-multiversx";
+const multiversx = new MultiversX(transport)
+```
+
+#### getAppConfiguration
+
+Get MultiversX app configuration.
+
+##### Examples
+
+```javascript
+const result = await multiversx.getAppConfiguration();
+const { contractData, accountIndex, addressIndex, version } = result;
+```
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<any>** an object with a contractData, accountIndex, addressIndex, version
+
+#### getAddress
+
+Get MultiversX address for a given BIP 32 path.
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a path in BIP 32 format
+*   `boolDisplay` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** optionally enable or not the display
+
+##### Examples
+
+```javascript
+const result = await multiversx.getAddress("44'/508'/0'/0'/0'");
+const { publicKey, address } = result;
+```
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{publicKey: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), address: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** an object with a address
+
+#### setAddress
+
+Set MultiversX address for a given BIP 32 path.
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a path in BIP 32 format
+*   `display` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** optionally enable or not the display
+
+##### Examples
+
+```javascript
+const result = await multiversx.setAddress("44'/508'/0'/0/0");
+result : Buffer;
+```
+
+Returns **any** an object with a address

package/jest.config.ts

@@ -0,0 +1,6 @@
+import baseConfig from "../../jest.config";
+
+export default {
+  ...baseConfig,
+  rootDir: __dirname,
+};

package/lib/MultiversX.d.ts

@@ -0,0 +1,56 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type Transport from "@ledgerhq/hw-transport";
+/**
+ * MultiversX API
+ *
+ * @example
+ * import MultiversX from "@ledgerhq/hw-app-multiversx";
+ * const multiversx = new MultiversX(transport)
+ */
+export default class MultiversX {
+    transport: Transport;
+    constructor(transport: Transport, scrambleKey?: string);
+    /**
+     * Get MultiversX app configuration.
+     *
+     * @return an object with a contractData, accountIndex, addressIndex, version
+     * @example
+     * const result = await multiversx.getAppConfiguration();
+     * const { contractData, accountIndex, addressIndex, version } = result;
+     */
+    getAppConfiguration(): Promise<any>;
+    serializePath(path: Array<number>): Buffer;
+    /**
+     * Get MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param boolDisplay optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.getAddress("44'/508'/0'/0'/0'");
+     * const { publicKey, address } = result;
+     */
+    getAddress(path: string, boolDisplay?: boolean): Promise<{
+        publicKey: string;
+        address: string;
+    }>;
+    /**
+     * Set MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param display optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.setAddress("44'/508'/0'/0/0");
+     * result : Buffer;
+     */
+    setAddress(path: string, display?: boolean): Promise<void>;
+    signTransaction(path: string, message: string): Promise<string>;
+    sign(path: string, message: string): Promise<{
+        signature: null | Buffer;
+    }>;
+    serializeESDTInfo(ticker: string, id: string, decimals: number, chainId: string, signature: string): Buffer;
+    provideESDTInfo(ticker?: string, id?: string, decimals?: number, chainId?: string, signature?: string): Promise<any>;
+}
+//# sourceMappingURL=MultiversX.d.ts.map

package/lib/MultiversX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiversX.d.ts","sourceRoot":"","sources":["../src/MultiversX.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AAiBpD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,SAAS,EAAE,SAAS,CAAC;gBAET,SAAS,EAAE,SAAS,EAAE,WAAW,SAAS;IAgBtD;;;;;;;OAOG;IACG,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC;IAUzC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;IAOjC;;;;;;;;;OASG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAqBF;;;;;;;;;OASG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAS1C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU/D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;KAAE,CAAC;IAuChF,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM;IAsBH,eAAe,CACnB,MAAM,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,CAAC;CAShB"}

package/lib/MultiversX.js

@@ -0,0 +1,170 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sdk_core_1 = require("@multiversx/sdk-core");
+const bip32_path_1 = __importDefault(require("bip32-path"));
+const CHUNK_SIZE = 150;
+const CURVE_MASK = 0x80;
+const CLA = 0xed;
+const INS = {
+    GET_VERSION: 0x02,
+    GET_ADDRESS: 0x03,
+    SET_ADDRESS: 0x05,
+    PROVIDE_ESDT_INFO: 0x08,
+};
+const SIGN_HASH_TX_INS = 0x07;
+const SW_OK = 0x9000;
+const SW_CANCEL = 0x6986;
+/**
+ * MultiversX API
+ *
+ * @example
+ * import MultiversX from "@ledgerhq/hw-app-multiversx";
+ * const multiversx = new MultiversX(transport)
+ */
+class MultiversX {
+    transport;
+    constructor(transport, scrambleKey = "eGLD") {
+        this.transport = transport;
+        transport.decorateAppAPIMethods(this, [
+            "getAddress",
+            "setAddress",
+            "signTransaction",
+            "signMessage",
+            "getAppConfiguration",
+            "provideESDTInfo",
+        ], scrambleKey);
+    }
+    /**
+     * Get MultiversX app configuration.
+     *
+     * @return an object with a contractData, accountIndex, addressIndex, version
+     * @example
+     * const result = await multiversx.getAppConfiguration();
+     * const { contractData, accountIndex, addressIndex, version } = result;
+     */
+    async getAppConfiguration() {
+        const response = await this.transport.send(CLA, INS.GET_VERSION, 0x00, 0x00);
+        return {
+            contractData: response[0],
+            accountIndex: response[1],
+            addressIndex: response[2],
+            version: `${response[3]}.${response[4]}.${response[5]}`,
+        };
+    }
+    serializePath(path) {
+        const buf = Buffer.alloc(8);
+        buf.writeUInt32BE(path[3], 0);
+        buf.writeUInt32BE(path[2], 4);
+        return buf;
+    }
+    /**
+     * Get MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param boolDisplay optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.getAddress("44'/508'/0'/0'/0'");
+     * const { publicKey, address } = result;
+     */
+    async getAddress(path, boolDisplay) {
+        const bipPath = bip32_path_1.default.fromString(path).toPathArray();
+        const data = this.serializePath(bipPath);
+        const response = await this.transport.send(CLA, INS.GET_ADDRESS, boolDisplay ? 0x01 : 0x00, 0x00, data, [SW_OK, SW_CANCEL]);
+        const addressLength = response[0];
+        const address = sdk_core_1.Address.newFromBech32(response.slice(1, 1 + addressLength).toString("ascii"));
+        return {
+            publicKey: address.toHex(),
+            address: address.toBech32(),
+        };
+    }
+    /**
+     * Set MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param display optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.setAddress("44'/508'/0'/0/0");
+     * result : Buffer;
+     */
+    async setAddress(path, display) {
+        const bipPath = bip32_path_1.default.fromString(path).toPathArray();
+        const data = this.serializePath(bipPath);
+        await this.transport.send(CLA, INS.SET_ADDRESS, display ? 0x01 : 0x00, 0x00, data, [
+            SW_OK,
+            SW_CANCEL,
+        ]);
+    }
+    async signTransaction(path, message) {
+        const { signature } = await this.sign(path, message);
+        if (signature === null) {
+            throw new Error("null signature received");
+        }
+        return signature.toString("hex");
+    }
+    async sign(path, message) {
+        const chunks = [];
+        const buffer = Buffer.from(message);
+        for (let i = 0; i < buffer.length; i += CHUNK_SIZE) {
+            let end = i + CHUNK_SIZE;
+            if (i > buffer.length) {
+                end = buffer.length;
+            }
+            chunks.push(buffer.slice(i, end));
+        }
+        const apdus = [];
+        chunks.forEach((data, index) => {
+            const apdu = {
+                cla: CLA,
+                ins: SIGN_HASH_TX_INS,
+                p1: index === 0 ? 0x00 : CURVE_MASK,
+                p2: CURVE_MASK,
+                data,
+            };
+            apdus.push(apdu);
+        });
+        let response = {};
+        for (const apdu of apdus) {
+            response = await this.transport.send(apdu.cla, apdu.ins, apdu.p1, apdu.p2, apdu.data);
+        }
+        if (response.length !== 67 || response[0] !== 64) {
+            throw new Error("invalid signature received from ledger device");
+        }
+        const signature = response.slice(1, response.length - 2).toString("hex");
+        return { signature };
+    }
+    serializeESDTInfo(ticker, id, decimals, chainId, signature) {
+        const tickerLengthBuffer = Buffer.from([ticker.length]);
+        const tickerBuffer = Buffer.from(ticker);
+        const idLengthBuffer = Buffer.from([id.length]);
+        const idBuffer = Buffer.from(id);
+        const decimalsBuffer = Buffer.from([decimals]);
+        const chainIdLengthBuffer = Buffer.from([chainId.length]);
+        const chainIdBuffer = Buffer.from(chainId);
+        const signatureBuffer = Buffer.from(signature, "hex");
+        const infoBuffer = [
+            tickerLengthBuffer,
+            tickerBuffer,
+            idLengthBuffer,
+            idBuffer,
+            decimalsBuffer,
+            chainIdLengthBuffer,
+            chainIdBuffer,
+            signatureBuffer,
+        ];
+        return Buffer.concat(infoBuffer);
+    }
+    async provideESDTInfo(ticker, id, decimals, chainId, signature) {
+        if (!ticker || !id || !decimals || !chainId || !signature) {
+            throw new Error("Invalid ESDT token credentials!");
+        }
+        const data = this.serializeESDTInfo(ticker, id, decimals, chainId, signature);
+        return await this.transport.send(CLA, INS.PROVIDE_ESDT_INFO, 0x00, 0x00, data);
+    }
+}
+exports.default = MultiversX;
+//# sourceMappingURL=MultiversX.js.map

package/lib/MultiversX.js.map

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

package/lib-es/MultiversX.d.ts

@@ -0,0 +1,56 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type Transport from "@ledgerhq/hw-transport";
+/**
+ * MultiversX API
+ *
+ * @example
+ * import MultiversX from "@ledgerhq/hw-app-multiversx";
+ * const multiversx = new MultiversX(transport)
+ */
+export default class MultiversX {
+    transport: Transport;
+    constructor(transport: Transport, scrambleKey?: string);
+    /**
+     * Get MultiversX app configuration.
+     *
+     * @return an object with a contractData, accountIndex, addressIndex, version
+     * @example
+     * const result = await multiversx.getAppConfiguration();
+     * const { contractData, accountIndex, addressIndex, version } = result;
+     */
+    getAppConfiguration(): Promise<any>;
+    serializePath(path: Array<number>): Buffer;
+    /**
+     * Get MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param boolDisplay optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.getAddress("44'/508'/0'/0'/0'");
+     * const { publicKey, address } = result;
+     */
+    getAddress(path: string, boolDisplay?: boolean): Promise<{
+        publicKey: string;
+        address: string;
+    }>;
+    /**
+     * Set MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param display optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.setAddress("44'/508'/0'/0/0");
+     * result : Buffer;
+     */
+    setAddress(path: string, display?: boolean): Promise<void>;
+    signTransaction(path: string, message: string): Promise<string>;
+    sign(path: string, message: string): Promise<{
+        signature: null | Buffer;
+    }>;
+    serializeESDTInfo(ticker: string, id: string, decimals: number, chainId: string, signature: string): Buffer;
+    provideESDTInfo(ticker?: string, id?: string, decimals?: number, chainId?: string, signature?: string): Promise<any>;
+}
+//# sourceMappingURL=MultiversX.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MultiversX.d.ts","sourceRoot":"","sources":["../src/MultiversX.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AAiBpD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,SAAS,EAAE,SAAS,CAAC;gBAET,SAAS,EAAE,SAAS,EAAE,WAAW,SAAS;IAgBtD;;;;;;;OAOG;IACG,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC;IAUzC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;IAOjC;;;;;;;;;OASG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAqBF;;;;;;;;;OASG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAS1C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU/D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;KAAE,CAAC;IAuChF,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM;IAsBH,eAAe,CACnB,MAAM,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,CAAC;CAShB"}

package/lib-es/MultiversX.js

@@ -0,0 +1,164 @@
+import { Address } from "@multiversx/sdk-core";
+import BIPPath from "bip32-path";
+const CHUNK_SIZE = 150;
+const CURVE_MASK = 0x80;
+const CLA = 0xed;
+const INS = {
+    GET_VERSION: 0x02,
+    GET_ADDRESS: 0x03,
+    SET_ADDRESS: 0x05,
+    PROVIDE_ESDT_INFO: 0x08,
+};
+const SIGN_HASH_TX_INS = 0x07;
+const SW_OK = 0x9000;
+const SW_CANCEL = 0x6986;
+/**
+ * MultiversX API
+ *
+ * @example
+ * import MultiversX from "@ledgerhq/hw-app-multiversx";
+ * const multiversx = new MultiversX(transport)
+ */
+export default class MultiversX {
+    transport;
+    constructor(transport, scrambleKey = "eGLD") {
+        this.transport = transport;
+        transport.decorateAppAPIMethods(this, [
+            "getAddress",
+            "setAddress",
+            "signTransaction",
+            "signMessage",
+            "getAppConfiguration",
+            "provideESDTInfo",
+        ], scrambleKey);
+    }
+    /**
+     * Get MultiversX app configuration.
+     *
+     * @return an object with a contractData, accountIndex, addressIndex, version
+     * @example
+     * const result = await multiversx.getAppConfiguration();
+     * const { contractData, accountIndex, addressIndex, version } = result;
+     */
+    async getAppConfiguration() {
+        const response = await this.transport.send(CLA, INS.GET_VERSION, 0x00, 0x00);
+        return {
+            contractData: response[0],
+            accountIndex: response[1],
+            addressIndex: response[2],
+            version: `${response[3]}.${response[4]}.${response[5]}`,
+        };
+    }
+    serializePath(path) {
+        const buf = Buffer.alloc(8);
+        buf.writeUInt32BE(path[3], 0);
+        buf.writeUInt32BE(path[2], 4);
+        return buf;
+    }
+    /**
+     * Get MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param boolDisplay optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.getAddress("44'/508'/0'/0'/0'");
+     * const { publicKey, address } = result;
+     */
+    async getAddress(path, boolDisplay) {
+        const bipPath = BIPPath.fromString(path).toPathArray();
+        const data = this.serializePath(bipPath);
+        const response = await this.transport.send(CLA, INS.GET_ADDRESS, boolDisplay ? 0x01 : 0x00, 0x00, data, [SW_OK, SW_CANCEL]);
+        const addressLength = response[0];
+        const address = Address.newFromBech32(response.slice(1, 1 + addressLength).toString("ascii"));
+        return {
+            publicKey: address.toHex(),
+            address: address.toBech32(),
+        };
+    }
+    /**
+     * Set MultiversX address for a given BIP 32 path.
+     *
+     * @param path a path in BIP 32 format
+     * @param display optionally enable or not the display
+     * @return an object with a address
+     * @example
+     * const result = await multiversx.setAddress("44'/508'/0'/0/0");
+     * result : Buffer;
+     */
+    async setAddress(path, display) {
+        const bipPath = BIPPath.fromString(path).toPathArray();
+        const data = this.serializePath(bipPath);
+        await this.transport.send(CLA, INS.SET_ADDRESS, display ? 0x01 : 0x00, 0x00, data, [
+            SW_OK,
+            SW_CANCEL,
+        ]);
+    }
+    async signTransaction(path, message) {
+        const { signature } = await this.sign(path, message);
+        if (signature === null) {
+            throw new Error("null signature received");
+        }
+        return signature.toString("hex");
+    }
+    async sign(path, message) {
+        const chunks = [];
+        const buffer = Buffer.from(message);
+        for (let i = 0; i < buffer.length; i += CHUNK_SIZE) {
+            let end = i + CHUNK_SIZE;
+            if (i > buffer.length) {
+                end = buffer.length;
+            }
+            chunks.push(buffer.slice(i, end));
+        }
+        const apdus = [];
+        chunks.forEach((data, index) => {
+            const apdu = {
+                cla: CLA,
+                ins: SIGN_HASH_TX_INS,
+                p1: index === 0 ? 0x00 : CURVE_MASK,
+                p2: CURVE_MASK,
+                data,
+            };
+            apdus.push(apdu);
+        });
+        let response = {};
+        for (const apdu of apdus) {
+            response = await this.transport.send(apdu.cla, apdu.ins, apdu.p1, apdu.p2, apdu.data);
+        }
+        if (response.length !== 67 || response[0] !== 64) {
+            throw new Error("invalid signature received from ledger device");
+        }
+        const signature = response.slice(1, response.length - 2).toString("hex");
+        return { signature };
+    }
+    serializeESDTInfo(ticker, id, decimals, chainId, signature) {
+        const tickerLengthBuffer = Buffer.from([ticker.length]);
+        const tickerBuffer = Buffer.from(ticker);
+        const idLengthBuffer = Buffer.from([id.length]);
+        const idBuffer = Buffer.from(id);
+        const decimalsBuffer = Buffer.from([decimals]);
+        const chainIdLengthBuffer = Buffer.from([chainId.length]);
+        const chainIdBuffer = Buffer.from(chainId);
+        const signatureBuffer = Buffer.from(signature, "hex");
+        const infoBuffer = [
+            tickerLengthBuffer,
+            tickerBuffer,
+            idLengthBuffer,
+            idBuffer,
+            decimalsBuffer,
+            chainIdLengthBuffer,
+            chainIdBuffer,
+            signatureBuffer,
+        ];
+        return Buffer.concat(infoBuffer);
+    }
+    async provideESDTInfo(ticker, id, decimals, chainId, signature) {
+        if (!ticker || !id || !decimals || !chainId || !signature) {
+            throw new Error("Invalid ESDT token credentials!");
+        }
+        const data = this.serializeESDTInfo(ticker, id, decimals, chainId, signature);
+        return await this.transport.send(CLA, INS.PROVIDE_ESDT_INFO, 0x00, 0x00, data);
+    }
+}
+//# sourceMappingURL=MultiversX.js.map

package/lib-es/MultiversX.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@ledgerhq/hw-app-multiversx",
+  "version": "6.22.0-next.0",
+  "description": "Ledger Hardware Wallet MultiversX Application API",
+  "keywords": [
+    "Ledger",
+    "LedgerWallet",
+    "egld",
+    "MultiversX",
+    "NanoS",
+    "Blue",
+    "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/ledgerjs/packages/hw-app-multiversx",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/MultiversX.js",
+  "module": "lib-es/MultiversX.js",
+  "types": "lib/MultiversX.d.ts",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@multiversx/sdk-core": "^13.7.0",
+    "bignumber.js": "^9.0.1",
+    "bip32-path": "^0.4.2",
+    "protobufjs": "^7.2.6",
+    "axios": "^1.7.4",
+    "@ledgerhq/hw-transport": "^6.31.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.10",
+    "@types/node": "^22.10.10",
+    "documentation": "14.0.2",
+    "jest": "^29.7.0",
+    "rimraf": "^4.4.1",
+    "source-map-support": "^0.5.21",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.4.0",
+    "@ledgerhq/hw-transport-mocker": "^6.29.4"
+  },
+  "scripts": {
+    "clean": "rimraf lib lib-es",
+    "build": "tsc && tsc -m esnext --moduleResolution bundler --outDir lib-es",
+    "prewatch": "pnpm build",
+    "watch": "tsc --watch",
+    "watch:es": "tsc --watch -m esnext --moduleResolution bundler --outDir lib-es",
+    "doc": "documentation readme src/** --section=API --pe ts --re ts --re d.ts",
+    "lint": "eslint ./src --no-error-on-unmatched-pattern --ext .ts,.tsx --cache",
+    "lint:fix": "pnpm lint --fix",
+    "test": "jest",
+    "unimported": "unimported"
+  }
+}

package/src/MultiversX.ts

@@ -0,0 +1,217 @@
+import type Transport from "@ledgerhq/hw-transport";
+import { Address } from "@multiversx/sdk-core";
+import BIPPath from "bip32-path";
+
+const CHUNK_SIZE = 150;
+const CURVE_MASK = 0x80;
+const CLA = 0xed;
+const INS = {
+  GET_VERSION: 0x02,
+  GET_ADDRESS: 0x03,
+  SET_ADDRESS: 0x05,
+  PROVIDE_ESDT_INFO: 0x08,
+};
+const SIGN_HASH_TX_INS = 0x07;
+const SW_OK = 0x9000;
+const SW_CANCEL = 0x6986;
+
+/**
+ * MultiversX API
+ *
+ * @example
+ * import MultiversX from "@ledgerhq/hw-app-multiversx";
+ * const multiversx = new MultiversX(transport)
+ */
+export default class MultiversX {
+  transport: Transport;
+
+  constructor(transport: Transport, scrambleKey = "eGLD") {
+    this.transport = transport;
+    transport.decorateAppAPIMethods(
+      this,
+      [
+        "getAddress",
+        "setAddress",
+        "signTransaction",
+        "signMessage",
+        "getAppConfiguration",
+        "provideESDTInfo",
+      ],
+      scrambleKey,
+    );
+  }
+
+  /**
+   * Get MultiversX app configuration.
+   *
+   * @return an object with a contractData, accountIndex, addressIndex, version
+   * @example
+   * const result = await multiversx.getAppConfiguration();
+   * const { contractData, accountIndex, addressIndex, version } = result;
+   */
+  async getAppConfiguration(): Promise<any> {
+    const response = await this.transport.send(CLA, INS.GET_VERSION, 0x00, 0x00);
+    return {
+      contractData: response[0],
+      accountIndex: response[1],
+      addressIndex: response[2],
+      version: `${response[3]}.${response[4]}.${response[5]}`,
+    };
+  }
+
+  serializePath(path: Array<number>) {
+    const buf = Buffer.alloc(8);
+    buf.writeUInt32BE(path[3], 0);
+    buf.writeUInt32BE(path[2], 4);
+    return buf;
+  }
+
+  /**
+   * Get MultiversX address for a given BIP 32 path.
+   *
+   * @param path a path in BIP 32 format
+   * @param boolDisplay optionally enable or not the display
+   * @return an object with a address
+   * @example
+   * const result = await multiversx.getAddress("44'/508'/0'/0'/0'");
+   * const { publicKey, address } = result;
+   */
+  async getAddress(
+    path: string,
+    boolDisplay?: boolean,
+  ): Promise<{
+    publicKey: string;
+    address: string;
+  }> {
+    const bipPath = BIPPath.fromString(path).toPathArray();
+    const data = this.serializePath(bipPath);
+    const response = await this.transport.send(
+      CLA,
+      INS.GET_ADDRESS,
+      boolDisplay ? 0x01 : 0x00,
+      0x00,
+      data,
+      [SW_OK, SW_CANCEL],
+    );
+
+    const addressLength = response[0];
+    const address = Address.newFromBech32(response.slice(1, 1 + addressLength).toString("ascii"));
+
+    return {
+      publicKey: address.toHex(),
+      address: address.toBech32(),
+    };
+  }
+
+  /**
+   * Set MultiversX address for a given BIP 32 path.
+   *
+   * @param path a path in BIP 32 format
+   * @param display optionally enable or not the display
+   * @return an object with a address
+   * @example
+   * const result = await multiversx.setAddress("44'/508'/0'/0/0");
+   * result : Buffer;
+   */
+  async setAddress(path: string, display?: boolean) {
+    const bipPath = BIPPath.fromString(path).toPathArray();
+    const data = this.serializePath(bipPath);
+    await this.transport.send(CLA, INS.SET_ADDRESS, display ? 0x01 : 0x00, 0x00, data, [
+      SW_OK,
+      SW_CANCEL,
+    ]);
+  }
+
+  async signTransaction(path: string, message: string): Promise<string> {
+    const { signature } = await this.sign(path, message);
+
+    if (signature === null) {
+      throw new Error("null signature received");
+    }
+
+    return signature.toString("hex");
+  }
+
+  async sign(path: string, message: string): Promise<{ signature: null | Buffer }> {
+    const chunks: Buffer[] = [];
+    const buffer: Buffer = Buffer.from(message);
+
+    for (let i = 0; i < buffer.length; i += CHUNK_SIZE) {
+      let end = i + CHUNK_SIZE;
+
+      if (i > buffer.length) {
+        end = buffer.length;
+      }
+
+      chunks.push(buffer.slice(i, end));
+    }
+
+    const apdus: any[] = [];
+    chunks.forEach((data, index) => {
+      const apdu: any = {
+        cla: CLA,
+        ins: SIGN_HASH_TX_INS,
+        p1: index === 0 ? 0x00 : CURVE_MASK,
+        p2: CURVE_MASK,
+        data,
+      };
+      apdus.push(apdu);
+    });
+
+    let response: any = {};
+    for (const apdu of apdus) {
+      response = await this.transport.send(apdu.cla, apdu.ins, apdu.p1, apdu.p2, apdu.data);
+    }
+
+    if (response.length !== 67 || response[0] !== 64) {
+      throw new Error("invalid signature received from ledger device");
+    }
+
+    const signature = response.slice(1, response.length - 2).toString("hex");
+    return { signature };
+  }
+
+  serializeESDTInfo(
+    ticker: string,
+    id: string,
+    decimals: number,
+    chainId: string,
+    signature: string,
+  ): Buffer {
+    const tickerLengthBuffer = Buffer.from([ticker.length]);
+    const tickerBuffer = Buffer.from(ticker);
+    const idLengthBuffer = Buffer.from([id.length]);
+    const idBuffer = Buffer.from(id);
+    const decimalsBuffer = Buffer.from([decimals]);
+    const chainIdLengthBuffer = Buffer.from([chainId.length]);
+    const chainIdBuffer = Buffer.from(chainId);
+    const signatureBuffer = Buffer.from(signature, "hex");
+    const infoBuffer = [
+      tickerLengthBuffer,
+      tickerBuffer,
+      idLengthBuffer,
+      idBuffer,
+      decimalsBuffer,
+      chainIdLengthBuffer,
+      chainIdBuffer,
+      signatureBuffer,
+    ];
+    return Buffer.concat(infoBuffer);
+  }
+
+  async provideESDTInfo(
+    ticker?: string,
+    id?: string,
+    decimals?: number,
+    chainId?: string,
+    signature?: string,
+  ): Promise<any> {
+    if (!ticker || !id || !decimals || !chainId || !signature) {
+      throw new Error("Invalid ESDT token credentials!");
+    }
+
+    const data = this.serializeESDTInfo(ticker, id, decimals, chainId, signature);
+
+    return await this.transport.send(CLA, INS.PROVIDE_ESDT_INFO, 0x00, 0x00, data);
+  }
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+      "outDir": "lib"
+    },
+    "include": ["src/**/*"]
+  }