Skip to content

Commit 3c1710f

Browse files
EmpieichOhsutaiyu
andauthored
Apply suggestions from code review
Co-authored-by: hsutaiyu <51791408+hsutaiyu@users.noreply.github.com>
1 parent 18061fb commit 3c1710f

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

docs/zkEVM/architecture/proving-system/json-rpc-to-proof.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The Ethereum JSON-RPC is a standardized collection of methods used by all Ethere
1717

1818
The zkEVM JSON-RPC is an interface compatible with the Ethereum JSON-RPC for any layer 2 system.
1919

20-
It replicates the same endpoints as the Ethereum JSON-RPC, and similarly receives queries and provides answers to users.
20+
It implements the same endpoints as the Ethereum JSON-RPC, and similarly receives queries and provides answers to users.
2121

2222
The figure below illustrates a user's Ethereum JSON-RPC query to obtain information on the latest forged block.
2323

@@ -43,7 +43,7 @@ zkEVM batches transition through various states: trusted, virtual, and consolida
4343

4444

4545

46-
We explore next the expected form of data in the zkEVM JSON-RPC's responses to queries for the latest L2 block.
46+
Next, we explore the expected format of data in the zkEVM JSON-RPC's responses to queries for the latest L2 block.
4747

4848

4949

@@ -108,7 +108,7 @@ The Etrog upgrade (which is ForkID 6) addresses these two issues.
108108

109109
That is, each L2 block consists of one or more transactions, and each block has its own unique timestamp.
110110

111-
With this implementation approach, the sequencer needs to make ensure that block construction has a shorter timeout than the batch generation.
111+
With this implementation approach, the sequencer needs to ensure that block construction has a shorter timeout than the batch generation.
112112

113113
The sequencer can modify the timestamp of the various blocks in a batch by utilizing a specific transaction as a marker, dubbed `changeL2Block`.
114114

@@ -130,7 +130,7 @@ The L2 block contains the most recent transactions approved by the trusted seque
130130

131131
The information is retrieved with the same RPC call as in Ethereum.
132132

133-
Users are not really concerned with the transaction being in a block, but rather when the batch transitions to a new state.
133+
Users are less concerned with the transaction being in a block, and more with when the newly generated batch results in a state transition.
134134

135135
The zkEVM protocol has additional endpoints for retrieving various information pertaining to the status of the L2 block.
136136

@@ -142,9 +142,9 @@ Here is a list of custom zkEVM endpoints, each accompanied by a brief descriptio
142142

143143
- $\mathtt{zkevm\_consolidatedBlockNumber}$: Returns the latest block number within the last verified batch.
144144

145-
- $\mathtt{zkevm\_isBlockVirtualized}$: Returns true if the provided block number is in a virtualized batch.
145+
- $\mathtt{zkevm\_isBlockVirtualized}$: Returns `true` if the provided block number is in a virtualized batch.
146146

147-
- $\mathtt{zkevm\_isBlockConsolidated}$: Returns true if the provided block number is in a consolidated batch.
147+
- $\mathtt{zkevm\_isBlockConsolidated}$: Returns `true` if the provided block number is in a consolidated batch.
148148

149149
- $\mathtt{zkevm\_batchNumber}$: Returns the latest batch number.
150150

@@ -154,7 +154,7 @@ Here is a list of custom zkEVM endpoints, each accompanied by a brief descriptio
154154

155155
- $\mathtt{zkevm\_batchNumberByBlockNumber}$: Returns the batch number of the batch containing the given block.
156156

157-
- $\mathtt{zkevm\_getBatchByNumber}$: Gets the info of a batch given its number.
157+
- $\mathtt{zkevm\_getBatchByNumber}$: Fetches the available info for a batch based on the specified batch number.
158158

159159
## Sending raw transactions
160160

@@ -210,7 +210,7 @@ In the `validateTx()` function performs the following preliminary checks:
210210

211211
14. The computed _intrinsic gas_ is greater than the provided gas. The _intrinsic gas_ of a transaction measures the required gas in terms of the amount of transactional data plus the starting gas for the raw transaction which is currently of $21000$, or $53000$ in the case of a contract creation transaction.
212212

213-
15. The current transaction gasprice is higher than the other transactions in the PoolDB with the same nonce and from. This is because a transaction cannot be replaced with another with less gasprice.
213+
15. The current transaction `GasPrice` is higher than the other transactions in the PoolDB with the same nonce and `from` address. This is because a transaction cannot be replaced with another with lower `GasPrice`.
214214

215215
16. The sizes of the transaction’s fields are compatible with the Executor needs. More specifically:
216216

0 commit comments

Comments
 (0)