postchain-client 1.22.0 → 2.0.0

package/built/src/{restclient → blockchainClient}/httpUtil.js

@@ -7,11 +7,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { Buffer } from "buffer";
 import * as logger from "../logger";
 import { decodeValue } from "../gtx/serialization";
 import { Method } from "./enums";
-function handleRequest(method, path, endpoint, postObject) {
+export function handleRequest(method, path, endpoint, postObject) {
     return __awaiter(this, void 0, void 0, function* () {
         if (method == Method.GET) {
             return yield get(path, endpoint);
@@ -21,7 +20,6 @@ function handleRequest(method, path, endpoint, postObject) {
         }
     });
 }
-export default handleRequest;
 /**
  * Sends request to get data from a given API endpoint.
  * @param path API endpoint of Rell backend
@@ -33,22 +31,23 @@ function get(path, endpoint) {
         try {
             const response = yield fetch(new URL(path, endpoint).href);
             const contentType = response.headers.get("Content-Type");
-            let rspBody;
+            const transactionTimestamp = response.headers.get("X-Transaction-Timestamp");
+            let rspBody = null;
+            const error = null;
             if (contentType === null || contentType === void 0 ? void 0 : contentType.includes("application/json")) {
                 rspBody = yield response.json();
             }
             else if (contentType === null || contentType === void 0 ? void 0 : contentType.includes("text/plain")) {
                 rspBody = yield response.text();
             }
-            return {
-                error: null,
-                statusCode: response.status,
-                rspBody,
-            };
+            else if (contentType === null || contentType === void 0 ? void 0 : contentType.includes("application/octet-stream")) {
+                rspBody = yield constructBufferResponseBody(response);
+            }
+            return createResponseObject(error, response.status, rspBody, transactionTimestamp);
         }
         catch (error) {
             logger.error(error.message);
-            return { error, statusCode: null, rspBody: null };
+            return createResponseObject(error, null, null);
         }
     });
 }
@@ -73,14 +72,11 @@ function post(path, endpoint, requestBody) {
                     },
                 };
                 const response = yield fetch(new URL(path, endpoint).href, requestOptions);
-                return {
-                    error: null,
-                    statusCode: response.status,
-                    rspBody: yield constructBufferPostResponseBody(response),
-                };
+                const transactionTimestamp = response.headers.get("X-Transaction-Timestamp");
+                return createResponseObject(null, response.status, yield constructBufferResponseBody(response), transactionTimestamp);
             }
             catch (error) {
-                return { error, statusCode: null, rspBody: null };
+                return createResponseObject(error, null, null);
             }
         }
         else {
@@ -93,19 +89,16 @@ function post(path, endpoint, requestBody) {
                         "Content-Type": "application/json",
                     },
                 });
-                return {
-                    error: null,
-                    statusCode: response.status,
-                    rspBody: yield constructBufferPostResponseBody(response),
-                };
+                const transactionTimestamp = response.headers.get("X-Transaction-Timestamp");
+                return createResponseObject(null, response.status, yield constructBufferResponseBody(response), transactionTimestamp);
             }
             catch (error) {
-                return { error, statusCode: null, rspBody: null };
+                return createResponseObject(error, null, null);
             }
         }
     });
 }
-function constructBufferPostResponseBody(response) {
+function constructBufferResponseBody(response) {
     return __awaiter(this, void 0, void 0, function* () {
         const contentType = response.headers.get("content-type");
         if (contentType === "application/octet-stream") {
@@ -120,4 +113,15 @@ function constructBufferPostResponseBody(response) {
         return responseText ? responseText : response.statusText;
     });
 }
+function createResponseObject(error, statusCode, rspBody, transactionTimestamp) {
+    const responseObject = {
+        error,
+        statusCode,
+        rspBody,
+    };
+    if (transactionTimestamp) {
+        responseObject.transactionTimestamp = transactionTimestamp;
+    }
+    return responseObject;
+}
 //# sourceMappingURL=httpUtil.js.map

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

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

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

@@ -1,11 +1,7 @@
 /// <reference types="node" />
-import { AppStructure, BlockInfo, KeyPair, TransactionInfo, TransactionReceipt, StatusObject, BufferId, BlockAnchoringState } from "./types";
+import { AppStructure, BlockInfo, KeyPair, TransactionInfo, TransactionReceipt, TransactionStatusReponse, BufferId, BlockAnchoringState, ClientCallback, ConfirmationProof, ClientConfig, Operation, QueryCallback, QueryObject, SignatureProvider, SignedTransaction, Transaction, RejectedTransaction, WaitingTransaction } from "./types";
 import { DictPair, RawGtv } from "../gtv/types";
 import { Web3PromiEvent } from "../promiEvent/promiEvents";
-import { RestClientCallback } from "../restclient/types";
-import { ClientConfig, Operation, QueryCallback, QueryObject, SignatureProvider, SignedTransaction, Transaction } from "./types";
-import { GTX } from "../gtx/types";
-import { ConfirmationProof } from "../blockchainClient/types";
 import { AnchoringStatus, ChainConfirmationLevel } from "./enums";
 import { AnchoringTransaction } from "../ICCF/types";
 import { Web3EventMap } from "../promiEvent/promiEventEmitter";
@@ -33,7 +29,7 @@ export interface IClient extends Queryable {
      * @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?: RestClientCallback<Buffer>): Promise<SignedTransaction>;
+    signTransaction(transaction: Transaction | SignedTransaction, signMethod: KeyPair | SignatureProvider, callback?: ClientCallback<Buffer>): Promise<SignedTransaction>;
     /**
      * Sends a transaction to the blockchain.
      *
@@ -43,7 +39,7 @@ export interface IClient extends Queryable {
      * @param confirmationLevel  - Enables configuration of the confirmation level the requests should sent for the transaction status.
      * @returns - A Web3PromiEvent that resolves with the transaction receipt.
      */
-    sendTransaction(transaction: Transaction | SignedTransaction | Operation, doStatusPolling?: boolean, callback?: RestClientCallback<TransactionReceipt>, confirmationLevel?: ChainConfirmationLevel): Web3PromiEvent<TransactionReceipt, Web3EventMap>;
+    sendTransaction(transaction: Transaction | SignedTransaction | Operation, doStatusPolling?: boolean, callback?: ClientCallback<TransactionReceipt>, confirmationLevel?: ChainConfirmationLevel): Web3PromiEvent<TransactionReceipt, Web3EventMap>;
     /**
      * Signs and sends a transaction for inclusion in a block. It adds a nop
      * if missing.
@@ -55,7 +51,7 @@ export interface IClient extends Queryable {
      * @returns - A Web3PromiEvent that resolves with the transaction receipt.
      *
      */
-    signAndSendUniqueTransaction(transaction: Operation | Transaction, signMethod: KeyPair | SignatureProvider, doStatusPolling?: boolean, callback?: RestClientCallback<TransactionReceipt>, confirmationLevel?: ChainConfirmationLevel): Web3PromiEvent<TransactionReceipt, Web3EventMap>;
+    signAndSendUniqueTransaction(transaction: Operation | Transaction, signMethod: KeyPair | SignatureProvider, doStatusPolling?: boolean, callback?: ClientCallback<TransactionReceipt>, confirmationLevel?: ChainConfirmationLevel): Web3PromiEvent<TransactionReceipt, Web3EventMap>;
     /**
      * Retrieves a transaction given its transaction RID.
      *
@@ -67,7 +63,7 @@ export interface IClient extends Queryable {
      * the callback will be called with (null, null).
      * @returns- A promise that resolves with the serialized message of the transaction.
      */
-    getTransaction(transactionRid: BufferId, callback?: RestClientCallback<Buffer>): Promise<Buffer>;
+    getTransaction(transactionRid: BufferId, callback?: ClientCallback<Buffer>): Promise<Buffer>;
     /**
      * Retrieves the status of a transaction given its transaction RID.
      *
@@ -80,20 +76,13 @@ export interface IClient extends Queryable {
      * @returns - A promise that resolves with the status object of the transaction.
      *
      */
-    getTransactionStatus: (transactionRid: BufferId, callback?: RestClientCallback<TransactionReceipt> | RestClientCallback<StatusObject>) => Promise<StatusObject>;
+    getTransactionStatus: (transactionRid: BufferId, callback?: ClientCallback<TransactionReceipt> | ClientCallback<TransactionStatusReponse>) => Promise<TransactionStatusReponse>;
     /**
      * Adds an operation containing a nonce which makes the transaction unique.
      *
      * @param transaction - The transaction to sign and send.
      */
     addNop(transaction: Transaction): Transaction;
-    /**
-     * @deprecated Use calculateTransactionRid util function instead.
-     *
-     * 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;
     /**
      * Fetch info about transactions from a chain.
      *
@@ -108,7 +97,7 @@ export interface IClient extends Queryable {
      * @returns - A promise that resolves with an array of transaction information.
      *
      */
-    getTransactionsInfo(limit?: number, beforeTime?: Date, callback?: RestClientCallback<TransactionInfo[]>, afterTime?: Date, signerPubKey?: string): Promise<TransactionInfo[]>;
+    getTransactionsInfo(limit?: number, beforeTime?: Date, callback?: ClientCallback<TransactionInfo[]>, afterTime?: Date, signerPubKey?: string): Promise<TransactionInfo[]>;
     /**
      * Fetch info about a transaction from a chain.
      *
@@ -120,7 +109,7 @@ export interface IClient extends Queryable {
      * @returns - A promise that resolves with the transaction information.
      *
      */
-    getTransactionInfo(transactionRid: BufferId, callback?: RestClientCallback<TransactionInfo>): Promise<TransactionInfo>;
+    getTransactionInfo(transactionRid: BufferId, callback?: ClientCallback<TransactionInfo>): Promise<TransactionInfo>;
     /**
      * Fetches the last known confirmation status for a transaction RID.
      *
@@ -131,7 +120,7 @@ export interface IClient extends Queryable {
      * is an object with the string property 'error'.
      * @returns - A promise that resolves with the transaction confirmation level and an anchoring transaction if the transaction is anchored
      */
-    getTransactionConfirmationLevel(transactionRid: BufferId, callback?: RestClientCallback<StatusObject | TransactionReceipt>): Promise<TransactionReceipt>;
+    getTransactionConfirmationLevel(transactionRid: BufferId, callback?: ClientCallback<TransactionStatusReponse | TransactionReceipt>): Promise<TransactionReceipt>;
     /**
      * Fetches the last known anchoring status for a block RID.
      *
@@ -152,7 +141,7 @@ export interface IClient extends Queryable {
      * @returns - A promise that resolves with the number of successful transactions.
      *
      */
-    getTransactionCount(callback?: RestClientCallback<number>): Promise<number>;
+    getTransactionCount(callback?: ClientCallback<number>): Promise<number>;
     /**
      * Fetch info about a block for a chain.
      *
@@ -165,7 +154,7 @@ export interface IClient extends Queryable {
      * @returns - A promise that resolves with the block info.
      *
      */
-    getBlockInfo(blockIdentifier: number | string, txs?: boolean, callback?: RestClientCallback<BlockInfo>): Promise<BlockInfo>;
+    getBlockInfo(blockIdentifier: number | string, txs?: boolean, callback?: ClientCallback<BlockInfo>): Promise<BlockInfo>;
     /**
      * Fetch info about the latest block for a chain.
      *
@@ -177,7 +166,7 @@ export interface IClient extends Queryable {
      * @returns - A promise that resolves with the block info.
      *
      */
-    getLatestBlock(txs?: boolean, callback?: RestClientCallback<BlockInfo>): Promise<BlockInfo>;
+    getLatestBlock(txs?: boolean, callback?: ClientCallback<BlockInfo>): Promise<BlockInfo>;
     /**
      * Fetch info about blocks for a chain. If both beforeTime and beforeHeight is provided, only beforeTime will be used.
      *
@@ -194,7 +183,7 @@ export interface IClient extends Queryable {
      * @returns - A promise that resolves with an array of block info.
      *
      */
-    getBlocks(props: {
+    getBlocks(props?: {
         limit?: number;
         beforeTime?: Date;
         afterTime?: Date;
@@ -202,46 +191,16 @@ export interface IClient extends Queryable {
         afterHeight?: number;
         excludeEmpty?: boolean;
         txs?: boolean;
-        callback?: RestClientCallback<TransactionInfo[]>;
+        callback?: ClientCallback<BlockInfo[]>;
     }): Promise<BlockInfo[]>;
-    /**
-     * Fetch info about blocks for a chain. If both beforeTime and beforeHeight is provided, only beforeTime will be used.
-     *
-     * @param limit - Limit number of transactions returned. Minimum value is 0 and maximum 100. Defaults to 25.
-     * @param beforeTime - Return only transactions before this time.
-     * @param beforeHeight - Return only transactions before this height.
-     * @param tsx - Boolean to decide whether or not to include full transaction data. Defaults to false.
-     * @param callback - A callback function to handle the response body. Taking parameters (error, responseBody). If error is null
-     * then responseBody is an object of type BlockInfo[].
-     * If error is not null, then responseBody
-     * is an object with the string property 'error'.
-     * @returns - A promise that resolves with an array of block info.
-     * @deprecated Use getBlocks instead.
-     *
-     */
-    getBlocksInfo(limit?: number, beforeTime?: Date, beforeHeight?: number, txs?: boolean, callback?: RestClientCallback<TransactionInfo[]>): Promise<BlockInfo[]>;
-    /**
-     * @deprecated Use encodeTransaction util function instead.
-     *
-     * Encodes the transaction using ASN.1.
-     * @returns the transaction encoded
-     */
-    encodeTransaction(transaction: Transaction): Buffer;
-    /**
-     * @deprecated Use decodeTransactionToGtx util function instead.
-     *
-     * 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[];
-    getConfirmationProof(txRID: BufferId, callback?: RestClientCallback<ConfirmationProof>): Promise<ConfirmationProof>;
-    getAppStructure(callback?: RestClientCallback<AppStructure>): Promise<AppStructure>;
+    getConfirmationProof(txRID: BufferId, callback?: ClientCallback<ConfirmationProof>): Promise<ConfirmationProof>;
+    getAppStructure(callback?: ClientCallback<AppStructure>): Promise<AppStructure>;
     /**
      *
      * @param transactionRid - The transaction RID to retrieve a cluster anchoring transaction or anchoring status
@@ -253,7 +212,7 @@ export interface IClient extends Queryable {
      * is an object with the string property 'error'.
      * @returns - A promise that resolves with an anchoring transaction or anchoring status based on the outcome
      */
-    getClusterAnchoringTransactionConfirmation(transactionRid: BufferId, anchoringClient: IClient, callback?: RestClientCallback<TransactionReceipt>): Promise<AnchoringTransaction | AnchoringStatus>;
+    getClusterAnchoringTransactionConfirmation(transactionRid: BufferId, anchoringClient: IClient, callback?: ClientCallback<TransactionReceipt>): Promise<AnchoringTransaction | AnchoringStatus>;
     /**
      *
      * @param anchoredTxRid - The anchored transaction RID retrieved from the cluster anchoring transaction, used to retrieve a system cluster anchoring transaction
@@ -267,5 +226,35 @@ export interface IClient extends Queryable {
      * is an object with the string property 'error'.
      * @returns - A promise that resolves with an anchoring transaction or null
      */
-    getSystemAnchoringTransactionConfirmation(anchoredTxRid: BufferId, anchoringClient: IClient, systemAnchoringChainRid: string, callback?: RestClientCallback<TransactionReceipt>): Promise<AnchoringTransaction | null>;
+    getSystemAnchoringTransactionConfirmation(anchoredTxRid: BufferId, anchoringClient: IClient, systemAnchoringChainRid: string, callback?: ClientCallback<TransactionReceipt>): Promise<AnchoringTransaction | null>;
+    /**
+     * Fetches the list of waiting transactions
+     * @param blockchainRid - The blockchain RID to fetch the waiting transactions from
+     * @param callback - A callback function to handle the response body. Taking parameters (error, responseBody). If error is null
+     * then responseBody is of type Array<string>.
+     *
+     * @returns - A promise that resolves to a list of waiting transaction RIDs of the specified blockchainRid
+     */
+    getWaitingTransactions(blockchainRid: BufferId, callback?: ClientCallback<Array<string>>): Promise<Array<string>>;
+    /**
+     * Fetches the waiting transaction from the specified blockchain
+     *
+     * @param blockchainRid - The blockchain RID to fetch the waiting transaction from
+     * @param txRid - The transaction RID to check the status of
+     * @param callback - A callback function to handle the response body. Taking parameters (error, responseBody). If error is null
+     * then responseBody is of type WaitingTransaction.
+     *
+     * @returns - A promise that resolves to a WaitingTransaction representing a waiting transaction binary tx data of the specified transactionRid for the blockchain
+     */
+    getWaitingTransaction(blockchainRid: BufferId, txRid: BufferId, callback?: ClientCallback<WaitingTransaction>): Promise<WaitingTransaction>;
+    /**
+     * Fetches the list of rejected transaction RIDs and their corresponding rejection reasons
+     *
+     * @param blockchainRid - The blockchain RID to fetch the rejected transactions from
+     * @param callback - A callback function to handle the response body. Taking parameters (error, responseBody). If error is null
+     * then responseBody is of type Array<RejectedTransaction>.
+     *
+     * @returns - A promise that resolves to a list of rejected transactions of the specified blockchainRid
+     */
+    getRejectedTransactions(blockchainRid: BufferId, callback?: ClientCallback<Array<RejectedTransaction>>): Promise<Array<RejectedTransaction>>;
 }

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

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

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

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+import { Method } from "./enums";
+import { HandleRequestInputProps, ResponseObject } from "./types";
+export declare function requestWithFailoverStrategy(method: Method, path: string, config: HandleRequestInputProps["config"], postObject?: Buffer, forceSingleEndpoint?: boolean): Promise<ResponseObject>;

package/built/src/blockchainClient/requestWithFailoverStrategy.js

@@ -0,0 +1,31 @@
+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 { FailoverStrategy } from "./enums";
+import { abortOnError, tryNextOnError, singleEndpoint, queryMajority } from "./failoverStrategies";
+export function requestWithFailoverStrategy(method, path, config, postObject, forceSingleEndpoint = false) {
+    return __awaiter(this, void 0, void 0, function* () {
+        switch (config.failoverStrategy) {
+            case FailoverStrategy.AbortOnError:
+                return yield abortOnError({ method, path, config, postObject });
+            case FailoverStrategy.TryNextOnError:
+                return yield tryNextOnError({ method, path, config, postObject });
+            case FailoverStrategy.SingleEndpoint:
+                return yield singleEndpoint({ method, path, config, postObject });
+            case FailoverStrategy.QueryMajority:
+                if (forceSingleEndpoint) {
+                    return yield singleEndpoint({ method, path, config, postObject });
+                }
+                return yield queryMajority({ method, path, config, postObject });
+            default:
+                throw new Error(`Unsupported failover strategy: ${config.failoverStrategy}`);
+        }
+    });
+}
+//# sourceMappingURL=requestWithFailoverStrategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requestWithFailoverStrategy.js","sourceRoot":"","sources":["../../../src/blockchainClient/requestWithFailoverStrategy.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAU,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGnG,MAAM,UAAgB,2BAA2B,CAC/C,MAAc,EACd,IAAY,EACZ,MAAyC,EACzC,UAAmB,EACnB,mBAAmB,GAAG,KAAK;;QAE3B,QAAQ,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAChC,KAAK,gBAAgB,CAAC,YAAY;gBAChC,OAAO,MAAM,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAClE,KAAK,gBAAgB,CAAC,cAAc;gBAClC,OAAO,MAAM,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACpE,KAAK,gBAAgB,CAAC,cAAc;gBAClC,OAAO,MAAM,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACpE,KAAK,gBAAgB,CAAC,aAAa;gBACjC,IAAI,mBAAmB,EAAE,CAAC;oBACxB,OAAO,MAAM,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO,MAAM,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACnE;gBACE,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;CAAA"}

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

@@ -1,11 +1,12 @@
 /// <reference types="node" />
 import { DictPair, RawGtv } from "../gtv/types";
-import { FailOverConfig } from "../restclient/types";
-import { AnchoringStatus, FailoverStrategy, ResponseStatus } from "./enums";
+import { AnchoringStatus, FailoverStrategy, Method, ResponseStatus } from "./enums";
 import { RawGtxBody } from "../gtx/types";
-import { NodeManager } from "../restclient/nodeManager";
+import { NodeManager } from "./nodeManager";
 import { AnchoringTransaction } from "../ICCF/types";
 import { IClient } from "./interface";
+export type PrivKey = Buffer;
+export type PubKey = Buffer;
 export type KeyPair = {
     privKey: PrivKey;
     pubKey: PubKey;
@@ -59,17 +60,13 @@ export interface SignatureProvider {
     sign(rawGtxBody: RawGtxBody): Promise<Buffer>;
     readonly pubKey: Buffer;
 }
-export type RestClientQueryObject = {
-    type: string;
-    [arg: string]: RawGtv;
-};
-export type QueryObject<TReturn extends RawGtv, TArgs extends DictPair | undefined = DictPair> = {
+export type QueryObject<TReturn extends RawGtv = RawGtv, TArgs extends DictPair | undefined = DictPair> = {
     name: string;
     args?: TArgs;
+    /** phantom type holder to preserve TReturn without runtime impact */
+    _returnType?: TReturn;
 };
-export type QueryCallback<TReturn> = (error: Error | null, response: TReturn) => void;
-export type PrivKey = Buffer;
-export type PubKey = Buffer;
+export type QueryCallback<TReturn> = (error: Error | null, response: TReturn | null) => void;
 export type Operation = {
     name: string;
     args?: RawGtv[];
@@ -78,18 +75,11 @@ export interface Transaction {
     operations: Operation[];
     signers: Buffer[];
 }
-export type StatusObject = {
+export type TransactionStatusReponse = {
     status: ResponseStatus | AnchoringStatus;
+    statusCode: number | null;
     rejectReason?: string;
 };
-export type SignerPair = {
-    pubKey: string;
-    signature: string;
-};
-export type BufferSignerPair = {
-    pubKey: Buffer;
-    signature: Buffer;
-};
 export type Step = {
     side: number;
     hash: Buffer;
@@ -207,4 +197,57 @@ export type TransactionsCount = {
 export type TransactionConfirmationProof = {
     proof: string;
 };
+export type PostRequestObjects = TransactionObject | QueryObject<RawGtv>;
+export type TransactionObject = {
+    tx: string;
+};
+export type ResponseObject = {
+    statusCode: number | null;
+    error: Error | null;
+    rspBody: unknown;
+    transactionTimestamp?: string;
+};
+type Arg = {
+    [arg: string]: RawGtv;
+};
+export type QueryObjectGTV = [name: string, args: Arg];
+export type FailOverConfig = {
+    strategy?: FailoverStrategy;
+    attemptsPerEndpoint?: number;
+    attemptInterval?: number;
+    unreachableDuration?: number;
+};
+export interface RetryRequestProps extends BaseRequestProps {
+    config: RetryRequestSettings;
+}
+export type RetryRequestSettings = {
+    endpointPool: Endpoint[];
+    nodeManager: NodeManager;
+    attemptsPerEndpoint: number;
+    unreachableDuration: number;
+    attemptInterval: number;
+};
+export interface BaseRequestProps {
+    method: Method;
+    path: string;
+    postObject?: PostRequestObjects | Buffer;
+}
+export interface HandleRequestInputProps extends BaseRequestProps {
+    config: ClientConfig | Omit<ClientConfig, "blockchainRid" | "directoryChainRid">;
+}
+export type ClientCallback<TData, TError = Error> = (error: TError | null | undefined, responseBody: TData | null | undefined, statusCode?: number | null | undefined) => void;
+export type RejectedTransaction = {
+    txRid: Buffer;
+    rejectReason: string;
+    rejectTimestamp: number;
+};
+export type RejectedTransactionResponse = {
+    txRID: string;
+    rejectReason: string;
+    rejectTimestamp: number;
+};
+export type WaitingTransaction = {
+    txData: RawGtv;
+    transactionTimestamp: number;
+};
 export {};

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

@@ -1,14 +1,13 @@
 /// <reference types="node" />
-import { Buffer } from "buffer";
 import { Web3PromiEvent } from "../promiEvent/promiEvents";
 import { GTX, RellOperation } from "../gtx/types";
-import { BlockInfo, BlockInfoResponse, ClientConfig, Endpoint, KeyPair, NetworkSettings, Operation, SignedTransaction, Transaction, TransactionInfo, TransactionInfoResponse, StatusObject, ClusterAnchoringConfirmation, TransactionReceipt, BufferId, AnchoringClientAndSystemBrid, StatusPolling } from "./types";
-import { FailOverConfig } from "../restclient/types";
-import { AnchoringStatus, ChainConfirmationLevel, FailoverStrategy, ResponseStatus } from "./enums";
-import { NodeManager } from "../restclient/nodeManager";
-import { Web3EventMap } from "../promiEvent/promiEventEmitter";
+import { BlockInfo, BlockInfoResponse, ClientConfig, Endpoint, KeyPair, NetworkSettings, Operation, SignedTransaction, Transaction, TransactionInfo, TransactionInfoResponse, TransactionStatusReponse, ClusterAnchoringConfirmation, TransactionReceipt, BufferId, AnchoringClientAndSystemBrid, StatusPolling, FailOverConfig, ClientCallback, RejectedTransactionResponse, RejectedTransaction } from "./types";
+import { AnchoringStatus, ChainConfirmationLevel, FailoverStrategy } from "./enums";
+import { NodeManager } from "./nodeManager";
 import { IClient } from "./interface";
 import { AnchoringTransaction } from "../ICCF/types";
+import { RawGtv } from "../gtv/types";
+import { Web3EventMap } from "../promiEvent/promiEventEmitter";
 export declare function getClientConfigFromSettings(settings: NetworkSettings): Promise<ClientConfig>;
 export declare function getMerkleHashVersionFromDapp(config: ClientConfig): Promise<number>;
 export declare function validTxRid(txRID: Buffer): boolean;
@@ -19,14 +18,16 @@ interface NodeDiscoveryProps {
     blockchainRid?: string;
     blockchainIid?: number;
 }
-export declare function nodeDiscovery({ nodeManager, directoryEndpointPool, failOverConfig, blockchainRid, blockchainIid, }: NodeDiscoveryProps): Promise<string[]>;
+export declare function nodeDiscovery({ nodeManager, directoryEndpointPool, failOverConfig, blockchainRid, blockchainIid, }: NodeDiscoveryProps): Promise<string[] | null>;
+export declare function getBlockchainApiUrls(directoryClient: IClient, blockchainRid: Buffer): Promise<string[] | null>;
 export declare function convertToRellOperation(operations: Operation[]): RellOperation[];
 export declare function getSerializedGTX(gtx: GTX): Buffer;
 export declare function getGTXFromBufferOrTransactionOrOperation(transaction: SignedTransaction | Transaction | Operation, blockchainRid: BufferId): GTX;
-export declare const callbackPromiseBuilder: (reject: (reason?: any) => void, resolve: (value?: any) => void, callback?: ((error: Error | null, result: any) => void) | undefined) => (error: Error | null | undefined, result: any) => void;
-export declare const handlePostResponsePromisified: (error: Error | null, statusCode: number | null, rspBody: any) => Promise<void>;
+export declare const callbackPromiseBuilder: <T, U = T>(reject: (reason?: Error | null) => void, resolve: (value: T | PromiseLike<T>) => void, callback?: ((error: Error | null, result: U | null) => void) | undefined) => ClientCallback<T>;
+export declare const handlePostResponsePromisified: (error: Error | null, statusCode: number | null, rspBody: RawGtv | null | undefined) => Promise<void>;
 export declare const formatTransactionInfoResponse: (transactionInfoResponse: TransactionInfoResponse) => TransactionInfo;
 export declare const formatBlockInfoResponse: (blockInfoResponse: BlockInfoResponse) => BlockInfo;
+export declare function formatRejectedTransactionFromResponse(rejectedTransactionResponse: RejectedTransactionResponse): RejectedTransaction;
 export declare const isKeyPair: (keypair: unknown) => keypair is KeyPair;
 export declare function getSystemClient(directoryNodeUrlPool: string[], directoryChainRid: string): Promise<IClient>;
 export declare function getSystemAnchoringChain(directoryClient: IClient): Promise<Buffer>;
@@ -38,9 +39,9 @@ export declare const defaultFailoverConfig: {
 };
 export declare const createEndpointObjects: (endpointPoolUrls: readonly string[]) => Endpoint[];
 export declare const getUrlsFromEndpoints: (endpointPool: Endpoint[]) => string[];
-export declare function awaitDappConfirmation(txRID: Buffer, dappStatusPolling: StatusPolling, getTransactionStatus: (txRID: Buffer) => Promise<StatusObject>): Promise<ResponseStatus>;
+export declare function awaitDappConfirmation(txRID: Buffer, dappStatusPolling: StatusPolling, getTransactionStatus: (txRID: Buffer) => Promise<TransactionStatusReponse>): Promise<TransactionStatusReponse>;
 export declare function awaitClusterAnchoringChainConfirmation(txRID: Buffer, clusterAnchoringStatusPolling: StatusPolling, getClusterAnchoringTransactionConfirmation: (txRID: Buffer) => Promise<AnchoringTransaction | AnchoringStatus>): Promise<ClusterAnchoringConfirmation>;
-export declare function handleDappConfirmations(transactionRid: Buffer, doStatusPolling: boolean, confirmationLevel: ChainConfirmationLevel, statusCode: number | null, promiEvent: Web3PromiEvent<TransactionReceipt, Web3EventMap>, dappStatusPolling: StatusPolling, getTransactionStatus: () => Promise<StatusObject>): Promise<TransactionReceipt>;
+export declare function handleDappConfirmations(transactionRid: Buffer, doStatusPolling: boolean, confirmationLevel: ChainConfirmationLevel, promiEvent: Web3PromiEvent<TransactionReceipt, Web3EventMap>, dappStatusPolling: StatusPolling, getTransactionStatus: () => Promise<TransactionStatusReponse>): Promise<TransactionReceipt>;
 export declare function handleSystemConfirmations(transactionReceipt: TransactionReceipt, confirmationLevel: ChainConfirmationLevel, promiEvent: Web3PromiEvent<TransactionReceipt, Web3EventMap>, statusPollingConfig: {
     dappStatusPolling: StatusPolling;
     clusterAnchoringStatusPolling: StatusPolling;
@@ -48,6 +49,30 @@ export declare function handleSystemConfirmations(transactionReceipt: Transactio
 }, anchoringClient: IClient, systemAnchoringChainBrid: string, getClusterAnchoringTransactionConfirmation: () => Promise<AnchoringTransaction | AnchoringStatus>, getSystemAnchoringTransactionConfirmation: (anchoredTxRid: Buffer, anchoringClient: IClient, systemAnchoringChainBrid: string) => Promise<AnchoringTransaction | null>): Promise<TransactionReceipt>;
 export declare function getAnchoringClientAndSystemChainRid(client: IClient): Promise<AnchoringClientAndSystemBrid>;
 export declare function getSystemAnchoringTransaction(dappClientEndpointPool: Endpoint[], anchoredTxRid: BufferId, anchoringClient: IClient, systemAnchoringChainRid: string, systemAnchoringStatusPolling: StatusPolling, merkleHashVersion: number): Promise<AnchoringTransaction | null>;
-export declare function setStatusPolling(statusPolling?: StatusPolling): StatusPolling;
+export declare function setStatusPolling(statusPolling?: Partial<StatusPolling>): StatusPolling;
 export declare function linkPromiEvents(event1: Web3PromiEvent<TransactionReceipt, Web3EventMap>, event2: Web3PromiEvent<TransactionReceipt, Web3EventMap>): void;
+/**
+ * @param error response error
+ * @param statusCode response status code
+ * @param responseObject the responsebody from the server
+ * @param callback the callback function to propagate the error and response back to the caller
+ */
+export declare function handleGetResponse<T>(error: Error | null | undefined, statusCode: number | null, responseObject: RawGtv | null | undefined, callback: ClientCallback<T>): void;
+/**
+ * @param error response error
+ * @param statusCode response status code
+ * @param responseObject the responsebody from the server
+ * @param callback the callback function to propagate the error and response back to the caller
+ */
+export declare function handlePostResponse<T extends RawGtv>(error: Error | null | undefined, statusCode: number | null, responseObject: RawGtv | null | undefined, callback: ClientCallback<T>): void;
+interface BlockchainRidFromIidPops {
+    endpointPool: Endpoint[];
+    chainId: number;
+    nodeManager: NodeManager;
+    failOverConfig?: FailOverConfig;
+    merkleHashVersion: number;
+}
+export declare function getBlockchainRidFromIid({ endpointPool, chainId, failOverConfig, nodeManager, }: BlockchainRidFromIidPops): Promise<string>;
+export declare const sleep: (ms: number) => Promise<unknown>;
+export declare function convertToPrintable(responseObject: unknown): string;
 export {};