Contributing

MEV-Boost is open-source software maintained by Flashbots. Contributions are welcome from the community.

Quick Links

• GitHub Repository
• Open Issues
• CONTRIBUTING.md
• Code of Conduct

Development Setup

Prerequisites

• Go 1.24 or later
• Make
• Git

Clone and Build

git clone https://github.com/flashbots/mev-boost.git
cd mev-boost
make build

Running Tests

# Run unit tests
make test

# Run linter
make lint

# Run integration tests with mergemock
make run-mergemock-integration

Running Locally

# Run with default settings pointed at a test relay
make run

Branch Strategy

• develop — The default branch. All pull requests target develop.
• main — Stable release branch. Merged from develop during releases.

Pull Request Guidelines

1. Fork the repository and create your branch from develop.
2. Write tests for any new functionality.
3. Run make test and make lint before submitting.
4. Keep PRs focused — one feature or fix per PR.
5. Write a clear description explaining what the change does and why.

Reporting Issues

• Bug reports — Open a GitHub Issue with logs, configuration details, and steps to reproduce.
• Security vulnerabilities — Do not open a public issue. Email security@flashbots.net instead. See Security & Bug Bounty for bounty details.
• Feature requests — Open a GitHub Issue or start a discussion on the Flashbots Forum.

Contributing to These Docs

This documentation site is maintained separately at flashbots/mev-boost.org.

git clone https://github.com/flashbots/mev-boost.org.git
cd mev-boost.org
npm install
npm start

Docs are written in Markdown/MDX and live in the docs/ directory. See the Docusaurus docs for formatting guidance.

Community

• Flashbots Forum — Long-form discussions and proposals.
• Flashbots Discord — Real-time chat and support.