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

1

View the Example Implementation

MEV_COMMIT_RPC=wss://chainrpc-wss.testnet.mev-commit.xyz PROVIDER_REGISTRY_ADDR=

2

Test and Deploy

Test filtering behavior on Holesky:

3

Register Your Relay

  1. Add your relay to our supporting relays list
  2. Provide connection details for validators
  3. 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.