TriggerConstantContract

Invoke the read-only function (modified by the view or pure modifier) of a contract to query contract data, or invoke the non-read-only function of a contract to predict whether the transaction can be successfully executed or estimate energy consumption. (Confirmed state)

Note:

The TriggerConstantContract operation does not generate an on-chain transaction and does not alter the status of the current node.

For estimating energy: Use triggerconstantcontract to call the non-read-only method of the contract. The energy_used field in the returned value represents the energy consumption. Thus, the fee_limit of the transaction can be set to energy_used x energy unit price.

Parameter encoding and decoding example: Encoding and decoding of parameters and return values.

Returns

Field	Type	Description
result	Return	Run result, for detailed parameter definition, refer to EstimateEnergy
energy_used	int64	Estimated energy consumption
constant_result	string[]	Result list of triggered functions
transaction	Transaction	Transaction information, refer to GetTransactionByID

Request

Body Params application/json

object {0}

Example

{
  "owner_address": "PHqgRM8giN6Nr9DgA1FybUjKFwd79cxhyp",
  "contract_address": "PNLKUWSfXBmynfg8zDHoRZWViQmrJiobaA",
  "function_selector": "balanceOf(address)",
  "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
  "visible": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

object {0}

Examples

SuccessException

{
  "result": {
    "result": true
  },
  "energy_used": 541,
  "constant_result": [
    "00000000000000000000000000000000000000000000000000000001970c956f"
  ],
  "transaction": {
    "ret": [
      {}
    ],
    "visible": true,
    "txID": "711a6c068547e0793f25b60ade4491cb77b9c57d93e3dd734d953a22db6549ee",
    "raw_data": {
      "contract": [
        {
          "parameter": {
            "value": {
              "data": "70a08231000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
              "owner_address": "PHqgRM8giN6Nr9DgA1FybUjKFwd79cxhyp",
              "contract_address": "PNLKUWSfXBmynfg8zDHoRZWViQmrJiobaA"
            },
            "type_url": "type.googleapis.com/protocol.TriggerSmartContract"
          },
          "type": "TriggerSmartContract"
        }
      ],
      "ref_block_bytes": "aab0",
      "ref_block_hash": "8c3b13ab5db2fc3c",
      "expiration": 1737619461000,
      "timestamp": 1737619458204
    },
    "raw_data_hex": "0a02aab022088c3b13ab5db2fc3c4088a7c391c9325a8e01081f1289010a31747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e54726967676572536d617274436f6e747261637412540a1541b3dcf27c251da9363f1a4888257c16676cf54edf12154142a1e39aefa49290f2b3f9ed688d7cecf86cd6e0222470a08231000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c709c91c391c932"
  }
}