invokeRead

Execute a contract invocation in read-only mode.

Input Arguments

Parameter	Description
scriptHash: string	Script hash of the smart contract to invoke a read on
operation: string	Operation on the smart contract to call
args: Argument[]	Any input arguments for the operation
network?: string	Network to submit this request to. If omitted, will default to network the wallet is currently set to.

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: 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
value: string	String representation of the argument which you are using

Error Response

Parameter	Description
type: string	The type of error which has occured
description: string	A description of the error which has occured
data: string	Any raw data associated with the error

Example

Request

neoline.invokeRead({
  scriptHash: '0x96ef49bb4f67e25235a4cd4455d2f10779186ab2',
  operation: 'balanceOf',
  args: [
    {
      type: 'Address',
      value: 'AY5xLg4RPZPcYoD1fW7j455PkAybbU2x42'
    }
  ]
})
.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

{
  script: '14b2ed6ac7d282933322293e5a0c5c8bb12f9477f251c10962616c616e63654f6667b26a187907f1d25544cda43552e2674fbb49ef96',
  state: 'HALT',
  gas_consumed: '0.315',
  stack: [
    {
      type: 'ByteArray',
      value: '00902f5009'
    }
  ]
}