forked from ethereum/EIPs
-
Notifications
You must be signed in to change notification settings - Fork 2
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
extend history retention to 8192 and modify blockhash to charge additional sload gas #4
Merged
Merged
Changes from 11 commits
Commits
Show all changes
15 commits
Select commit
Hold shift + click to select a range
8317c8c
extend history retention to 8192 and modify blockhash to charge addit…
g11tech bbb6d22
title
g11tech 56250b6
fix cleanup
g11tech fcd968d
add missing contributor names
gballet 363fb62
further update on discussion
g11tech 34e0923
update
g11tech d0ecf24
update
g11tech a016b6c
update
g11tech 328152b
add contract assembley
g11tech d49c765
apply feedback
g11tech e7a0178
add helpful comments
g11tech a00d184
fix the comment vals
g11tech 149a923
update the assembely as per feedback
g11tech c2de186
improv
g11tech cbb3ee6
add and generate deployment tx, inputdata and sender/contract address
g11tech File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,8 @@ | ||
--- | ||
eip: 2935 | ||
title: Save historical block hashes in state | ||
description: store previous block hashes as storage slots of a system contract to allow for stateless execution | ||
author: Vitalik Buterin (@vbuterin), Tomasz Stanczak (@tkstanczak), Guillaume Ballet (@gballet), Gajinder Singh (@g11tech), Tanishq Jasoria (@tanishqjasoria) | ||
title: Serve historical block hashes from state | ||
description: Store and serve last 8192 block hashes as storage slots of a system contract to allow for stateless execution | ||
author: Vitalik Buterin (@vbuterin), Tomasz Stanczak (@tkstanczak), Guillaume Ballet (@gballet), Gajinder Singh (@g11tech), Tanishq Jasoria (@tanishqjasoria), Ignacio Hagopian (@jsign), Jochem Brouwer (@jochem-brouwer) | ||
discussions-to: https://ethereum-magicians.org/t/eip-2935-save-historical-block-hashes-in-state/4565 | ||
status: Draft | ||
type: Standards Track | ||
|
@@ -12,23 +12,24 @@ created: 2020-09-03 | |
|
||
## Abstract | ||
|
||
Store last 256 historical block hashes in a contract, and modify the `BLOCKHASH (0x40)` opcode to read and serve from this contract storage. | ||
Store last `HISTORY_SERVE_WINDOW` historical block hashes in a contract, and modify the `BLOCKHASH (0x40)` opcode to read and serve from this contract storage. | ||
|
||
## Motivation | ||
|
||
Currently BLOCKHASH opcode accesses history to resolve hash of the block number in EVM. However a more stateless client friendly way is to maintain and serve these hashes from state. | ||
Currently `BLOCKHASH` opcode accesses history to resolve hash of the block number in EVM. However a more stateless client friendly way is to maintain and serve these hashes from state. | ||
|
||
Although this is possible even in Merkle trie state, but Verkle trie state further allows bundling the BLOCKHASH witnesses (along with other witnesses) in an efficient manner making it worthwhile to have these in state. | ||
Although this is possible even in Merkle trie state, but Verkle trie state further allows bundling the `BLOCKHASH` witnesses (along with other witnesses) in an efficient manner making it worthwhile to have these in state. | ||
|
||
A side benefit of this approach could be that it allows building/validating proofs related to last 256 ancestors directly against the current state. | ||
A side benefit of this approach could be that it allows building/validating proofs related to last `HISTORY_SERVE_WINDOW` ancestors directly against the current state. | ||
|
||
## Specification | ||
|
||
| Parameter | Value | | ||
| - | - | | ||
| `FORK_TIMESTAMP` | TBD | | ||
| `HISTORY_STORAGE_ADDRESS` | `0xfffffffffffffffffffffffffffffffffffffffe`| | ||
| `HISTORY_SERVE_WINDOW` | `256` | | ||
| `HISTORY_SERVE_WINDOW` | `8192` | | ||
| `BLOCKHASH_OLD_WINDOW` | `256` | | ||
|
||
This EIP specifies for storing last `HISTORY_SERVE_WINDOW` block hashes in a ring buffer storage of `HISTORY_SERVE_WINDOW` length. | ||
|
||
|
@@ -40,7 +41,7 @@ def process_block_hash_history(block: Block, state: State): | |
if block.timestamp >= FORK_TIMESTAMP: | ||
state.insert_slot(HISTORY_STORAGE_ADDRESS, (block.number-1) % HISTORY_SERVE_WINDOW , block.parent.hash) | ||
|
||
# If this is the first fork block, add the parent's direct 255 ancestors as well | ||
# If this is the fork block, add the parent's direct `HISTORY_SERVE_WINDOW - 1` ancestors as well | ||
if block.parent.timestamp < FORK_TIMESTAMP: | ||
ancestor = block.parent | ||
for i in range(HISTORY_SERVE_WINDOW - 1): | ||
|
@@ -52,25 +53,94 @@ def process_block_hash_history(block: Block, state: State): | |
state.insert_slot(HISTORY_STORAGE_ADDRESS, ancestor.number % HISTORY_SERVE_WINDOW, ancestor.hash) | ||
``` | ||
|
||
Note that if this is the fork block, then it persists the additional requisite history that could be needed while resolving `BLOCKHASH` opcode for all of the `HISTORY_SERVE_WINDOW` ancestors (up until genesis). | ||
Note that if this is the fork block, then it persists the additional requisite history that could be needed while resolving `BLOCKHASH` opcode for all of the `HISTORY_SERVE_WINDOW` > `BLOCKHASH_OLD_WINDOW` ancestors (up until genesis). | ||
|
||
For resolving the `BLOCKHASH` opcode this fork onwards (`block.timestamp >= FORK_TIMESTAMP`), switch the logic to: | ||
|
||
```python | ||
def resolve_blockhash(block: Block, state: State, arg: uint64): | ||
# check the wrap around range | ||
if arg >= block.number or arg < max(block.number - HISTORY_SERVE_WINDOW, 0) | ||
if arg >= block.number or (arg + HISTORY_SERVE_WINDOW) < block.number | ||
return 0 | ||
|
||
return state.load_slot(HISTORY_STORAGE_ADDRESS, arg % HISTORY_SERVE_WINDOW) | ||
``` | ||
|
||
Exact evm assembly that can be used for the blockhash contract: | ||
|
||
``` | ||
// check for <=32 (<33) byte size or else revert | ||
calldatasize | ||
push1 0x21 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. shouldn't we limit it to 8 bytes ? |
||
gt | ||
push1 0x0a | ||
// jump and skip revert | ||
jumpi | ||
g11tech marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
push0 | ||
push0 | ||
revert | ||
|
||
// check if blocknumber > input or else return 0 | ||
jumpdest | ||
push0 | ||
calldataload | ||
number | ||
gt | ||
push1 0x1a | ||
jumpi | ||
|
||
// return 0 | ||
push0 | ||
push0 | ||
mstore | ||
push1 0x20 | ||
push0 | ||
return | ||
|
||
// check if input + 8125 > blocknumber (input >= blocknumber - 8124) or else return 0 | ||
g11tech marked this conversation as resolved.
Show resolved
Hide resolved
|
||
jumpdest | ||
number | ||
push2 0x2001 | ||
push0 | ||
calldataload | ||
add | ||
gt | ||
push1 0x2e | ||
jumpi | ||
|
||
// return 0 | ||
push0 | ||
push0 | ||
mstore | ||
push1 0x2e | ||
push0 | ||
return | ||
|
||
// mod 8192 and sload | ||
jumpdest | ||
push2 0x2000 | ||
push0 | ||
calldataload | ||
mod | ||
sload | ||
|
||
// load into mem and return 32 bytes | ||
push0 | ||
mstore | ||
push1 0x20 | ||
push0 | ||
return | ||
|
||
stop | ||
``` | ||
|
||
Some activation scenarios: | ||
|
||
* For the fork to be activated at genesis, no history is written to the genesis state, and at the start of block `1`, genesis hash will be written as a normal operation to slot `0`. | ||
* for activation at block `1`, only genesis hash will be written at slot `0` as there is no additional history that needs to be persisted. | ||
* for activation at block `32`, block `31`'s hash will be written to slot `31` and additonal history for `0..30`'s hashes will be persisted, so all in all `0..31`'s hashes. | ||
* for activation at block `1000`, block `744-999`'s hashes will be presisted in the slot and `BLOCKHASH` for `743` or less would resolve to `0` as only `HISTORY_SERVE_WINDOW` can be served. | ||
* for activation at block `10000`, block `1808-9999`'s hashes will be presisted in the slot and `BLOCKHASH` for `1807` or less would resolve to `0` as only `HISTORY_SERVE_WINDOW` are persisted. | ||
|
||
### [EIP-158](./eip-158.md) handling | ||
|
||
|
@@ -82,7 +152,7 @@ This address is currently exempt from [EIP-158](./eip-158.md) cleanup in Kaustin | |
|
||
### Gas costs and witnesses | ||
|
||
We propose not to modify any gas costs since clients can directly resolve `BLOCKHASH` from an in-memory maintained structure or do a direct actual `SLOAD` or even a "system" execution of the deployed contract's `get`. However, for purposes of bundling block witnesses for stateless clients (for e.g. in Verkle activated networks), client should record corresponding witness accesses and bundle in the witnesses along with the corresponding proofs. | ||
Since now `BLOCKHASH` is served from state, the clients now **additionally** charge the corresponding warm or cold `SLOAD` costs. For verkle based networks this would imply doing and bundling corresponding accesses (and gas charges) of `SLOAD`. | ||
|
||
## Rationale | ||
|
||
|
@@ -99,11 +169,12 @@ Second concern was how to best transition the BLOCKHASH resolution logic post fo | |
1. Either waiting for `HISTORY_SERVE_WINDOW` blocks for the entire relevant history to persist | ||
2. Storing of all last `HISTORY_SERVE_WINDOW` block hashes on the fork block. | ||
|
||
We choose to go with later as it alleviates the need to detect fork activation height to transition to the new logic in backward compatible manner as the entire requisite history will be available from the first block of the fork itself. The cost of doing so is marginal considering the `HISTORY_SERVE_WINDOW` being small. | ||
We choose to go with later as it alleviates the need to detect fork activation height to transition to the new logic in backward compatible manner as the entire `BLOCKHASH` requisite history will be available from the first block of the fork itself. | ||
The cost of doing so is marginal considering the `HISTORY_SERVE_WINDOW` being relatively limited. Most clients write this into their flat db/memory caches and just requires reading last `HISTORY_SERVE_WINDOW` from the chain history. | ||
|
||
## Backwards Compatibility | ||
|
||
The behavior of `BLOCKHASH` opcode remains same and this EIP doesn't affect backward compatibility with the contracts deployed or the gas consumption costs as the resolution of the opcode is handled "directly" by the clients. | ||
The behavior of `BLOCKHASH` opcode gets extended in backward compatible manner as the history it can serve will get extended upto `HISTORY_SERVE_WINDOW` on the fork block. However the gas charges will also get bumped as per the additional `SLOAD` costs. | ||
|
||
## Test Cases | ||
|
||
|
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
style: I'm a uppercase assemblist