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

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

Best Practices

Bidder Best Practices

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

Security & Privacy

Solvers

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?

What is Execution Preconfirmations?

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

Send a bid to the bidder mev-commit node.

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.

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 deposit in the bidder registry and move funds automatily from one window to another.

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.

Cancel Auto Deposit

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.

Key	Description
`commitmentDigest`	Represents the hash of the bid structure, including the bid signature
`commitmentSignature`	Represents an ECDSA signature of the `commitmentDigest`
`commitmentProviderAddress`	Represents the address of the provider
`sharedSecret`	Represents the shared secret between the bidder and provider

Get Started

Concepts

Developers

Commitments