/* 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;
} */


Documentation

API Reference

Knowledge Base

Send a bid to the bidder mev-commit node.

Send Bid

Amount of ETH that the bidder has agreed to pay to the provider for including the transaction in the block.

Max block number that the bidder wants to include the transaction in.

Hex string encoding of digest of the commitment.

Hex string encoding of signature of the commitment signed by the provider confirming this transaction.

Timestamp at which the bid ends decaying.

Timestamp at which the bid starts decaying.

Timestamp at which the commitment is published.

Hex string encoding of the address of the provider that signed the commitment signature.

Hex string encoding of digest of the bid message signed by the bidder.

Hex string encoding of signature of the bidder that sent this bid.

Hex string encoding of the hash of the transaction that the bidder wants to include in the block.

Unsigned bid message from bidders to the bidder mev-commit node.

Bid message

Stream result of v1Commitment

SendBid

Primev is building mev-commit; a credible commitment network used for preconfirmations & more

Welcome to Primev

Step into the Primev ecosystem with ease. This guide covers everything you need to set up your mev-commit node, whether you're aiming to be a bidder or a provider.

Quickstart

Quickstart Your mev-commit Node

Testnet Faucet

Opt into mev-commit with ease. This guide covers everything you need to do to passively interact with the mev-commit protocol as a validator.

Validators

Validator Guide

Relays

Relay Guide

My First Preconf

Receive your First Preconfirmation

Bidder Node Commands

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

What is mev-commit?

Network Overview

Understanding mev-commit

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

Validator Considerations

Testnet

mev-commit Testnet

System Requirements

Provider API

Bidder API

Managing Your Bidder Deposit

Tools for Bid Submission

Stake Validators Keys Manually

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?

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.

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

RegisterStake is called by the provider to register 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

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

Retrieve Deposit

GetMinDeposit is called by the bidder to get the minimum deposit required in the bidder registry to make bids.

Retrieve Min Deposit

Deposit is called by the bidder node to add deposit in the bidder registry.

API Reference

Provider

Bidder

Send Bid

Body

Response