Merge pull request 0xPolygon#476 from 0xPolygon/edit-user-fees

Update zkEVM - effective gas price docs

Author: EmpieichO

docs/zkEVM/architecture/effective-gas/implement-egp-strat.md

@@ -27,6 +27,17 @@ Since the L1 gas price is likely to change between when a user signs a transacti
 
 All transactions such that $\texttt{SignedGasPrice} > \texttt{L2MinGasPrice}$ are accepted for pre-execution.
 
+The following parameters can be configured in the Polygon zkEVM node:
+
+- $\texttt{DefaultMinGasPriceAllowed}$ which is the default minimum gas price to suggest.
+- $\texttt{MinAllowedGasPriceInterval}$, as explained above, is the interval within which to find the lowest suggested gas price and compare it with the user's gas price in the transaction.
+- $\texttt{PollMinAllowedGasPriceInterval}$ is the interval to poll L1 in order to find the suggested L2 minimum gas price.
+- $\texttt{IntervalToRefreshGasPrices}$ is the interval to refresh L2 gas prices.
+
+More specifically, these are configured in the $\texttt{[Pool]}$ section of the [configuration file](https://github.com/0xPolygonHermez/zkevm-node/blob/b938572f138ba6cc40ef6736153c469afeb11c96/config/default.go#L37).
+
+![Figure: ](../../../img/zkEVM/config-prev-parameter.png)
+
 ## How to avoid incurring losses in L2
 
 There are three measures put in place to help avoid incurring gas price-induced losses in the L2 network:

docs/zkEVM/architecture/effective-gas/tx-prioritization-egp.md

@@ -124,4 +124,4 @@ Ultimately, the scheme is accurate and fair to both the users and the zkEVM netw
 
 Check out this [repo](https://github.com/0xPolygonHermez/zkevm-rom/issues/316) for a detailed example of how the effective gas price is calculated.
 
-A more elaborate and expanded documentation of the EGP scheme can be found in the specifications section [here](../../spec/user-fees/index.md).
+The content of this document series was sourced from the [User fees document](https://github.com/0xPolygonHermez/zkevm-techdocs/blob/main/knowledge-layer/architecture/PDFs/users-fees.pdf).

docs/zkEVM/architecture/effective-gas/user-tx-flow/index.md

@@ -2,8 +2,6 @@ Next, we provide a concise description of Polygon zkEVM's approach to calculatin
 
 It's an overview of the end-to-end flow of transactions, commencing from users signing transactions and submitting them at the RPC level, to when the sequencer executes them.
 
-It's a quicker way to go through all involved formulas or criteria, but without explanatory examples.
-
-You will find more elaborate discussions, with ample examples, in the [Specifications section](../../../spec/user-fees/index.md).
+It's a quicker way to go through all involved formulas or criteria, as well as examining explanatory examples.
 
 The end-to-end flow of transactions occurs in two phases: the RPC flow, and the sequencer flow.

docs/zkEVM/architecture/effective-gas/zkevm-egp-strat.md

@@ -12,7 +12,6 @@ This document presents an outline of Polygon zkEVM's strategy for executing tran
 
     The polled gas prices are used to set the expected 'signed gas price', called $\texttt{MinL2GasPrice}$.
 
-
 - **Provide suggested gas prices**
 
     The polled L1 gas price values are sent to users upon request individually.