From 1edc6656655d406492c3d009d63b6b763a984559 Mon Sep 17 00:00:00 2001 From: Gabriel-Trintinalia Date: Wed, 21 Sep 2022 05:04:23 +1000 Subject: [PATCH] Add Warning to Docs about Restarting Node before Fully Syncing A Node (#1174) * Add Warning to Docs about Restarting Node before Fully Syncing A Node Signed-off-by: gtrintinalia * fix vale errors cause by workflow migration Signed-off-by: Alexandra Tran * edit sync note Signed-off-by: Alexandra Tran Signed-off-by: gtrintinalia Signed-off-by: Alexandra Tran Co-authored-by: gtrintinalia Co-authored-by: Alexandra Tran --- CI/vale/styles/Vocab/Besu/accept.txt | 14 + .../use-privacy/performance-best-practices.md | 2 +- .../private-networks/reference/api/objects.md | 56 ++-- .../tutorials/kubernetes/charts.md | 6 +- .../tutorials/kubernetes/index.md | 13 +- .../tutorials/kubernetes/production.md | 6 +- .../how-to/prepare-for-the-merge.md | 4 + docs/public-networks/reference/api/index.md | 17 +- docs/public-networks/reference/api/objects.md | 266 +++++++++--------- docs/public-networks/reference/evm-tool.md | 2 +- docs/public-networks/reference/trace-types.md | 8 +- .../tutorials/merge-testnet.md | 4 + 12 files changed, 210 insertions(+), 188 deletions(-) diff --git a/CI/vale/styles/Vocab/Besu/accept.txt b/CI/vale/styles/Vocab/Besu/accept.txt index 3b51fe33..b6f5c1d3 100644 --- a/CI/vale/styles/Vocab/Besu/accept.txt +++ b/CI/vale/styles/Vocab/Besu/accept.txt @@ -2,8 +2,10 @@ Alethio [aA]llowlist(s)? Ansible +API(s)? [aA]utogenerated [aA]ttester(s)? +AZ(s)? Azure [bB]ackend [bB]ackoff @@ -26,6 +28,7 @@ Codefi containerd ConsenSys [cC]ounterpart(y|ies) +CPU(s)? [cC]rafter [cC]ryptocurrenc(y|ies) ctrl @@ -34,6 +37,7 @@ Dapp(s)? Dev [dD]atatype(s)? [dD]eauthoriz(e|ing) +EIP(s)? [eE]ncryptor(s)? [eE]node(s)? etcd @@ -57,6 +61,7 @@ Gradle Grafana gRPC [gG]?[wW]ei +HAProxy HashiCorp [hH]ashrate(s)? Helmfile(s)? @@ -72,6 +77,7 @@ Javadoc JMeter JSON jnacl +JWT(s)? Kafka kalium Keycloak @@ -103,6 +109,7 @@ MkDocs Nginx Nodejs [nN]once(s)? +NVMe [oO]ffchain [oO]nboard(ing)? [oO]nchain @@ -113,6 +120,7 @@ Orion PegaSys [pP]ermission(ing|ed)? [pP]luggable +PMT(s)? P[oO]A Poste Postgres @@ -145,6 +153,7 @@ Mordor Slack [sS]lashable Splunk +SSD(s)? statefully [sS]tatefulset [sS]ubcommand(s)? @@ -169,6 +178,11 @@ Unix [vV]alidator(s)? Vertx [vV]eto(s|es)? +VNet(s)? +VPC(s)? +VPN(s)? +VSCode +VTx Web Web3Signer [wW]ebservice(s)? diff --git a/docs/private-networks/how-to/use-privacy/performance-best-practices.md b/docs/private-networks/how-to/use-privacy/performance-best-practices.md index 0acd469c..9deade5f 100644 --- a/docs/private-networks/how-to/use-privacy/performance-best-practices.md +++ b/docs/private-networks/how-to/use-privacy/performance-best-practices.md @@ -15,7 +15,7 @@ Running EVM transactions creates a lot of random reads that are executed sequent The Besu data folder for high throughput nodes should be located on the fastest possible storage media. * Prefer [NVMe](https://cloud.google.com/compute/docs/disks/local-ssd#performance) attached SLC flash or Intel Optane. -* Avoid network attached SSDs or cloud storage with limited IOPs. +* Avoid network attached SSDs or cloud storage with limited input/output operations per second. * Do not use spinning disks under any circumstances. ## Private transaction performance diff --git a/docs/private-networks/reference/api/objects.md b/docs/private-networks/reference/api/objects.md index d95630a9..605b31b3 100644 --- a/docs/private-networks/reference/api/objects.md +++ b/docs/private-networks/reference/api/objects.md @@ -18,20 +18,20 @@ Returned by [`priv_getPrivateTransaction`](index.md#priv_getprivatetransaction). | Key | Type | Value | |-----|:----:|-------| -| **from** | Data, 20 bytes | Address of the sender. | -| **gas** | Quantity | Gas provided by the sender. | -| **gasPrice** | Quantity | Gas price, in Wei, provided by the sender. | -| **input** | Data | The data to create or invoke a contract. | -| **nonce** | Quantity | Number of transactions made by the sender to the privacy group before this one. | -| **to** | Data, 20 bytes | `null` if a contract creation transaction, otherwise, the contract address. | -| **value** | Quantity | `null` because private transactions cannot transfer Ether. | -| **v** | Quantity | ECDSA Recovery ID. | -| **r** | Data, 32 bytes | ECDSA signature r. | -| **s** | Data, 32 bytes | ECDSA signature s. | -| **privateFrom** | Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) public key of the sender. | -| **privateFor** | Array of Data, 32 bytes each | [Tessera](https://docs.tessera.consensys.net/) public keys of recipients. Not returned if using `privacyGroupId` to [send the transaction](../../../private-networks/concepts/privacy/privacy-groups.md#privacy-types). | -| **privacyGroupId** | Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) privacy group ID of recipients. Not returned if using `privateFor` to [send the transaction](../../../private-networks/concepts/privacy/privacy-groups.md#privacy-types). | -| **restriction** | String | Must be [`restricted`](../../../private-networks/concepts/privacy/private-transactions/index.md). | +| `from` | Data, 20 bytes | Address of the sender. | +| `gas` | Quantity | Gas provided by the sender. | +| `gasPrice` | Quantity | Gas price, in Wei, provided by the sender. | +| `input` | Data | The data to create or invoke a contract. | +| `nonce` | Quantity | Number of transactions made by the sender to the privacy group before this one. | +| `to` | Data, 20 bytes | `null` if a contract creation transaction, otherwise, the contract address. | +| `value` | Quantity | `null` because private transactions cannot transfer Ether. | +| `v` | Quantity | ECDSA Recovery ID. | +| `r` | Data, 32 bytes | ECDSA signature r. | +| `s` | Data, 32 bytes | ECDSA signature s. | +| `privateFrom` | Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) public key of the sender. | +| `privateFor` | Array of Data, 32 bytes each | [Tessera](https://docs.tessera.consensys.net/) public keys of recipients. Not returned if using `privacyGroupId` to [send the transaction](../../../private-networks/concepts/privacy/privacy-groups.md#privacy-types). | +| `privacyGroupId` | Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) privacy group ID of recipients. Not returned if using `privateFor` to [send the transaction](../../../private-networks/concepts/privacy/privacy-groups.md#privacy-types). | +| `restriction` | String | Must be [`restricted`](../../../private-networks/concepts/privacy/private-transactions/index.md). | ## Private transaction receipt object @@ -39,17 +39,17 @@ Returned by [`priv_getTransactionReceipt`](index.md#priv_gettransactionreceipt). | Key | Type | Value | |-----|:----:|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| **blockHash** | Data, 32 bytes | Hash of block containing this transaction. | -| **blockNumber** | Quantity | Block number of block containing this transaction. | -| **contractAddress** | Data, 20 bytes | Contract address created if a contract creation transaction, otherwise, `null`. A failed contract creation transaction still produces a contract address value. | -| **from** | Data, 20 bytes | Address of the sender. | -| **logs** | Array | Array of [log objects](../../../public-networks/reference/api/objects.md#log-object) generated by this private transaction. | -| **to** | Data, 20 bytes | Address of the receiver, if sending ether, otherwise, null. | -| **transactionIndex** | Quantity, Integer | Index position of transaction in the block. | -| **revertReason** | String | ABI-encoded string that displays the [reason for reverting the transaction](../../../private-networks/how-to/send-transactions/revert-reason.md). Only available if revert reason is [enabled](../cli/options.md#revert-reason-enabled). | -| **output** | Data | RLP-encoded return value of a contract call if a value returns, otherwise, `null`. | -| **commitmentHash** | Data, 32 bytes | Hash of the privacy marker transaction. | -| **status** | Quantity | Either `0x1` (success) or `0x0` (failure). | -| **privateFrom** | Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) public key of the sender. | -| **privateFor** or **privacyGroupId** | Array or Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) public keys or privacy group ID of the recipients. | -| **logsBloom** | Data, 256 bytes | Bloom filter for light clients to quickly retrieve related logs. | +| `blockHash` | Data, 32 bytes | Hash of block containing this transaction. | +| `blockNumber` | Quantity | Block number of block containing this transaction. | +| `contractAddress` | Data, 20 bytes | Contract address created if a contract creation transaction, otherwise, `null`. A failed contract creation transaction still produces a contract address value. | +| `from` | Data, 20 bytes | Address of the sender. | +| `logs` | Array | Array of [log objects](../../../public-networks/reference/api/objects.md#log-object) generated by this private transaction. | +| `to` | Data, 20 bytes | Address of the receiver, if sending ether, otherwise, null. | +| `transactionIndex` | Quantity, Integer | Index position of transaction in the block. | +| `revertReason` | String | ABI-encoded string that displays the [reason for reverting the transaction](../../../private-networks/how-to/send-transactions/revert-reason.md). Only available if revert reason is [enabled](../cli/options.md#revert-reason-enabled). | +| `output` | Data | RLP-encoded return value of a contract call if a value returns, otherwise, `null`. | +| `commitmentHash` | Data, 32 bytes | Hash of the privacy marker transaction. | +| `status` | Quantity | Either `0x1` (success) or `0x0` (failure). | +| `privateFrom` | Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) public key of the sender. | +| `privateFor` or `privacyGroupId` | Array or Data, 32 bytes | [Tessera](https://docs.tessera.consensys.net/) public keys or privacy group ID of the recipients. | +| `logsBloom` | Data, 256 bytes | Bloom filter for light clients to quickly retrieve related logs. | diff --git a/docs/private-networks/tutorials/kubernetes/charts.md b/docs/private-networks/tutorials/kubernetes/charts.md index 948c01b6..640e73bc 100644 --- a/docs/private-networks/tutorials/kubernetes/charts.md +++ b/docs/private-networks/tutorials/kubernetes/charts.md @@ -59,10 +59,10 @@ azure: subscriptionId: azure-subscriptionId ``` -Setting the `cluster.cloudNativeServices: true` will: +Setting the `cluster.cloudNativeServices: true`: -* Store keys in Azure KeyVault or AWS Secrets Manager -* Make use of Azure Managed Identities or AWS IAMs for pod identity access +* Stores keys in Azure Key Vault or AWS Secrets Manager. +* Uses Azure Managed Identities or AWS Identity and Access Management for pod identity access. !!! note diff --git a/docs/private-networks/tutorials/kubernetes/index.md b/docs/private-networks/tutorials/kubernetes/index.md index 775c341b..12e803b5 100644 --- a/docs/private-networks/tutorials/kubernetes/index.md +++ b/docs/private-networks/tutorials/kubernetes/index.md @@ -92,16 +92,17 @@ cloud or on premise. In Kubernetes, [namespaces](https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/) provide a mechanism for isolating groups of resources within a single cluster. -Both namespaces and resources (for example, StatefulSets or Services) within a namespace must be unique, but resources +Both namespaces and resources (for example, Stateful Sets or Services) within a namespace must be unique, but resources across namespaces don't need to be. !!! note - Namespace-based scoping is not applicable for cluster-wide objects (for example, StorageClass or PersistentVolumes). + Namespace-based scoping is not applicable for cluster-wide objects (for example, Storage Class + or Persistent Volumes). ### Nodes -Consider using StatefulSets instead of Deployments for Besu. The term 'client node' refers to bootnode, validator +Consider using Stateful Sets instead of Deployments for Besu. The term 'client node' refers to bootnode, validator and member/RPC nodes. For Besu nodes, we only use CLI arguments to keep things consistent. ### Role-based access controls @@ -109,7 +110,7 @@ and member/RPC nodes. For Besu nodes, we only use CLI arguments to keep things c We encourage using role-based access controls (RBACs) for access to the private key of each node, that is, only a specific pod or statefulset is allowed to access a specific secret. -If you need to specify a Kube configuration file for each pod, use the KUBE_CONFIG_PATH variable. +If you need to specify a Kube configuration file for each pod, use the `KUBE_CONFIG_PATH` variable. ### Storage @@ -125,9 +126,9 @@ Select the appropriate type of [Storage Class](https://kubernetes.io/docs/concep on your cloud provider. In the templates, the size of the [volume claims](https://kubernetes.io/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims) is set to 20Gb by default; you can change this depending on your needs. If you have a different storage account than the one in the charts, you may edit those -[storageClasses](https://github.com/ConsenSys/quorum-kubernetes/blob/5920caff6dd15b4ca17f760ad9e4d7d2e43b41a1/helm/charts/besu-node/templates/node-storage.yaml). +[Storage Classes](https://github.com/ConsenSys/quorum-kubernetes/blob/5920caff6dd15b4ca17f760ad9e4d7d2e43b41a1/helm/charts/besu-node/templates/node-storage.yaml). -When using PVCs, set the `allowVolumeExpansion` to `true`. This helps keep costs low and enables growing the volume +When using Persistent Volume Claims, set the `allowVolumeExpansion` to `true`. This helps keep costs low and enables growing the volume over time rather than creating new volumes and copying data across. ### Monitoring diff --git a/docs/private-networks/tutorials/kubernetes/production.md b/docs/private-networks/tutorials/kubernetes/production.md index 499480e1..51d79c6c 100644 --- a/docs/private-networks/tutorials/kubernetes/production.md +++ b/docs/private-networks/tutorials/kubernetes/production.md @@ -90,8 +90,8 @@ alternatively alert via Cloudwatch or Azure Monitoring. ## Multi-cluster support When CNI is used, multi-cluster support is simple, but you have to cater for cross-cluster DNS names. -Ideally, you want to create two separate VPCs (or VNets) and make sure they have different base CIDR blocks so that IPs -don't conflict. +Ideally, you want to create two separate VPCs (or VNets) and make sure they have different base CIDR +blocks so that IP addresses don't conflict. Once done, peer the VPCs together and update the subnet route table, so they are effectively a giant single network. ![multi-cluster](../../../assets/images/kubernetes-3.png) @@ -99,7 +99,7 @@ Once done, peer the VPCs together and update the subnet route table, so they are When you [spin up clusters](cluster.md), use [CNI](index.md#limitations) and CIDR blocks to match the subnet's CIDR settings. Then deploy the genesis chart on one cluster and copy across the genesis file and static nodes config maps. -Depending on your DNS settings, they might be fine as is or they might need to be actual IPs. +Depending on your DNS settings, they might be fine as is, or they might need to be actual IP addresses. That is, you can provision cluster B only after cluster A has Besu nodes up and running. Deploy the network on cluster A, and then on cluster B. diff --git a/docs/public-networks/how-to/prepare-for-the-merge.md b/docs/public-networks/how-to/prepare-for-the-merge.md index 3413cadc..01b65910 100644 --- a/docs/public-networks/how-to/prepare-for-the-merge.md +++ b/docs/public-networks/how-to/prepare-for-the-merge.md @@ -66,6 +66,10 @@ Validators can't produce attestations or blocks without a fully synced execution To expedite network participation, [sync Besu](connect/sync-node.md) on Ethereum Mainnet before the Merge configuration (Bellatrix) comes online. +!!! caution + + If you restart your node before snap or checkpoint sync completes, syncing restarts from scratch. + ## Update Besu Once Bellatrix is scheduled for activation on Mainnet, Besu will be released with updated configuration for Mainnet. diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 3b47395c..aa4fd0ab 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -5717,15 +5717,14 @@ For example, you cannot query transactions with a gas price between 8 and 9 Gwei All filters must be satisfied for a transaction to be returned. -| Field name | Value | Value type | Supported operators | -|--------------|-------------------------------------------|:---------------------:|---------------------| -| **from** | Address of the sender. | *Data*, 20 bytes | `eq` | -| **to** | Address of the receiver, or `"contract_creation"`.| *Data*, 20 bytes |`eq`, `action`| -| **gas** | Gas provided by the sender. | *Quantity* | `eq`, `gt`, `lt` | -| **gasPrice** | Gas price, in wei, provided by the sender.| *Quantity* | `eq`, `gt`, `lt` | -| **value** | Value transferred, in wei. | *Quantity* | `eq`, `gt`, `lt` | -| **nonce** | Number of transactions made by the sender.| *Quantity* | `eq`, `gt`, `lt` | -| +| Field name | Value | Value type | Supported operators | +|------------|-------------------------------------------|:---------------------:|---------------------| +| `from` | Address of the sender. | *Data*, 20 bytes | `eq` | +| `to` | Address of the receiver, or `"contract_creation"`.| *Data*, 20 bytes |`eq`, `action`| +| `gas` | Gas provided by the sender. | *Quantity* | `eq`, `gt`, `lt` | +| `gasPrice` | Gas price, in wei, provided by the sender.| *Quantity* | `eq`, `gt`, `lt` | +| `value` | Value transferred, in wei. | *Quantity* | `eq`, `gt`, `lt` | +| `nonce` | Number of transactions made by the sender.| *Quantity* | `eq`, `gt`, `lt` | Supported operators: diff --git a/docs/public-networks/reference/api/objects.md b/docs/public-networks/reference/api/objects.md index 2b02998b..fa2ea91d 100644 --- a/docs/public-networks/reference/api/objects.md +++ b/docs/public-networks/reference/api/objects.md @@ -21,26 +21,26 @@ Returned by [`eth_getBlockByHash`](index.md#eth_getblockbyhash) and | Key | Type | Value | |-----|:----:|-------| -| **number** | *Quantity*, Integer | Block number. `null` when block is pending. | -| **hash** | *Data*, 32 bytes | Hash of the block. `null` when block is pending. | -| **parentHash** | *Data*, 32 bytes | Hash of the parent block. | -| **nonce** | *Data*, 8 bytes | Hash of the generated proof of work. `null` when block is pending. | -| **sha3Uncles** | *Data*, 32 bytes | SHA3 of the uncle's data in the block. | -| **logsBloom** | *Data*, 256 bytes | Bloom filter for the block logs. `null` when block is pending. | -| **transactionsRoot** | *Data*, 32 bytes | Root of the transaction trie for the block. | -| **stateRoot** | Data, 32 bytes | Root of the final state trie for the block. | -| **receiptsRoot** | Data, 32 bytes | Root of the receipts trie for the block. | -| **miner** | Data, 20 bytes | Address to pay mining rewards to. | -| **difficulty** | Quantity, Integer | Difficulty for this block. | -| **totalDifficulty** | Quantity, Integer | Total difficulty of the chain until this block. | -| **extraData** | Data | Extra data field for this block. The first 32 bytes is vanity data you can set using the [`--miner-extra-data`](../cli/options.md#miner-extra-data) command line option. Stores extra data when used with [Clique](../../../private-networks/how-to/configure/consensus/clique.md#genesis-file) and [IBFT](../../../private-networks/how-to/configure/consensus/ibft.md#genesis-file). | -| **size** | Quantity, Integer | Size of block in bytes. | -| **gasLimit** | Quantity | Maximum gas allowed in this block. | -| **gasUsed** | Quantity | Total gas used by all transactions in this block. | -| **timestamp** | Quantity | Unix timestamp for block assembly. | -| **transactions** | Array | Array of [transaction objects](#transaction-object), or 32 byte transaction hashes depending on the specified boolean parameter. | -| **uncles** | Array | Array of uncle hashes. | -| **baseFeePerGas** | Quantity | The block's [base fee per gas](../../concepts/transactions/types.md#eip1559-transactions). This field is empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/2d8a95e14e56de27c5465d93747b0006bd8ac47f/EIPS/eip-1559.md). | +| `number` | *Quantity*, Integer | Block number. `null` when block is pending. | +| `hash` | *Data*, 32 bytes | Hash of the block. `null` when block is pending. | +| `parentHash` | *Data*, 32 bytes | Hash of the parent block. | +| `nonce` | *Data*, 8 bytes | Hash of the generated proof of work. `null` when block is pending. | +| `sha3Uncles` | *Data*, 32 bytes | SHA3 of the uncle's data in the block. | +| `logsBloom` | *Data*, 256 bytes | Bloom filter for the block logs. `null` when block is pending. | +| `transactionsRoot` | *Data*, 32 bytes | Root of the transaction trie for the block. | +| `stateRoot` | Data, 32 bytes | Root of the final state trie for the block. | +| `receiptsRoot` | Data, 32 bytes | Root of the receipts trie for the block. | +| `miner` | Data, 20 bytes | Address to pay mining rewards to. | +| `difficulty` | Quantity, Integer | Difficulty for this block. | +| `totalDifficulty` | Quantity, Integer | Total difficulty of the chain until this block. | +| `extraData` | Data | Extra data field for this block. The first 32 bytes is vanity data you can set using the [`--miner-extra-data`](../cli/options.md#miner-extra-data) command line option. Stores extra data when used with [Clique](../../../private-networks/how-to/configure/consensus/clique.md#genesis-file) and [IBFT](../../../private-networks/how-to/configure/consensus/ibft.md#genesis-file). | +| `size` | Quantity, Integer | Size of block in bytes. | +| `gasLimit` | Quantity | Maximum gas allowed in this block. | +| `gasUsed` | Quantity | Total gas used by all transactions in this block. | +| `timestamp` | Quantity | Unix timestamp for block assembly. | +| `transactions` | Array | Array of [transaction objects](#transaction-object), or 32 byte transaction hashes depending on the specified boolean parameter. | +| `uncles` | Array | Array of uncle hashes. | +| `baseFeePerGas` | Quantity | The block's [base fee per gas](../../concepts/transactions/types.md#eip1559-transactions). This field is empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/2d8a95e14e56de27c5465d93747b0006bd8ac47f/EIPS/eip-1559.md). | ## Fee history results object @@ -49,9 +49,9 @@ If blocks in the specified block range are not available, then only the fee hist | Key | Type | Value | |-----|:----:|-------| -| **oldestBlock** | Quantity, Integer | Lowest number block of the returned range. | -| **baseFeePerGas** | Array | Array of block base fees per gas, including an extra block value. The extra value is the next block after the newest block in the returned range. Returns zeroes for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/2d8a95e14e56de27c5465d93747b0006bd8ac47f/EIPS/eip-1559.md). | -| **gasUsedRatio** | Array | Array of block gas used ratios. These are calculated as the ratio of `gasUsed` and `gasLimit`. | +| `oldestBlock` | Quantity, Integer | Lowest number block of the returned range. | +| `baseFeePerGas` | Array | Array of block base fees per gas, including an extra block value. The extra value is the next block after the newest block in the returned range. Returns zeroes for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/2d8a95e14e56de27c5465d93747b0006bd8ac47f/EIPS/eip-1559.md). | +| `gasUsedRatio` | Array | Array of block gas used ratios. These are calculated as the ratio of `gasUsed` and `gasLimit`. | ## Filter options object @@ -61,17 +61,17 @@ Used to [`filter logs`](../../how-to/use-besu-api/access-logs.md). | Key | Type | Required/Optional | Value | |-----|:----:|:-----------------:|-------| -| **fromBlock** | Quantity | Tag | Optional | Integer block number or `latest`, `pending`, `earliest`. See [Block Parameter](../../how-to/use-besu-api/json-rpc.md#block-parameter). Default is `latest`. | -| **toBlock** | Quantity | Tag | Optional | Integer block number or `latest`, `pending`, `earliest`. See [Block Parameter](../../how-to/use-besu-api/json-rpc.md#block-parameter). Default is `latest`. | -| **address** | Data | Array | Optional | Contract address or array of addresses from which [logs](../../concepts/events-and-logs.md) originate. | -| **topics** | Array of Data, 32 bytes each | Optional | Array of topics by which to [filter logs](../../concepts/events-and-logs.md#topic-filters). | +| `fromBlock` | Quantity | Tag | Optional | Integer block number or `latest`, `pending`, `earliest`. See [Block Parameter](../../how-to/use-besu-api/json-rpc.md#block-parameter). Default is `latest`. | +| `toBlock` | Quantity | Tag | Optional | Integer block number or `latest`, `pending`, `earliest`. See [Block Parameter](../../how-to/use-besu-api/json-rpc.md#block-parameter). Default is `latest`. | +| `address` | Data | Array | Optional | Contract address or array of addresses from which [logs](../../concepts/events-and-logs.md) originate. | +| `topics` | Array of Data, 32 bytes each | Optional | Array of topics by which to [filter logs](../../concepts/events-and-logs.md#topic-filters). | [`eth_getLogs`](index.md#eth_getlogs) and [`priv_getLogs`](index.md#priv_getlogs) have an extra key. | Key | Type | Required/Optional | Value | |-----|:----:|:-----------------:|-------| -| **blockHash** | Data, 32 bytes | Optional. | Hash of block for which to return logs. If you specify `blockHash`, you cannot specify `fromBlock` and `toBlock`. | +| `blockHash` | Data, 32 bytes | Optional. | Hash of block for which to return logs. If you specify `blockHash`, you cannot specify `fromBlock` and `toBlock`. | ## Log object @@ -80,15 +80,15 @@ Returned by [`eth_getFilterChanges`](index.md#eth_getfilterchanges) and [`priv_g | Key | Type | Value | |-----|:----:|-------| -| **removed** | Tag | `true` if log removed because of a chain reorganization. `false` if a valid log. | -| **logIndex** | Quantity, Integer | Log index position in the block. `null` when log is pending. | -| **transactionIndex** | Quantity, Integer | Index position of the starting transaction for the log. `null` when log is pending. | -| **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. | -| **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). | +| `removed` | Tag | `true` if log removed because of a chain reorganization. `false` if a valid log. | +| `logIndex` | Quantity, Integer | Log index position in the block. `null` when log is pending. | +| `transactionIndex` | Quantity, Integer | Index position of the starting transaction for the log. `null` when log is pending. | +| `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. | +| `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). | ## Miner data object @@ -97,15 +97,15 @@ Returned by [`eth_getMinerDataByBlockHash`](index.md#eth_getminerdatabyblockhash | Key | Type | Value | |-----|:----:|-------| -| **netBlockReward** | Quantity, Integer | The net block reward, in Wei, is `staticBlockReward + transactionFee + uncleInclusionReward`. | -| **staticBlockReward** | Quantity, Integer | The static block reward, in Wei, is preset on a hard fork. | -| **transactionFee** | Quantity, Integer | The transaction fee, in Wei, is `sum of upfront cost - refund amount for all transactions`. | -| **uncleInclusionReward** | Quantity, Integer | The uncle inclusion reward, in Wei, is `static block reward * number of ommers/32`. | -| **uncleRewards** | Map | Map of uncle block hashes and uncle miner coinbase addresses. | -| **coinbase** | Data, 20 bytes | Coinbase address. | -| **extraData** | Data | Extra data field for this block. The first 32 bytes is vanity data you can set using the [`--miner-extra-data`](../cli/options.md#miner-extra-data) command line option. | -| **difficulty** | Quantity, Integer | Difficulty of this block. | -| **totalDifficulty** | Quantity, Integer | Total difficulty of the chain until this block. | +| `netBlockReward` | Quantity, Integer | The net block reward, in Wei, is `staticBlockReward + transactionFee + uncleInclusionReward`. | +| `staticBlockReward` | Quantity, Integer | The static block reward, in Wei, is preset on a hard fork. | +| `transactionFee` | Quantity, Integer | The transaction fee, in Wei, is `sum of upfront cost - refund amount for all transactions`. | +| `uncleInclusionReward` | Quantity, Integer | The uncle inclusion reward, in Wei, is `static block reward * number of ommers/32`. | +| `uncleRewards` | Map | Map of uncle block hashes and uncle miner coinbase addresses. | +| `coinbase` | Data, 20 bytes | Coinbase address. | +| `extraData` | Data | Extra data field for this block. The first 32 bytes is vanity data you can set using the [`--miner-extra-data`](../cli/options.md#miner-extra-data) command line option. | +| `difficulty` | Quantity, Integer | Difficulty of this block. | +| `totalDifficulty` | Quantity, Integer | Total difficulty of the chain until this block. | ## Pending transaction object @@ -113,21 +113,21 @@ Returned by [`txpool_besuPendingTransactions`](index.md#txpool_besupendingtransa | Key | Type | Value | |-----|:----:|-------| -| **accessList** | Array | (Optional) List of addresses and storage keys the transaction plans to access. Used in [`ACCESS_LIST` transactions](../../concepts/transactions/types.md#access_list-transactions) and may be used in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | -| **from** | Data, 20 bytes | Address of the sender. | -| **gas** | Quantity | Gas provided by the sender. | -| **gasPrice** | Quantity | (Optional) Gas price, in Wei, provided by the sender. Not used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | -| **maxPriorityFeePerGas** | Quantity, Integer | (Optional) Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | -| **maxFeePerGas** | Quantity, Integer | (Optional) Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | -| **hash** | Data, 32 bytes | Hash of the transaction. | -| **input** | Data | Data sent with the transaction to create or invoke a contract. | -| **nonce** | Quantity | Number of transactions made by the sender before this one. | -| **to** | Data, 20 bytes | Address of the receiver. `null` if a contract creation transaction. | -| **transactionType** | String | [Transaction type](../../concepts/transactions/types.md). | -| **value** | Quantity | Value transferred, in Wei. | -| **v** | Quantity | ECDSA Recovery ID. | -| **r** | Data, 32 bytes | ECDSA signature r. | -| **s** | Data, 32 bytes | ECDSA signature s. | +| `accessList` | Array | (Optional) List of addresses and storage keys the transaction plans to access. Used in [`ACCESS_LIST` transactions](../../concepts/transactions/types.md#access_list-transactions) and may be used in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | +| `from` | Data, 20 bytes | Address of the sender. | +| `gas` | Quantity | Gas provided by the sender. | +| `gasPrice` | Quantity | (Optional) Gas price, in Wei, provided by the sender. Not used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | +| `maxPriorityFeePerGas` | Quantity, Integer | (Optional) Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | +| `maxFeePerGas` | Quantity, Integer | (Optional) Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | +| `hash` | Data, 32 bytes | Hash of the transaction. | +| `input` | Data | Data sent with the transaction to create or invoke a contract. | +| `nonce` | Quantity | Number of transactions made by the sender before this one. | +| `to` | Data, 20 bytes | Address of the receiver. `null` if a contract creation transaction. | +| `transactionType` | String | [Transaction type](../../concepts/transactions/types.md). | +| `value` | Quantity | Value transferred, in Wei. | +| `v` | Quantity | ECDSA Recovery ID. | +| `r` | Data, 32 bytes | ECDSA signature r. | +| `s` | Data, 32 bytes | ECDSA signature s. | ## Range object @@ -135,8 +135,8 @@ Returned by [`debug_storageRangeAt`](index.md#debug_storagerangeat). | Key | Type | Value | |-----|:----:|-------| -| **storage** | Object | Key hash and value. Pre-image key is `null` if it falls outside the cache. | -| **nextKey** | Hash | Hash of next key if further storage in range. Otherwise, not included. | +| `storage` | Object | Key hash and value. Pre-image key is `null` if it falls outside the cache. | +| `nextKey` | Hash | Hash of next key if further storage in range. Otherwise, not included. | ### Structured log object @@ -144,15 +144,15 @@ Log information returned as part of the [Trace object](#trace-object). | Key | Type | Value | |-----|:----:|-------| -| **pc** | Integer | Current program counter. | -| **op** | String | Current OpCode. | -| **gas** | Integer | Gas remaining. | -| **gasCost** | Integer | Cost in wei of each gas unit. | -| **depth** | Integer | Execution depth. | -| **exceptionalHaltReasons** | Array | One or more strings representing an error condition causing the EVM execution to terminate. These strings suggest that EVM execution terminated for reasons such as running out of gas or attempting to execute an unknown instruction. Generally a single exceptional halt reason returns but it's possible for more than one to occur at once. | -| **stack** | Array of 32 byte arrays | EVM execution stack before executing current operation. | -| **memory** | Array of 32 byte arrays | Memory space of the contract before executing current operation. | -| **storage** | Object | Storage entries changed by the current transaction. | +| `pc` | Integer | Current program counter. | +| `op` | String | Current OpCode. | +| `gas` | Integer | Gas remaining. | +| `gasCost` | Integer | Cost in wei of each gas unit. | +| `depth` | Integer | Execution depth. | +| `exceptionalHaltReasons` | Array | One or more strings representing an error condition causing the EVM execution to terminate. These strings suggest that EVM execution terminated for reasons such as running out of gas or attempting to execute an unknown instruction. Generally a single exceptional halt reason returns but it's possible for more than one to occur at once. | +| `stack` | Array of 32 byte arrays | EVM execution stack before executing current operation. | +| `memory` | Array of 32 byte arrays | Memory space of the contract before executing current operation. | +| `storage` | Object | Storage entries changed by the current transaction. | ## Trace object @@ -163,10 +163,10 @@ Returned by [`debug_traceBlock`](index.md#debug_traceblock), | Key | Type | Value | |-----|:----:|-------| -| **gas** | Integer | Gas used by the transaction. | -| **failed** | Boolean | True if transaction failed, otherwise, false. | -| **returnValue** | String | Bytes returned from transaction execution (without a `0x` prefix). | -| **structLogs** | Array | Array of structured log objects. | +| `gas` | Integer | Gas used by the transaction. | +| `failed` | Boolean | True if transaction failed, otherwise, false. | +| `returnValue` | String | Bytes returned from transaction execution (without a `0x` prefix). | +| `structLogs` | Array | Array of structured log objects. | ## Trace filter options object @@ -174,12 +174,12 @@ Parameter for [`trace_filter`](index.md#trace_filter). All parameters are option | Key | Type | Value | |-----|:----:|-------| -| **fromBLock** | String | Tag | Trace starts at this block. | -| **toBlock** | String | Tag | Trace stops at this block. | -| **fromAddress** | String | Include only traces sent from this address. | -| **toAddress** | String | Include only traces with this destination address. | -| **after** | Quantity | The offset trace number. | -| **count** | Integer | Number of traces to display in a batch. | +| `fromBLock` | String | Tag | Trace starts at this block. | +| `toBlock` | String | Tag | Trace stops at this block. | +| `fromAddress` | String | Include only traces sent from this address. | +| `toAddress` | String | Include only traces with this destination address. | +| `after` | Quantity | The offset trace number. | +| `count` | Integer | Number of traces to display in a batch. | ## Transaction object @@ -190,27 +190,27 @@ and | Key | Type | Value | |-----|:----:|-------| -| **accessList** | Array | (Optional) List of addresses and storage keys the transaction plans to access. Used in [`ACCESS_LIST` transactions](../../concepts/transactions/types.md#access_list-transactions) and may be used in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | -| **blockHash** | Data, 32 bytes | Hash of the block containing this transaction. `null` when transaction is pending. | -| **blockNumber** | Quantity | Block number of the block containing this transaction. `null` when transaction is pending. | -| **chainId** | Quantity | [Chain ID](../../concepts/network-and-chain-id.md). | -| **from** | Data, 20 bytes | Address of the sender. | -| **gas** | Quantity | Gas provided by the sender. | -| **gasPrice** | Quantity | (Optional) Gas price, in Wei, provided by the sender. Used only in non-[`EIP1559`](../../concepts/transactions/types.md#eip1559-transactions) transactions. | -| **maxPriorityFeePerGas** | Quantity, Integer | (Optional) Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | -| **maxFeePerGas** | Quantity, Integer | (Optional) Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | -| **hash** | Data, 32 bytes | Hash of the transaction. | -| **input** | Data | Data sent with the transaction to create or invoke a contract. For [private transactions](../../../private-networks/concepts/privacy/index.md), it's a pointer to the transaction location in [Tessera](https://docs.tessera.consensys.net/). | -| **nonce** | Quantity | Number of transactions made by the sender before this one. | -| **publicKey** | Data, 64 bytes | Public key of the sender. | -| **raw** | Data | This signed transaction in Recursive Length Prefix (RLP) encoded form. | -| **to** | Data, 20 bytes | Address of the receiver. `null` if a contract creation transaction. | -| **transactionIndex** | Quantity, Integer | Index position of the transaction in the block. `null` when transaction is pending. | -| **transactionType** | String | [Transaction type](../../concepts/transactions/types.md). | -| **value** | Quantity | Value transferred, in Wei. | -| **v** | Quantity | ECDSA Recovery ID. | -| **r** | Data, 32 bytes | ECDSA signature r. | -| **s** | Data, 32 bytes | ECDSA signature s. | +| `accessList` | Array | (Optional) List of addresses and storage keys the transaction plans to access. Used in [`ACCESS_LIST` transactions](../../concepts/transactions/types.md#access_list-transactions) and may be used in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | +| `blockHash` | Data, 32 bytes | Hash of the block containing this transaction. `null` when transaction is pending. | +| `blockNumber` | Quantity | Block number of the block containing this transaction. `null` when transaction is pending. | +| `chainId` | Quantity | [Chain ID](../../concepts/network-and-chain-id.md). | +| `from` | Data, 20 bytes | Address of the sender. | +| `gas` | Quantity | Gas provided by the sender. | +| `gasPrice` | Quantity | (Optional) Gas price, in Wei, provided by the sender. Used only in non-[`EIP1559`](../../concepts/transactions/types.md#eip1559-transactions) transactions. | +| `maxPriorityFeePerGas` | Quantity, Integer | (Optional) Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | +| `maxFeePerGas` | Quantity, Integer | (Optional) Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). | +| `hash` | Data, 32 bytes | Hash of the transaction. | +| `input` | Data | Data sent with the transaction to create or invoke a contract. For [private transactions](../../../private-networks/concepts/privacy/index.md), it's a pointer to the transaction location in [Tessera](https://docs.tessera.consensys.net/). | +| `nonce` | Quantity | Number of transactions made by the sender before this one. | +| `publicKey` | Data, 64 bytes | Public key of the sender. | +| `raw` | Data | This signed transaction in Recursive Length Prefix (RLP) encoded form. | +| `to` | Data, 20 bytes | Address of the receiver. `null` if a contract creation transaction. | +| `transactionIndex` | Quantity, Integer | Index position of the transaction in the block. `null` when transaction is pending. | +| `transactionType` | String | [Transaction type](../../concepts/transactions/types.md). | +| `value` | Quantity | Value transferred, in Wei. | +| `v` | Quantity | ECDSA Recovery ID. | +| `r` | Data, 32 bytes | ECDSA signature r. | +| `s` | Data, 32 bytes | ECDSA signature s. | ## Transaction call object @@ -221,15 +221,15 @@ All transaction call object parameters are optional. | Key | Type | Value | |-----|:----:|-------| -| **from** | Data, 20 bytes | Address of the sender. | -| **to** | Data, 20 bytes | Address of the action receiver. | -| **gas** | Quantity, Integer | Gas provided by the sender. `eth_call` consumes zero gas, but other executions might need this parameter. `eth_estimateGas` ignores this value. | -| **gasPrice** | Quantity, Integer | Gas price, in Wei, provided by the sender. The default is `0`. Used only in non-[`EIP1559`](../../concepts/transactions/types.md#eip1559-transactions) transactions. | -| **maxPriorityFeePerGas** | Quantity, Integer | Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Can be used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). If used, must specify `maxFeePerGas`. | -| **maxFeePerGas** | Quantity, Integer | Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Can be used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). If used, must specify `maxPriorityFeePerGas`. | -| **value** | Quantity, Integer | Value transferred, in Wei. | -| **data** | Data | Hash of the method signature and encoded parameters. For details, see [Ethereum Contract ABI](https://solidity.readthedocs.io/en/develop/abi-spec.html). | -| **strict** | Tag | If `true`, checks that the `from` account’s ether balance is sufficient to cover the transaction and gas fee. If `false`, the `gasPrice` and `baseFee` are set to zero, in order to simulate a transaction without enforcing a balance check. The default is `false`. | +| `from` | Data, 20 bytes | Address of the sender. | +| `to` | Data, 20 bytes | Address of the action receiver. | +| `gas` | Quantity, Integer | Gas provided by the sender. `eth_call` consumes zero gas, but other executions might need this parameter. `eth_estimateGas` ignores this value. | +| `gasPrice` | Quantity, Integer | Gas price, in Wei, provided by the sender. The default is `0`. Used only in non-[`EIP1559`](../../concepts/transactions/types.md#eip1559-transactions) transactions. | +| `maxPriorityFeePerGas` | Quantity, Integer | Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Can be used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). If used, must specify `maxFeePerGas`. | +| `maxFeePerGas` | Quantity, Integer | Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Can be used only in [`EIP1559` transactions](../../concepts/transactions/types.md#eip1559-transactions). If used, must specify `maxPriorityFeePerGas`. | +| `value` | Quantity, Integer | Value transferred, in Wei. | +| `data` | Data | Hash of the method signature and encoded parameters. For details, see [Ethereum Contract ABI](https://solidity.readthedocs.io/en/develop/abi-spec.html). | +| `strict` | Tag | If `true`, checks that the `from` account’s ether balance is sufficient to cover the transaction and gas fee. If `false`, the `gasPrice` and `baseFee` are set to zero, in order to simulate a transaction without enforcing a balance check. The default is `false`. | ## Transaction receipt object @@ -237,21 +237,21 @@ Returned by [`eth_getTransactionReceipt`](index.md#eth_gettransactionreceipt). | Key | Type | Value | |-----|:----:|-------| -| **blockHash** | Data, 32 bytes | Hash of block containing this transaction. | -| **blockNumber** | Quantity | Block number of block containing 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. | -| **from** | Data, 20 bytes | Address of the sender. | -| **gasUsed** | Quantity | Amount of gas used by this specific transaction. | -| **logs** | Array | Array of [log objects](#log-object) generated by this transaction. | -| **logsBloom** | Data, 256 bytes | Bloom filter for light clients to quickly retrieve related logs. | -| **status** | Quantity | Either `0x0` (failure), `0x1` (success), or `0x2` (invalid). | -| **to** | Data, 20 bytes | Address of the receiver, if sending ether, otherwise, null. | -| **transactionHash** | Data, 32 bytes | Hash of the transaction. | -| **transactionIndex** | Quantity, Integer | Index position of transaction in the block. | -| **transactionType** | String | [Transaction type](../../concepts/transactions/types.md). | -| **revertReason** | String | ABI-encoded string that displays the [reason for reverting the transaction](../../../private-networks/how-to/send-transactions/revert-reason.md). Only available if revert reason is [enabled](../cli/options.md#revert-reason-enabled). | +| `blockHash` | Data, 32 bytes | Hash of block containing this transaction. | +| `blockNumber` | Quantity | Block number of block containing 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. | +| `from` | Data, 20 bytes | Address of the sender. | +| `gasUsed` | Quantity | Amount of gas used by this specific transaction. | +| `logs` | Array | Array of [log objects](#log-object) generated by this transaction. | +| `logsBloom` | Data, 256 bytes | Bloom filter for light clients to quickly retrieve related logs. | +| `status` | Quantity | Either `0x0` (failure), `0x1` (success), or `0x2` (invalid). | +| `to` | Data, 20 bytes | Address of the receiver, if sending ether, otherwise, null. | +| `transactionHash` | Data, 32 bytes | Hash of the transaction. | +| `transactionIndex` | Quantity, Integer | Index position of transaction in the block. | +| `transactionType` | String | [Transaction type](../../concepts/transactions/types.md). | +| `revertReason` | String | ABI-encoded string that displays the [reason for reverting the transaction](../../../private-networks/how-to/send-transactions/revert-reason.md). Only available if revert reason is [enabled](../cli/options.md#revert-reason-enabled). | !!!note @@ -260,7 +260,7 @@ Returned by [`eth_getTransactionReceipt`](index.md#eth_gettransactionreceipt). | Key | Type | Value | |-----|:----:|-------| -| **root** | Data, 32 bytes | Post-transaction state root | +| `root` | Data, 32 bytes | Post-transaction state root | ## Transaction trace object @@ -268,8 +268,8 @@ Returned by [`trace_replayBlockTransactions`](index.md#trace_replayblocktransact | Key | Type | Value | |-----|:----:|-------| -| **output** | Boolean | Transaction result. 1 for success and 0 for failure. | -| **stateDiff** | Object | [State changes in the requested block](../trace-types.md#statediff). | -| **trace** | Array | [Ordered list of calls to other contracts](../trace-types.md#trace). | -| **vmTrace** | Object | [Ordered list of EVM actions](../trace-types.md#vmtrace). | -| **transactionHash** | Data, 32 bytes | Hash of the replayed transaction. | +| `output` | Boolean | Transaction result. 1 for success and 0 for failure. | +| `stateDiff` | Object | [State changes in the requested block](../trace-types.md#statediff). | +| `trace` | Array | [Ordered list of calls to other contracts](../trace-types.md#trace). | +| `vmTrace` | Object | [Ordered list of EVM actions](../trace-types.md#vmtrace). | +| `transactionHash` | Data, 32 bytes | Hash of the replayed transaction. | diff --git a/docs/public-networks/reference/evm-tool.md b/docs/public-networks/reference/evm-tool.md index e626d5c3..ebb0ebe4 100644 --- a/docs/public-networks/reference/evm-tool.md +++ b/docs/public-networks/reference/evm-tool.md @@ -321,7 +321,7 @@ Most of the options from EVM execution do not apply. ``` Provide an operation by operation trace of the command in JSON when set to true. -Set to `true` for EVMLab Fuzzing. +Set to `true` for EVM Lab Fuzzing. Whether or not `json` is set, a summary JSON object is printed to standard output for each state test executed. diff --git a/docs/public-networks/reference/trace-types.md b/docs/public-networks/reference/trace-types.md index 52a20cb3..4e0203b5 100644 --- a/docs/public-networks/reference/trace-types.md +++ b/docs/public-networks/reference/trace-types.md @@ -9,7 +9,7 @@ tags: When [tracing transactions](../how-to/troubleshoot/trace-transactions.md), the trace type options are [`trace`](#trace), [`vmTrace`](#vmtrace), and [`stateDiff`](#statediff). -## trace +## `trace` An ordered list of calls to other contracts, excluding precompiled contracts. @@ -54,7 +54,7 @@ An ordered list of calls to other contracts, excluding precompiled contracts. | `traceAddress` | Tree list address of where the call occurred, address of the parents, and order of the current sub call. | `type` | Whether the transaction is a `CALL` or `CREATE` series operation. -## vmTrace +## `vmTrace` An ordered list of EVM actions when processing the transaction. @@ -108,7 +108,7 @@ not executed. | `pc` | Program counter. | `sub` | Sub call operations. -## stateDiff +## `stateDiff` State changes in the requested block for each transaction represented as a map of accounts to an object. Besu lists the balance, code, nonce, and storage changes from immediately before the @@ -116,7 +116,7 @@ transaction to after the transaction. For the `key:value` pairs: * `+` indicates the field didn’t exist before and now has the specified value * `-` indicates a deleted value -* `*` has a from and a to value. +* `*` has a `from` and a `to` value. An absent value is distinct from zero when creating accounts or clearing storage. diff --git a/docs/public-networks/tutorials/merge-testnet.md b/docs/public-networks/tutorials/merge-testnet.md index f576e84d..884a23fb 100644 --- a/docs/public-networks/tutorials/merge-testnet.md +++ b/docs/public-networks/tutorials/merge-testnet.md @@ -209,3 +209,7 @@ After starting Besu and Teku, your node starts syncing and connecting to peers. You can check your validator status by searching your Ethereum address on the [Goerli Beacon Chain explorer](https://goerli.beaconcha.in/). It may take up to multiple days for your validator to be activated and start proposing blocks. + +!!! caution + + If you restart your node before snap or checkpoint sync completes, syncing restarts from scratch.