Skip to content
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

Update Gas and Fees, Blocks and Transactions pages #3509

Merged
merged 38 commits into from
Aug 4, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
4767ee4
Added Block Size and Base Fee sections
minimalsm Jul 30, 2021
7a8d710
Added More on Base Fees section
minimalsm Jul 30, 2021
d7f029a
Rewrite intro section
minimalsm Jul 30, 2021
9a33190
Include tips and feecap
minimalsm Jul 30, 2021
7cfdcf5
Restructure paragraphs
minimalsm Jul 30, 2021
0a2906e
Rewording a sentence
minimalsm Jul 30, 2021
d916a2e
Complete gas and fees page
minimalsm Aug 3, 2021
0ada868
Update block page
minimalsm Aug 3, 2021
3d3b417
Update transactions page to include 1559 changes
minimalsm Aug 3, 2021
70bf473
Update gas page
minimalsm Aug 3, 2021
42c62a2
Add internal link to London Update on blocks page
minimalsm Aug 3, 2021
7d92888
Wording on gas page: London upgrade to london update
minimalsm Aug 3, 2021
c57cbed
Remove gasPrice from Transactions page
minimalsm Aug 3, 2021
791b37b
Update src/content/developers/docs/gas/index.md
minimalsm Aug 3, 2021
cf6f6d8
Update src/content/developers/docs/gas/index.md
minimalsm Aug 3, 2021
8e2510e
Update src/content/developers/docs/gas/index.md
minimalsm Aug 3, 2021
3284f0b
Update src/content/developers/docs/gas/index.md
minimalsm Aug 3, 2021
1d1a0d6
Update src/content/developers/docs/gas/index.md
minimalsm Aug 3, 2021
93d3089
Update src/content/developers/docs/gas/index.md
minimalsm Aug 3, 2021
e270160
Update src/content/developers/docs/gas/index.md
minimalsm Aug 3, 2021
352495d
Update src/content/developers/docs/gas/index.md
minimalsm Aug 4, 2021
6b86af7
Update src/content/developers/docs/gas/index.md
minimalsm Aug 4, 2021
14d8ab0
Update src/content/developers/docs/gas/index.md
minimalsm Aug 4, 2021
0fa9a5e
Update Whats in a block to camelCase
minimalsm Aug 4, 2021
d2b3328
Update Whats in a block to camelCase
minimalsm Aug 4, 2021
ad48b9b
Update phrase wording on gas page
minimalsm Aug 4, 2021
37738a1
Change London Upgrade header to EIP-1559 and reword
minimalsm Aug 4, 2021
ae2c599
Reorder base fee and block size content, refactor block size paragraph
minimalsm Aug 4, 2021
efb358b
Refactor Tips section
minimalsm Aug 4, 2021
9c8dc15
Refactor on gas section
minimalsm Aug 4, 2021
c077cad
Clarified After the London Upgrade section
minimalsm Aug 4, 2021
5fc90c6
Refactor on gas section
minimalsm Aug 4, 2021
8f63cb2
Add example of new transactions
minimalsm Aug 4, 2021
a092cf2
Add Intro to After London section
minimalsm Aug 4, 2021
57d21ed
Add refund information
minimalsm Aug 4, 2021
d9388ee
Move three sections to subsections of After London Upgrade
minimalsm Aug 4, 2021
03f06ca
Remove burnt fees from block anatomy
minimalsm Aug 4, 2021
6145f53
Add more suggested changes
minimalsm Aug 4, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 10 additions & 9 deletions src/content/developers/docs/blocks/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,18 +44,19 @@ Proof of work means the following:

## What's in a block? {#block-anatomy}

- Timestamp – the time when the block was mined.
- Block number – the length of the blockchain in blocks.
- Difficulty – the effort required to mine the block.
- mixHash – a unique identifier for that block.
- A parent hash – the unique identifier for the block that came before (this is how blocks are linked in a chain).
- Transactions list – the transactions included in the block.
- State root – the entire state of the system: account balances, contract storage, contract code and account nonces are inside.
- Nonce – a hash that, when combined with the mixHash, proves that the block has gone through [proof of work](/developers/docs/consensus-mechanisms/pow/).
- `timestamp` – the time when the block was mined.
- `blockNumber` – the length of the blockchain in blocks.
- `baseFeePerGas` - the minimum fee per gas required for a transaction to be included in the block.
- `difficulty` – the effort required to mine the block.
- `mixHash` – a unique identifier for that block.
- `parentHash` – the unique identifier for the block that came before (this is how blocks are linked in a chain).
- `transactions` – the transactions included in the block.
- `stateRoot` – the entire state of the system: account balances, contract storage, contract code and account nonces are inside.
- `nonce` – a hash that, when combined with the mixHash, proves that the block has gone through [proof of work](/developers/docs/consensus-mechanisms/pow/).

## Block size {#block-size}

A final important note is that blocks themselves are bounded in size. Each block has a block gas limit which is set by the network and the miners collectively: the total amount of gas expended by all transactions in the block must be less than the block gas limit. This is important because it ensures that blocks can’t be arbitrarily large. If blocks could be arbitrarily large, then less performant full nodes would gradually stop being able to keep up with the network due to space and speed requirements. The block gas limit at block 0 was initialized to 5,000; any miner who mines a new block can alter the gas limit by up to about 0.1% in either direction from the parent block gas limit. The gas limit as of April 2021 currently hovers around 15,000,000.
A final important note is that blocks themselves are bounded in size. Each block has a target size of 15 million gas but the size of blocks will increase or decrease in accordance with network demands, up until the block limit of 30 milion gas (2x target block size). The total amount of gas expended by all transactions in the block must be less than the block gas limit. This is important because it ensures that blocks can’t be arbitrarily large. If blocks could be arbitrarily large, then less performant full nodes would gradually stop being able to keep up with the network due to space and speed requirements.

## Further reading {#further-reading}

Expand Down
Loading