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"
    }
}