eth_getLogs
Returns logs matching the filter in the parameters.
Parameters
Filter
Parameter | Type | Required | Description |
---|---|---|---|
fromBlock |
string | optional | Starting block number, inclusive; if not present, latest is assumed |
toBlock |
string | optional | Ending block number, inclusive; if not present, latest is assumed |
address |
string | optional | Contract address or list of addresses from which logs should originate |
topics |
string | optional | Topic elements - see later |
blockHash |
string | optional | If present, we search the specific block matching this hash |
If blockHash
is specified, it is an error to also specify fromBlock
or toBlock
. If fromBlock
or toBlock
is specified, it is an error to also specify blockHash
.
fromBlock
must be less than or equal to toBlock
.
Block Number
The block number can be:
- A hex number in a string: eg.
"0x800"
- A block hash as a string eg.
"0xf77e76c25038b0be1fbd12a4f3e404173802bf0c9a9e62deef7949201d59ebfb
"earliest"
for the earliest block"latest"
for the latest block"safe"
for the block that the node's high quorum certificate points to"finalized"
for the latest finalized block."pending"
is the block that is about to be created.
Topic specifications
Topic elements represent an alternative that matches any of the contained topics.
Examples (from Erigon):
* `[]` matches any topic list
* `[[A]]` matches topic A in first position
* `[[], [B]]` or `[None, [B]]` matches any topic in first position AND B in second position
* `[[A], [B]]` matches topic A in first position AND B in second position
* `[[A, B], [C, D]]` matches topic (A OR B) in first position AND (C OR D) in second position
Return values
We return a list of log objects
Log object
Parameter | Type | Required | Description |
---|---|---|---|
removed |
bool | required | Always false |
logIndex |
string | required | Hex string; the (0-based) index of this log within the current transaction receipt |
transactionIndex |
string | required | Hex string; the (0-based) index of this transaction within the current block |
transactionHash |
string | required | Hash of the transaction that generated this log |
blockHash |
string | required | Hash of the block in which the transaction that generated this log appears |
blockNumber |
string | required | Hex string; the number of the block in which this transaction appears |
address |
string | required | The address from which this log was emitted |
data |
string | required | Hex string; the data associated with this log entry |
topics |
string | required | An array containing the topics associated with this log entry, as an array of hex strings |
Example Request
curl -d '{
"id": "1",
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [ { "fromBlock": "0x779", "toBlock": "0x779" } ]}' -H "Content-Type: application/json" -X POST "https://api.zq2-prototestnet.zilliqa.com/"
Example response
{"jsonrpc":"2.0","result":[{"removed":false,"logIndex":"0x0","transactionIndex":"0x0","transactionHash":"0xcfd9d4473c9467f7fc1fe6f602599c8559ea78953acaae205551bb6c2f55472f","blockHash":"0x224a67320685771e1e0c428b1a271af8339cbd542d1726642c3a14519f25ae9e","blockNumber":"0x779","address":"0xbca0f6f4cbfe8ac37096b674de8f96c701c43f7c","data":"0x00000000000000000000000000000000000000000000000000000000000f4240","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000000000000000000000000000000000000000000000","0x000000000000000000000000cb57ec3f064a16cadb36c7c712f4c9fa62b77415"]}],"id":"1"}
Arguments
Parameter | Type | Required | Description |
---|---|---|---|
id |
string | Required | "1" |
jsonrpc |
string | Required | "2.0" |
method |
string | Required | "DSBlockListing" |
params |
array | Requred | [ filter ] |