Update block parameter and eth_estimateGas default (#1832)

* Document truststore options

Signed-off-by: Alexandra Tran <[email protected]>

* add more context to descriptions

Signed-off-by: Alexandra Tran <[email protected]>

* Update block parameter and eth_estimateGas default

Signed-off-by: Alexandra Tran <[email protected]>

---------

Signed-off-by: Alexandra Tran <[email protected]>
Co-authored-by: Alexandra Tran <[email protected]>

Author: alexandratran

docs/public-networks/how-to/use-besu-api/json-rpc.md

@@ -333,11 +333,14 @@ The block parameter can have one of the following values:
   :::
 
 - `earliest` : _tag_ - The earliest (genesis) block.
-- `latest` : _tag_ - The last block mined.
-- `pending` : _tag_ - When used with [`eth_getTransactionCount`](../../reference/api/index.md#eth_gettransactioncount),
-  refers to the last block mined plus pending transactions.
-  When used with [`qbft_getValidatorsByBlockNumber`](../../../private-networks/reference/api/index.md#qbft_getvalidatorsbyblocknumber),
-  returns a list of validators that will be used to produce the next block.
+- `latest` : _tag_ - The most recent block.
+- `pending` : _tag_ - The next anticipated block, except in the following cases:
+  - For some methods (specified in their parameter description), `pending` returns the
+    same value as `latest`.
+  - For [`eth_getTransactionCount`](../../reference/api/index.md#eth_gettransactioncount),
+    `pending` refers to the most recent block plus pending transactions.
+  - For [`qbft_getValidatorsByBlockNumber`](../../../private-networks/reference/api/index.md#qbft_getvalidatorsbyblocknumber),
+    `pending` returns a list of validators that will be used to produce the next block.
 - `finalized` : _tag_ - The most recent crypto-economically secure block.
   It cannot be reorganized outside manual intervention driven by community coordination.
 - `safe` : _tag_ - The most recent block that is safe from reorganization under honest majority and

docs/public-networks/reference/api/index.md

@@ -2639,6 +2639,7 @@ By default, the `eth_estimateGas` error response includes the [revert reason](..
 - `blockNumber`: _string_ - (optional) hexadecimal or decimal integer representing a block number, or one of
   the string tags `latest`, `earliest`, `pending`, `finalized`, or `safe`, as described in
   [block parameter](../../how-to/use-besu-api/json-rpc.md#block-parameter).
+  The default is `pending`.
 
 - `stateOverride`: _object_ - The [address-to-state mapping](./objects.md#state-override-object).
     Each entry specifies a state that will be temporarily overridden before executing the call.