postchain-client 1.3.2 → 1.5.0

package/built/index.d.ts

@@ -8,3 +8,5 @@ export * as merkle from "./src/merkle/merkleHelper";
 export * as encryption from "./src/encryption/encryption";
 export * as restClientutil from "./src/restclient/restclientutil";
 export * as chromiaClient from "./src/chromia/chromiaClientProvider";
+export { createClient } from "./src/blockchainClient/blockchainClient";
+export { newSignatureProvider } from "./src/gtx/gtx";

package/built/index.js

@@ -18,4 +18,6 @@ import * as restClientutil_1 from "./src/restclient/restclientutil";
 export { restClientutil_1 as restClientutil };
 import * as chromiaClient_1 from "./src/chromia/chromiaClientProvider";
 export { chromiaClient_1 as chromiaClient };
+export { createClient } from "./src/blockchainClient/blockchainClient";
+export { newSignatureProvider } from "./src/gtx/gtx";
 //# sourceMappingURL=index.js.map

package/built/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"uBAAqB,iBAAiB;kBAA1B,GAAG;6BACY,iBAAiB;wBAAhC,SAAS;uBACA,eAAe;kBAAxB,GAAG;6BACY,qBAAqB;wBAApC,SAAS;8BACO,6BAA6B;yBAA7C,UAAU;0BACE,cAAc;qBAA1B,MAAM;0BACM,2BAA2B;qBAAvC,MAAM;8BACU,6BAA6B;yBAA7C,UAAU;kCACU,iCAAiC;6BAArD,cAAc;iCACK,qCAAqC;4BAAxD,aAAa"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"uBAAqB,iBAAiB;kBAA1B,GAAG;6BACY,iBAAiB;wBAAhC,SAAS;uBACA,eAAe;kBAAxB,GAAG;6BACY,qBAAqB;wBAApC,SAAS;8BACO,6BAA6B;yBAA7C,UAAU;0BACE,cAAc;qBAA1B,MAAM;0BACM,2BAA2B;qBAAvC,MAAM;8BACU,6BAA6B;yBAA7C,UAAU;kCACU,iCAAiC;6BAArD,cAAc;iCACK,qCAAqC;4BAAxD,aAAa;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/built/src/blockchainClient/blockchainClient.d.ts

@@ -0,0 +1,3 @@
+import { NetworkSettings } from "./types";
+import { IClient } from "./interface";
+export declare function createClient(settings: NetworkSettings): Promise<IClient>;

package/built/src/blockchainClient/blockchainClient.js

