Skip to main content

/wallet/triggerconstantcontract REST API Endpoint

Triggers the non-readonly function of a contract for predicting whether the transaction can be successfully executed or estimating the energy consumption.

Updated on
Mar 03, 2025

Body Parameters

owner_address
string
REQUIRED

The owner address that triggers the contract. If visible=true, use base58check format, otherwise use hex format. For constant call you can use the all-zero address

contract_address
string
REQUIRED

The smart contract address. If visible=true, use base58check format, otherwise use hex format.

call_value
integer

The amount of TRX transferred to the contract with this transaction, the unit is SUN

function_selector
string
REQUIRED

The function call, must not be left blank

parameter
string
REQUIRED

The parameter encoding needs to be in accordance with the ABI rules, the rules are more complicated, users can use the ethers library to encode

visible
boolean

A boolean value indicating whether the address is in base58 format

Returns

result

The result object with the following fields:

result

It is true if the estimate is successful, otherwise false

code

(Optional) The response code

message

(Optional) The result message

energy_used

The estimated energy consumption

constant_result

The result list of tiggered functions

energy_penalty

The amount of energy deducted as a penalty for exceeding resource limits

transaction

The transaction object with the following field:

ret

An array storing the execution result or status of the transaction

visible

A boolean value indicating whether the transaction was successful

txID

The transaction id

raw_data

An object that contains the transaction details with the following fields:

contract

An array of objects containing information about the delegate resource contract

parameter

An object containing the delegate resource contract parameters

value

An object containing the values of the delegate resource contract parameters

owner_address

The owner address

contract_address

The contract address

data

The operating parameters

type_url

The URL of the freeze balance contract type

type

The type of the freeze balance contract

ref_block_bytes

The ref block bytes of the transaction

ref_block_hash

The ref block hash of the transaction

expiration

This is a timestamp indicating the expiration time of the transaction in milliseconds

timestamp

This is a timestamp indicating the time at which the transaction was created in milliseconds

raw_data_hex

The hexadecimal representation of the raw data in the transactio

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free