1 of 1

List All Contract Results

List contract results from all contracts on the network.

This method will use 15 Compute Units.

List All Contract Results

List contract results from all contracts on the network.

This method will use 15 Compute Units.

List contract results from all contracts on the network

Returns a list of all ContractResults for all contract's function executions.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/results

Query parameters

fromstring

Account ID or EVM address executing the contract

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}|(0x)?[A-Fa-f0-9]{40}$

block.hashstring

The block's hash

Pattern: ^(eq:)?(0x)?([0-9A-Fa-f]{64}|[0-9A-Fa-f]{96})$

block.numberstring

The block's number

Pattern: ^(eq:)?(\d{1,19}|0x[a-fA-f0-9]+)$

internalboolean

Whether to include child transactions or not

Example: true

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "asc"

ascdesc

timestamparray of string

The consensus timestamp in seconds.nanoseconds format with an optional comparison operator

itemsstring

Pattern: ^((eq|gt|gte|lt|lte|ne):)?\d{1,10}(.\d{1,9})?$

transaction.indexinteger (int32)

The transaction index in the block

Example: 1

Response

Body

resultsContractResults (array of ContractResult (object))

access_listnullable string

The hex encoded access_list of the wrapped ethereum transaction

Example: "0xabcd"

addressstring

The hex encoded evm address of contract

Example: "0x25fe26adc577cc89172e6156c9e24f7b9751b762"

amountnullable integer (int64)

The number of tinybars sent to the function

Example: 10

block_gas_usednullable integer (int64)

The total amount of gas used in the block

Example: 2000

block_hashnullable string

The hex encoded block (record file chain) hash

Example: "0x6ceecd8bb224da491"

block_numbernullable integer (int64)

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

Example: 10

bloomall of

nullable Bloom (string (binary))

Example: "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"

any

The hex encoded bloom filter of the contract result

call_resultnullable string

The hex encoded result returned by the function

Example: "0x2b048531b38d2882e86044bc972e940ee0a01938"

chain_idnullable string

The hex encoded chain_id of the wrapped ethereum transaction

Example: "0x0127"

contract_idnullable EntityId (string)

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

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

created_contract_idsnullable array of nullable EntityId (string)

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

itemsnullable EntityId (string)

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

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

error_messagenullable string

The message when an error occurs during smart contract execution

Example: "Out of gas"

failed_initcodestring

The hex encoded initcode of a failed contract create transaction

Example: "0x856739"

fromEvmAddress (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

function_parametersnullable string

The hex encoded parameters passed to the function

Example: "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"

gas_limitinteger (int64)

The maximum units of gas allowed for contract execution

Example: 100000

gas_pricenullable string

The hex encoded gas_price of the wrapped ethereum transaction

Example: "0x4a817c800"

gas_usednullable integer (int64)

The units of gas used to execute contract

Example: 1000

hashstring

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

Example: "0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1"

max_fee_per_gasnullable string

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

Example: "0x5"

max_priority_fee_per_gasnullable string

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

Example: "0x100"

noncenullable integer (int64)

The nonce of the wrapped ethereum transaction

Example: 1

rnullable string

The hex encoded signature_r of the wrapped ethereum transaction

Example: "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"

resultstring

The result of the transaction

Example: "SUCCESS"

snullable string

The hex encoded signature_s of the wrapped ethereum transaction

Example: "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"

statusstring

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

Example: 1

timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

tonullable EvmAddressNullable (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0x0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

transaction_indexnullable integer (int64)

The position of the transaction in the block

Example: 1

typenullable integer

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

Example: 2

vnullable integer

The recovery_id of the wrapped ethereum transaction

Example: 1

linksLinks (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

List contract results from all contracts on the network

Returns a list of all ContractResults for all contract's function executions.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/contracts/results

Query parameters

fromstring

Account ID or EVM address executing the contract

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}|(0x)?[A-Fa-f0-9]{40}$

block.hashstring

The block's hash

Pattern: ^(eq:)?(0x)?([0-9A-Fa-f]{64}|[0-9A-Fa-f]{96})$

block.numberstring

The block's number

Pattern: ^(eq:)?(\d{1,19}|0x[a-fA-f0-9]+)$

internalboolean

Whether to include child transactions or not

Example: true

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "asc"

ascdesc

timestamparray of string

The consensus timestamp in seconds.nanoseconds format with an optional comparison operator

itemsstring

Pattern: ^((eq|gt|gte|lt|lte|ne):)?\d{1,10}(.\d{1,9})?$

transaction.indexinteger (int32)

The transaction index in the block

Example: 1

Response

Body

resultsContractResults (array of ContractResult (object))

access_listnullable string

The hex encoded access_list of the wrapped ethereum transaction

Example: "0xabcd"

addressstring

The hex encoded evm address of contract

Example: "0x25fe26adc577cc89172e6156c9e24f7b9751b762"

amountnullable integer (int64)

The number of tinybars sent to the function

Example: 10

block_gas_usednullable integer (int64)

The total amount of gas used in the block

Example: 2000

block_hashnullable string

The hex encoded block (record file chain) hash

Example: "0x6ceecd8bb224da491"

block_numbernullable integer (int64)

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

Example: 10

bloomall of

nullable Bloom (string (binary))

Example: "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"

any

The hex encoded bloom filter of the contract result

call_resultnullable string

The hex encoded result returned by the function

Example: "0x2b048531b38d2882e86044bc972e940ee0a01938"

chain_idnullable string

The hex encoded chain_id of the wrapped ethereum transaction

Example: "0x0127"

contract_idnullable EntityId (string)

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

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

created_contract_idsnullable array of nullable EntityId (string)

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

itemsnullable EntityId (string)

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

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

error_messagenullable string

The message when an error occurs during smart contract execution

Example: "Out of gas"

failed_initcodestring

The hex encoded initcode of a failed contract create transaction

Example: "0x856739"

fromEvmAddress (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

function_parametersnullable string

The hex encoded parameters passed to the function

Example: "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"

gas_limitinteger (int64)

The maximum units of gas allowed for contract execution

Example: 100000

gas_pricenullable string

The hex encoded gas_price of the wrapped ethereum transaction

Example: "0x4a817c800"

gas_usednullable integer (int64)

The units of gas used to execute contract

Example: 1000

hashstring

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

Example: "0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1"

max_fee_per_gasnullable string

The hex encoded max_fee_per_gas of the wrapped ethereum transaction

Example: "0x5"

max_priority_fee_per_gasnullable string

The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction

Example: "0x100"

noncenullable integer (int64)

The nonce of the wrapped ethereum transaction

Example: 1

rnullable string

The hex encoded signature_r of the wrapped ethereum transaction

Example: "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"

resultstring

The result of the transaction

Example: "SUCCESS"

snullable string

The hex encoded signature_s of the wrapped ethereum transaction

Example: "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"

statusstring

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

Example: 1

timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

tonullable EvmAddressNullable (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0x0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

transaction_indexnullable integer (int64)

The position of the transaction in the block

Example: 1

typenullable integer

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

Example: 2

vnullable integer

The recovery_id of the wrapped ethereum transaction

Example: 1

linksLinks (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

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

{
  "results": [
    {
      "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": "0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1",
      "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
    }
  ],
  "links": {
    "next": "/api/v1/transactions?timestamp=lt:1657598275.517984411"
  }
}