Skip to content

Conversation

@roethke
Copy link
Collaborator

@roethke roethke commented Jan 21, 2026

What changed? Why?
Improves Flashblocks documentation based on the Deep Dive blog post, which was proving more helpful for teams than the existing docs.

Updates:

  • New Overview page — Architecture, transaction lifecycle, block building algorithm, and integration guidance
  • Better formatting, tables, and cross-references
  • Improved Flashblocks section readability
  • Updated docs.json — Added overview to navigation

Notes to reviewers

How has it been tested?
Locally

@cb-heimdall
Copy link
Collaborator

cb-heimdall commented Jan 21, 2026

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

roethke and others added 2 commits January 26, 2026 16:01
Co-authored-by: cody-wang-cb <cody.wang@coinbase.com>
Co-authored-by: cody-wang-cb <cody.wang@coinbase.com>
| 10 | Full block limit (~187.5M gas) |

**Implications for large transactions:**
- Transactions with gas limits > 1/10 of block limit (currently ~18.75M gas) will never fit in a Flashblock
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is incorrect unless something has changed.

If a transaction consumes 20Mgas, it can be included as early as the 2nd flashblock (so long as the first flashblock has at least 1.25M gas unconsumed.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a max gas limit per transaction. now, but this is different than the size of an individual flashblock

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How could we use mintlify components to improve the organization of this page? Would drop downs or toggles be better so that people can view only the answers they want to?

@cb-heimdall cb-heimdall dismissed ericbrown99’s stale review February 9, 2026 21:13

Approved review 3712473321 from ericbrown99 is now dismissed due to new commit. Re-request for approval.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants