postchain-client 1.0.2 → 1.1.0

package/built/src/restclient/restclient.js

@@ -0,0 +1,309 @@
+"use strict";
+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 { ResponseStatus, Method, } from "./types";
+import * as logger from "../logger";
+import { EmptyListOfUrlsException, LostMessageError, SerializedTransactionFormatException, TxRejectedError, UnexpectedResponseError, UnexpectedStatusError, UnvalidTxRidException, } from "./errors";
+import { toBuffer, toQueryObjectGTV } from "../formatter";
+import { requestWithRetry } from "./restclientutil";
+import { encodeValue } from "../gtx/serialization";
+export function createRestClient(endpointPool, blockchainRID, maxSockets = 10, pollingInterval = 500, failOverConfig) {
+    validateInput(endpointPool, failOverConfig);
+    return {
+        config: {
+            endpointPool: endpointPool,
+            pool: { maxSockets },
+            pollingInterval,
+            attemptsPerEndpoint: (failOverConfig === null || failOverConfig === void 0 ? void 0 : failOverConfig.attemptsPerEndpoint) || 3,
+            attemptInterval: (failOverConfig === null || failOverConfig === void 0 ? void 0 : failOverConfig.attemptInterval) || 500,
+        },
+        /**
+         * Retrieves the client message with the specified double-sha256 hash
+         * @param txRID the id of the transaction
+         * @param callback 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).
+         */
+        getTransaction: function (txRID, callback) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (!validTxRID(txRID)) {
+                    callback(new UnvalidTxRidException(txRID), null);
+                }
+                else {
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.GET, "tx/" + blockchainRID + "/" + txRID.toString("hex"), this.config);
+                    handleGetResponse(error, statusCode, statusCode === 200 ? toBuffer(rspBody.tx) : rspBody, callback);
+                }
+            });
+        },
+        /**
+         * Sends a transaction to postchain for inclusion in a block.
+         * Use status() to monitor progress once this transaction is
+         * posted.
+         *
+         * @param serializedTransaction The transaction (a buffer) to send
+         * @param callback taking parameter (error, responseObject) if error is null
+         * then resonseObject is also null. If error is not null, then responseObject
+         * is an object with the string property 'error'
+         */
+        postTransaction: function (serializedTransaction, callback) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (!Buffer.isBuffer(serializedTransaction)) {
+                    throw new SerializedTransactionFormatException();
+                }
+                const transactionObject = {
+                    tx: serializedTransaction.toString("hex"),
+                };
+                const { error, statusCode, rspBody } = yield requestWithRetry(Method.POST, "tx/" + blockchainRID, this.config, transactionObject);
+                handlePostResponse(error, statusCode, rspBody, callback);
+            });
+        },
+        /**
+         * Retrieves a confirmation proof for a client message with the specified double-sha256
+         * hash.
+         * @param txRID the id of the transaction
+         * @param callback parameters (error, responseObjectProof) if first
+         * parameter is not null, an error occurred.
+         * If first parameter is null, then the second parameter is an object
+         * like the following:
+         *
+         * {hash: messageHashBuffer,
+         *  blockHeader: blockHeaderBuffer,
+         *  signatures: [{pubKey: pubKeyBuffer, signature: sigBuffer}, ...],
+         *  merklePath: [{side: <0|1>, hash: <hash buffer level n-1>},
+         *               ...
+         *               {side: <0|1>, hash: <hash buffer level 1>}]}
+         *
+         * If no such client message exists, the callback will be called with (null, null).
+         *
+         * The proof object can be validated using
+         * postchain-common.util.validateMerklePath(proof.merklePath, proof.hash,
+         * proof.blockHeader.slice(32, 64))
+         *
+         * The signatures must be validated agains some know trusted source for valid signers
+         * at this specific block height.
+         */
+        getConfirmationProof: function (txRID, callback) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (!validTxRID(txRID)) {
+                    callback(new UnvalidTxRidException(txRID), null);
+                }
+                else {
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.GET, "tx/" +
+                        blockchainRID +
+                        "/" +
+                        txRID.toString("hex") +
+                        "/confirmationProof", this.config);
+                    const confirmationProof = {
+                        hash: undefined,
+                        blockHeader: undefined,
+                        signatures: [],
+                        merklePath: [],
+                    };
+                    if (statusCode === 200 || statusCode === 503) {
+                        confirmationProof.hash = toBuffer(rspBody.hash);
+                        confirmationProof.blockHeader = toBuffer(rspBody.blockHeader);
+                        if (rspBody.signatures) {
+                            confirmationProof.signatures = rspBody.signatures.map((item) => ({
+                                pubKey: toBuffer(item.pubKey),
+                                signature: toBuffer(item.signature),
+                            }));
+                        }
+                        if (rspBody.merklePath) {
+                            confirmationProof.merklePath = rspBody.merklePath.map((item) => {
+                                return { side: item.side, hash: toBuffer(item.hash) };
+                            });
+                        }
+                    }
+                    handleGetResponse(error, statusCode, confirmationProof, callback);
+                }
+            });
+        },
+        /**
+         * Queries the status of a certain transaction.
+         * @param txRID the id of the transaction
+         * @param callback 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'
+         */
+        status: function (txRID, callback) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (!validTxRID(txRID)) {
+                    callback(new UnvalidTxRidException(txRID), null);
+                }
+                else {
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.GET, "tx/" + blockchainRID + "/" + txRID.toString("hex") + "/status", this.config);
+                    handleGetResponse(error, statusCode, rspBody, callback);
+                }
+            });
+        },
+        /**
+         * Interfaces the query enpoint of the Rell backend. Returns either a resolved or rejected promise.
+         * @param queryObject an object that must contain a "type" and follows this pattern: { type: "nameOfQuery", arg1: argValue1, arg2: argvalue2 }
+         */
+        query: function (queryObject) {
+            return __awaiter(this, void 0, void 0, function* () {
+                // eslint-disable-next-line no-async-promise-executor
+                return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+                    const callback = (error, result) => {
+                        if (error) {
+                            reject(error);
+                        }
+                        else {
+                            resolve(result);
+                        }
+                    };
+                    const { error, statusCode, rspBody } = yield requestWithRetry(Method.POST, `query_gtv/${blockchainRID}`, this.config, encodeValue(toQueryObjectGTV(queryObject)));
+                    handlePostResponse(error, statusCode, rspBody, callback);
+                }));
+            });
+        },
+        /**
+         * Polls for status while waiting for response; confirmed, rejected or unknown. Returns either a resolved or rejected promise.
+         * @param txRID the id of the transaction
+         */
+        waitConfirmation(txRID) {
+            return new Promise((resolve, reject) => {
+                this.status(txRID, (error, result) => {
+                    if (error) {
+                        reject(error);
+                    }
+                    else {
+                        const status = result.status;
+                        switch (status) {
+                            case ResponseStatus.Confirmed:
+                                resolve(null);
+                                break;
+                            case ResponseStatus.Rejected:
+                                reject(new TxRejectedError(result.rejectReason));
+                                break;
+                            case ResponseStatus.Unknown:
+                                reject(new LostMessageError());
+                                break;
+                            case ResponseStatus.Waiting:
+                                setTimeout(() => this.waitConfirmation(txRID).then(resolve, reject), this.config.pollingInterval);
+                                break;
+                            default:
+                                logger.error(status);
+                                reject(new UnexpectedResponseError());
+                        }
+                    }
+                });
+            });
+        },
+        /**
+         * Posts a transaction and polls for status while waiting for status response; confirmed, rejected or unknown. Returns either a resolved or rejected promise.
+         * @param serializedTransaction The transaction (a buffer) to send
+         * @param txRID the id of the transaction
+         * @param validate true if the transaction needs to be validated
+         */
+        postAndWaitConfirmation(serializedTransaction, txRID, validate) {
+            if (validate === true) {
+                return Promise.reject("Automatic validation is not yet implemented");
+            }
+            return new Promise((resolve, reject) => {
+                this.postTransaction(serializedTransaction, (error) => {
+                    if (error)
+                        reject(error);
+                    else {
+                        setTimeout(() => this.waitConfirmation(txRID).then(resolve, reject), 1011);
+                    }
+                });
+            });
+        },
+        /**
+         * Returns a string array with the endpoints hosting the dApp the client
+         * is connected to
+         */
+        getEndpointPool() {
+            return this.config.endpointPool;
+        },
+    };
+}
+/**
+ * Validates that txRID is a Buffer of 32 bytes.
+ * @param txRID A buffer of 32 bytes
+ */
+function validTxRID(txRID) {
+    if (txRID.length != 32) {
+        const error = new UnvalidTxRidException(txRID);
+        logger.error(error.toString());
+        return false;
+    }
+    return true;
+}
+function validateInput(endpointPool, failOverConfig) {
+    if (!endpointPool.length) {
+        throw new EmptyListOfUrlsException();
+    }
+    if ((failOverConfig === null || failOverConfig === void 0 ? void 0 : failOverConfig.attemptsPerEndpoint) < 1) {
+        logger.debug("Attempts can not be 0 or below, setting it to 1");
+        failOverConfig.attemptsPerEndpoint = 1;
+    }
+}
+/**
+ * @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
+ */
+function handleGetResponse(error, statusCode, responseObject, callback) {
+    try {
+        logger.debug(`error: ${error}, status code: ${statusCode}, response body: ${JSON.stringify(responseObject)}`);
+        if (error) {
+            callback(error, null);
+        }
+        else if (statusCode === 404) {
+            logger.error("404 received");
+            callback(null, null);
+        }
+        else if (statusCode != 200) {
+            callback(new UnexpectedStatusError(statusCode), responseObject);
+        }
+        else {
+            callback(null, responseObject);
+        }
+    }
+    catch (error) {
+        logger.error("restclient.handleGetResponse(): Failed to call callback function " +
+            error);
+    }
+}
+/**
+ * @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
+ */
+function handlePostResponse(error, statusCode, responseObject, callback) {
+    logger.debug(`error: ${error}, status code: ${statusCode}, response body: ${JSON.stringify(responseObject)}`);
+    try {
+        if (error) {
+            logger.error(`In restclient post(). ${error}`);
+            callback(error);
+        }
+        else if (statusCode != 200) {
+            logger.error(`Unexpected status code from server: ${statusCode}`);
+            callback(new UnexpectedStatusError(statusCode), responseObject);
+        }
+        else {
+            logger.info(`Calling responseCallback with responseObject: ${JSON.stringify(responseObject)}`);
+            callback(null, responseObject);
+        }
+    }
+    catch (error) {
+        logger.error("restclient.handlePostResponse(): Failed to call callback function " +
+            error);
+    }
+}
+//# sourceMappingURL=restclient.js.map

