1 of 1

List Contracts Logs

List contracts logs across many contracts on the network.

This method will use 120 Compute Units.

List Contracts Logs

List contracts logs across many contracts on the network.

This method will use 120 Compute Units.

List contracts logs across many contracts on the network

Search the logs across many contracts with multiple contract calls. Chained logs are not included but can be found by calling /api/v1/contracts/{contractId}/results/{timestamp} or /api/v1/contracts/results/{transactionId}. When searching by topic a timestamp parameter must be supplied and span a time range of at most seven days.

Ordering

The order is governed by the combination of timestamp and index values. If the index param is omitted, the order is determined by the timestamp only.

Note: The default order for this API is currently DESC

Filtering

When filtering there are some restrictions enforced to ensure correctness and scalability.

The table below defines the restrictions and support for the endpoint

Query Param	Comparison Operator	Support	Description	Example
index	eq	Y	Single occurrence only. Requires the presence of timestamp	?index=X
	ne	N
	lt(e)	Y	Single occurrence only. Requires the presence of timestamp	?index=lte:X
	gt(e)	Y	Single occurrence only. Requires the presence of timestamp	?index=gte:X
timestamp	eq	Y	Single occurrence only.	?timestamp=Y
	ne	N
	lt(e)	Y	Single occurrence only. Optional second timestamp gt(e)	?timestamp=lte:Y
	gt(e)	Y	Single occurrence only. Optional second timestamp lt(e)	?timestamp=gte:Y

Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.

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

Query parameters

indexstring

Contract log index

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

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})?$

topic0LogTopicQueryParam (array of string)

The first topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

topic1LogTopicQueryParam (array of string)

The second topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

topic2LogTopicQueryParam (array of string)

The third topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

topic3LogTopicQueryParam (array of string)

The fourth topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

Response

Body

logsContractLogs (array of ContractLog (all of))

addressstring

The hex encoded EVM address of the contract

Example: "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"

Pattern: ^0x[0-9A-Fa-f]{40}$

bloomall of

nullable Bloom (string (binary))

Example: "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"

any

The hex encoded bloom filter of the contract log

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}$

datanullable string

The hex encoded data of the contract log

Example: "0x00000000000000000000000000000000000000000000000000000000000000fa"

indexinteger

The index of the contract log in the chain of logs for an execution

Example: 0

topicsContractLogTopics (array of string)

A list of hex encoded topics associated with this log event

itemsstring

block_hashstring

The hex encoded block (record file chain) hash

Example: "0x553f9311833391c0a3b2f9ed64540a89f2190a511986cd94889f1c0cf7fa63e898b1c6730f14a61755d1fb4ca05fb073"

block_numberinteger (int64)

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

Example: 10

root_contract_idall of

nullable 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}$

any

The executed contract that created this contract log

timestampTimestamp (string)

Example: "1586567700.453054000"

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

transaction_hashstring

A hex encoded transaction hash

Example: "0x397022d1e5baeb89d0ab66e6bf602640610e6fb7e55d78638db861e2c6339aa9"

transaction_indexnullable integer (int32)

The position of the transaction in the block

Example: 1

Request

Response

List contracts logs across many contracts on the network

Ordering

The order is governed by the combination of timestamp and index values. If the index param is omitted, the order is determined by the timestamp only.

Note: The default order for this API is currently DESC

Filtering

When filtering there are some restrictions enforced to ensure correctness and scalability.

The table below defines the restrictions and support for the endpoint

Query Param	Comparison Operator	Support	Description	Example
index	eq	Y	Single occurrence only. Requires the presence of timestamp	?index=X
	ne	N
	lt(e)	Y	Single occurrence only. Requires the presence of timestamp	?index=lte:X
	gt(e)	Y	Single occurrence only. Requires the presence of timestamp	?index=gte:X
timestamp	eq	Y	Single occurrence only.	?timestamp=Y
	ne	N
	lt(e)	Y	Single occurrence only. Optional second timestamp gt(e)	?timestamp=lte:Y
	gt(e)	Y	Single occurrence only. Optional second timestamp lt(e)	?timestamp=gte:Y

Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.

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

Query parameters

indexstring

Contract log index

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

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})?$

topic0LogTopicQueryParam (array of string)

The first topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

topic1LogTopicQueryParam (array of string)

The second topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

topic2LogTopicQueryParam (array of string)

The third topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

topic3LogTopicQueryParam (array of string)

The fourth topic associated with a contract log. Requires a timestamp range also be populated.

itemsstring

Pattern: ^(0x)?[0-9A-Fa-f]{1,64}$

Response

Body

logsContractLogs (array of ContractLog (all of))

addressstring

The hex encoded EVM address of the contract

Example: "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"

Pattern: ^0x[0-9A-Fa-f]{40}$

bloomall of

nullable Bloom (string (binary))

Example: "0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"

any

The hex encoded bloom filter of the contract log

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}$

datanullable string

The hex encoded data of the contract log

Example: "0x00000000000000000000000000000000000000000000000000000000000000fa"

indexinteger

The index of the contract log in the chain of logs for an execution

Example: 0

topicsContractLogTopics (array of string)

A list of hex encoded topics associated with this log event

itemsstring

block_hashstring

The hex encoded block (record file chain) hash

Example: "0x553f9311833391c0a3b2f9ed64540a89f2190a511986cd94889f1c0cf7fa63e898b1c6730f14a61755d1fb4ca05fb073"

block_numberinteger (int64)

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

Example: 10

root_contract_idall of

nullable 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}$

any

The executed contract that created this contract log

timestampTimestamp (string)

Example: "1586567700.453054000"

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

transaction_hashstring

A hex encoded transaction hash

Example: "0x397022d1e5baeb89d0ab66e6bf602640610e6fb7e55d78638db861e2c6339aa9"

transaction_indexnullable integer (int32)

The position of the transaction in the block

Example: 1

Request

Response

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

{
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": {},
      "contract_id": "0.1.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "index": 0,
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ],
      "block_hash": "0x553f9311833391c0a3b2f9ed64540a89f2190a511986cd94889f1c0cf7fa63e898b1c6730f14a61755d1fb4ca05fb073",
      "block_number": 10,
      "root_contract_id": {},
      "timestamp": "1586567700.453054000",
      "transaction_hash": "0x397022d1e5baeb89d0ab66e6bf602640610e6fb7e55d78638db861e2c6339aa9",
      "transaction_index": 1
    }
  ]
}