Add ability to update target gas price. (#604)

* Rename whitelist to allowlist.

Signed-off-by: Byron Gravenorst <[email protected]>

* Additional updates.

Signed-off-by: Byron Gravenorst <[email protected]>

* Whitelist renaming.

Signed-off-by: Byron Gravenorst <[email protected]>

* Address reviewer feedback.

Signed-off-by: Byron Gravenorst <[email protected]>

* Fix typos.

Signed-off-by: Byron Gravenorst <[email protected]>

* Add ability to update target gas price.

Signed-off-by: Byron Gravenorst <[email protected]>

Author: bgravenorst

docs/Reference/API-Methods.md

@@ -4578,6 +4578,43 @@ Returns full trace of all invoked opcodes of all transactions included in the bl
     methods, use the [`--rpc-http-api`](CLI/CLI-Syntax.md#rpc-http-api) or
     [`--rpc-ws-api`](CLI/CLI-Syntax.md#rpc-ws-api) options.
 
+### miner_changeTargetGasLimit
+
+Updates the target gas limit set using the [`--target-gas-limit`](CLI/CLI-Syntax.md#target-gas-limit)
+command line option.
+
+#### Parameters
+
+`integer` : `quantity` - The target gas price in Wei.
+
+#### Returns
+
+`result` - `Success` or `error`.
+
+!!! example
+
+    === "curl HTTP request"
+
+        ```bash
+        curl -X POST --data '{"jsonrpc":"2.0","method":"miner_changeTargetGasLimit","params":[800000], "id":1}' http://127.0.0.1:8545
+        ```
+
+    === "wscat WS request"
+
+        ```bash
+        {"jsonrpc":"2.0","method":"miner_changeTargetGasLimit","params":[800000], "id":1}
+        ```
+
+    === "JSON result"
+
+        ```json
+        {
+           "jsonrpc" : "2.0",
+           "id" : 1,
+           "result" : "Success"
+        }
+        ```
+
 ### `miner_start`
 
 Starts the mining process. To start mining, you must first specify a miner coinbase using the

docs/Reference/CLI/CLI-Syntax.md

@@ -3189,6 +3189,10 @@ within that constraint.
 If a value for `target-gas-limit` is not specified, the block gas limit remains at the value
 specified in the [genesis file](../Config-Items.md#genesis-block-parameters).
 
+Use the [`miner_changeTargetGasLimit`](../API-Methods.md#miner_changetargetgaslimit) API to update
+the `target-gas-limit` while Besu is running. Alternatively restart Besu with an updated
+`target-gas-limit` value.
+
 ### `tx-pool-max-size`
 
 === "Syntax"