feat: add ContractExecute endpoint (#3317)

Signed-off-by: Mario Dimitrov <[email protected]>

Author: mariodimitrovv

src/contract/ContractExecuteTransaction.js

@@ -189,7 +189,11 @@ export default class ContractExecuteTransaction extends Transaction {
      */
     setGas(gas) {
         this._requireNotFrozen();
-        this._gas = gas instanceof Long ? gas : Long.fromValue(gas);
+        const gasLong = gas instanceof Long ? gas : Long.fromValue(gas);
+        if (gasLong.lt(0)) {
+            throw new Error("Gas must be greater than 0");
+        }
+        this._gas = gasLong;
 
         return this;
     }

tck/methods/contract.ts

@@ -1,6 +1,7 @@
 import {
     ContractCreateTransaction,
     ContractDeleteTransaction,
+    ContractExecuteTransaction,
     ContractUpdateTransaction,
     Hbar,
     Timestamp,
@@ -9,6 +10,7 @@ import {
 import {
     CreateContractParams,
     DeleteContractParams,
+    ExecuteContractParams,
     UpdateContractParams,
 } from "../params/contract";
 import { ContractResponse } from "../response/contract";
@@ -233,3 +235,46 @@ export const deleteContract = async ({
         status: receipt.status.toString(),
     };
 };
+
+export const executeContract = async ({
+    contractId,
+    gas,
+    amount,
+    functionParameters,
+    commonTransactionParams,
+}: ExecuteContractParams): Promise<ContractResponse> => {
+    const transaction = new ContractExecuteTransaction().setGrpcDeadline(
+        DEFAULT_GRPC_DEADLINE,
+    );
+
+    if (contractId != null) {
+        transaction.setContractId(contractId);
+    }
+
+    if (gas != null) {
+        transaction.setGas(Long.fromString(gas));
+    }
+
+    if (amount != null) {
+        transaction.setPayableAmount(Hbar.fromTinybars(amount));
+    }
+
+    if (functionParameters != null) {
+        const functionParams = decode(functionParameters);
+        transaction.setFunctionParameters(functionParams);
+    }
+
+    if (commonTransactionParams != null) {
+        applyCommonTransactionParams(
+            commonTransactionParams,
+            transaction,
+            sdk.getClient(),
+        );
+    }
+    const response = await transaction.execute(sdk.getClient());
+    const receipt = await response.getReceipt(sdk.getClient());
+
+    return {
+        status: receipt.status.toString(),
+    };
+};

tck/params/contract.ts

@@ -37,3 +37,11 @@ export interface DeleteContractParams {
     readonly permanentRemoval?: boolean;
     readonly commonTransactionParams?: Record<string, any>;
 }
+
+export interface ExecuteContractParams {
+    readonly contractId: string;
+    readonly gas?: string;
+    readonly amount?: string;
+    readonly functionParameters?: string;
+    readonly commonTransactionParams?: Record<string, any>;
+}

test/unit/ContractExecuteTransaction.js

@@ -119,6 +119,13 @@ describe("ContractExecuteTransaction", function () {
             expect(transaction.gas.toNumber()).to.equal(gasNumber);
         });
 
+        it("should throw error if gas is negative", function () {
+            const gasNumber = -10;
+            expect(() => {
+                new ContractExecuteTransaction().setGas(gasNumber);
+            }).to.throw("Gas must be greater than 0");
+        });
+
         it("should set payable amount", function () {
             const transaction =
                 new ContractExecuteTransaction().setPayableAmount(