diff --git a/docs/public-networks/how-to/use-besu-api/access-logs.md b/docs/public-networks/how-to/use-besu-api/access-logs.md index 07b1a2ac29..7adbab9bf9 100644 --- a/docs/public-networks/how-to/use-besu-api/access-logs.md +++ b/docs/public-networks/how-to/use-besu-api/access-logs.md @@ -15,7 +15,7 @@ Access logs using the following Besu API methods: - [`eth_getFilterChanges`](../../reference/api/index.md#eth_getfilterchanges) - [`eth_getFilterLogs`](../../reference/api/index.md#eth_getfilterlogs) -- [`eth_getLogs`](../../reference/api/index.md#eth_getlogs). +- [`eth_getLogs`](../../reference/api/index.md#eth_getlogs) Use [`eth_newFilter`](../../reference/api/index.md#eth_newfilter) to create the filter before using [`eth_getFilterChanges`](../../reference/api/index.md#eth_getfilterchanges) and [`eth_getFilterLogs`](../../reference/api/index.md#eth_getfilterlogs)). @@ -68,6 +68,7 @@ If the contract had been executed twice since the last poll, with `valueIndexed` "removed": false, "blockNumber": "0x21c", "blockHash": "0xc7e6c9d5b9f522b2c9d2991546be0a8737e587beb6628c056f3c327a44b45132", + "blockTimestamp": "0x55ba4740", "transactionHash": "0xfd1a40f9fbf89c97b4545ec9db774c85e51dd8a3545f969418a22f9cb79417c5", "transactionIndex": "0x0", "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", @@ -97,6 +98,7 @@ If the contract had been executed twice with `valueIndexed` set to 5 since the f "removed": false, "blockNumber": "0x1a7", "blockHash": "0x4edda22a242ddc7bc51e2b6b11e63cd67be1af7389470cdea9c869768ff75d42", + "blockTimestamp": "0x55ba4662", "transactionHash": "0x9535bf8830a72ca7d0020df0b547adc4d0ecc4321b7d5b5d6beb1eccee5c0afa", "transactionIndex": "0x0", "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", @@ -111,6 +113,7 @@ If the contract had been executed twice with `valueIndexed` set to 5 since the f "removed": false, "blockNumber": "0x21c", "blockHash": "0xc7e6c9d5b9f522b2c9d2991546be0a8737e587beb6628c056f3c327a44b45132", + "blockTimestamp": "0x55ba4740", "transactionHash": "0xfd1a40f9fbf89c97b4545ec9db774c85e51dd8a3545f969418a22f9cb79417c5", "transactionIndex": "0x0", "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 8971700079..526bf85da5 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -175,7 +175,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"admin_changeLogLevel","params":[ ### `admin_generateLogBloomCache` -Generates cached log bloom indexes for blocks. APIs such as [`eth_getLogs`](#eth_getlogs) and [`eth_getFilterLogs`](#eth_getfilterlogs) use the cache for improved performance. +Generates cached log bloom indexes for blocks. APIs calls such as [`eth_getLogs`](#eth_getlogs) and [`eth_getFilterLogs`](#eth_getfilterlogs) use the cache for improved performance. :::tip @@ -3984,6 +3984,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":[ "removed": false, "blockNumber": "0x233", "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", + "blockTimestamp": "0x55ba4769", "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", "transactionIndex": "0x0", "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", @@ -3997,6 +3998,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":[ "removed": false, "blockNumber": "0x238", "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", + "blockTimestamp": "0x55ba4773", "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", "transactionIndex": "0x0", "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", @@ -4068,6 +4070,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x "removed": false, "blockNumber": "0xb3", "blockHash": "0xe7cd776bfee2fad031d9cc1c463ef947654a031750b56fed3d5732bee9c61998", + "blockTimestamp": "0x55ba4486", "transactionHash": "0xff36c03c0fba8ac4204e4b975a6632c862a3f08aa01b004f570cc59679ed4689", "transactionIndex": "0x0", "address": "0x2e1f232a9439c3d459fceca0beef13acc8259dd8", @@ -4081,6 +4084,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x "removed": false, "blockNumber": "0xb6", "blockHash": "0x3f4cf35e7ed2667b0ef458cf9e0acd00269a4bc394bb78ee07733d7d7dc87afc", + "blockTimestamp": "0x55ba448c", "transactionHash": "0x117a31d0dbcd3e2b9180c40aca476586a648bc400aa2f6039afdd0feab474399", "transactionIndex": "0x0", "address": "0x2e1f232a9439c3d459fceca0beef13acc8259dd8", @@ -4122,7 +4126,7 @@ Using `eth_getLogs` to get logs from a large range of blocks, especially an enti ```bash -curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"fromBlock":"earliest", "toBlock":"latest", "address": "0x2e1f232a9439c3d459fceca0beef13acc8259dd8", "topics":[]}], "id":1}' http://127.0.0.1:8545/ -H "Content-Type: application/json" +curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"fromBlock":"0x16e2a9a","toBlock":"0x16e2a9a","address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "topics":[]}], "id":1}' http://127.0.0.1:8545/ -H "Content-Type: application/json" ``` @@ -4135,9 +4139,9 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"fromBlo "method": "eth_getLogs", "params": [ { - "fromBlock": "earliest", - "toBlock": "latest", - "address": "0x2e1f232a9439c3d459fceca0beef13acc8259dd8", + "fromBlock": "0x16e2a9a", + "toBlock": "0x16e2a9a", + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "topics": [] } ], @@ -4155,29 +4159,31 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"fromBlo "id": 1, "result": [ { - "logIndex": "0x0", "removed": false, - "blockNumber": "0xb3", - "blockHash": "0xe7cd776bfee2fad031d9cc1c463ef947654a031750b56fed3d5732bee9c61998", - "transactionHash": "0xff36c03c0fba8ac4204e4b975a6632c862a3f08aa01b004f570cc59679ed4689", + "logIndex": "0x2", "transactionIndex": "0x0", - "address": "0x2e1f232a9439c3d459fceca0beef13acc8259dd8", - "data": "0x0000000000000000000000000000000000000000000000000000000000000003", + "transactionHash": "0xf9bde920aba1c0eb632138ae21d3f019977de264a4714a54f1ae2e337cce4e3d", + "blockHash": "0xa02851f445eea915ef51c54f1352a773c3821a1860d49c6d3e94a16659291c19", + "blockNumber": "0x16e2a9a", + "blockTimestamp": "0x693c23db", + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + "data": "0x00000000000000000000000000000000000000000000000001112ea12c39c032", "topics": [ - "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + "0xddf252ad1be2c89b69c2b068fc378da...9d4b2b7fad" ] }, { - "logIndex": "0x0", "removed": false, - "blockNumber": "0xb6", - "blockHash": "0x3f4cf35e7ed2667b0ef458cf9e0acd00269a4bc394bb78ee07733d7d7dc87afc", - "transactionHash": "0x117a31d0dbcd3e2b9180c40aca476586a648bc400aa2f6039afdd0feab474399", + "logIndex": "0x6", "transactionIndex": "0x0", - "address": "0x2e1f232a9439c3d459fceca0beef13acc8259dd8", - "data": "0x0000000000000000000000000000000000000000000000000000000000000005", + "transactionHash": "0xf9bde920aba1c0eb632138ae21d3f019977de264a4714a54f1ae2e337cce4e3d", + "blockHash": "0xa02851f445eea915ef51c54f1352a773c3821a1860d49c6d3e94a16659291c19", + "blockNumber": "0x16e2a9a", + "blockTimestamp": "0x693c23db", + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + "data": "0x00000000000000000000000000000000000000000000000001112ea12c39c032", "topics": [ - "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + "0xddf252ad1be2c89b69c2b068fc378d...629ba9375161" ] } ] @@ -4189,7 +4195,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"fromBlo ```bash -curl -X POST -H "Content-Type: application/json" --data '{"query": "{logs(filter:{fromBlock: 1486000, toBlock: 1486010, addresses: [\"0x7ef66b77759e12caf3ddb3e4aff524e577c59d8d\"], topics: [[\"0x8a22ee899102a366ac8ad0495127319cb1ff2403cfae855f83a89cda1266674d\"]]}) {index topics data account{address} transaction{hash} }}"}' http://localhost:8547/graphql +curl -X POST -H "Content-Type: application/json" --data '{"query": "{logs(filter:{fromBlock: 24000026, toBlock: 24000026, addresses: [\"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\"]}) {index topics data account{address} transaction{hash} }}"}' http://localhost:8547/graphql ``` @@ -4198,7 +4204,7 @@ curl -X POST -H "Content-Type: application/json" --data '{"query": "{logs(filter ```text { - logs(filter: {fromBlock: 1486000, toBlock: 1486010, addresses: ["0x7ef66b77759e12caf3ddb3e4aff524e577c59d8d"], topics: [["0x8a22ee899102a366ac8ad0495127319cb1ff2403cfae855f83a89cda1266674d"]]}) { + logs(filter: {fromBlock: 24000026, toBlock: 24000026, addresses: ["0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"]}) { index topics data @@ -4221,33 +4227,29 @@ curl -X POST -H "Content-Type: application/json" --data '{"query": "{logs(filter "data": { "logs": [ { - "index": 0, + "index": 2, "topics": [ - "0x8a22ee899102a366ac8ad0495127319cb1ff2403cfae855f83a89cda1266674d", - "0x0000000000000000000000000000000000000000000000000000000000000004", - "0x0000000000000000000000000000000000000000000000000000000000508918" + "0xddf252ad1be2c89b69c2b068fc378...d4b2b7fad" ], - "data": "0xa5a04999ec29a8bd19ce32b859280ef9dbb464d846be06f64a1b1012ec08ab03", + "data": "0x00000000000000000000000000000000000000000000000001112ea12c39c032", "account": { - "address": "0x7ef66b77759e12caf3ddb3e4aff524e577c59d8d" + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, "transaction": { - "hash": "0x36a2186344c6a32760e7700fdf3685936220876c51ff39d071eb48c17f7e802f" + "hash": "0xf9bde920aba1c0eb632138ae21d3f019977de264a4714a54f1ae2e337cce4e3d" } }, { - "index": 0, + "index": 6, "topics": [ - "0x8a22ee899102a366ac8ad0495127319cb1ff2403cfae855f83a89cda1266674d", - "0x0000000000000000000000000000000000000000000000000000000000000003", - "0x0000000000000000000000000000000000000000000000000000000000648c72" + "0xddf252ad1be2c89b69c2b068fc378...9ba9375161" ], - "data": "0x0ee96b660ad82c8010c90760a03edfbb40b4af5e3634a8c214e4ac7fa1f61492", + "data": "0x00000000000000000000000000000000000000000000000001112ea12c39c032", "account": { - "address": "0x7ef66b77759e12caf3ddb3e4aff524e577c59d8d" + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, "transaction": { - "hash": "0x9e2cc9e84a9e78839d6f4b591dfd98cc7a454a8ee3cd6ccd0a18e662e22d3818" + "hash": "0xf9bde920aba1c0eb632138ae21d3f019977de264a4714a54f1ae2e337cce4e3d" } } ] @@ -4954,6 +4956,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","para "result": { "blockHash": "0xe7212a92cfb9b06addc80dec2a0dfae9ea94fd344efeb157c41e12994fcad60a", "blockNumber": "0x50", + "blockTimestamp": "0x55ba43bb", "contractAddress": null, "cumulativeGasUsed": "0x5208", "from": "0x627306090abab3a6e1400e9345bc60c78a8bef57", diff --git a/docs/public-networks/reference/api/objects.md b/docs/public-networks/reference/api/objects.md index f541257724..d56fbb8375 100644 --- a/docs/public-networks/reference/api/objects.md +++ b/docs/public-networks/reference/api/objects.md @@ -104,7 +104,8 @@ Parameter for [`eth_newFilter`](index.md#eth_newfilter), [`eth_getLogs`](index.m ## Log object -Returned by [`eth_getFilterChanges`](index.md#eth_getfilterchanges) and [`priv_getLogs`](../../../private-networks/reference/api.md#priv_getlogs). +Returned by [`eth_getFilterChanges`](index.md#eth_getfilterchanges), [`eth_getFilterLogs`](index.md#eth_getfilterlogs), [`eth_getLogs`](index.md#eth_getLogs). + [Transaction receipt objects](#transaction-receipt-object) and [call result objects](#call-result-object) can contain an array of log objects. | Key | Type | Value | @@ -115,6 +116,7 @@ Returned by [`eth_getFilterChanges`](index.md#eth_getfilterchanges) and [`priv_g | `transactionHash` | Data, 32 bytes | Hash of the starting transaction for the log. `null` when log is pending. | | `blockHash` | Data, 32 bytes | Hash of the block that includes the log. `null` when log is pending. | | `blockNumber` | Quantity | Number of block that includes the log. `null` when log is pending. | +| `blockTimestamp` | Quantity | Hex-encoded unix timestamp (in seconds) of the block that includes the log. | | `address` | Data, 20 bytes | Address the log originated from. | | `data` | Data | Non-indexed arguments of the log. | | `topics` | Array of Data, 32 bytes each | [Event signature hash](../../concepts/events-and-logs.md#event-signature-hash) and 0 to 3 [indexed log arguments](../../concepts/events-and-logs.md#event-parameters). | @@ -264,6 +266,7 @@ Returned by [`eth_getTransactionReceipt`](index.md#eth_gettransactionreceipt). | --- | :-: | --- | | `blockHash` | Data, 32 bytes | Hash of block containing this transaction. | | `blockNumber` | Quantity | Block number of block containing this transaction. | +| `blockTimestamp` | Quantity | Hex-encoded unix timestamp (in seconds) of the block that includes this transaction. | | `contractAddress` | Data, 20 bytes | Contract address created, if contract creation transaction, otherwise, `null`. A failed contract creation transaction still produces a contract address value. | | `cumulativeGasUsed` | Quantity | Total amount of gas used by previous transactions in the block and this transaction. | | `effectiveGasPrice` | Quantity | The [actual value per gas deducted](../../concepts/transactions/types.md#eip1559-transactions) from the sender's account. |