/wallet/estimateenergy

预估调用合约所需能量。需节点开启 vm.estimateEnergy=true。

• 源码：framework/src/main/java/org/tron/core/services/http/EstimateEnergyServlet.java
• Method：POST
• Contract：protocol.TriggerSmartContract
• Response：api.EstimateEnergyMessage
• 支持固化接口：/walletsolidity/estimateenergy

请求参数

字段	类型	必填	说明
owner_address	string	是	调用方地址（合约 msg.sender）
contract_address	string	条件必填	目标合约地址；必须提供 contract_address 或 data
function_selector	string	否	函数签名
parameter	string	否	ABI 编码参数（hex）
data	string	否	预先构造的调用或部署 data（hex）
call_value	int64	否	模拟调用带入的 TRX（sun）
token_id	int64	否	模拟调用带入的 TRC-10 token id
call_token_value	int64	否	模拟调用带入的 TRC-10 数量
visible	bool	否	地址和响应文本字段格式

必填约束为 owner_address AND (contract_address OR data)。与 /wallet/triggerconstantcontract 不同，此 servlet 不应用 Permission_id 或 extra_data，也不读取 fee_limit。

示例：

curl --request POST \
     --url https://nile.trongrid.io/wallet/estimateenergy \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "owner_address":    "41dd791d6b49e190062d650e6a23c575510d35f2f9",
  "contract_address": "41eca9bc828a3005b9a3b909f2cc5c2a54794de05f",
  "function_selector": "balanceOf(address)",
  "parameter":         "000000000000000000000000dd791d6b49e190062d650e6a23c575510d35f2f9"
}
'

响应

字段	类型	说明
result	Return	调用结果（success/error）
energy_required	int64	预估所需能量

响应示例：

{
  "result": { "result": true },
  "energy_required": 1870
}

未开启 vm.estimateEnergy=true 时调用走 ContractValidateException 分支（见下文）：result.code = CONTRACT_VALIDATE_ERROR，result.message 为 this node does not support estimate energy。

异常响应

请求进入 servlet 后不会写出 {"Error": ...}。由 servlet 接管的异常会被 catch 后写入 result.code、result.message，HTTP 体仍是 EstimateEnergyMessage。

在请求进入此 servlet 前，共享层仍可能返回不同结构：请求体超限时，SizeLimitHandler 通常返回 HTTP 413 Payload Too Large；非阻塞限流拒绝则返回 HTTP 200 和 {"Error":"class java.lang.IllegalAccessException : lack of computing resources"}。

触发条件	result.result	result.code	result.message
节点未开启 vm.estimateEnergy	false	CONTRACT_VALIDATE_ERROR	this node does not support estimate energy
节点关闭 constant-call 支持	false	CONTRACT_VALIDATE_ERROR	this node does not support constant, so estimate energy cannot work
contract_address 已设置但合约不存在	false	CONTRACT_VALIDATE_ERROR	Smart contract is not exist.
EVM exception / retry 耗尽 / 其他非校验异常	false	OTHER_ERROR	<exceptionClass> : <message>（" → '）

异常路径下 energy_required 字段不被填充（值为 0）。

---