@@ -0,0 +1,251 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { randomBytes } from "crypto";
+import _ from "lodash";
+import { logger } from "../..";
+import { toBuffer, toString, toQueryObjectGTV } from "../formatter";
+import { encodeValue } from "../gtx/serialization";
+import { handleGetResponse, handlePostResponse, } from "../restclient/restclient";
+import { requestWithRetry } from "../restclient/restclientutil";
+import { Method } from "../restclient/types";
+import * as gtxTool from "../gtx/gtx";
+import { ResponseStatus, } from "./types";
+import { LostMessageError, TxRejectedError, UnexpectedResponseError, UnvalidTxRidException, } from "../restclient/errors";
+import { callbackPromiseBuilder, getConfig, getGTXFromBufferOrTransactionOrOperation, getSerializedGTX, handlePostResponsePromisified, validTxRID, } from "./utils";
+import { Web3PromiEvent } from "../promiEvent/promiEvents";
+import { NumberOfSignersAndSignaturesException } from "../gtx/errors";
+import { makeKeyPair } from "../encryption/encryption";
+import { getTransactionRIDException } from "./errors";
+export function createClient(settings) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const blockchainRID = settings.blockchainRID;
+        return {
+            config: yield getConfig(settings),
+            query(nameOrQueryObject, args, callback) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    let _name, _args;
+                    if (typeof nameOrQueryObject === "string") {
+                        _name = nameOrQueryObject;
+                        _args = args;
+                    }
+                    else {
+                        _name = nameOrQueryObject === null || nameOrQueryObject === void 0 ? void 0 : nameOrQueryObject.name;
+                        _args = nameOrQueryObject === null || nameOrQueryObject === void 0 ? void 0 : nameOrQueryObject.args;
+                    }
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.POST, `query_gtv/${blockchainRID}`, this.config, encodeValue(toQueryObjectGTV(_name, _args)));
+                    return new Promise((resolve, reject) => {
+                        handlePostResponse(error, statusCode, rspBody, callbackPromiseBuilder(reject, resolve, callback));
+                    });
+                });
+            },
+            signTransaction(transaction, signMethod, callback) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    const signMethodIsPrivKey = "privKey" in signMethod;
+                    logger.debug(`signing transaction with ${signMethodIsPrivKey
+                        ? "privkey: " + signMethod.privKey.toString("hex")
+                        : "signature provider [pubkey: " + toString(signMethod.pubKey) + "]"}`);
+                    const gtx = getGTXFromBufferOrTransactionOrOperation(transaction, this.config.blockchainRID);
+                    try {
+                        const signedTx = yield (signMethodIsPrivKey
+                            ? gtxTool.sign(gtx, signMethod.privKey, signMethod.pubKey)
+                            : gtxTool.sign(gtx, signMethod));
+                        const gtxBytes = getSerializedGTX(signedTx);
+                        if (typeof callback === "function") {
+                            callback(null, gtxBytes);
+                        }
+                        return gtxBytes;
+                    }
+                    catch (error) {
+                        if (typeof callback === "function") {
+                            callback(error, null);
+                        }
+                        throw new Error(error);
+                    }
+                });
+            },
+            sendTransaction(transaction, callback) {
+                const promiEvent = new Web3PromiEvent((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+                    const gtx = getGTXFromBufferOrTransactionOrOperation(transaction, this.config.blockchainRID);
+                    if (gtx.signers.length !== gtx.signatures.length) {
+                        reject(new NumberOfSignersAndSignaturesException());
+                    }
+                    const gtxBytes = getSerializedGTX(gtx);
+                    const transactionObject = {
+                        tx: gtxBytes.toString("hex"),
+                    };
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.POST, "tx/" + blockchainRID, this.config, transactionObject);
+                    const transactionRID = gtxTool.getDigestToSign(gtx);
+                    try {
+                        yield handlePostResponsePromisified(error, statusCode, rspBody);
+                        if (typeof callback === "function") {
+                            callback(null, {
+                                status: ResponseStatus.Waiting,
+                                statusCode,
+                                transactionRID,
+                            });
+                        }
+                    }
+                    catch (_error) {
+                        if (typeof callback === "function") {
+                            callback(_error, null);
+                        }
+                        return reject(_error);
+                    }
+                    promiEvent.emit("sent", {
+                        status: ResponseStatus.Waiting,
+                        statusCode: statusCode,
+                        transactionRID,
+                    });
+                    const waitConfirmation = (txRID) => {
+                        return new Promise((resolve, reject) => {
+                            this.getTransactionStatus(txRID, (error, result) => {
+                                if (error) {
+                                    reject(error);
+                                }
+                                else {
+                                    const status = result.status;
+                                    switch (status) {
+                                        case ResponseStatus.Confirmed:
+                                            resolve(ResponseStatus.Confirmed);
+                                            break;
+                                        case ResponseStatus.Rejected:
+                                            reject(new TxRejectedError(result.rejectReason));
+                                            break;
+                                        case ResponseStatus.Unknown:
+                                            reject(new LostMessageError());
+                                            break;
+                                        case ResponseStatus.Waiting:
+                                            setTimeout(() => waitConfirmation(txRID).then(resolve, reject), this.config.pollingInterval);
+                                            break;
+                                        default:
+                                            logger.error(status);
+                                            reject(new UnexpectedResponseError());
+                                    }
+                                }
+                            });
+                        });
+                    };
+                    try {
+                        waitConfirmation(gtxTool.getDigestToSign(gtx)).then((confirmationStatus) => {
+                            resolve({
+                                status: confirmationStatus,
+                                statusCode: statusCode,
+                                transactionRID,
+                            });
+                        });
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                }));
+                return promiEvent;
+            },
+            signAndSendUniqueTransaction(transactionOrOperation, signMethod, callback) {
+                const promiEvent = new Web3PromiEvent((resolve, reject) => {
+                    const signMethodIsPrivKey = "privKey" in signMethod;
+                    let _pubKey;
+                    if (signMethodIsPrivKey) {
+                        _pubKey = !signMethod.pubKey
+                            ? makeKeyPair(signMethod.privKey).pubKey
+                            : signMethod.pubKey;
+                    }
+                    const transaction = "name" in transactionOrOperation
+                        ? {
+                            operations: [transactionOrOperation],
+                            signers: [signMethod.pubKey || _pubKey],
+                        }
+                        : transactionOrOperation;
+                    const hasNop = transaction.operations.some((operation) => {
+                        return operation.name === "nop";
+                    });
+                    const transactionWithNop = hasNop
+                        ? transaction
+                        : this.addNop(transaction);
+                    this.signTransaction(transactionWithNop, signMethod)
+                        .then((signedTx) => {
+                        const sendTransactionPromiEvent = this.sendTransaction(signedTx, callback);
+                        sendTransactionPromiEvent.on("sent", (receipt) => {
+                            promiEvent.emit("sent", receipt);
+                        });
+                        resolve(sendTransactionPromiEvent);
+                    })
+                        .catch((error) => {
+                        reject(error);
+                    });
+                });
+                return promiEvent;
+            },
+            getTransaction(transactionRID, callback) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    if (!validTxRID(transactionRID)) {
+                        if (typeof callback === "function") {
+                            callback(new UnvalidTxRidException(transactionRID), null);
+                        }
+                        throw new UnvalidTxRidException(transactionRID);
+                    }
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.GET, "tx/" + blockchainRID + "/" + transactionRID.toString("hex"), this.config);
+                    return new Promise((resolve, reject) => {
+                        handleGetResponse(error, statusCode, statusCode === 200 ? toBuffer(rspBody.tx) : rspBody, callbackPromiseBuilder(reject, resolve, callback));
+                    });
+                });
+            },
+            getTransactionStatus(transactionRID, callback) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    if (!validTxRID(transactionRID)) {
+                        const error = new UnvalidTxRidException(transactionRID);
+                        if (typeof callback === "function") {
+                            callback(error, null);
+                        }
+                        throw error;
+                    }
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.GET, "tx/" +
+                        blockchainRID +
+                        "/" +
+                        transactionRID.toString("hex") +
+                        "/status", this.config);
+                    return new Promise((resolve, reject) => {
+                        handleGetResponse(error, statusCode, rspBody, callbackPromiseBuilder(reject, resolve, callback));
+                    });
+                });
+            },
+            addNop(transaction) {
+                const _transaction = _.cloneDeep(transaction);
+                const noOperation = {
+                    name: "nop",
+                    args: [randomBytes(32)],
+                };
+                _transaction.operations = [..._transaction.operations, noOperation];
+                return _transaction;
+            },
+            getTransactionRID(transaction) {
+                try {
+                    const gtx = getGTXFromBufferOrTransactionOrOperation(transaction, this.config.blockchainRID);
+                    return gtxTool.getDigestToSign(gtx);
+                }
+                catch (e) {
+                    throw new getTransactionRIDException(e);
+                }
+            },
+            encodeTransaction(transaction) {
+                const gtx = getGTXFromBufferOrTransactionOrOperation(transaction, this.config.blockchainRID);
+                return gtxTool.serialize(gtx);
+            },
+            decodeTransactionToGTX(encodedTransaction) {
+                const gtx = gtxTool.deserialize(encodedTransaction);
+                logger.debug(`Output from deserializing a raw transaction: ${JSON.stringify(gtx)}`);
+                return gtx;
+            },
+            getClientNodeURLPool() {
+                return this.config.endpointPool;
+            },
+        };
+    });
+}
+//# sourceMappingURL=blockchainClient.js.map

