Skip to content

GitLab

新注册的用户请输入邮箱并保存，随后登录邮箱激活账号。后续可直接使用邮箱登录！

10 public · Changes

Page history
feat: modify docs --story=1 authored by gz Xu's avatar gz Xu
Hide whitespace changes
Inline Side-by-side
Showing with 46 additions and 44 deletions
zkevm-docs/10-public.markdown
View page @ 66f9a8e9
# 总体布局 # Public
## 总体布局
本段介绍结构体`PublicCircuitConfig`的列及其含义。 本段介绍结构体`PublicCircuitConfig`的列及其含义。
## 单功能列 Single-purpose columns ## 单功能列 Single-purpose columns
下面是public子电路中的单功能的列: 下面是public子电路中的单功能的列:
...@@ -54,21 +56,21 @@ values: [Column<Instance>; NUM_VALUES], ...@@ -54,21 +56,21 @@ values: [Column<Instance>; NUM_VALUES],
### 区块公共数据存放 ### 区块公共数据存放
#### tag为ChainId时,该行数据值为: #### tag为ChainId时,该行数据值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :-----: | :----------: | :------------: | :------------: | :-------: | :-------: |
| ChainId | 0 | chain_id[..16] | chain_id[16..] | 0 | 0 | | ChainId | 0 | chain_id[..16] | chain_id[16..] | 0 | 0 |
#### tag为BlockNumber时,该行数据值为: #### tag为BlockNumber时,该行数据值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :---------: | :----------: | :------: | :----------------: | :-------: | :----------------: |
| BlockNumber | 0 | 0 | Block_Number_first | 0 | Block_Num_in_chunk | | BlockNumber | 0 | 0 | Block_Number_first | 0 | Block_Num_in_chunk |
当前block的 BlockNumber_cur = Block_Number_first + block_idx_cur 当前block的 BlockNumber_cur = Block_Number_first + block_idx_cur
#### tag为BlockHash的时候,遍历最近的history_hash,每行存放数据值如下: #### tag为BlockHash的时候,遍历最近的history_hash,每行存放数据值如下:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :-------: | :-----------: | :--------: | :--------: | :-------: | :-------: |
| BlockHash | max_block_idx | hash[..16] | hash[16..] | 0 | 0 | | BlockHash | max_block_idx | hash[..16] | hash[16..] | 0 | 0 |
block\_tx\_idx  存  max\_block\_idx  （表示该hash最多能被 chunk 内第几个block读取到），value\[2\] 存 block\_number（表示当前hahs对应的block\_number） block\_tx\_idx  存  max\_block\_idx  （表示该hash最多能被 chunk 内第几个block读取到），value\[2\] 存 block\_number（表示当前hahs对应的block\_number）
...@@ -81,72 +83,72 @@ block\_tx\_idx  存  max\_block\_idx  （表示该hash最多能被 chunk  ...@@ -81,72 +83,72 @@ block\_tx\_idx  存  max\_block\_idx  （表示该hash最多能被 chunk 
3. 另外，max\_block\_idx - block\_idx\_cur - 1 需要约束 U8 lookup。 3. 另外，max\_block\_idx - block\_idx\_cur - 1 需要约束 U8 lookup。
#### tag为BlockCoinbaseAndTimestamp时,该行数据值为: #### tag为BlockCoinbaseAndTimestamp时,该行数据值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :-----------------------: | :----------: | :-----------: | :-----------: | :------------------: | :------------------: |
| BlockCoinbaseAndTimestamp | block index | coinbase[..4] | coinbase[4..] | BlockTimestamp[..16] | BlockTimestamp[16..] | | BlockCoinbaseAndTimestamp | block index | coinbase[..4] | coinbase[4..] | BlockTimestamp[..16] | BlockTimestamp[16..] |
#### tag为BlockGasLimitAndBaseFee时,该行数据值为: #### tag为BlockGasLimitAndBaseFee时,该行数据值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :---------------------: | :----------: | :-----------------: | :-----------------: | :----------------: | :----------------: |
| BlockGasLimitAndBaseFee | block index | BlockGasLimit[..16] | BlockGasLimit[16..] | BlockBaseFee[..16] | BlockBaseFee[16..] | | BlockGasLimitAndBaseFee | block index | BlockGasLimit[..16] | BlockGasLimit[16..] | BlockBaseFee[..16] | BlockBaseFee[16..] |
#### tag为BlockTxLogNumAndDifficulty时,该行数据值为: #### tag为BlockTxLogNumAndDifficulty时,该行数据值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :------------------------: | :----------: | :------: | :-------: | :-------------------: | :-------------------: |
| BlockTxLogNumAndDifficulty | block index | tx_num | log_num | BlockDifficulty[..16] | BlockDifficulty[16..] | | BlockTxLogNumAndDifficulty | block index | tx_num | log_num | BlockDifficulty[..16] | BlockDifficulty[16..] |
#### tag为TxFromValue时,该行数据值为: #### tag为TxFromValue时,该行数据值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :---------: | :----------: | :-------: | :-------: | :---------: | :---------: |
| TxFromValue | block_tx_idx | from[..4] | from[4..] | value[..16] | value[16..] | | TxFromValue | block_tx_idx | from[..4] | from[4..] | value[..16] | value[16..] |
#### tag为TxToCallDataSize时,该行数据值为: #### tag为TxToCallDataSize时,该行数据值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :--------------: | :----------: | :------: | :-------: | :-------: | :----------: |
| TxToCallDataSize | block_tx_idx | to_hi | to_lo | 0 | tx.input.len | | TxToCallDataSize | block_tx_idx | to_hi | to_lo | 0 | tx.input.len |
#### tag为TxIsCreateAndStatus时,该行数值为: #### tag为TxIsCreateAndStatus时,该行数值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :-----------------: | :----------: | :---------------------------------: | :----------------: | :------------: | :-------: |
| TxIsCreateAndStatus | block_tx_idx | 1/0(if create contract is 1,else 0) | call data gas cost | call data size | tx status | | TxIsCreateAndStatus | block_tx_idx | 1/0(if create contract is 1,else 0) | call data gas cost | call data size | tx status |
#### tag为TxGasLimitAndGasPrice时,该行数值为: #### tag为TxGasLimitAndGasPrice时,该行数值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :-------------------: | :----------: | :------: | :-------: | :-------------: | :-------------: |
| TxGasLimitAndGasPrice | block_tx_idx | None | tx.gas | gas_price[..16] | gas_price[16..] | | TxGasLimitAndGasPrice | block_tx_idx | None | tx.gas | gas_price[..16] | gas_price[16..] |
#### 将合约的输入数据按byte遍历, 每个byte存放进TxCalldata的数据行,其中idx为该byte在合约的输入数据中的次序,byte为该次序对应的byte数据,该行数值为: #### 将合约的输入数据按byte遍历, 每个byte存放进TxCalldata的数据行,其中idx为该byte在合约的输入数据中的次序,byte为该次序对应的byte数据,该行数值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :--------: | :----------: | :------: | :-------: | :-------: | :-------: |
| TxCalldata | block_tx_idx | 0 | 0 | idx | byte | | TxCalldata | block_tx_idx | 0 | 0 | idx | byte |
### 区块log数据存放 ### 区块log数据存放
区块中每笔交易可以产生多条log,遍历区块中每笔交易的每个log,其中topic_num为该log中topics的数目(不超过4)；tx_idx为该log所属的transaction_index；log_index为该log的log_index；address为该log所属的地址；如果topic_num为0的话,log_tag为AddrWith0Topic；如果topic_num为1/2/3/4的话,log_tag为AddrWith1/2/3/4Topic。 区块中每笔交易可以产生多条log,遍历区块中每笔交易的每个log,其中topic_num为该log中topics的数目(不超过4)；tx_idx为该log所属的transaction_index；log_index为该log的log_index；address为该log所属的地址；如果topic_num为0的话,log_tag为AddrWith0Topic；如果topic_num为1/2/3/4的话,log_tag为AddrWith1/2/3/4Topic。
#### tag为TxLog,该行数值为: #### tag为TxLog,该行数值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :---: | :----------: | :-------: | :-------: | :----------: | :----------: |
| TxLog | block_tx_idx | log_index | log_tag | address[..4] | address[4..] | | TxLog | block_tx_idx | log_index | log_tag | address[..4] | address[4..] |
#### tag为TxLog的时候,根据topic的数目,依次存放topic1/2/3/4的数据,其中topic_hash为该topic对应的hash,topic_log_tag为Topic1/2/3/4,每行数值为: #### tag为TxLog的时候,根据topic的数目,依次存放topic1/2/3/4的数据,其中topic_hash为该topic对应的hash,topic_log_tag为Topic1/2/3/4,每行数值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :---: | :----------: | :-------: | :-----------: | :--------------: | :--------------: |
| TxLog | block_tx_idx | log_index | topic_log_tag | topic_hash[..16] | topic_hash[16..] | | TxLog | block_tx_idx | log_index | topic_log_tag | topic_hash[..16] | topic_hash[16..] |
#### tag为TxLog时候,记录了log的data长度(data_len),该行数值为: #### tag为TxLog时候,记录了log的data长度(data_len),该行数值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :---: | :----------: | :-------: | :--------------: | :-------: | :-------: |
| TxLog | tx_idx | log_index | log_tag=DataSize | 0 | data_len | | TxLog | tx_idx | log_index | log_tag=DataSize | 0 | data_len |
#### 将log中的数据按照byte便利,每个byte存放一行,其中data_idx为该byte在数据块中的次序,其中LogTag::Data为该数据类型,每行数值为: #### 将log中的数据按照byte便利,每个byte存放一行,其中data_idx为该byte在数据块中的次序,其中LogTag::Data为该数据类型,每行数值为:
| tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] | | tag | block_tx_idx | value[0] | values[1] | values[2] | values[3] |
| :--: | :--: | :--: | :--: | :--: | :--: | | :---: | :----------: | :-------: | :----------: | :-------: | :-------: |
| TxLog | tx_idx | log_index | LogTag::Data | byte | data_idx | | TxLog | tx_idx | log_index | LogTag::Data | byte | data_idx |
### 合约公共数据存放 ### 合约公共数据存放
......

Copyright © 2024 ChainWeaver Org. All Rights Reserved. 版权所有。

京ICP备2023035722号-3

京公网安备 11010802044225号