Skip to content

Update README.md #41

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.

Sign up for GitHub

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

Open
yizhang0901 wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Update README.md #41

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8406df6
Update README.md
yizhang0901 Feb 16, 2026
42fecd1
Update README 2.md
yizhang0901 Feb 17, 2026
a6612f1
Update README 2.md
yizhang0901 Feb 17, 2026
4a39735
Merge pull request #42 from flashbots/yizhang0901-patch-2
yizhang0901 Feb 18, 2026
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
18 changes: 17 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,23 @@ This repository is in progress and will host the work of the Decentralized Order

## Builders

Builders can register to receive orderflow from MEV-share matchmakers by submitting a PR to this repository. In the PR, they should add an entry to `registrations.json` with the following information:
### Criteria for receiving orderflow

To be eligible to receive orderflow, a builder must:
* Build ≥2% of canonical Ethereum blocks over the trailing 60 days
* Provide a real-time communication channel for technical coordination
* Commit to the Flashbots Fair Market Principles

Builders may be suspended if they:
* Fall below 2% block share over the trailing 30 days; or
* Violate the Fair Market Principles; or
* Experience documented technical instability materially affecting inclusion reliability.

In rare cases where these thresholds would impact transaction inclusion for users, Flashbots may temporarily adjust the multiplexing criteria. Any adjustments will be documented and applied equally across all builders.

### Registering to receive orderflow

Builders can register to receive orderflow by submitting a PR to this repository. In the PR, they should add an entry to `registrations.json` with the following information:
* Their name as they would like it displayed.
* The RPC endpoint that matchakers should send bundles to.
* The API versions they support. Builders can find the complete set of bundle APIs [here](https://github.com/flashbots/mev-share/tree/main/specs/bundles) (version names are indicated by the file name). We recommend that builders upgrade to the latest version when new versions are released. For an example of how to integrate the new `mev_sendBundle` method (and in particular how to enforce validity conditions), you can reference the open-source [Flashbots MEV-Boost Block Builder](https://github.com/flashbots/builder/tree/mev-share).
Expand Down