@ledgerhq/hw-app-icon 1.1.0-next.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ledgerhq/hw-app-icon@1.0.0 build /home/runner/work/ledger-live/ledger-live/libs/ledgerjs/packages/hw-app-icon
+> tsc && tsc -m ES6 --outDir lib-es
+

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @ledgerhq/hw-app-icon
+
+## 1.1.0-next.0
+
+### Minor Changes
+
+- [#7075](https://github.com/LedgerHQ/ledger-live/pull/7075) [`db9c2d7`](https://github.com/LedgerHQ/ledger-live/commit/db9c2d78fb74df586c3ea1b9fb75ce3b014a0f4b) Thanks [@hedi-edelbloute](https://github.com/hedi-edelbloute)! - Integrate Sync, Send, Receive, Create Account for Icon network

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,82 @@
+## @ledgerhq/hw-app-icon
+
+Ledger Hardware Wallet Icon JavaScript bindings.
+
+## API
+
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+#### Table of Contents
+
+*   [Icx](#icx)
+    *   [Parameters](#parameters)
+    *   [Examples](#examples)
+    *   [getAddress](#getaddress)
+        *   [Parameters](#parameters-1)
+        *   [Examples](#examples-1)
+    *   [signTransaction](#signtransaction)
+        *   [Parameters](#parameters-2)
+        *   [Examples](#examples-2)
+    *   [getAppConfiguration](#getappconfiguration)
+
+### Icx
+
+ICON API
+
+#### Parameters
+
+*   `transport` **Transport**&#x20;
+
+#### Examples
+
+```javascript
+import Icx from "@ledgerhq/hw-app-icx";
+const icx = new Icx(transport)
+```
+
+#### getAddress
+
+Returns public key and ICON 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`   (optional, default `false`)
+*   `boolChaincode`   (optional, default `true`)
+
+##### Examples
+
+```javascript
+icx.getAddress("44'/4801368'/0'", true, true).then(o => o.address)
+```
+
+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), chainCode: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?}>** an object with a publickey(hexa string), address(string) and
+(optionally) chaincode(hexa string)
+
+#### signTransaction
+
+Signs a transaction and returns signed message given the raw transaction
+and the BIP 32 path of the account to sign
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a path in BIP 32 format
+*   `rawTxAscii` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** raw transaction data to sign in ASCII string format
+
+##### Examples
+
+```javascript
+icx.signTransaction("44'/4801368'/0'",
+    "icx_sendTransaction.fee.0x2386f26fc10000." +
+    "from.hxc9ecad30b05a0650a337452fce031e0c60eacc3a.nonce.0x3." +
+    "to.hx4c5101add2caa6a920420cf951f7dd7c7df6ca24.value.0xde0b6b3a7640000")
+  .then(result => ...)
+```
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{signedRawTxBase64: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), hashHex: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** an object with a base64 encoded signature and hash in hexa string
+
+#### getAppConfiguration
+
+Returns the application configurations such as versions.
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{majorVersion: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), minorVersion: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), patchVersion: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)}>** major/minor/patch versions of Icon application

package/jest.config.ts

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

package/lib/Icon.d.ts

@@ -0,0 +1,70 @@
+/********************************************************************************
+ *   Ledger JS API for ICON
+ *   (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+import type Transport from "@ledgerhq/hw-transport";
+/**
+ * ICON API
+ *
+ * @example
+ * import Icx from "@ledgerhq/hw-app-icx";
+ * const icx = new Icx(transport)
+ */
+export default class Icx {
+    transport: Transport;
+    constructor(transport: Transport);
+    /**
+     * Returns public key and ICON address for a given BIP 32 path.
+     * @param path a path in BIP 32 format
+     * @option boolDisplay optionally enable or not the display
+     * @option boolChaincode optionally enable or not the chaincode request
+     * @return an object with a publickey(hexa string), address(string) and
+     *  (optionally) chaincode(hexa string)
+     * @example
+     * icx.getAddress("44'/4801368'/0'", true, true).then(o => o.address)
+     */
+    getAddress(path: string, boolDisplay?: boolean, boolChaincode?: boolean): Promise<{
+        publicKey: string;
+        address: string;
+        chainCode?: string;
+    }>;
+    /**
+     * Signs a transaction and returns signed message given the raw transaction
+     * and the BIP 32 path of the account to sign
+     * @param path a path in BIP 32 format
+     * @param rawTxAscii raw transaction data to sign in ASCII string format
+     * @return an object with a base64 encoded signature and hash in hexa string
+     * @example
+     * icx.signTransaction("44'/4801368'/0'",
+     *     "icx_sendTransaction.fee.0x2386f26fc10000." +
+     *     "from.hxc9ecad30b05a0650a337452fce031e0c60eacc3a.nonce.0x3." +
+     *     "to.hx4c5101add2caa6a920420cf951f7dd7c7df6ca24.value.0xde0b6b3a7640000")
+     *   .then(result => ...)
+     */
+    signTransaction(path: string, rawTxAscii: string): Promise<{
+        signedRawTxBase64: string;
+        hashHex: string;
+    }>;
+    /**
+     * Returns the application configurations such as versions.
+     * @return  major/minor/patch versions of Icon application
+     */
+    getAppConfiguration(): Promise<{
+        majorVersion: number;
+        minorVersion: number;
+        patchVersion: number;
+    }>;
+}
+//# sourceMappingURL=Icon.d.ts.map

package/lib/Icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../src/Icon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;kFAekF;AAGlF,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AAapD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,GAAG;IACtB,SAAS,EAAE,SAAS,CAAC;gBAET,SAAS,EAAE,SAAS;IAShC;;;;;;;;;OASG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,WAAW,UAAQ,EACnB,aAAa,UAAO,GACnB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAoCF;;;;;;;;;;;;OAYG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QACT,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IA4CF;;;OAGG;IACH,mBAAmB,IAAI,OAAO,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CASH"}

package/lib/Icon.js

@@ -0,0 +1,147 @@
+"use strict";
+/********************************************************************************
+ *   Ledger JS API for ICON
+ *   (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("./utils");
+const errors_1 = require("@ledgerhq/errors");
+const CLA = 0xe0;
+const INS = {
+    GET_VERSION: 0x06,
+    GET_ADDR: 0x02,
+    SIGN: 0x04,
+};
+const SW_OK = 0x9000;
+const SW_CANCEL = 0x6986;
+/**
+ * ICON API
+ *
+ * @example
+ * import Icx from "@ledgerhq/hw-app-icx";
+ * const icx = new Icx(transport)
+ */
+class Icx {
+    constructor(transport) {
+        this.transport = transport;
+        transport.decorateAppAPIMethods(this, ["getAddress", "signTransaction", "getAppConfiguration"], "ICON");
+    }
+    /**
+     * Returns public key and ICON address for a given BIP 32 path.
+     * @param path a path in BIP 32 format
+     * @option boolDisplay optionally enable or not the display
+     * @option boolChaincode optionally enable or not the chaincode request
+     * @return an object with a publickey(hexa string), address(string) and
+     *  (optionally) chaincode(hexa string)
+     * @example
+     * icx.getAddress("44'/4801368'/0'", true, true).then(o => o.address)
+     */
+    getAddress(path, boolDisplay = false, boolChaincode = true) {
+        const paths = (0, utils_1.splitPath)(path);
+        const buffer = Buffer.alloc(1 + paths.length * 4);
+        buffer[0] = paths.length;
+        paths.forEach((element, index) => {
+            buffer.writeUInt32BE(element, 1 + 4 * index);
+        });
+        const statusList = [SW_OK, SW_CANCEL];
+        return this.transport
+            .send(CLA, INS.GET_ADDR, boolDisplay ? 0x01 : 0x00, boolChaincode ? 0x01 : 0x00, buffer, statusList)
+            .then(response => {
+            const publicKeyLength = response[0];
+            const addressLength = response[1 + publicKeyLength];
+            const errorCodeData = response.slice(-2);
+            const returnCode = errorCodeData[0] * 0x100 + errorCodeData[1];
+            if (returnCode === SW_CANCEL) {
+                throw new errors_1.UserRefusedAddress();
+            }
+            return {
+                publicKey: response.slice(1, 1 + publicKeyLength).toString("hex"),
+                address: response
+                    .slice(1 + publicKeyLength + 1, 1 + publicKeyLength + 1 + addressLength)
+                    .toString(),
+                chainCode: boolChaincode ? response.slice(-32).toString("hex") : undefined,
+            };
+        });
+    }
+    /**
+     * Signs a transaction and returns signed message given the raw transaction
+     * and the BIP 32 path of the account to sign
+     * @param path a path in BIP 32 format
+     * @param rawTxAscii raw transaction data to sign in ASCII string format
+     * @return an object with a base64 encoded signature and hash in hexa string
+     * @example
+     * icx.signTransaction("44'/4801368'/0'",
+     *     "icx_sendTransaction.fee.0x2386f26fc10000." +
+     *     "from.hxc9ecad30b05a0650a337452fce031e0c60eacc3a.nonce.0x3." +
+     *     "to.hx4c5101add2caa6a920420cf951f7dd7c7df6ca24.value.0xde0b6b3a7640000")
+     *   .then(result => ...)
+     */
+    signTransaction(path, rawTxAscii) {
+        const paths = (0, utils_1.splitPath)(path);
+        let offset = 0;
+        const rawTx = Buffer.from(rawTxAscii);
+        const toSend = [];
+        let response;
+        while (offset !== rawTx.length) {
+            const maxChunkSize = offset === 0 ? 150 - 1 - paths.length * 4 - 4 : 150;
+            const chunkSize = offset + maxChunkSize > rawTx.length ? rawTx.length - offset : maxChunkSize;
+            const buffer = Buffer.alloc(offset === 0 ? 1 + paths.length * 4 + 4 + chunkSize : chunkSize);
+            if (offset === 0) {
+                buffer[0] = paths.length;
+                paths.forEach((element, index) => {
+                    buffer.writeUInt32BE(element, 1 + 4 * index);
+                });
+                buffer.writeUInt32BE(rawTx.length, 1 + 4 * paths.length);
+                rawTx.copy(buffer, 1 + 4 * paths.length + 4, offset, offset + chunkSize);
+            }
+            else {
+                rawTx.copy(buffer, 0, offset, offset + chunkSize);
+            }
+            toSend.push(buffer);
+            offset += chunkSize;
+        }
+        return (0, utils_1.foreach)(toSend, (data, i) => this.transport
+            .send(CLA, INS.SIGN, i === 0 ? 0x00 : 0x80, 0x00, data, [SW_OK, SW_CANCEL])
+            .then(apduResponse => {
+            response = apduResponse;
+        })).then(() => {
+            const errorCodeData = response.slice(-2);
+            const returnCode = errorCodeData[0] * 0x100 + errorCodeData[1];
+            if (returnCode === SW_CANCEL) {
+                throw new errors_1.UserRefusedOnDevice();
+            }
+            // r, s, v are aligned sequencially
+            return {
+                signedRawTxBase64: (0, utils_1.hexToBase64)(response.slice(0, 32 + 32 + 1).toString("hex")),
+                hashHex: response.slice(32 + 32 + 1, 32 + 32 + 1 + 32).toString("hex"),
+            };
+        });
+    }
+    /**
+     * Returns the application configurations such as versions.
+     * @return  major/minor/patch versions of Icon application
+     */
+    getAppConfiguration() {
+        return this.transport.send(CLA, INS.GET_VERSION, 0x00, 0x00).then(response => {
+            return {
+                majorVersion: response[0],
+                minorVersion: response[1],
+                patchVersion: response[2],
+            };
+        });
+    }
+}
+exports.default = Icx;
+//# sourceMappingURL=Icon.js.map

package/lib/Icon.js.map

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

package/lib/utils.d.ts

@@ -0,0 +1,22 @@
+/********************************************************************************
+ *   Ledger Node JS API for ICON
+ *   (c) 2016-2017 Ledger
+ *
+ *  Modifications (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+export declare function splitPath(path: string): number[];
+export declare function foreach<T, A>(arr: T[], callback: (T: any, number: any) => Promise<A>): Promise<A[]>;
+export declare function hexToBase64(hexString: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;kFAiBkF;AAGlF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAchD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAA,EAAE,MAAM,KAAA,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAWzF;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,UAQ5C"}

package/lib/utils.js

@@ -0,0 +1,61 @@
+"use strict";
+/********************************************************************************
+ *   Ledger Node JS API for ICON
+ *   (c) 2016-2017 Ledger
+ *
+ *  Modifications (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexToBase64 = exports.foreach = exports.splitPath = void 0;
+// TODO use bip32-path library
+function splitPath(path) {
+    const result = [];
+    const components = path.split("/");
+    components.forEach(element => {
+        let number = parseInt(element, 10);
+        if (isNaN(number)) {
+            return; // FIXME shouldn't it throws instead?
+        }
+        if (element.length > 1 && element[element.length - 1] === "'") {
+            number += 0x80000000;
+        }
+        result.push(number);
+    });
+    return result;
+}
+exports.splitPath = splitPath;
+function foreach(arr, callback) {
+    function iterate(index, array, result) {
+        if (index >= array.length) {
+            return result;
+        }
+        else
+            return callback(array[index], index).then(function (res) {
+                result.push(res);
+                return iterate(index + 1, array, result);
+            });
+    }
+    return Promise.resolve().then(() => iterate(0, arr, []));
+}
+exports.foreach = foreach;
+function hexToBase64(hexString) {
+    return btoa((hexString.match(/\w{2}/g) || [])
+        .map(function (a) {
+        return String.fromCharCode(parseInt(a, 16));
+    })
+        .join(""));
+}
+exports.hexToBase64 = hexToBase64;
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;kFAiBkF;;;AAElF,8BAA8B;AAC9B,SAAgB,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,IAAI,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,qCAAqC;QAC/C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9D,MAAM,IAAI,UAAU,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAdD,8BAcC;AAED,SAAgB,OAAO,CAAO,GAAQ,EAAE,QAAmC;IACzE,SAAS,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM;QACnC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC;QAChB,CAAC;;YACC,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG;gBACrD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,OAAO,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAXD,0BAWC;AAED,SAAgB,WAAW,CAAC,SAAiB;IAC3C,OAAO,IAAI,CACT,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;SAC9B,GAAG,CAAC,UAAU,CAAC;QACd,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CACZ,CAAC;AACJ,CAAC;AARD,kCAQC"}

package/lib-es/Icon.d.ts

@@ -0,0 +1,70 @@
+/********************************************************************************
+ *   Ledger JS API for ICON
+ *   (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+import type Transport from "@ledgerhq/hw-transport";
+/**
+ * ICON API
+ *
+ * @example
+ * import Icx from "@ledgerhq/hw-app-icx";
+ * const icx = new Icx(transport)
+ */
+export default class Icx {
+    transport: Transport;
+    constructor(transport: Transport);
+    /**
+     * Returns public key and ICON address for a given BIP 32 path.
+     * @param path a path in BIP 32 format
+     * @option boolDisplay optionally enable or not the display
+     * @option boolChaincode optionally enable or not the chaincode request
+     * @return an object with a publickey(hexa string), address(string) and
+     *  (optionally) chaincode(hexa string)
+     * @example
+     * icx.getAddress("44'/4801368'/0'", true, true).then(o => o.address)
+     */
+    getAddress(path: string, boolDisplay?: boolean, boolChaincode?: boolean): Promise<{
+        publicKey: string;
+        address: string;
+        chainCode?: string;
+    }>;
+    /**
+     * Signs a transaction and returns signed message given the raw transaction
+     * and the BIP 32 path of the account to sign
+     * @param path a path in BIP 32 format
+     * @param rawTxAscii raw transaction data to sign in ASCII string format
+     * @return an object with a base64 encoded signature and hash in hexa string
+     * @example
+     * icx.signTransaction("44'/4801368'/0'",
+     *     "icx_sendTransaction.fee.0x2386f26fc10000." +
+     *     "from.hxc9ecad30b05a0650a337452fce031e0c60eacc3a.nonce.0x3." +
+     *     "to.hx4c5101add2caa6a920420cf951f7dd7c7df6ca24.value.0xde0b6b3a7640000")
+     *   .then(result => ...)
+     */
+    signTransaction(path: string, rawTxAscii: string): Promise<{
+        signedRawTxBase64: string;
+        hashHex: string;
+    }>;
+    /**
+     * Returns the application configurations such as versions.
+     * @return  major/minor/patch versions of Icon application
+     */
+    getAppConfiguration(): Promise<{
+        majorVersion: number;
+        minorVersion: number;
+        patchVersion: number;
+    }>;
+}
+//# sourceMappingURL=Icon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../src/Icon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;kFAekF;AAGlF,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AAapD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,GAAG;IACtB,SAAS,EAAE,SAAS,CAAC;gBAET,SAAS,EAAE,SAAS;IAShC;;;;;;;;;OASG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,WAAW,UAAQ,EACnB,aAAa,UAAO,GACnB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAoCF;;;;;;;;;;;;OAYG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QACT,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IA4CF;;;OAGG;IACH,mBAAmB,IAAI,OAAO,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CASH"}

package/lib-es/Icon.js

@@ -0,0 +1,144 @@
+/********************************************************************************
+ *   Ledger JS API for ICON
+ *   (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+import { splitPath, foreach, hexToBase64 } from "./utils";
+import { UserRefusedOnDevice, UserRefusedAddress } from "@ledgerhq/errors";
+const CLA = 0xe0;
+const INS = {
+    GET_VERSION: 0x06,
+    GET_ADDR: 0x02,
+    SIGN: 0x04,
+};
+const SW_OK = 0x9000;
+const SW_CANCEL = 0x6986;
+/**
+ * ICON API
+ *
+ * @example
+ * import Icx from "@ledgerhq/hw-app-icx";
+ * const icx = new Icx(transport)
+ */
+export default class Icx {
+    constructor(transport) {
+        this.transport = transport;
+        transport.decorateAppAPIMethods(this, ["getAddress", "signTransaction", "getAppConfiguration"], "ICON");
+    }
+    /**
+     * Returns public key and ICON address for a given BIP 32 path.
+     * @param path a path in BIP 32 format
+     * @option boolDisplay optionally enable or not the display
+     * @option boolChaincode optionally enable or not the chaincode request
+     * @return an object with a publickey(hexa string), address(string) and
+     *  (optionally) chaincode(hexa string)
+     * @example
+     * icx.getAddress("44'/4801368'/0'", true, true).then(o => o.address)
+     */
+    getAddress(path, boolDisplay = false, boolChaincode = true) {
+        const paths = splitPath(path);
+        const buffer = Buffer.alloc(1 + paths.length * 4);
+        buffer[0] = paths.length;
+        paths.forEach((element, index) => {
+            buffer.writeUInt32BE(element, 1 + 4 * index);
+        });
+        const statusList = [SW_OK, SW_CANCEL];
+        return this.transport
+            .send(CLA, INS.GET_ADDR, boolDisplay ? 0x01 : 0x00, boolChaincode ? 0x01 : 0x00, buffer, statusList)
+            .then(response => {
+            const publicKeyLength = response[0];
+            const addressLength = response[1 + publicKeyLength];
+            const errorCodeData = response.slice(-2);
+            const returnCode = errorCodeData[0] * 0x100 + errorCodeData[1];
+            if (returnCode === SW_CANCEL) {
+                throw new UserRefusedAddress();
+            }
+            return {
+                publicKey: response.slice(1, 1 + publicKeyLength).toString("hex"),
+                address: response
+                    .slice(1 + publicKeyLength + 1, 1 + publicKeyLength + 1 + addressLength)
+                    .toString(),
+                chainCode: boolChaincode ? response.slice(-32).toString("hex") : undefined,
+            };
+        });
+    }
+    /**
+     * Signs a transaction and returns signed message given the raw transaction
+     * and the BIP 32 path of the account to sign
+     * @param path a path in BIP 32 format
+     * @param rawTxAscii raw transaction data to sign in ASCII string format
+     * @return an object with a base64 encoded signature and hash in hexa string
+     * @example
+     * icx.signTransaction("44'/4801368'/0'",
+     *     "icx_sendTransaction.fee.0x2386f26fc10000." +
+     *     "from.hxc9ecad30b05a0650a337452fce031e0c60eacc3a.nonce.0x3." +
+     *     "to.hx4c5101add2caa6a920420cf951f7dd7c7df6ca24.value.0xde0b6b3a7640000")
+     *   .then(result => ...)
+     */
+    signTransaction(path, rawTxAscii) {
+        const paths = splitPath(path);
+        let offset = 0;
+        const rawTx = Buffer.from(rawTxAscii);
+        const toSend = [];
+        let response;
+        while (offset !== rawTx.length) {
+            const maxChunkSize = offset === 0 ? 150 - 1 - paths.length * 4 - 4 : 150;
+            const chunkSize = offset + maxChunkSize > rawTx.length ? rawTx.length - offset : maxChunkSize;
+            const buffer = Buffer.alloc(offset === 0 ? 1 + paths.length * 4 + 4 + chunkSize : chunkSize);
+            if (offset === 0) {
+                buffer[0] = paths.length;
+                paths.forEach((element, index) => {
+                    buffer.writeUInt32BE(element, 1 + 4 * index);
+                });
+                buffer.writeUInt32BE(rawTx.length, 1 + 4 * paths.length);
+                rawTx.copy(buffer, 1 + 4 * paths.length + 4, offset, offset + chunkSize);
+            }
+            else {
+                rawTx.copy(buffer, 0, offset, offset + chunkSize);
+            }
+            toSend.push(buffer);
+            offset += chunkSize;
+        }
+        return foreach(toSend, (data, i) => this.transport
+            .send(CLA, INS.SIGN, i === 0 ? 0x00 : 0x80, 0x00, data, [SW_OK, SW_CANCEL])
+            .then(apduResponse => {
+            response = apduResponse;
+        })).then(() => {
+            const errorCodeData = response.slice(-2);
+            const returnCode = errorCodeData[0] * 0x100 + errorCodeData[1];
+            if (returnCode === SW_CANCEL) {
+                throw new UserRefusedOnDevice();
+            }
+            // r, s, v are aligned sequencially
+            return {
+                signedRawTxBase64: hexToBase64(response.slice(0, 32 + 32 + 1).toString("hex")),
+                hashHex: response.slice(32 + 32 + 1, 32 + 32 + 1 + 32).toString("hex"),
+            };
+        });
+    }
+    /**
+     * Returns the application configurations such as versions.
+     * @return  major/minor/patch versions of Icon application
+     */
+    getAppConfiguration() {
+        return this.transport.send(CLA, INS.GET_VERSION, 0x00, 0x00).then(response => {
+            return {
+                majorVersion: response[0],
+                minorVersion: response[1],
+                patchVersion: response[2],
+            };
+        });
+    }
+}
+//# sourceMappingURL=Icon.js.map

package/lib-es/Icon.js.map

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

package/lib-es/utils.d.ts

@@ -0,0 +1,22 @@
+/********************************************************************************
+ *   Ledger Node JS API for ICON
+ *   (c) 2016-2017 Ledger
+ *
+ *  Modifications (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+export declare function splitPath(path: string): number[];
+export declare function foreach<T, A>(arr: T[], callback: (T: any, number: any) => Promise<A>): Promise<A[]>;
+export declare function hexToBase64(hexString: string): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;kFAiBkF;AAGlF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAchD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAA,EAAE,MAAM,KAAA,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAWzF;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,UAQ5C"}

package/lib-es/utils.js

@@ -0,0 +1,55 @@
+/********************************************************************************
+ *   Ledger Node JS API for ICON
+ *   (c) 2016-2017 Ledger
+ *
+ *  Modifications (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+// TODO use bip32-path library
+export function splitPath(path) {
+    const result = [];
+    const components = path.split("/");
+    components.forEach(element => {
+        let number = parseInt(element, 10);
+        if (isNaN(number)) {
+            return; // FIXME shouldn't it throws instead?
+        }
+        if (element.length > 1 && element[element.length - 1] === "'") {
+            number += 0x80000000;
+        }
+        result.push(number);
+    });
+    return result;
+}
+export function foreach(arr, callback) {
+    function iterate(index, array, result) {
+        if (index >= array.length) {
+            return result;
+        }
+        else
+            return callback(array[index], index).then(function (res) {
+                result.push(res);
+                return iterate(index + 1, array, result);
+            });
+    }
+    return Promise.resolve().then(() => iterate(0, arr, []));
+}
+export function hexToBase64(hexString) {
+    return btoa((hexString.match(/\w{2}/g) || [])
+        .map(function (a) {
+        return String.fromCharCode(parseInt(a, 16));
+    })
+        .join(""));
+}
+//# sourceMappingURL=utils.js.map

package/lib-es/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;kFAiBkF;AAElF,8BAA8B;AAC9B,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,IAAI,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,qCAAqC;QAC/C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9D,MAAM,IAAI,UAAU,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,OAAO,CAAO,GAAQ,EAAE,QAAmC;IACzE,SAAS,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM;QACnC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC;QAChB,CAAC;;YACC,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG;gBACrD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,OAAO,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,IAAI,CACT,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;SAC9B,GAAG,CAAC,UAAU,CAAC;QACd,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CACZ,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ledgerhq/hw-app-icon",
+  "version": "1.1.0-next.0",
+  "description": "Ledger Hardware Wallet ICON Application API",
+  "keywords": [
+    "Ledger",
+    "LedgerWallet",
+    "icx",
+    "Icon",
+    "NanoS",
+    "Blue",
+    "Hardware Wallet"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LedgerHQ/ledger-live"
+  },
+  "bugs": {
+    "url": "https://github.com/LedgerHQ/ledger-live/issues"
+  },
+  "homepage": "https://github.com/LedgerHQ/ledger-live",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/Icon.js",
+  "module": "lib-es/Icon.js",
+  "types": "lib/Icon.d.ts",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "bip32-path": "^0.4.2",
+    "@ledgerhq/errors": "^6.18.0",
+    "@ledgerhq/hw-transport": "^6.31.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.10",
+    "@types/node": "^20.8.10",
+    "jest": "^29.7.0",
+    "rimraf": "^4.4.1",
+    "source-map-support": "^0.5.21",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.4.0",
+    "documentation": "14.0.2",
+    "@ledgerhq/hw-transport-mocker": "^6.29.2",
+    "@ledgerhq/hw-transport-node-speculos": "^6.29.2"
+  },
+  "scripts": {
+    "clean": "rimraf lib lib-es",
+    "build": "tsc && tsc -m ES6 --outDir lib-es",
+    "prewatch": "pnpm build",
+    "watch": "tsc --watch",
+    "doc": "documentation readme src/** --section=API --pe ts --re ts --re d.ts",
+    "lint": "eslint ./src --no-error-on-unmatched-pattern --ext .ts,.tsx",
+    "lint:fix": "pnpm lint --fix",
+    "test": "jest"
+  }
+}

package/src/Icon.ts

@@ -0,0 +1,185 @@
+/********************************************************************************
+ *   Ledger JS API for ICON
+ *   (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+
+import { splitPath, foreach, hexToBase64 } from "./utils";
+import type Transport from "@ledgerhq/hw-transport";
+import { UserRefusedOnDevice, UserRefusedAddress } from "@ledgerhq/errors";
+
+const CLA = 0xe0;
+const INS = {
+  GET_VERSION: 0x06,
+  GET_ADDR: 0x02,
+  SIGN: 0x04,
+};
+
+const SW_OK = 0x9000;
+const SW_CANCEL = 0x6986;
+
+/**
+ * ICON API
+ *
+ * @example
+ * import Icx from "@ledgerhq/hw-app-icx";
+ * const icx = new Icx(transport)
+ */
+export default class Icx {
+  transport: Transport;
+
+  constructor(transport: Transport) {
+    this.transport = transport;
+    transport.decorateAppAPIMethods(
+      this,
+      ["getAddress", "signTransaction", "getAppConfiguration"],
+      "ICON",
+    );
+  }
+
+  /**
+   * Returns public key and ICON address for a given BIP 32 path.
+   * @param path a path in BIP 32 format
+   * @option boolDisplay optionally enable or not the display
+   * @option boolChaincode optionally enable or not the chaincode request
+   * @return an object with a publickey(hexa string), address(string) and
+   *  (optionally) chaincode(hexa string)
+   * @example
+   * icx.getAddress("44'/4801368'/0'", true, true).then(o => o.address)
+   */
+  getAddress(
+    path: string,
+    boolDisplay = false,
+    boolChaincode = true,
+  ): Promise<{
+    publicKey: string;
+    address: string;
+    chainCode?: string;
+  }> {
+    const paths = splitPath(path);
+    const buffer = Buffer.alloc(1 + paths.length * 4);
+    buffer[0] = paths.length;
+    paths.forEach((element, index) => {
+      buffer.writeUInt32BE(element, 1 + 4 * index);
+    });
+    const statusList = [SW_OK, SW_CANCEL];
+    return this.transport
+      .send(
+        CLA,
+        INS.GET_ADDR,
+        boolDisplay ? 0x01 : 0x00,
+        boolChaincode ? 0x01 : 0x00,
+        buffer,
+        statusList,
+      )
+      .then(response => {
+        const publicKeyLength = response[0];
+        const addressLength = response[1 + publicKeyLength];
+        const errorCodeData = response.slice(-2);
+        const returnCode = errorCodeData[0] * 0x100 + errorCodeData[1];
+
+        if (returnCode === SW_CANCEL) {
+          throw new UserRefusedAddress();
+        }
+        return {
+          publicKey: response.slice(1, 1 + publicKeyLength).toString("hex"),
+          address: response
+            .slice(1 + publicKeyLength + 1, 1 + publicKeyLength + 1 + addressLength)
+            .toString(),
+          chainCode: boolChaincode ? response.slice(-32).toString("hex") : undefined,
+        };
+      });
+  }
+
+  /**
+   * Signs a transaction and returns signed message given the raw transaction
+   * and the BIP 32 path of the account to sign
+   * @param path a path in BIP 32 format
+   * @param rawTxAscii raw transaction data to sign in ASCII string format
+   * @return an object with a base64 encoded signature and hash in hexa string
+   * @example
+   * icx.signTransaction("44'/4801368'/0'",
+   *     "icx_sendTransaction.fee.0x2386f26fc10000." +
+   *     "from.hxc9ecad30b05a0650a337452fce031e0c60eacc3a.nonce.0x3." +
+   *     "to.hx4c5101add2caa6a920420cf951f7dd7c7df6ca24.value.0xde0b6b3a7640000")
+   *   .then(result => ...)
+   */
+  signTransaction(
+    path: string,
+    rawTxAscii: string,
+  ): Promise<{
+    signedRawTxBase64: string;
+    hashHex: string;
+  }> {
+    const paths = splitPath(path);
+    let offset = 0;
+    const rawTx = Buffer.from(rawTxAscii);
+    const toSend: Buffer[] = [];
+    let response: Buffer;
+    while (offset !== rawTx.length) {
+      const maxChunkSize = offset === 0 ? 150 - 1 - paths.length * 4 - 4 : 150;
+      const chunkSize = offset + maxChunkSize > rawTx.length ? rawTx.length - offset : maxChunkSize;
+      const buffer = Buffer.alloc(offset === 0 ? 1 + paths.length * 4 + 4 + chunkSize : chunkSize);
+      if (offset === 0) {
+        buffer[0] = paths.length;
+        paths.forEach((element, index) => {
+          buffer.writeUInt32BE(element, 1 + 4 * index);
+        });
+        buffer.writeUInt32BE(rawTx.length, 1 + 4 * paths.length);
+        rawTx.copy(buffer, 1 + 4 * paths.length + 4, offset, offset + chunkSize);
+      } else {
+        rawTx.copy(buffer, 0, offset, offset + chunkSize);
+      }
+      toSend.push(buffer);
+      offset += chunkSize;
+    }
+    return foreach(toSend, (data, i) =>
+      this.transport
+        .send(CLA, INS.SIGN, i === 0 ? 0x00 : 0x80, 0x00, data, [SW_OK, SW_CANCEL])
+        .then(apduResponse => {
+          response = apduResponse;
+        }),
+    ).then(() => {
+      const errorCodeData = response.slice(-2);
+      const returnCode = errorCodeData[0] * 0x100 + errorCodeData[1];
+
+      if (returnCode === SW_CANCEL) {
+        throw new UserRefusedOnDevice();
+      }
+      // r, s, v are aligned sequencially
+      return {
+        signedRawTxBase64: hexToBase64(response.slice(0, 32 + 32 + 1).toString("hex")),
+        hashHex: response.slice(32 + 32 + 1, 32 + 32 + 1 + 32).toString("hex"),
+      };
+    });
+  }
+
+  /**
+   * Returns the application configurations such as versions.
+   * @return  major/minor/patch versions of Icon application
+   */
+  getAppConfiguration(): Promise<{
+    majorVersion: number;
+    minorVersion: number;
+    patchVersion: number;
+  }> {
+    return this.transport.send(CLA, INS.GET_VERSION, 0x00, 0x00).then(response => {
+      return {
+        majorVersion: response[0],
+        minorVersion: response[1],
+        patchVersion: response[2],
+      };
+    });
+  }
+}

package/src/utils.ts

@@ -0,0 +1,58 @@
+/********************************************************************************
+ *   Ledger Node JS API for ICON
+ *   (c) 2016-2017 Ledger
+ *
+ *  Modifications (c) 2018 ICON Foundation
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ ********************************************************************************/
+
+// TODO use bip32-path library
+export function splitPath(path: string): number[] {
+  const result: number[] = [];
+  const components = path.split("/");
+  components.forEach(element => {
+    let number = parseInt(element, 10);
+    if (isNaN(number)) {
+      return; // FIXME shouldn't it throws instead?
+    }
+    if (element.length > 1 && element[element.length - 1] === "'") {
+      number += 0x80000000;
+    }
+    result.push(number);
+  });
+  return result;
+}
+
+export function foreach<T, A>(arr: T[], callback: (T, number) => Promise<A>): Promise<A[]> {
+  function iterate(index, array, result) {
+    if (index >= array.length) {
+      return result;
+    } else
+      return callback(array[index], index).then(function (res) {
+        result.push(res);
+        return iterate(index + 1, array, result);
+      });
+  }
+  return Promise.resolve().then(() => iterate(0, arr, []));
+}
+
+export function hexToBase64(hexString: string) {
+  return btoa(
+    (hexString.match(/\w{2}/g) || [])
+      .map(function (a) {
+        return String.fromCharCode(parseInt(a, 16));
+      })
+      .join(""),
+  );
+}

package/tests/Icon.test.ts

@@ -0,0 +1,35 @@
+import {
+  openTransportReplayer,
+  RecordStore,
+} from "@ledgerhq/hw-transport-mocker";
+import Icon from "../src/Icon";
+
+test("Icon init", async () => {
+  const transport = await openTransportReplayer(RecordStore.fromString(""));
+  const icx = new Icon(transport);
+  expect(icx).not.toBe(undefined);
+});
+
+test("getAppConfiguration", async () => {
+  const transport = await openTransportReplayer(
+    RecordStore.fromString(`
+          => e006000000
+          <= 0102039000
+        `)
+  );
+  const icon = new Icon(transport);
+  const result = await icon.getAppConfiguration();
+  expect(result).toEqual({
+    majorVersion: 1,
+    minorVersion: 2,
+    patchVersion: 3
+  });
+});
+
+test("should throw on invalid derivation path", async () => {
+  const transport = await openTransportReplayer(new RecordStore());
+  const icon = new Icon(transport);
+  return expect(
+    icon.getAddress("some invalid derivation path", false)
+  ).rejects.toThrow("EOF: no more APDU to replay");
+});

package/tsconfig.json

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