Skip to content

Commit b03dc74

Browse files
authored
Merge pull request 0xPolygon#304 from 0xPolygon/empieichO-docs-review
Update zkEVM - Install dependencies doc
2 parents 738f936 + f9ec842 commit b03dc74

File tree

2 files changed

+11
-9
lines changed

2 files changed

+11
-9
lines changed

docs/zkEVM/architecture/user-fees.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ The aim with this document is to describe the Effective Gas Price (EGP), a mecha
55

66
Let's make a quick recollection of the basic fee schema used in Ethereum.
77

8-
Firstly, gas is a unit that accounts for resources used when processing a transaction. At the time of sending a transaction, the user can decide two parameters; $\texttt{gasLimit}$ and $\texttt{gasPrice}$:
8+
Firstly, gas is a unit that accounts for resources used when processing a transaction. At the time of sending a transaction, the user can decide on two parameters; $\texttt{gasLimit}$ and $\texttt{gasPrice}$:
99

1010
- $\texttt{gasLimit}$ is the maximum amount of gas units that a user is willing to buy in order to complete a transaction.
1111

@@ -860,9 +860,9 @@ Let’s examine the above figure in more detail.
860860

861861
Henceforth, the Executor executes the transaction using $\texttt{EEGP}$, obtaining $\texttt{GasUsedNew}$, which the sequencer utilizes to compute a new effective gas price, referred to as $\texttt{NEGP}$.
862862

863-
4. We have to paths:
863+
4. We have two paths:
864864

865-
- If the percentage deviation between $\texttt{EEGP}$ and $\texttt{NEGP}$ is higher than a fixed deviation parameter $\texttt{FinalDeviationPct}$, which is $10$ in the actual configuration, that is
865+
- If the percentage deviation between $\texttt{EEGP}$ and $\texttt{NEGP}$ is higher than a fixed deviation parameter $\texttt{FinalDeviationParameter}$, which is $10$ in the actual configuration, that is
866866

867867
$$
868868
\frac{|\texttt{NEGP} − \texttt{EEGP}|}{\texttt{EEGP}} \cdot 100 < \texttt{FinalDeviationParameter}
@@ -880,21 +880,21 @@ Let’s examine the above figure in more detail.
880880
\frac{|\texttt{NEGP} − \texttt{EEGP}|}{\texttt{EEGP}} \cdot 100 ≥ \texttt{FinalDeviationParameter}
881881
$$
882882

883-
there is a big difference between executions and we may better adjust gas price due to potential (and quite big) losses to the network or the user.
883+
there is a big difference between executions and we may want to adjust gas price due to potential losses to the network or the user.
884884

885885
5. In the latter case, two options arise:
886886

887-
- If the gas price signed is less or equal than the accurate effective gas price computed with the correct state root
887+
- If the gas price signed is less than or equal to the accurately computed effective gas price, with the correct state root, and
888888

889889
$$
890890
\texttt{SignedGasPrice} \leq \texttt{NEGP}
891891
$$
892892

893-
the network suffers again a risk of loss.
893+
the network runs the risk of incurring a loss.
894894

895-
Henceforth, the user is charged the full $\texttt{SignedGasPrice}$, so the Executor will execute the transaction using it, concluding the sequencing process.
895+
Hence the user is charged the full $\texttt{SignedGasPrice}$, and the executor therefore executes the transaction using the $\texttt{SignedGasPrice}$. And the sequencing process is concluded.
896896

897-
- Otherwise, if $\texttt{SignedGasPrice} > \texttt{NEGP}$, then it means we have margin to adjust the gas price that is charged to the user.
897+
- Otherwise, if $\texttt{SignedGasPrice} > \texttt{NEGP}$, then there's sufficient margin to adjust the gas price and thus charge the user less than their $\texttt{SignedGasPrice}$.
898898

899899
However, in order to save executions, we end the adjustment process in this iteration, so that we conclude the flow using a trick explained in the next point.
900900

@@ -911,7 +911,7 @@ Let’s examine the above figure in more detail.
911911

912912
This precaution is employed to mitigate potential vulnerabilities in deployed Smart Contracts, that arise from creating a specific condition based on the gas price, for example, to manipulate execution costs.
913913

914-
- If the transaction does not make use of the gas price-related opcodes, the Executor executes the transaction with the more adjusted gas price up to this point which is $\texttt{NEGP}$ and end up the sequencing process.
914+
- If the transaction does not make use of the gas-price-related opcodes, the executor executes the transaction with the more adjusted gas price, which is $\texttt{NEGP}$, and ends the sequencing process.
915915

916916

917917
### Numerical Example: Sequencer Flow

docs/zkEVM/get-started/deploy-zkevm/install-dependencies.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ urls=(
6161
"https://storage.googleapis.com/zkevm/zkproverc/v2.0.0-RC4-fork.5.tgz"
6262
"https://storage.googleapis.com/zkevm/zkproverc/v3.0.0-RC2-fork.6.tgz"
6363
"https://storage.googleapis.com/zkevm/zkproverc/v3.0.0-RC3-fork.6.tgz"
64+
"https://storage.googleapis.com/zkevm/zkproverc/v4.0.0-rc.6-fork.7.tgz"
65+
"https://storage.googleapis.com/zkevm/zkproverc/v5.0.0-rc.4-fork.8.tgz"
6466
)
6567

6668
for url in "${urls[@]}"; do

0 commit comments

Comments
 (0)