v1

latestOpenAPI 3.0.3Apache-2.02026-07-1348142206.6 KB

contracts

Invoke a smart contract

Returns a result from EVM execution such as cost-free execution of read-only smart contract queries, gas estimation, and transient simulation of read-write operations. If the estimate field is set to true gas estimation is executed. This API can process calls against the latest block or specific historical blocks when a hexadecimal or decimal block number is provided in the block field.

post/api/v1/contracts/call

Request body

blockstring nullable

Hexadecimal block number or the string "latest", "pending", "earliest". Defaults to "latest".

datastring binary nullable

Hexadecimal method signature and encoded parameters. Up to 131072 bytes as at most 262146 hexadecimal digits including optional leading 0x.

estimateboolean nullable

Whether gas estimation is called. Defaults to false.

fromstring binary nullable

The 20-byte hexadecimal EVM address the transaction is sent from.

gasinteger nullable

Gas provided for the transaction execution. Defaults to 15000000.

gasPriceinteger nullable

Gas price used for each paid gas.

tostring binary required

The 20-byte hexadecimal EVM address the transaction is directed to.

valueinteger nullable

Value sent with this transaction. Defaults to 0.

Example request

{
  "block": "latest",
  "data": "0x47f1aae7",
  "estimate": true,
  "from": "00000000000000000000000000000000000004e2",
  "gas": 15000000,
  "gasPrice": 100000000,
  "to": "0xd9d0c5c0ff85758bdf05a7636f8036d4d065f5b6"
}

Response

resultstring binary

Result in hexadecimal from executed contract call.

Example response

{
  "result": "0x0000000000006d8d"
}