Merge pull request #454 from multiversx/query-improvements

Query improvements: add SmartContractQueriesController.query()

src/errors.ts

@@ -372,3 +372,15 @@ export class ErrParseTransactionOutcome extends Err {
         super(message);
     }
 }
+
+/**
+ * Signals an error when querying a smart contract.
+ */
+export class ErrSmartContractQuery extends Err {
+    public returnCode: string;
+
+    public constructor(returnCode: string, message: string) {
+        super(message);
+        this.returnCode = returnCode;
+    }
+}

src/smartContractQueriesController.ts

@@ -1,4 +1,4 @@
-import { Err } from "./errors";
+import { Err, ErrSmartContractQuery } from "./errors";
 import { IContractQueryResponse } from "./interfaceOfNetwork";
 import { SmartContractQuery, SmartContractQueryResponse } from "./smartContractQuery";
 import { ArgSerializer, ContractFunction, EndpointDefinition, NativeSerializer, ResultsParser } from "./smartcontracts";
@@ -23,6 +23,26 @@ export class SmartContractQueriesController {
         this.legacyResultsParser = new ResultsParser();
     }
 
+    async query(options: {
+        contract: string;
+        caller?: string;
+        value?: bigint;
+        function: string;
+        arguments: any[];
+    }): Promise<any[]> {
+        const query = this.createQuery(options);
+        const queryResponse = await this.runQuery(query);
+        this.raiseForStatus(queryResponse);
+        return this.parseQueryResponse(queryResponse);
+    }
+
+    private raiseForStatus(queryResponse: SmartContractQueryResponse): void {
+        const isOk = queryResponse.returnCode === "ok";
+        if (!isOk) {
+            throw new ErrSmartContractQuery(queryResponse.returnCode, queryResponse.returnMessage);
+        }
+    }
+
     createQuery(options: {
         contract: string;
         caller?: string;