/* Wraps all code blocks to prevent overflow  */
div.min-w-full > pre.language-shell {
  white-space: pre-wrap; /* Wrap text */
  word-break: break-word; /* Prevents overflow by breaking long words */
  overflow-wrap: break-word; /* Ensures text breaks nicely */
}

.inline-card-header > a {
  height: 100%;
}

/* Adjusts card padding */
.inline-card-header > a > div {
  padding-left: 1.25rem;
  padding-right: 1.25rem;
}

/* Displays the logo and title of a card inline */
.inline-card-header > a > div > div {
  display: inline-block;
  vertical-align: middle;
}

.inline-card-header > a > div > h2 {
  display: inline-block;
  vertical-align: middle;
  margin: auto 0 auto 10px;
}

/* Adds back link styles to links within cards */
.inline-card-header div a {
  text-decoration: none;
  font-weight: 600;
  border-bottom: 1px solid rgb(var(--primary-light)) !important;
}

/* 
.inline-card-header > a > div {
  color: blue;
} */


Subscribe to notifications for given topics. The client will receive notifications for the topics it has subscribed to.

### Available Topics
- peer_connected: Emitted when a peer connects to the network
- peer_disconnected: Emitted when a peer disconnects from the network
- validator_opted_in: Emitted before an upcoming L1 block proposer has opted in to the mev-commit protocol. The "proposer-notify-offset" param configures how far in advance the notification is emitted
- epoch_validators_opted_in: Emitted at the beginning of an epoch, specifying any slots where the L1 validator is opted-in to mev-commit.

See the API description for response structure details.

Subscribe

Topic of the notification. Available topics:

- peer_connected: Response includes ethAddress and type
- peer_disconnected: Response includes ethAddress and type
- validator_opted_in: Response includes epoch, slot, and bls_key of the upcoming opted-in proposer
- epoch_validators_opted_in: Response includes epoch, epoch_start_time, and opted-in slots array

Topic of the notification

Payload of the notification. Structure depends on the topic:

- peer_connected: {"ethAddress": "0x...", "type": "bootnode|provider|bidder"}
- peer_disconnected: {"ethAddress": "0x...", "type": "bootnode|provider|bidder"}
- validator_opted_in: {"epoch": uint64, "slot": uint64, "bls_key": "string"} - Sent when an upcoming block proposer is opted-in
- epoch_validators_opted_in: {"epoch": uint64, "epoch_start_time": uint64, "slots": []}

Payload of the notification

Notification represents a notification message sent to subscribers

SubscribeRequest represents a request to subscribe to notification topics

A successful response.(streaming responses)

Stream result of v1Notification

Documentation

Primev's mev-commit makes Ethereum FAST by enabling preconfirmations and new types of mev using an encrypted mempool, enhancing yield for opted-in validators.

Welcome to Primev

This guide covers everything you need to set up your mev-commit bidder node. For providers, please refer to the [manual start mev-commit](/v1.0.0/developers/manual-start-mev-commit) section

Quickstart

Quickstart for mev-commit bidder node

How to bridge ETH between L1 and mev-commit using the web interface

Bridge UI

Using the Bridge UI

Bridge CLI

Opt into mev-commit with ease. This guide covers everything you need to passively opt-in to mev-commit as an L1 validator.

Validator Guide

Opt into mev-commit by natively restaking to our AVS.

Eigenlayer Opt-in

Opt into mev-commit by ERC20 restaking with the MevCommitMiddleware contract through Symbiotic.

Symbiotic Opt-in

Opt into mev-commit by simply staking ETH.

Vanilla Opt-in

Relays

Relay Integration Guide

Best Practices

Bidder Best Practices

Bidder Node Commands

Bidder CLI

Bidder CLI application

Registering as a Provider

Consuming Bids

Consuming Bids from mev-commit

Sending Commitments

Use the pointers below to determine whether an upcoming proposer has opted in to mev-commit or not.

Querying for Proposers

Withdraws the stake from the provider registry.

Withdraw Stake

What is mev-commit?

Network Overview

Understanding mev-commit

Security & Privacy

Solvers

Understanding how builders are identified and attributed in mev-commit

Builder Attribution

Bid Structure

Bidder Deposit

Understanding Bidder Deposit Rules

Learn about how bids decay in value in real time

Bid Decay

Bid Decay Mechanism

Chain Details

Ethereum vs mev-commit

Differences Between Ethereum and mev-commit Chain

Bridging Details

Rewards and Slashing

Points

mev-commit Points Program

Validator Considerations

Mainnet

Mev-commit Mainnet

