> For the complete documentation index, see [llms.txt](https://tutorial.neoline.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tutorial.neoline.io/reference/neo3-provider-api-legacy/read-methods/invokeread.md).

# invokeRead

Execute a contract invocation in read-only mode.

## **Input Arguments**

<table><thead><tr><th width="302">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>scriptHash: string</code></td><td>Script hash of the smart contract to invoke a read on</td></tr><tr><td><code>operation: string</code></td><td>Operation on the smart contract to call</td></tr><tr><td><code>args:</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#argument"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a><code>Argument[]</code></td><td>Any input arguments for the operation</td></tr><tr><td><code>signers:</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#signer"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a><code>Signers[]</code></td><td>Sender and the effective scope of signature</td></tr></tbody></table>

## **Success Response**

The wallet will return the direct response from the RPC node.

| Parameter                                                                                                                                          | Description                                                                                   |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| `script: string`                                                                                                                                   | The script which was run                                                                      |
| `state: string`                                                                                                                                    | Status of the executeion                                                                      |
| `gas_consumed: string`                                                                                                                             | Estimated amount of GAS to be used to execute the invocation. (Up to 10 free per transaction) |
| `stack:` [![i](http://localhost:8080/assets/images/info.svg)](/reference/neo3-provider-api-legacy/read-methods/invokeread.md#argument)`Argument[]` | An array of response arguments                                                                |

### Argument

| Parameter                                                                                                   | Description                                                                                              |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `type: 'String' \| 'Boolean' \| 'Hash160' \| 'Hash256' \| 'Integer' \| 'ByteArray' \| 'Array' \| 'Address'` | The type of the argument with you are using. The type is an array, please see the example for the value. |
| `value: string`                                                                                             | String representation of the argument which you are using                                                |

### Signer

| Parameter                                                                                                                                                 | Description                                                              |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `account: string`                                                                                                                                         | scriptHash of the address                                                |
| `scopes: number` [![i](http://localhost:8080/assets/images/info.svg)](/reference/neo3-provider-api-legacy/read-methods/invokeread.md#scopes)              | Effective range of the signature                                         |
| `allowedContracts?: Array`                                                                                                                                | Contracts of the signature can take effect, if scopes is CustomContracts |
| `allowedGroups?: Array`                                                                                                                                   | Pubkeys of the signature can take effect, if scopes is CustomGroups      |
| `rules?:` [![i](http://localhost:8080/assets/images/info.svg)](/reference/neo3-provider-api-legacy/read-methods/invokeread.md#witnessrule)`WitnessRule[]` | Custom rules for witness to adhere by, if scopes is WitnessRules         |

### Scopes

<table><thead><tr><th width="182">Field</th><th>Description</th></tr></thead><tbody><tr><td><code>0</code></td><td>Only transactions are signed and no contracts are allowed to use this signature.</td></tr><tr><td><code>1</code></td><td>It only applies to the chain call entry. That is, if the user invokes contract A, and then contract A calls contract B, only contract A can use the signature. It is recommended as the default value for the wallet.</td></tr><tr><td><code>16</code></td><td>Custom contract. The signature can be used in the specified contract. It can be used in conjunction with CalledByEntry.</td></tr><tr><td><code>32</code></td><td>Custom contract groups that can be used in a specified contract group. It can be used in conjunction with CalledByEntry.</td></tr><tr><td><code>64</code></td><td>Indicates that the current context must satisfy the specified rules.</td></tr><tr><td><code>128</code></td><td>Global. The risk is extremely high because the contract may transfer all assets in the address. Only choose it when the contract is extremely trusted.</td></tr></tbody></table>

### WitnessRule

| Parameter                                                                                                                                                           | Description                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| `action: 'Deny' \| 'Allow'`                                                                                                                                         | Represents the action of a WitnessRule.    |
| `condition: WitnessCondition` [![i](http://localhost:8080/assets/images/info.svg)](/reference/neo3-provider-api-legacy/read-methods/invokeread.md#witnesscondition) | Represents the condition of a WitnessRule. |

### WitnessCondition

<table><thead><tr><th width="390">Field</th><th>Description</th></tr></thead><tbody><tr><td><code>BooleanWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#booleanwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that the condition will always be met or not met.</td></tr><tr><td><code>AndWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#andwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that all conditions must be met.</td></tr><tr><td><code>NotWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#notwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Reverse another condition.</td></tr><tr><td><code>OrWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#orwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that any of the conditions meets.</td></tr><tr><td><code>ScriptHashWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#scripthashwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that the condition is met when the current context has the specified script hash.</td></tr><tr><td><code>GroupWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#groupwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that the condition is met when the current context has the specified group.</td></tr><tr><td><code>CalledByEntryWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#calledbyentrywitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that the condition is met when the current context is the entry point or is called by the entry point.</td></tr><tr><td><code>CalledByContractWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#calledbycontractwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that the condition is met when the current context is called by the specified contract.</td></tr><tr><td><code>CalledByGroupWitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#calledbygroupwitnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>Indicates that the condition is met when the current context is called by the specified group.</td></tr></tbody></table>

### BooleanWitnessCondition

<table><thead><tr><th width="301">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'Boolean'</code></td><td>The type of the BooleanWitnessCondition.</td></tr><tr><td><code>expression: boolean</code></td><td>The expression of the BooleanWitnessCondition.</td></tr></tbody></table>

### AndWitnessCondition

<table><thead><tr><th width="384">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'And'</code></td><td>The type of the AndWitnessCondition.</td></tr><tr><td><code>expressions:</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#witnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a><code>WitnessCondition[]</code></td><td>The expressions of the AndWitnessCondition.</td></tr></tbody></table>

### NotWitnessCondition

<table><thead><tr><th width="358">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'Not'</code></td><td>The type of the NotWitnessCondition.</td></tr><tr><td><code>expression: WitnessCondition</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#witnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a></td><td>The expression of the NotWitnessCondition.</td></tr></tbody></table>

### OrWitnessCondition

<table><thead><tr><th width="387">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'Or'</code></td><td>The type of the OrWitnessCondition.</td></tr><tr><td><code>expressions:</code> <a href="/pages/V8k8yTt2mQwID5CyTYZb#witnesscondition"><img src="http://localhost:8080/assets/images/info.svg" alt="i"></a><code>WitnessCondition[]</code></td><td>The expressions of the OrWitnessCondition.</td></tr></tbody></table>

### ScriptHashWitnessCondition

<table><thead><tr><th width="327">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'ScriptHash'</code></td><td>The type of the ScriptHashWitnessCondition.</td></tr><tr><td><code>hash: string</code></td><td>The hash of the ScriptHashWitnessCondition.</td></tr></tbody></table>

### GroupWitnessCondition

<table><thead><tr><th width="327">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'Group'</code></td><td>The type of the GroupWitnessCondition.</td></tr><tr><td><code>group: string</code></td><td>The group of the GroupWitnessCondition.</td></tr></tbody></table>

### CalledByEntryWitnessCondition

<table><thead><tr><th width="336">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'CalledByEntry'</code></td><td>The type of the CalledByEntryWitnessCondition.</td></tr></tbody></table>

### CalledByContractWitnessCondition

<table><thead><tr><th width="333">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'CalledByContract'</code></td><td>The type of the CalledByContractWitnessCondition.</td></tr><tr><td><code>hash: string</code></td><td>The hash of the CalledByContractWitnessCondition.</td></tr></tbody></table>

### CalledByGroupWitnessCondition

<table><thead><tr><th width="306">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: 'CalledByGroup'</code></td><td>The type of the CalledByGroupWitnessCondition.</td></tr><tr><td><code>group: string</code></td><td>The group of the CalledByGroupWitnessCondition.</td></tr></tbody></table>

## **Error Response**

<table><thead><tr><th width="307">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>type: string</code></td><td>The type of error which has occured</td></tr><tr><td><code>description: string</code></td><td>A description of the error which has occured</td></tr><tr><td><code>data: string</code></td><td>Any raw data associated with the error</td></tr></tbody></table>

## Example

### Request

```js
neolineN3.invokeRead({
    scriptHash: 'd2a4cff31913016155e38e474a2c06d08be276cf',
    operation: 'transfer',
    args: [
        {
            "type": "Hash160",
            "value": "0xebae4ab3f21765e5f604dfdd590fdf142cfb89fa"
        },
        {
            "type": "Hash160",
            "value": "0xebae4ab3f21765e5f604dfdd590fdf142cfb89fa"
        },
        {
            "type": "Integer",
            "value": "10000"
        },
        {
            "type": "String",
            "value": ""
        }
    ],
    signers: [
        {
            account: "2cab903ff032ac693f8514581665be534beac39f",
            scopes: 1
        }
    ],
})
.then(result => {
  console.log('Read invocation result: ' + JSON.stringify(result));
})
.catch((error) => {
  const {type, description, data} = error;
  switch(type) {
    case 'NO_PROVIDER':
        console.log('No provider available.');
        break;
    case 'CONNECTION_REFUSED':
        console.log('Connection dApp not connected. Please call the "connect" function.');
        break;
    case 'RPC_ERROR':
        console.log('There was an error when broadcasting this transaction to the network.');
        break;
    default:
        // Not an expected error object.  Just write the error to the console.
        console.error(error);
        break;
  }
});
```

### Response

```js
{
    script: "DAABECcMFPqJ+ywU3w9Z3d8E9uVlF/KzSq7rDBT6ifssFN8PWd3fBPblZRfys0qu6xTAHwwIdHJhbnNmZXIMFM924ovQBixKR47jVWEBExnzz6TSQWJ9W1I=",
    state:"HALT",
    stack:[
        {
            type:"Boolean",
            value:false
        }
    ]
}
/* Example, Type is array */
args: [
        {
            type: "Array",
            value: [
              {
                type: "String",
                value: "0x576f726c64"
              }, {
                type: "String",
                value: "0x576f726c64"
              }
            ]
        }
    ]
```