Merge pull request #830 from ethereum/eip2930_reference_docs

Added the EIP2930 accessList field to the test reference
ethereum · Apr 26, 2021 · 9b4c624 · 9b4c624
2 parents fe9ad9d + a650ea1
commit 9b4c624
Show file tree

Hide file tree

Showing 2 changed files with 65 additions and 1 deletion.
diff --git a/docs/test_filler/test_transaction_blockchain.rst b/docs/test_filler/test_transaction_blockchain.rst
@@ -35,6 +35,24 @@ Format
                            secretKey: "5ec13e7 ... 5ec13e7"
                            nonce: '0x909ce'
                          },
+                         {
+                           data: "0xDA7A",
+                           accessList: [
+                             {  
+                                "address": "0xcccccccccccccccccccccccccccccccccccccccd",
+                                "storageKeys": ["0x1000", "0x60A7"]
+                             },
+                             {  
+                                "address": "0xccccccccccccccccccccccccccccccccccccccce"
+                             }
+                           ], 
+                           gasLimit: "0x6a506a50",
+                           gasPrice: 1,
+                           value: 1,
+                           to: "add13ess01233210add13ess01233210",
+                           secretKey: "5ec13e7 ... 5ec13e7"
+                           nonce: '0x909ce'
+                         },
                          <other transactions>
                        ]
                        <other block fields>
@@ -57,6 +75,18 @@ Format
                  to: "add13ess01233210add13ess01233210"
                  secretKey: "5ec13e7 ... 5ec13e7"
                  nonce: '0x909ce'
+               - data: 0xDA7A
+                 accessList: 
+                 - address: 0xcccccccccccccccccccccccccccccccccccccccd
+                   storageKeys:
+                   - 0x1000
+                 - address: 0xcccccccccccccccccccccccccccccccccccccccc
+                 gasLimit: '0x6a506a50'
+                 gasPrice: "1"
+                 value: 1
+                 to: "add13ess01233210add13ess01233210"
+                 secretKey: "5ec13e7 ... 5ec13e7"
+                 nonce: '0x909ce'
                - <another transaction>
                <other block fields>
              - <another block>
@@ -72,6 +102,13 @@ Fields
   **:abi <function signature> <function parameters separated by spaces>**.
 
 
+- **accessList**:
+
+  An optional `EIP2930 <https://eips.ethereum.org/EIPS/eip-2930>`_ access list. 
+  The **accessList** is a list of structures, each of which has to have an **address**
+  and may have a list of **storageKeys**.
+
+
 - **gasLimit**:
 
   Gas limit for the transaction

diff --git a/docs/test_filler/test_transaction_state.rst b/docs/test_filler/test_transaction_state.rst
@@ -24,7 +24,21 @@ Format
                   <other sections>,
                   "transaction":
                      {
-                        "data": ["0xDA7A", "0xDA7A", ":label hex 0xDA7A", ":abi f(uint) 0xDA7A"],
+                        "data": ["0xDA7A", "0xDA7A", ":label hex 0xDA7A", 
+                             ":abi f(uint) 0xDA7A",
+                             {
+                                  "data": "0xDA7A", 
+                                  "accessList": [ 
+                                     {
+                                        "address": "0x0000000000000000000000000000000000000101",
+                                        "storageKeys": [0x60A7, 0xBEEF]
+                                     },
+                                     {
+                                        "address": "0x0000000000000000000000000000000000000102"
+                                     }
+                                  ]
+                              }
+                        ],
                         "gasLimit": ["0x6a506a50"],
                         "gasPrice: 1,
                         "value": ["1"],
@@ -43,6 +57,13 @@ Format
                - 0xDA7A
                - :label hex 0xDA7A
                - :abi f(uint) 0xDA7A
+               - data: :label acl 0xDA7A
+                 accessList:
+                 - address: 0x0000000000000000000000000000000000000101
+                   storageKeys: 
+                   - 0x60A7
+                   - 0xBEEF
+                 - address: 0x0000000000000000000000000000000000000102
                gasLimit:
                - '0xga50ga50'
                gasPrice: "1"
@@ -66,6 +87,12 @@ Fields
   This value is specified as a list to enable
   `files with multiple tests <../state-transition-tutorial.html#multitest-files>`_
 
+  The data can also have an `EIP2930 
+  <https://eips.ethereum.org/EIPS/eip-2930>`_ access list. In that case the data
+  field itself is a structure with two fields: **data** (the data) and **accessList**.
+  The **accessList** is a list of structures, each of which has to have an **address**
+  and may have a list of **storageKeys**.
+
 - **gasLimit**:
 
   Gas limit for the transaction.