package/built/src/restclient/restclient.js.map

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

package/built/src/restclient/restclientutil.d.ts

@@ -1,3 +1,7 @@
+/// <reference types="node" />
+import { RestClientConfig, PostRequestObjects, Method, ResponseObject } from "./types";
 export declare function getBrid(urlBase: string, chainId: number): Promise<string>;
+export declare function requestWithRetry(method: Method, path: string, config: RestClientConfig, postObject?: PostRequestObjects | Buffer): Promise<ResponseObject>;
+export declare function handleRequest(method: Method, path: string, endpoint: string, postObject?: PostRequestObjects | Buffer): Promise<ResponseObject>;
 export declare function nextEndpoint(endpointPool: readonly string[]): string;
 export declare const sleep: (ms: number) => Promise<unknown>;

package/built/src/restclient/restclientutil.js

@@ -0,0 +1,137 @@
+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 * as logger from "../logger";
+import { decodeValue } from "../gtx/serialization";
+import { GetBridFromChainException } from "./errors";
+import { Method, } from "./types";
+export function getBrid(urlBase, chainId) {
+    if (chainId >= 0) {
+        const url = `${urlBase}/brid/iid_${chainId}`;
+        return fetch(url).then((response) => {
+            if (response.ok)
+                return response.text();
+            throw new GetBridFromChainException(chainId, response.statusText);
+        });
+    }
+    else {
+        const url = `${urlBase}/_debug`;
+        return fetch(url).then((response) => {
+            if (response.ok)
+                return response
+                    .json()
+                    .then((json) => json.blockchain[json.blockchain.length - 1].brid);
+            throw new GetBridFromChainException(chainId, response.statusText);
+        });
+    }
+}
+export function requestWithRetry(method, path, config, postObject) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let statusCode, rspBody, error;
+        const noRetryStatusCodes = [200, 400, 409, 500];
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        for (const _endpoint of config.endpointPool) {
+            const endpoint = nextEndpoint(config.endpointPool);
+            for (let attempt = 0; attempt < config.attemptsPerEndpoint; attempt++) {
+                ({ error, statusCode, rspBody } = yield handleRequest(method, path, endpoint, postObject));
+                if (noRetryStatusCodes.includes(statusCode)) {
+                    return { error, statusCode, rspBody };
+                }
+                if (statusCode == 503) {
+                    break;
+                }
+                logger.info(`${method} request failed on ${endpoint}. Attempt: ${attempt + 1} / ${config.attemptsPerEndpoint}`);
+                yield sleep(config.attemptInterval);
+            }
+        }
+        return { error, statusCode, rspBody };
+    });
+}
+export function handleRequest(method, path, endpoint, postObject) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (method == Method.GET) {
+            return yield get(path, endpoint);
+        }
+        else {
+            return yield post(path, endpoint, postObject);
+        }
+    });
+}
+/**
+ * Sends request to get data from a given API endpoint.
+ * @param path API endpoint of Rell backend
+ * @param endpoint
+ */
+function get(path, endpoint) {
+    return __awaiter(this, void 0, void 0, function* () {
+        logger.debug("GET URL " + new URL(path, endpoint).href);
+        try {
+            const response = yield fetch(new URL(path, endpoint).href);
+            if (response.status == 404) {
+                return { error: null, statusCode: response.status, rspBody: null };
+            }
+            const rspBody = yield response.json();
+            return { error: null, statusCode: response.status, rspBody };
+        }
+        catch (error) {
+            logger.error(error.message);
+            return { error, statusCode: null, rspBody: null };
+        }
+    });
+}
+/**
+ * Sends request to post data to a given API endpoint.
+ * @param path API endpoint of Rell backend
+ * @param endpoint
+ * @param requestBody request body
+ */
+function post(path, endpoint, requestBody) {
+    return __awaiter(this, void 0, void 0, function* () {
+        logger.debug("POST URL " + new URL(path, endpoint).href);
+        logger.debug("POST body " + JSON.stringify(requestBody));
+        if (Buffer.isBuffer(requestBody)) {
+            try {
+                const requestOptions = {
+                    method: "post",
+                    body: requestBody,
+                };
+                const response = yield fetch(new URL(path, endpoint).href, requestOptions);
+                return {
+                    error: null,
+                    statusCode: response.status,
+                    rspBody: decodeValue(Buffer.from(yield response.arrayBuffer())),
+                };
+            }
+            catch (error) {
+                return { error, statusCode: null, rspBody: null };
+            }
+        }
+        else {
+            try {
+                const response = yield fetch(new URL(path, endpoint).href, {
+                    method: "post",
+                    body: JSON.stringify(requestBody),
+                });
+                return {
+                    error: null,
+                    statusCode: response.status,
+                    rspBody: yield response.json(),
+                };
+            }
+            catch (error) {
+                return { error, statusCode: null, rspBody: null };
+            }
+        }
+    });
+}
+export function nextEndpoint(endpointPool) {
+    return endpointPool[Math.floor(Math.random() * endpointPool.length)];
+}
+export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+//# sourceMappingURL=restclientutil.js.map

package/built/src/restclient/restclientutil.js.map

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

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

@@ -24,6 +24,10 @@ export type QueryObject = {
     type: string;
     [arg: string]: RawGtv;
 };
+export type QueryObjectGTV = [name: string, args: Arg];
+export type Arg = {
+    [arg: string]: RawGtv;
+};
 export type ServerReturnProof = {
     hash: string;
     blockHeader: string;

package/built/src/restclient/types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/restclient/types.ts"],"names":[],"mappings":"AA+CA,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;AA4BD,MAAM,CAAN,IAAY,MAGX;AAHD,WAAY,MAAM;IAChB,qBAAW,CAAA;IACX,uBAAa,CAAA;AACf,CAAC,EAHW,MAAM,KAAN,MAAM,QAGjB"}