Testnet

Mev-commit Testnet

System Requirements

Provider API

Bidder API

Managing Your Bidder Deposit

Tools for Bid Submission

Manual Node Setup

Run mev-commit Chain Node

A collection of answers to frequently asked questions.

Introduction

Learn about deposit amounts required for bidding and their significance.

Deposit amount

What is the Deposit Amount?

Learn how to resolve the `failed to read msg: stream reset` error for provider nodes within the mev-commit network.

Failed to read message

How do I fix the error: "failed to read msg: stream reset"?

Discover what Foundry is and its role in smart contract development and interactions within the mev-commit ecosystem.

What is Foundry?

Using cast with mev-commit

Why is cast necessary for mev-commit chain interactions?

Understand why resending a bid in the mev-commit ecosystem results in receiving the same commitment.

Receiving same commitment on bid

Why do I receive the same commitment when resending a bid?

What is Execution Preconfirmations?

Learn how to find the sweet spot for competitive bids.

How to Price A Bid

Learn about what happens behind the scenes during an execution preconfirmation.

What Happens During A Preconf?

What Happens During An Execution Preconfirmation?

Learn what providers do during an execution preconfirmation.

How Do Preconfs Work?

How Do You Provide A Commitment for Execution?

Instructions for registering as an Eigenlayer operator for the mev-commit AVS, enabling validator opt-in via restaking.

Eigenlayer Operator Registration

ReceiveBids is called by the provider to receive bids from the mev-commit node.
The mev-commit node will stream bids to the provider as the response. The bid can optionally
have the raw transaction payload in it. The order of the transaction hashes will be the same
as the raw transaction payloads if included.

Receive Bids

SendProcessedBids is called by the provider to send processed bids to the mev-commit node.
The provider will stream processed bids to the mev-commit node.

Send Processed Bids

Stake is called by the provider to register or add to its stake in the provider registry.

Register Stake

GetMinStake is called by the provider to get the minimum stake required to be in the provider registry.

Retrieve Minimum Stake

GetStake is called by the provider to get its stake in the provider registry.

Retrieve Stake

Unstake is called by the provider to request a unstake from the provider registry.

Unstake Funds

WithdrawStake is called by the provider to withdraw its stake from the provider registry.

Send a bid to the bidder mev-commit node. The bid is a message from the bidder to the provider 
with the transaction hashes and the amount of ETH that the bidder is willing to pay to the provider
for including the transaction in the block. The bid also includes the block number that the bidder
wants to include the transaction in, the start and end timestamps for the bid decay. The bidder can
optionally include the raw transaction payloads (hex encoded RLP) instead of transaction hashes.

Send Bid

GetDeposit is called by the bidder to get its deposit in the bidder registry.

Retrieve Deposit

Deposit is called by the bidder node to add deposit in the bidder registry. The bidder can deposit
funds in a particular window by specifying the window number. If the window number is not specified,
the current block number is used to calculate the window number. If the block number is specified,
the window number is calculated based on the block number. If AutoDeposit is enabled, the deposit
API returns error.

Add Deposit

Withdraw is called by the bidder to withdraw deposit from the bidder registry.

Withdraw Deposit

WithdrawFromWindows is called by the bidder node to withdraw funds from multiple windows.

Withdraw Deposit From Windows

AutoDeposit is called by the bidder node to add a recurring deposit in the bidder registry. The bidder
can specify the amount of ETH to be deposited in each window. The bidder can also specify the start window
number for the deposit. If the start window number is not specified, the current block number is used to
calculate the window number. If the block number is specified, the window number is calculated based on
the block number. One it is enabled, the node will automatically deposit the specified amount in each window
as well as withdraw the deposit from the previous window.

Add Auto Deposit

AutoDepositStatus is called by the bidder node to get the status of the auto deposit.

Get Auto Deposit Status

CancelAutoDeposit is called by the bidder node to cancel the auto deposit. The bidder can specify if it
wants to withdraw the deposit from the current deposited windows. If the withdraw flag is set to true, the API will
wait till we can withdraw the deposit from the latest deposited window.

Cancel Auto Deposit

GetValidators is called by the bidder to get the validators for a given epoch.

Get Validators

CancelTransaction is called by the provider to cancel a transaction sent from this wallet.

Cancel Transaction

GetPendingTransactions is called by the provider to get the pending transactions for the wallet.

Pending Transactions

GetTopology is called by the user to get the topology of the node. The topology
includes connectivity information about the node.

API Reference

Provider

Bidder

Notifications

Debug

Subscribe

Available Topics

Body

Response