contracts

Get the contract result from a contract on the network executed at a given timestamp

Changed on

Returns a single ContractResult for a contract's function executions at a specific timestamp.

get/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}

Request

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

Path parameters

contractIdOrAddressstring required

Contract or account identifier in format shard.realm.num, realm.num, num or a 20-byte EVM address (with or without 0x prefix).

timestampstring required

The Unix timestamp in seconds.nanoseconds format, the timestamp at which the associated transaction reached consensus. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Query parameters

hbarboolean

Controls the unit used for monetary fields (amount, gas_price, max_fee_per_gas, max_priority_fee_per_gas). When true (default), values are returned in tinybars. When false, values are returned in weibars (the native Ethereum unit, where 1 tinybar = 10,000,000,000 weibars).

Response

OK

addressstring nullable

The hex encoded evm address of contract

amountinteger nullable

The amount sent to the function. When hbar=true (default), the value is in tinybars. When hbar=false, the value is in weibars.

block_gas_usedinteger nullable

The total amount of gas used in the block

block_hashstring nullable

The hex encoded block (record file chain) hash

block_numberinteger nullable

The block height calculated as the number of record files starting from zero since network start.

bloomstring binary nullable

The hex encoded bloom filter of the contract result

call_resultstring nullable

The hex encoded result returned by the function

chain_idstring nullable

The hex encoded chain_id of the wrapped ethereum transaction

childboolean

Whether the transaction was executed as part of another transaction's EVM execution (e.g. a system contract call or a call dispatched by a hook).

contract_idstring nullable

Network entity ID in the format of shard.realm.num

created_contract_idsEntityId[] nullable

The list of smart contracts that were created by the function call.

error_messagestring nullable

The message when an error occurs during smart contract execution

failed_initcodestring nullable

The hex encoded initcode of a failed contract create transaction

fromstring binary nullable

A network entity encoded as an EVM address in hex.

function_parametersstring nullable

The hex encoded parameters passed to the function

gas_consumedinteger nullable

The units of consumed gas by the EVM to execute contract

gas_limitinteger

The maximum units of gas allowed for contract execution

gas_pricestring nullable

The hex encoded gas_price of the wrapped ethereum transaction

gas_usedinteger nullable

The units of gas used to execute contract

hashstring

The hex encoded transaction hash

max_fee_per_gasstring nullable

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

max_priority_fee_per_gasstring nullable

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

nonceinteger nullable

The nonce of the wrapped ethereum transaction

rstring nullable

The hex encoded signature_r of the wrapped ethereum transaction

resultstring

The result of the transaction

sstring nullable

The hex encoded signature_s of the wrapped ethereum transaction

statusstring

The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else

timestampstring

A Unix timestamp in seconds.nanoseconds format

tostring binary nullable

A network entity encoded as an EVM address in hex.

transaction_indexinteger nullable

The position of the transaction in the block

typeinteger nullable

The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)

vinteger nullable

The recovery_id of the wrapped ethereum transaction

Example response

{
  "access_list": [
    {
      "address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
      "storage_keys": [
        "0x0000000000000000000000000000000000000000000000000000000000000081"
      ]
    }
  ],
  "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
  "authorization_list": [
    {
      "address": "0x0000000000000000000000000000000000000001",
      "chain_id": "0x127",
      "nonce": 5,
      "r": "0x2222222222222222222222222222222222222222222222222222222222222222",
      "s": "0x3333333333333333333333333333333333333333333333333333333333333333",
      "y_parity": "0x1"
    }
  ],
  "amount": 10,
  "block_gas_used": 2000,
  "block_hash": "0x6ceecd8bb224da491",
  "block_number": 10,
  "bloom": "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398",
  "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
  "chain_id": "0x127",
  "contract_id": "0.0.2",
  "created_contract_ids": [
    "0.0.2"
  ],
  "error_message": "Out of gas",
  "failed_initcode": "0x856739",
  "from": "0x0000000000000000000000000000000000001f41",
  "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
  "gas_consumed": 35000,
  "gas_limit": 100000,
  "gas_price": "0x4a817c800",
  "gas_used": 80000,
  "hash": "0x3531396130303866616264653464",
  "max_fee_per_gas": "0x5",
  "max_priority_fee_per_gas": "0x100",
  "nonce": 1,
  "r": "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043",
  "result": "SUCCESS",
  "s": "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355",
  "timestamp": "1586567700.453054000",
  "to": "0x0000000000000000000000000000000000001f41",
  "transaction_index": 1,
  "type": 2,
  "v": 1,
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398",
      "contract_id": "0.0.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ]
    }
  ],
  "state_changes": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.0.2",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value_read": "0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750",
      "value_written": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ]
}

Changes

  • v1e27696aab264Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • v18ce3e9a7251eRevision changes
    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status