contracts

Invoke a smart contract

Changed on

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

  • Base URL
    (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/contracts/call
  • Auth
    none declared

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,
  "state_overrides": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "balance": "0x1",
      "code": "0x6080604052",
      "nonce": "0x1",
      "state": [
        {
          "key": "0x0000000000000000000000000000000000000000000000000000000000000001",
          "value": "0x0000000000000000000000000000000000000000000000000000000000000001"
        }
      ],
      "state_diff": [
        {
          "key": "0x0000000000000000000000000000000000000000000000000000000000000001",
          "value": "0x0000000000000000000000000000000000000000000000000000000000000001"
        }
      ]
    }
  ],
  "to": "0xd9d0c5c0ff85758bdf05a7636f8036d4d065f5b6"
}

Response

OK

resultstring binary

Result in hexadecimal from executed contract call.

Example response

{
  "result": "0x0000000000006d8d"
}

Changes

  • v1cf87b25e4c68Revision changes
    • info

      added the new optional request property

  • v1e018d575a0edRevision changes
    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable