diff --git a/docs/private-networks/get-started/start-node.md b/docs/private-networks/get-started/start-node.md index e589d7bc982..c7193e0b4d0 100644 --- a/docs/private-networks/get-started/start-node.md +++ b/docs/private-networks/get-started/start-node.md @@ -114,4 +114,10 @@ besu --genesis-file=/genesis.json --data-path= --rpc-http-enabl ``` Where `` is the path to the directory to save the chain data to. -Ensure you configure a peer discovery method, such as [bootnodes](../how-to/configure/bootnodes.md) +Ensure you configure a peer discovery method, such as [bootnodes](../how-to/configure/bootnodes.md). + +!!! note + You might need to set + [`--tx-pool-limit-by-account-percentage`](../../public-networks/reference/cli/options.md#tx-pool-limit-by-account-percentage) + to 1. + The default value is suitable for Mainnet, but may cause issues on private networks. diff --git a/docs/public-networks/reference/cli/options.md b/docs/public-networks/reference/cli/options.md index 55004341108..e57d9f75d3b 100644 --- a/docs/public-networks/reference/cli/options.md +++ b/docs/public-networks/reference/cli/options.md @@ -3331,34 +3331,42 @@ Use the [`miner_changeTargetGasLimit`](../api/index.md#miner_changetargetgaslimi the `target-gas-limit` while Besu is running. Alternatively restart Besu with an updated `target-gas-limit` value. -### `tx-pool-future-max-by-account` +### `tx-pool-limit-by-account-percentage` === "Syntax" ```bash - --tx-pool-future-max-by-account= + --tx-pool-limit-by-account-percentage= ``` === "Example" ```bash - --tx-pool-future-max-by-account=100 + --tx-pool-limit-by-account-percentage=0.1 ``` === "Environment variable" ```bash - BESU_TX_POOL_FUTURE_MAX_BY_ACCOUNT=100 + BESU_TX_POOL_LIMIT_BY_ACCOUNT_PERCENTAGE=0.1 ``` === "Configuration file" ```bash - tx-pool-future-max-by-account="100" + tx-pool-limit-by-account-percentage=0.4 ``` -The maximum number of future transactions kept in the transaction pool, per account. -The default is 64. +The maximum percentage of future transactions kept in the transaction pool, per account. +Accepted values are in the range (0–1]. +The default is .001 or 0.1% of transactions from a single account to be kept in the pool. + +!!! warning + The default value is often unsuitable for [private networks](../../../private-networks/index.md). + This feature mitigates future-nonce transactions from filling the pool without ever being + executable by Besu. + This is important for Mainnet, but may cause issues on private networks. + Please update this value or set to 1 if you know the nodes gossiping transactions in your network. ### `tx-pool-max-size`