# Get a smart contract function

A query that calls a function of the given smart contract instance, giving it function parameters as its inputs. This is performed locally on the particular node that the client is communicating with. It cannot change the state of the contract instance (and so, cannot spend anything from the instance's cryptocurrency account). It will not have a consensus timestamp. It cannot generate a record or a receipt. The response will contain the output returned by the function call. This is useful for calling getter functions, which purely read the state and don't change it. It is faster and cheaper than a normal call because it is purely local to a single node.

Unlike a contract execution transaction, the node will consume the entire amount of provided gas in determining the fee for this query.

**Query Signing Requirements**

* The client operator account's private key (fee payer) is required to sign this query

**Query Fees**

* Please see the transaction and query [fees](https://dev.uniultra.xyz/docs/networks/mainnet/fees#transaction-and-query-fees) table for the base transaction fee
* Please use the [Hedera fee estimator](https://hedera.com/fees) to estimate your query fee cost

| Method                                                         | Type                                                                                   | Description                                                                                                                                                                                                                                             | Requirement          |
| -------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| `setContractId(<contractId>)`                                  | [ContractId](https://dev.uniultra.xyz/docs/sdks-and-apis/specialized-types#contractid) | Sets the contract instance to call, in the format used in transactions (x.z.y).                                                                                                                                                                         | Required             |
| `setGas(<gas>)`                                                | long                                                                                   | Sets the amount of gas to use for the call.                                                                                                                                                                                                             | Required             |
| `setFunction(<name>)`                                          | String                                                                                 | Sets the function name to call. The function will be called with no parameters.                                                                                                                                                                         | Required             |
| `setFunction(<name, params>)`                                  | <p>String,<br>ContractFunctionParameters</p>                                           | Sets the function to call, and the parameters to pass to the function.                                                                                                                                                                                  | Optional             |
| <p><code>setSenderAccountId(\<accountId)</code></p><p><br></p> | [AccountId](https://dev.uniultra.xyz/docs/sdks-and-apis/specialized-types#accountid)   | The account that is the "sender." If not present it is the accountId from the transactionId. Typically a different value than specified in the transactionId requires a valid signature over either the Hedera transaction or foreign transaction data. |                      |
| `setMaxResultSize(<size>)`                                     | long                                                                                   | Sets the max number of bytes that the result might include. The run will fail if it would have returned more than this number of bytes.                                                                                                                 | Deprecated \[0.20.0] |

### Methods

{% tabs %}
{% tab title="Java" %}

```java
//Contract call query
ContractCallQuery query = new ContractCallQuery()
    .setContractId(contractId)
    .setGas(600)
    .setFunction("greet"); 

//Sign with the client operator private key to pay for the query and submit the query to a Hedera network
ContractFunctionResult contractCallResult = query.execute(client);

// Get the function value
String message = contractCallResult.getString(0);
System.out.println("contract message: " + message);

//v2.0.0
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
//Contract call query
const query = new ContractCallQuery()
    .setContractId(contractId)
    .setGas(600)
    .setFunction("greet");

//Sign with the client operator private key to pay for the query and submit the query to a Hedera network
const contractCallResult = await query.execute(client);

// Get the function value
const message = contractCallResult.getString(0);
console.log("contract message: " + message);
```

{% endtab %}

{% tab title="Go" %}

```java
//Contract call query
query := hedera.NewContractCallQuery().
		SetContractID(contractID).
		SetGas(600).
		SetFunction("greet", nil)

//Sign with the client operator private key to pay for the query and submit the query to a Hedera network
contractFunctionResult, err := query.Execute(client)

if err != nil {
		panic(err)
}

//Print the query results to the console
println(contractFunctionResult)
//v2.0.0
```

{% endtab %}
{% endtabs %}

**Sample Output:**

```
ContractFunctionResult{
     contractId=0.0.104984
     rawResult=000000000000000000000000000000000000000000000000000000000000002
        0000000000000000000000000000000000000000000000000000000000000000d48656c
        6c6f2c20776f726c642100000000000000000000000000000000000000, 
     bloom=, 
     gasUsed=581, 
     errorMessage=null, 
     logs=[]
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.uniultra.xyz/docs/sdks-and-apis/sdks/smart-contracts/call-a-smart-contract-function-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.