package/built/src/blockchainClient/blockchainClient.js.map

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

package/built/src/blockchainClient/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class MissingPubKeyError extends Error {
+    constructor();
+}
+export declare class MissingBlockchainError extends Error {
+    constructor();
+}
+export declare class MissingNodeUrlError extends Error {
+    constructor();
+}
+export declare class InvalidTransactionFormatException extends Error {
+    constructor();
+}
+export declare class getTransactionRIDException extends Error {
+    constructor(error: Error);
+}

package/built/src/blockchainClient/errors.js

@@ -0,0 +1,26 @@
+export class MissingPubKeyError extends Error {
+    constructor() {
+        super(`No public key was provided`);
+    }
+}
+export class MissingBlockchainError extends Error {
+    constructor() {
+        super(`No target blockchain was provided`);
+    }
+}
+export class MissingNodeUrlError extends Error {
+    constructor() {
+        super(`No node url or directory node url was provided`);
+    }
+}
+export class InvalidTransactionFormatException extends Error {
+    constructor() {
+        super(`The transaction is not in the right format`);
+    }
+}
+export class getTransactionRIDException extends Error {
+    constructor(error) {
+        super(`"Error occurred while getting transaction RID:", ${error}`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/built/src/blockchainClient/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/blockchainClient/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;QACE,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtC,CAAC;CACF;AACD,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C;QACE,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC7C,CAAC;CACF;AACD,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IAC1D;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtD,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,KAAY;QACtB,KAAK,CAAC,oDAAoD,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;CACF"}

package/built/src/blockchainClient/interface.d.ts

@@ -0,0 +1,108 @@
+/// <reference types="node" />
+import { KeyPair } from "./types";
+import { RawGtv } from "../gtv/types";
+import { Web3PromiEvent } from "../promiEvent/promiEvents";
+import { StatusObject } from "../restclient/types";
+import { ClientConfig, Operation, QueryArguments, QueryCallback, QueryObject, SignatureProvider, SignedTransaction, Transaction, TransactionReceipt } from "./types";
+import { GTX } from "../gtx/types";
+export interface Queryable {
+    query<TArgs extends QueryArguments | undefined = QueryArguments, TReturn extends RawGtv = RawGtv>(nameOrQueryObject: string | QueryObject<TArgs>, args?: TArgs, callback?: QueryCallback<TReturn>): Promise<TReturn>;
+}
+export interface IClient extends Queryable {
+    config: ClientConfig;
+    /**
+     * Performs an asynchronous query to the Rell backend. Returns either a resolved or rejected promise. The input is the name of the query followed by the arguments of the
+     * query as an optional input argument.
+     *
+     * @template TArgs - The type of the query arguments. Defaults to `QueryArguments`.
+     * @template TReturn - The type of the query return value. Defaults to `RawGtv`.
+     * @param nameOrQueryObject - the name of the query in Rell or a QueryObject containing name and args
+     * @param args - The query argument following this pattern: { arg1: argValue1, arg2: argvalue2 }
+     * @param callback - A callback function to handle the query response. Parameters (error, signedTx).
+     * @returns - A promise that resolves with the query result.
+     */
+    query<TArgs extends QueryArguments | undefined = QueryArguments, TReturn extends RawGtv = RawGtv>(nameOrQueryObject: string | QueryObject<TArgs>, args?: TArgs, callback?: QueryCallback<TReturn>): Promise<TReturn>;
+    /**
+     * Signs a transaction using the provided signing method. The signature provider must contain a public key and a `sign` function that returns the signature of a digest.
+     *
+     * @param transaction - The transaction or signed transaction to be signed.
+     * @param signMethod - The signing method, either a KeyPair or a SignatureProvider. A signature provider with a `sign` callback and a `pubkey` or a key pair where `pubKey`is optional.
+     * @param callback - A callback function to handle the signing result. Parameters (error, signedTx)
+     * * @returns - A promise that resolves with the signed transaction.
+     */
+    signTransaction(transaction: Transaction | SignedTransaction, signMethod: KeyPair | SignatureProvider, callback?: (error: Error, signedTx: Buffer) => void): Promise<SignedTransaction>;
+    /**
+     * Sends a transaction to the blockchain.
+     *
+     * @param transaction - The signed transaction, transaction, or operation to send.
+     * @param callback - A callback function to handle the transaction receipt. Parameter (error, transactionReceipt).
+     * @returns - A Web3PromiEvent that resolves with the transaction receipt.
+     */
+    sendTransaction(transaction: Transaction | SignedTransaction | Operation, callback?: (error: Error, transactionReceipt: TransactionReceipt) => void): Web3PromiEvent<TransactionReceipt, {
+        sent: TransactionReceipt;
+    }>;
+    /**
+     * Signs and sends a transaction for inclusion in a block. It adds a nop
+     * if missing.
+     * @param transaction - The operation or transaction to sign and send.
+     * @param signMethod - The signing method, either a KeyPair or a SignatureProvider. A signature provider with a `sign` callback and a `pubkey` or a key pair where `pubKey`is optional.
+     * @param callback - A callback function to handle the transaction receipt.
+     * @returns - A Web3PromiEvent that resolves with the transaction receipt.
+     *
+     */
+    signAndSendUniqueTransaction(transaction: Operation | Transaction, signMethod: KeyPair | SignatureProvider, callback?: (error: Error, transactionReceipt: TransactionReceipt) => void): Web3PromiEvent<TransactionReceipt, {
+        sent: TransactionReceipt;
+    }>;
+    /**
+     * Retrieves a transaction given its transaction RID.
+     *
+     * @param transactionRID - The transaction RID.
+     * @param callback - A callback function to handle the serialized message. Parameters (error, serializedMessage) if first
+     * parameter is not null, an error occurred.
+     * If first parameter is null, then the second parameter is a buffer
+     * with the serialized client message. If no such client message exists,
+     * the callback will be called with (null, null).
+     * @returns- A promise that resolves with the serialized message of the transaction.
+     */
+    getTransaction(transactionRID: Buffer, callback?: (error: Error, serializedMessage: Buffer) => void): Promise<Buffer>;
+    /**
+     * Retrieves the status of a transaction given its transaction RID.
+     *
+     * @param transactionRID - The transaction RID.
+     * @param callback - A callback function to handle the response body. Taking parameters (error, responseBody). If error is null
+     * then responseBody is an object on the form
+     * { status: '<confirmed|waiting|rejected|unknown>' }
+     * If error is not null, then responseBody
+     * is an object with the string property 'error'.
+     * @returns - A promise that resolves with the status object of the transaction.
+     *
+     */
+    getTransactionStatus: (transactionRID: Buffer, callback?: (error: Error, responseBody: StatusObject) => void) => Promise<StatusObject>;
+    /**
+     * Adds an operation containing a nonce which makes the transaction unique.
+     *
+     * @param transaction - The transaction to sign and send.
+     */
+    addNop(transaction: Transaction): Transaction;
+    /**
+     * Calculates and returns the transaction RID, i.e., the merkle root hash of the transaction.
+     * @param transaction The transaction to sign and send
+     */
+    getTransactionRID(transaction: Transaction | SignedTransaction | Operation): Buffer;
+    /**
+     * Encodes the transaction using ASN.1.
+     * @returns the transaction encoded
+     */
+    encodeTransaction(transaction: Transaction): Buffer;
+    /**
+     * Decodes the transaction using ASN.1.
+     * @returns the transaction decoded in GTX format
+     */
+    decodeTransactionToGTX(transaction: Buffer): GTX;
+    /**
+     * Retrieves the client node URL pool.
+     *
+     * @returns An array of the client node URL pool.
+     */
+    getClientNodeURLPool(): string[];
+}

package/built/src/blockchainClient/interface.js

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

package/built/src/blockchainClient/interface.js.map

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

package/built/src/blockchainClient/types.d.ts

@@ -0,0 +1,91 @@
+/// <reference types="node" />
+import { RawGtv } from "../gtv/types";
+import { FailOverConfig } from "../restclient/types";
+export type KeyPair = {
+    privKey: Buffer;
+    pubKey?: Buffer;
+};
+export type QueryArguments = {
+    [arg: string]: RawGtv;
+};
+export type ClientConfig = {
+    endpointPool: readonly string[];
+    blockchainRID: Buffer;
+    pollingInterval: number;
+    attemptsPerEndpoint: number;
+    attemptInterval: number;
+};
+export type URL = string;
+interface DirectoryNode {
+    directoryChainNodeURL: URL | URL[];
+    directoryChainRID: string;
+}
+type NodeURLPool = URL | URL[] | DirectoryNode;
+interface PostchainClientBaseConfig {
+    nodeURLPool: NodeURLPool;
+    connectionConfig?: ConnectionConfig;
+}
+type ConnectionConfig = {
+    endpointPool: readonly string[];
+    blockchainRID: string;
+    maxSockets: number;
+    pollingInterval: number;
+    failOverConfig?: FailOverConfig;
+};
+interface PostchainClientRIDConfig extends PostchainClientBaseConfig {
+    targetChainRID: string;
+    targetChainIID?: never;
+}
+interface PostchainClientIIDConfig extends PostchainClientBaseConfig {
+    targetChainIID: number;
+    targetChainRID?: never;
+}
+export type PostchainClientConfig = PostchainClientRIDConfig | PostchainClientIIDConfig;
+export type NetworkSettings = {
+    nodeURLPool?: string | string[];
+    directoryNodeURLPool?: string | string[];
+    blockchainRID?: string;
+    blockchainIID?: number;
+    pollingInterval?: number;
+    failOverConfig?: FailOverConfig;
+};
+export interface TransactionReceipt {
+    status: ResponseStatus;
+    statusCode: number;
+    transactionRID: Buffer;
+}
+export type SignedTransaction = Buffer;
+export interface SignatureProvider {
+    sign(digest: Buffer): Promise<Buffer>;
+    readonly pubKey: Buffer;
+}
+export type RestClientQueryObject = {
+    type: string;
+    [arg: string]: RawGtv;
+};
+export type QueryObject<TArgs> = {
+    name: string;
+    args?: TArgs;
+};
+export type QueryCallback<TReturn> = (error: Error, response: TReturn) => void;
+export type PrivKey = Buffer;
+export type PubKey = Buffer;
+export type Operation = {
+    name: string;
+    args?: RawGtv[];
+};
+export interface Transaction {
+    operations: Operation[];
+    signers: Buffer[];
+}
+export type StatusObject = {
+    status: ResponseStatus;
+    rejectReason?: string;
+};
+export declare enum ResponseStatus {
+    Confirmed = "confirmed",
+    Rejected = "rejected",
+    Unknown = "unknown",
+    Waiting = "waiting"
+}
+export {};

package/built/src/blockchainClient/types.js

@@ -0,0 +1,8 @@
+export var ResponseStatus;
+(function (ResponseStatus) {
+    ResponseStatus["Confirmed"] = "confirmed";
+    ResponseStatus["Rejected"] = "rejected";
+    ResponseStatus["Unknown"] = "unknown";
+    ResponseStatus["Waiting"] = "waiting";
+})(ResponseStatus || (ResponseStatus = {}));
+//# sourceMappingURL=types.js.map

package/built/src/blockchainClient/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/blockchainClient/types.ts"],"names":[],"mappings":"AA0GA,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,yCAAuB,CAAA;IACvB,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;AACrB,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB"}

package/built/src/blockchainClient/utils.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+import { GTX, RellOperation } from "../gtx/types";
+import { NetworkSettings, Operation, SignedTransaction, Transaction } from "./types";
+export declare function getConfig(settings: NetworkSettings): Promise<{
+    endpointPool: string[];
+    blockchainRID: Buffer;
+    pollingInterval: number;
+    attemptsPerEndpoint: number;
+    attemptInterval: number;
+}>;
+export declare function validTxRID(txRID: Buffer): boolean;
+export declare function getNodeUrls(settings: NetworkSettings): Promise<string[]>;
+export declare function convertToRellOperation(operations: Operation[]): RellOperation[];
+export declare function testPromiEvent(): any;
+export declare function getSerializedGTX(gtx: GTX): Buffer;
+export declare function getGTXFromBufferOrTransactionOrOperation(transaction: SignedTransaction | Transaction | Operation, blockchainRID: Buffer): GTX;
+export declare const callbackPromiseBuilder: (reject: any, resolve: any, callback?: any) => (error: Error, result: any) => void;
+export declare const handlePostResponsePromisified: (error: Error, statusCode: number, rspBody: any) => Promise<void>;