@alephium/web3 0.1.0 → 0.2.0-rc.10

package/dist/src/contract/events.d.ts

@@ -1,29 +1,11 @@
-import { node } from '../api';
-import { NodeProvider } from '../api';
-declare type EventCallback = (event: node.ContractEvent) => Promise<void>;
-declare type ErrorCallback = (error: any, subscription: Subscription) => Promise<void>;
-export interface SubscribeOptions {
-    provider: NodeProvider;
-    contractAddress: string;
-    fromCount?: number;
-    pollingInterval: number;
-    eventCallback: EventCallback;
-    errorCallback: ErrorCallback;
-}
-export declare class Subscription {
-    provider: NodeProvider;
+import { ContractEvent } from '../api/api-alephium';
+import { Subscription, SubscribeOptions } from '../utils';
+export declare class EventSubscription extends Subscription<ContractEvent> {
     readonly contractAddress: string;
-    pollingInterval: number;
     private fromCount;
-    private eventCallback;
-    private errorCallback;
-    private task;
-    private cancelled;
-    private eventEmitter;
-    constructor(options: SubscribeOptions);
-    unsubscribe(): void;
+    constructor(options: SubscribeOptions<ContractEvent>, contractAddress: string, fromCount?: number);
+    startPolling(): void;
     currentEventCount(): number;
-    private fetchEvents;
+    polling(): Promise<void>;
 }
-export declare function subscribe(options: SubscribeOptions): Subscription;
-export {};
+export declare function subscribeToEvents(options: SubscribeOptions<ContractEvent>, contractAddress: string, fromCount?: number): EventSubscription;

package/dist/src/contract/events.js

@@ -16,39 +16,26 @@ GNU Lesser General Public License for more details.
 You should have received a copy of the GNU Lesser General Public License
 along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.subscribe = exports.Subscription = void 0;
-const eventemitter3_1 = __importDefault(require("eventemitter3"));
-class Subscription {
-    constructor(options) {
-        this.provider = options.provider;
-        this.contractAddress = options.contractAddress;
-        this.fromCount = typeof options.fromCount === 'undefined' ? 0 : options.fromCount;
-        this.pollingInterval = options.pollingInterval;
-        this.eventCallback = options.eventCallback;
-        this.errorCallback = options.errorCallback;
-        this.task = undefined;
-        this.cancelled = false;
-        this.eventEmitter = new eventemitter3_1.default();
+exports.subscribeToEvents = exports.EventSubscription = void 0;
+const utils_1 = require("../utils");
+class EventSubscription extends utils_1.Subscription {
+    constructor(options, contractAddress, fromCount) {
+        super(options);
+        this.contractAddress = contractAddress;
+        this.fromCount = typeof fromCount === 'undefined' ? 0 : fromCount;
+        this.startPolling();
+    }
+    startPolling() {
         this.eventEmitter.on('tick', async () => {
-            await this.fetchEvents();
+            await this.polling();
         });
         this.eventEmitter.emit('tick');
     }
-    unsubscribe() {
-        this.eventEmitter.removeAllListeners();
-        this.cancelled = true;
-        if (typeof this.task !== 'undefined') {
-            clearTimeout(this.task);
-        }
-    }
     currentEventCount() {
         return this.fromCount;
     }
-    async fetchEvents() {
+    async polling() {
         try {
             const events = await this.provider.events.getEventsContractContractaddress(this.contractAddress, {
                 start: this.fromCount
@@ -60,18 +47,18 @@ class Subscription {
                 this.task = setTimeout(() => this.eventEmitter.emit('tick'), this.pollingInterval);
                 return;
             }
-            const promises = events.events.map((event) => this.eventCallback(event));
+            const promises = events.events.map((event) => this.messageCallback(event));
             await Promise.all(promises);
             this.fromCount = events.nextStart;
-            await this.fetchEvents();
+            await this.polling();
         }
         catch (err) {
             await this.errorCallback(err, this);
         }
     }
 }
-exports.Subscription = Subscription;
-function subscribe(options) {
-    return new Subscription(options);
+exports.EventSubscription = EventSubscription;
+function subscribeToEvents(options, contractAddress, fromCount) {
+    return new EventSubscription(options, contractAddress, fromCount);
 }
-exports.subscribe = subscribe;
+exports.subscribeToEvents = subscribeToEvents;

package/dist/src/contract/index.js

@@ -18,7 +18,11 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/dist/src/global.d.ts

@@ -0,0 +1,4 @@
+import { NodeProvider } from './api';
+export declare function setCurrentNodeProvider(provider: NodeProvider): void;
+export declare function setCurrentNodeProvider(baseUrl: string, apiKey?: string): void;
+export declare function getCurrentNodeProvider(): NodeProvider;

package/dist/src/global.js

@@ -0,0 +1,38 @@
+"use strict";
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentNodeProvider = exports.setCurrentNodeProvider = void 0;
+const api_1 = require("./api");
+let _currentNodeProvider = undefined;
+function setCurrentNodeProvider(provider, apiKey) {
+    if (typeof provider == 'string') {
+        _currentNodeProvider = new api_1.NodeProvider(provider, apiKey);
+    }
+    else {
+        _currentNodeProvider = provider;
+    }
+}
+exports.setCurrentNodeProvider = setCurrentNodeProvider;
+function getCurrentNodeProvider() {
+    if (typeof _currentNodeProvider === 'undefined') {
+        throw Error('No node provider is set.');
+    }
+    return _currentNodeProvider;
+}
+exports.getCurrentNodeProvider = getCurrentNodeProvider;

package/dist/src/index.d.ts

@@ -2,4 +2,7 @@ export * from './api';
 export * from './contract';
 export * from './signer';
 export * from './utils';
+export * from './transaction';
 export * from './constants';
+export * as web3 from './global';
+export * as utils from './utils';

package/dist/src/index.js

@@ -18,17 +18,37 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.utils = exports.web3 = void 0;
 __exportStar(require("./api"), exports);
 __exportStar(require("./contract"), exports);
 __exportStar(require("./signer"), exports);
 __exportStar(require("./utils"), exports);
+__exportStar(require("./transaction"), exports);
 __exportStar(require("./constants"), exports);
+exports.web3 = __importStar(require("./global"));
+exports.utils = __importStar(require("./utils"));

package/dist/src/signer/index.d.ts

@@ -1,2 +1 @@
 export * from './signer';
-export * from './node-wallet';

package/dist/src/signer/index.js

@@ -18,7 +18,11 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -28,4 +32,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./signer"), exports);
-__exportStar(require("./node-wallet"), exports);

package/dist/src/signer/signer.d.ts

@@ -111,7 +111,7 @@ export declare abstract class SignerWithNodeProvider implements SignerProvider {
     alwaysSubmitTx: boolean;
     abstract getAccounts(): Promise<Account[]>;
     getAccount(signerAddress: string): Promise<Account>;
-    constructor(provider: NodeProvider, alwaysSubmitTx: boolean);
+    constructor(alwaysSubmitTx: boolean);
     private defaultSignerAddress;
     submitTransaction(unsignedTx: string, txHash: string, signerAddress?: string): Promise<SubmissionResult>;
     private shouldSubmitTx;

package/dist/src/signer/signer.js

@@ -18,7 +18,11 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -44,6 +48,7 @@ const elliptic_1 = require("elliptic");
 const utils = __importStar(require("../utils"));
 const utils_1 = require("../utils");
 const blakejs_1 = __importDefault(require("blakejs"));
+const global_1 = require("../global");
 const ec = new elliptic_1.ec('secp256k1');
 (0, utils_1.assertType)();
 (0, utils_1.assertType)();
@@ -58,8 +63,8 @@ const ec = new elliptic_1.ec('secp256k1');
 (0, utils_1.assertType)();
 (0, utils_1.assertType)();
 class SignerWithNodeProvider {
-    constructor(provider, alwaysSubmitTx) {
-        this.provider = provider;
+    constructor(alwaysSubmitTx) {
+        this.provider = (0, global_1.getCurrentNodeProvider)();
         this.alwaysSubmitTx = alwaysSubmitTx;
     }
     async getAccount(signerAddress) {

package/dist/src/transaction/index.d.ts

@@ -0,0 +1 @@
+export * from './status';

package/dist/src/{test → transaction}/index.js

@@ -18,7 +18,11 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -27,15 +31,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.testWallet = exports.testPassword = exports.testAddress = exports.testWalletName = void 0;
-const signer_1 = require("../signer");
-exports.testWalletName = 'alephium-web3-test-only-wallet';
-exports.testAddress = '1DrDyTr9RpRsQnDnXo2YRiPzPW4ooHX5LLoqXrqfMrpQH';
-exports.testPassword = 'alph';
-async function testWallet(provider) {
-    const wallet = new signer_1.NodeWallet(provider, exports.testWalletName);
-    await wallet.unlock(exports.testPassword);
-    return wallet;
-}
-exports.testWallet = testWallet;
-__exportStar(require("./privatekey-wallet"), exports);
+__exportStar(require("./status"), exports);

package/dist/src/transaction/status.d.ts

@@ -0,0 +1,10 @@
+import { TxStatus } from '../api/api-alephium';
+import { Subscription, SubscribeOptions } from '../utils';
+export declare class TxStatusSubscription extends Subscription<TxStatus> {
+    readonly txId: string;
+    readonly fromGroup?: number;
+    readonly toGroup?: number;
+    constructor(options: SubscribeOptions<TxStatus>, txId: string, fromGroup?: number, toGroup?: number);
+    polling(): Promise<void>;
+}
+export declare function subscribeToTxStatus(options: SubscribeOptions<TxStatus>, txId: string, fromGroup?: number, toGroup?: number): TxStatusSubscription;

package/dist/src/transaction/status.js

@@ -0,0 +1,48 @@
+"use strict";
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscribeToTxStatus = exports.TxStatusSubscription = void 0;
+const utils_1 = require("../utils");
+class TxStatusSubscription extends utils_1.Subscription {
+    constructor(options, txId, fromGroup, toGroup) {
+        super(options);
+        this.txId = txId;
+        this.fromGroup = fromGroup;
+        this.toGroup = toGroup;
+        this.startPolling();
+    }
+    async polling() {
+        try {
+            const txStatus = await this.provider.transactions.getTransactionsStatus({
+                txId: this.txId,
+                fromGroup: this.fromGroup,
+                toGroup: this.toGroup
+            });
+            await this.messageCallback(txStatus);
+        }
+        catch (err) {
+            await this.errorCallback(err, this);
+        }
+    }
+}
+exports.TxStatusSubscription = TxStatusSubscription;
+function subscribeToTxStatus(options, txId, fromGroup, toGroup) {
+    return new TxStatusSubscription(options, txId, fromGroup, toGroup);
+}
+exports.subscribeToTxStatus = subscribeToTxStatus;

package/dist/src/utils/index.d.ts

@@ -1,6 +1,5 @@
 export * from './address';
 export * from './bs58';
 export * from './djb2';
-export * from './password-crypto';
-export * from './transaction';
 export * from './utils';
+export * from './subscription';

package/dist/src/utils/index.js

@@ -18,7 +18,11 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -30,6 +34,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./address"), exports);
 __exportStar(require("./bs58"), exports);
 __exportStar(require("./djb2"), exports);
-__exportStar(require("./password-crypto"), exports);
-__exportStar(require("./transaction"), exports);
 __exportStar(require("./utils"), exports);
+__exportStar(require("./subscription"), exports);

package/dist/src/utils/subscription.d.ts

@@ -0,0 +1,23 @@
+import EventEmitter from 'eventemitter3';
+import { NodeProvider } from '../api';
+declare type MessageCallback<Message> = (message: Message) => Promise<void>;
+declare type ErrorCallback<Message> = (error: any, subscription: Subscription<Message>) => Promise<void>;
+export interface SubscribeOptions<Message> {
+    pollingInterval: number;
+    messageCallback: MessageCallback<Message>;
+    errorCallback: ErrorCallback<Message>;
+}
+export declare abstract class Subscription<Message> {
+    provider: NodeProvider;
+    pollingInterval: number;
+    protected messageCallback: MessageCallback<Message>;
+    protected errorCallback: ErrorCallback<Message>;
+    protected task: ReturnType<typeof setTimeout> | undefined;
+    protected eventEmitter: EventEmitter;
+    protected cancelled: boolean;
+    constructor(options: SubscribeOptions<Message>);
+    startPolling(): void;
+    unsubscribe(): void;
+    abstract polling(): Promise<void>;
+}
+export {};

package/dist/src/utils/subscription.js

@@ -0,0 +1,53 @@
+"use strict";
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subscription = void 0;
+const eventemitter3_1 = __importDefault(require("eventemitter3"));
+const global_1 = require("../global");
+class Subscription {
+    constructor(options) {
+        this.provider = (0, global_1.getCurrentNodeProvider)();
+        this.pollingInterval = options.pollingInterval;
+        this.messageCallback = options.messageCallback;
+        this.errorCallback = options.errorCallback;
+        this.task = undefined;
+        this.cancelled = false;
+        this.eventEmitter = new eventemitter3_1.default();
+    }
+    startPolling() {
+        this.eventEmitter.on('tick', async () => {
+            await this.polling();
+            if (!this.cancelled) {
+                this.task = setTimeout(() => this.eventEmitter.emit('tick'), this.pollingInterval);
+            }
+        });
+        this.eventEmitter.emit('tick');
+    }
+    unsubscribe() {
+        this.eventEmitter.removeAllListeners();
+        this.cancelled = true;
+        if (typeof this.task !== 'undefined') {
+            clearTimeout(this.task);
+        }
+    }
+}
+exports.Subscription = Subscription;

package/dist/src/utils/utils.d.ts

@@ -7,9 +7,10 @@ export declare function convertHttpResponse<T>(response: node.HttpResponse<T, {
     detail: string;
 }>): T;
 export declare function signatureEncode(signature: EC.Signature): string;
-export declare const signatureDecode: (ec: EC, signature: string) => SignatureInput;
+export declare function signatureDecode(ec: EC, signature: string): SignatureInput;
+export declare function xorByte(intValue: number): number;
 export declare function isHexString(input: string): boolean;
-export declare const groupOfAddress: (address: string) => number;
+export declare function groupOfAddress(address: string): number;
 export declare function contractIdFromAddress(address: string): Uint8Array;
 export declare function tokenIdFromAddress(address: string): Uint8Array;
 export declare function hexToBinUnsafe(hex: string): Uint8Array;
@@ -20,6 +21,8 @@ export declare function addressFromContractId(contractId: string): string;
 export declare function contractIdFromTx(txId: string, outputIndex: number): string;
 export declare function subContractId(parentContractId: string, pathInHex: string): string;
 export declare function stringToHex(str: string): string;
+export declare function hexToString(str: string): string;
+export declare function timeout(ms: number): Promise<void>;
 declare type _Eq<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;
 export declare type Eq<X, Y> = _Eq<{
     [P in keyof X]: X[P];

package/dist/src/utils/utils.js

@@ -20,7 +20,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertType = exports.stringToHex = exports.subContractId = exports.contractIdFromTx = exports.addressFromContractId = exports.addressFromPublicKey = exports.publicKeyFromPrivateKey = exports.binToHex = exports.hexToBinUnsafe = exports.tokenIdFromAddress = exports.contractIdFromAddress = exports.groupOfAddress = exports.isHexString = exports.signatureDecode = exports.signatureEncode = exports.convertHttpResponse = void 0;
+exports.assertType = exports.timeout = exports.hexToString = exports.stringToHex = exports.subContractId = exports.contractIdFromTx = exports.addressFromContractId = exports.addressFromPublicKey = exports.publicKeyFromPrivateKey = exports.binToHex = exports.hexToBinUnsafe = exports.tokenIdFromAddress = exports.contractIdFromAddress = exports.groupOfAddress = exports.isHexString = exports.xorByte = exports.signatureDecode = exports.signatureEncode = exports.convertHttpResponse = void 0;
 const elliptic_1 = require("elliptic");
 const bn_js_1 = __importDefault(require("bn.js"));
 const blakejs_1 = __importDefault(require("blakejs"));
@@ -49,7 +49,7 @@ function signatureEncode(signature) {
 }
 exports.signatureEncode = signatureEncode;
 // the signature should be in hex string format for 64 bytes
-const signatureDecode = (ec, signature) => {
+function signatureDecode(ec, signature) {
     if (signature.length !== 128) {
         throw new Error('Invalid signature length');
     }
@@ -62,15 +62,16 @@ const signatureDecode = (ec, signature) => {
     else {
         throw new Error('The signature is not normalized');
     }
-};
+}
 exports.signatureDecode = signatureDecode;
-const xorByte = (intValue) => {
+function xorByte(intValue) {
     const byte0 = (intValue >> 24) & 0xff;
     const byte1 = (intValue >> 16) & 0xff;
     const byte2 = (intValue >> 8) & 0xff;
     const byte3 = intValue & 0xff;
     return (byte0 ^ byte1 ^ byte2 ^ byte3) & 0xff;
-};
+}
+exports.xorByte = xorByte;
 function isHexString(input) {
     return input.length % 2 === 0 && /[0-9a-f]*$/.test(input);
 }
@@ -82,7 +83,7 @@ var AddressType;
     AddressType[AddressType["P2SH"] = 2] = "P2SH";
     AddressType[AddressType["P2C"] = 3] = "P2C";
 })(AddressType || (AddressType = {}));
-const groupOfAddress = (address) => {
+function groupOfAddress(address) {
     const decoded = bs58_1.default.decode(address);
     if (decoded.length == 0)
         throw new Error('Address string is empty');
@@ -100,32 +101,32 @@ const groupOfAddress = (address) => {
     else {
         throw new Error(`Invalid asset address type: ${addressType}`);
     }
-};
+}
 exports.groupOfAddress = groupOfAddress;
-const groupOfAddressBytes = (bytes) => {
+function groupOfAddressBytes(bytes) {
     const hint = (0, djb2_1.default)(bytes) | 1;
     const hash = xorByte(hint);
     const group = hash % constants_1.TOTAL_NUMBER_OF_GROUPS;
     return group;
-};
+}
 // Pay to public key hash address
-const groupOfP2pkhAddress = (address) => {
+function groupOfP2pkhAddress(address) {
     if (address.length != 32) {
         throw new Error(`Invalid p2pkh address length: ${address.length}`);
     }
     return groupOfAddressBytes(address);
-};
+}
 // Pay to multiple public key hash address
-const groupOfP2mpkhAddress = (address) => {
+function groupOfP2mpkhAddress(address) {
     if ((address.length - 2) % 32 != 0) {
         throw new Error(`Invalid p2mpkh address length: ${address.length}`);
     }
     return groupOfAddressBytes(address.slice(1, 33));
-};
+}
 // Pay to script hash address
-const groupOfP2shAddress = (address) => {
+function groupOfP2shAddress(address) {
     return groupOfAddressBytes(address);
-};
+}
 function contractIdFromAddress(address) {
     return idFromAddress(address);
 }
@@ -182,7 +183,7 @@ function contractIdFromTx(txId, outputIndex) {
 }
 exports.contractIdFromTx = contractIdFromTx;
 function subContractId(parentContractId, pathInHex) {
-    const data = buffer_1.Buffer.concat([hexToBinUnsafe(pathInHex), hexToBinUnsafe(parentContractId)]);
+    const data = buffer_1.Buffer.concat([hexToBinUnsafe(parentContractId), hexToBinUnsafe(pathInHex)]);
     return binToHex(blakejs_1.default.blake2b(blakejs_1.default.blake2b(data, undefined, 32), undefined, 32));
 }
 exports.subContractId = subContractId;
@@ -194,6 +195,14 @@ function stringToHex(str) {
     return hex;
 }
 exports.stringToHex = stringToHex;
+function hexToString(str) {
+    return buffer_1.Buffer.from(str, 'hex').toString();
+}
+exports.hexToString = hexToString;
+function timeout(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+exports.timeout = timeout;
 // eslint-disable-next-line @typescript-eslint/no-empty-function, @typescript-eslint/no-unused-vars
 function assertType() { }
 exports.assertType = assertType;

package/jest-config.json

@@ -0,0 +1,11 @@
+{
+  "testPathIgnorePatterns": [".*/node_modules/"],
+  "transform": {
+    "^.+\\.(t|j)sx?$": "ts-jest"
+  },
+  "testMatch": ["**/*.test.ts"],
+  "moduleFileExtensions": ["ts", "tsx", "js", "jsx", "json", "node"],
+  "collectCoverage": true,
+  "coverageDirectory": "./coverage/",
+  "collectCoverageFrom": ["src/**/*.ts"]
+}