Local call

Makes a local call to a method on a smart contract that has been successfully deployed.

A transaction is not created as the call is never propagated across the network. All persistent data held by the smart contract is copied before the call is made.

Only this copy is altered by the call and the actual data is unaffected. Even if an amount of funds are specified to send with the call, no funds are in fact sent.

The purpose of this function is to query and test methods.

POSThttps://strax.nownodes.io/api/SmartContracts/local-call

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

An object containing the necessary parameters to build the transaction.

contractAddress*string

The address of the smart contract containing the method.

methodName*string

The name of the method to call.

amountstring

The amount of STRAT (or sidechain coin) to send to the smart contract address.

No funds are actually sent, but the Amount field allows certain scenarios, where the funds sent dictates the result, to be checked.

gasPriceinteger (int64)

The gas price to use. This is used to calculate the expected expenditure if the method is run by a miner mining a call transaction rather than locally.

gasLimitinteger (int64)

The maximum amount of gas that can be spent executing this transaction.

Although the gas expenditure is theoretical rather than actual, this limit cannot be exceeded even when the method is run locally.

senderstring

A wallet address containing the funds to cover transaction fees, gas, and any funds specified in the Amount field.

Note that because the method call is local no funds are spent. However, the concept of the sender address is still valid and may need to be checked.

For example, some methods, such as a withdrawal method on an escrow smart contract, should only be executed by the deployer, and in this case, it is the Sender address that identifies the deployer.

parametersarray of string

An array of encoded strings containing the parameters (and their type) to pass to the smart contract method when it is called.

More information on the format of a parameter string is available here.

Response

200400500

Returns call response

Request

JavaScriptCurlPython

const response = await fetch('https://strax.nownodes.io/api/SmartContracts/local-call', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({
      "contractAddress": "text",
      "methodName": "text"
    }),
});
const data = await response.json();