Relay Integration Guide
Overview
This guide will walk you through integrating your relay with mev-commit.
Once integrated, your relay will automatically:
- Track which validators have opted into mev-commit
- Only deliver mev-commit compliant blocks when opted-in validators are due to propose.
Quick Start
View the Example Implementation
- Check out this mev-commit relay integration
- Add required environment variables:
Test and Deploy
Test filtering behavior on Holesky:
- Register a test builder
- Submit test bids
- Verify correct block filtering
Register Your Relay
- Add your relay to our supporting relays list
- Provide connection details for validators
- Contact the Primev team to coordinate validator outreach
You have now successfully integrated your relay with mev-commit.
Implementation Details
How to Query the Provider Registry
The mev-commit provider registry contract maintains the list of authorized providers such as block builders. You can query this contract to validate builder addresses.
Contract Details:
- Network: mev-commit
- Address:
What Contracts to Monitor
To track which validators have opted into mev-commit monitor the appropriate validator registry contracts:
- Native Restaking: MevCommitAVS contract
- ERC20 Restaking: MevCommitMiddleware contract
- Direct Staking: VanillaRegistry contract
About Bid Filtering
When receiving bids from builders:
First, check if target validator has opted into mev-commit. For opted-in validators, verify the submitting builder:
- Ensure builder is registered on mev-commit, OR
- Builder is on the relay’s registered builder list
Only forward bids that satisfy one of these conditions.