API Reference

cfx_estimateGasAndCollateral - Conflux

Virtually executes a transaction, returns an estimate for the size of storage collateralized and the gas used by the transaction. The transaction will not be added to the blockchain.

Parameters

  • Object - a call request object:
    • from: BASE32 - (optional, default: random address) Address of sender.
    • to: BASE32 - (optional, default: null for contract creation) Address of receiver.
    • gasPrice: QUANTITY - (optional, default: 0) Gas price provided by the sender in Drip.
    • gas: QUANTITY - (optional, default: 500000000) Gas provided by the sender.
    • value: QUANTITY - (optional, default: 0) Value transferred in Drip.
    • data: DATA - (optional, default: 0x) The data send along with the transaction.
    • nonce: QUANTITY - (optional, default: 0) The number of transactions made by the sender prior to this one.
  • QUANTITY|TAG - (optional, default: "latest_state") Integer epoch number, or the string "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", see the epoch number parameter

Returns

Object - an estimate result object:

  • gasLimit: QUANTITY - The recommended gas_limit.
  • gasUsed: QUANTITY - Gas used during execution.
  • storageCollateralized: QUANTITY - Size of storage collateralized, in bytes.

Example

Request

curl -X POST \ --data '{"jsonrpc":"2.0","method": "cfx_estimateGasAndCollateral", "params": [ { "from": "cfx:aatmuv92xj87ptxg6mr11c5amug2kv6ra21g7pbbrp", "to": "cfx:achc8nxj7r451c223m18w2dwjnmhkd6rxawrvkvsy2", "data": "0x9bd9bbc60000000000000000000000008e45db7d866eb1a54992b24d2a8f45d53998100c0000000000000000000000000000000000000000000000000b1a2bc2ec50000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000002000000000000000000000000101130e9d3b904b18586db51cc2db1559d47610e0000000000000000000000001ea847f89a3dd63e66e29b7b8b60540d84c78d0600000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000429d069189e000000000000000000000000000000000000000000000000000006f05b59d3b20000", "gasPrice": "0x1" } ],"id":1}' \ -H "Content-Type: application/json" \ https://cfx-core.unifra.io/v1/ad2eb3c7a9404cc6a35a6641eaf70577

Result

{ "jsonrpc": "2.0", "result": { "gasLimit": "0x211a5", "gasUsed": "0x211a5", "storageCollateralized": "0x0" }, "id": 0 }
Path Params
string
required
Body Params
string
Defaults to 2.0
string
Defaults to cfx_estimateGasAndCollateral
params
array of objects
params
int32
Defaults to 0
Responses

Language
URL
Click Try It! to start a request and see the response here! Or choose an example:
application/json