Get Contract Result at Timestamp

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

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

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

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}

Path parameters

contractIdOrAddress*string

The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.

timestamp*string

The timestamp at which the associated transaction reached consensus

Response

200206400404

OK

Body

application/json

access_listnullable string

The hex encoded access_list of the wrapped ethereum transaction

addressstring

The hex encoded evm address of contract

amountnullable integer (int64)

The number of tinybars sent to the function

block_gas_usednullable integer (int64)

The total amount of gas used in the block

block_hashnullable string

The hex encoded block (record file chain) hash

block_numbernullable integer (int64)

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

bloomall of

call_resultnullable string

The hex encoded result returned by the function

chain_idnullable string

The hex encoded chain_id of the wrapped ethereum transaction

contract_idnullable EntityId (string)

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

created_contract_idsnullable array of nullable EntityId (string)

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

error_messagenullable string

The message when an error occurs during smart contract execution

failed_initcodestring

The hex encoded initcode of a failed contract create transaction

fromEvmAddress (string (binary))

A network entity encoded as an EVM address in hex.

function_parametersnullable string

The hex encoded parameters passed to the function

gas_limitinteger (int64)

The maximum units of gas allowed for contract execution

gas_pricenullable string

The hex encoded gas_price of the wrapped ethereum transaction

gas_usednullable integer (int64)

The units of gas used to execute contract

hashstring

A hex encoded 32 byte hash and it is only populated for Ethereum transaction case

max_fee_per_gasnullable string

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

max_priority_fee_per_gasnullable string

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

noncenullable integer (int64)

The nonce of the wrapped ethereum transaction

rnullable string

The hex encoded signature_r of the wrapped ethereum transaction

resultstring

The result of the transaction

snullable string

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

timestampTimestamp (string)

tonullable EvmAddressNullable (string (binary))

A network entity encoded as an EVM address in hex.

transaction_indexnullable integer (int64)

The position of the transaction in the block

typenullable integer

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

vnullable integer

The recovery_id of the wrapped ethereum transaction

access_listnullable string

The hex encoded access_list of the wrapped ethereum transaction

addressstring

The hex encoded evm address of contract

block_gas_usednullable integer (int64)

The total amount of gas used in the block

block_hashnullable string

The hex encoded block (record file chain) hash

block_numbernullable integer (int64)

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

chain_idnullable string

The hex encoded chain_id of the wrapped ethereum transaction

failed_initcodestring

The hex encoded initcode of a failed contract create transaction

gas_pricenullable string

The hex encoded gas_price of the wrapped ethereum transaction

hashstring

The hex encoded transaction hash

logsContractResultLogs (array of ContractResultLog (object))

max_fee_per_gasnullable string

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

max_priority_fee_per_gasnullable string

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

noncenullable integer (int64)

The nonce of the wrapped ethereum transaction

rnullable string

The hex encoded signature_r of the wrapped ethereum transaction

snullable string

The hex encoded signature_s of the wrapped ethereum transaction

state_changesContractResultStateChanges (array of ContractResultStateChange (object))

transaction_indexnullable integer (int64)

The position of the transaction in the block

typenullable integer

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

vnullable integer

The recovery_id of the wrapped ethereum transaction

Request

JavaScriptCurl

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "access_list": "0xabcd",
  "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
  "amount": 10,
  "block_gas_used": 2000,
  "block_hash": "0x6ceecd8bb224da491",
  "block_number": 10,
  "bloom": {},
  "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
  "chain_id": "0x0127",
  "contract_id": "0.1.2",
  "created_contract_ids": [
    "0.1.2"
  ],
  "error_message": "Out of gas",
  "failed_initcode": "0x856739",
  "from": "0000000000000000000000000000000000001f41",
  "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
  "gas_limit": 100000,
  "gas_price": "0x4a817c800",
  "gas_used": 1000,
  "hash": "0x3531396130303866616264653464",
  "max_fee_per_gas": "0x5",
  "max_priority_fee_per_gas": "0x100",
  "nonce": 1,
  "r": "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043",
  "result": "SUCCESS",
  "s": "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355",
  "status": 1,
  "timestamp": "1586567700.453054000",
  "to": "0x0000000000000000000000000000000000001f41",
  "transaction_index": 1,
  "type": 2,
  "v": 1,
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": {},
      "contract_id": "0.1.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ]
    }
  ],
  "state_changes": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.1.2",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value_read": "0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750",
      "value_written": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ]
}