# Documentation ## Docs - [Welcome to Primev](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/welcome-to-primev.md): Primev's mev-commit makes Ethereum FAST by enabling preconfirmations and new types of mev using an encrypted mempool, bringing speed and better swap prices to transactions. - [Quickstart your mev-commit node](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/quickstart.md): This guide covers everything you need to set up your mev-commit node. - [FAST RPC](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/fastrpc.md) - [Using the Bridge UI](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/bridge/bridge.md): How to bridge ETH between L1 and mev-commit using the web interface - [Bridge CLI](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/bridge/bridge-cli.md) - [Validator Guide](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/validators/validator-guide.md): Opt into mev-commit with ease. This guide covers everything you need to passively opt-in to mev-commit as an L1 validator. - [Eigenlayer Opt-in](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/validators/eigenlayer.md): Opt into mev-commit by natively restaking to our AVS. - [Symbiotic Opt-in](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/validators/symbiotic.md): Opt into mev-commit by ERC20 restaking with the MevCommitMiddleware contract through Symbiotic. - [Vanilla Opt-in](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/validators/vanilla.md): Opt into mev-commit by simply staking ETH. - [Lido Opt-in](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/validators/lido.md): Opt into mev-commit using Validators registered through Lido. - [Rocket Pool Opt-in](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/validators/rocketpool.md): Opt into mev-commit using Validators registered through Rocket Minipools. - [Relay Integration Guide](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/relays.md) - [Bidder Best Practices](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/bidders/best-practices.md) - [Bidder Node Commands](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/bidders/bidder-node-commands.md): This guide covers how to interact with your bidder node. - [Bidder CLI application](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/bidders/bidder-cli.md) - [Registering as a Provider](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/providers/registering-a-provider.md) - [Consuming Bids from mev-commit](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/providers/consuming-bids.md) - [Sending Commitments](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/providers/sending-commitments.md) - [Withdraw Stake](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/get-started/providers/withdraw.md): Withdraws the stake from the provider registry. - [Fast Protocol Economics & Mev Distribution Model](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/fast-protocol.md) - [What is mev-commit?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/mev-commit-intro/what-is-mev-commit.md) - [Actors](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/mev-commit-intro/actors.md) - [Understanding mev-commit](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/mev-commit-intro/network-overview.md) - [Oracle](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/mev-commit-intro/oracle.md) - [Commitments](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/commitments.md) - [Bid Structure](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/bids/bid-structure.md) - [Reverting txns](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/bids/reverting-txns.md) - [Understanding Bidder Deposit Rules](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/bids/bidder-deposit.md) - [Bid Decay Mechanism](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/bids/bid-decay-mechanism.md): Learn about how bids decay in value in real time - [Chain Details](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/mev-commit-chain/chain-details.md) - [Differences Between Ethereum and mev-commit Chain](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/mev-commit-chain/differences-between-ethereum-and-mev-commit-chain.md) - [Bridging Details](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/mev-commit-chain/bridging-details.md) - [Security & Privacy](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/privacy.md) - [Rewards and Slashing](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/rewards-and-slashing/rewards-and-slashing.md) - [mev-commit Points Program](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/rewards-and-slashing/points.md) - [Builder Attribution](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/rewards-and-slashing/builder-attribution.md): Understanding how builders are identified and attributed in mev-commit - [Validator considerations](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/concepts/validator-considerations.md) - [Mev-commit Mainnet](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/networks/mainnet.md) - [Mev-commit Testnet](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/networks/testnet.md) - [System Requirements](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/system-requirements.md) - [FAST RPC API](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/fast-rpc-api.md) - [Provider API](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/provider-api.md) - [Bidder API](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/bidder-api/bidder-api.md) - [Managing Your Bidder Deposit](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/bidder-api/bidder-deposit.md) - [Docker Container for Bidder Node](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/bidder-api/docker-bidder.md) - [Tools for Bid Submission](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/bidder-api/tools-for-bid-submission.md) - [Contracts](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/contracts.md) - [Debugging](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/debugging.md) - [Run mev-commit Chain Node](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/developers/run-mev-commit-chain-node.md) - [GetCommitmentInfo](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/getcommitmentinfo.md): GetCommitmentInfo is called by the provider to retrieve the commitment information. - [GetMinStake](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/getminstake.md): GetMinStake is called by the provider to get the minimum stake required to be in the provider registry. - [GetProviderReward](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/getproviderreward.md): GetProviderReward is called by the provider to retrieve their current reward balance without withdrawing it from the bidder registry. - [GetStake](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/getstake.md): GetStake is called by the provider to get its stake in the provider registry. - [ReceiveBids](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/receivebids.md): 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… - [SendProcessedBids](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/sendprocessedbids.md): 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. - [Stake](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/stake.md): Stake is called by the provider to register or add to its stake in the provider registry. - [Unstake](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/unstake.md): Unstake is called by the provider to request a unstake from the provider registry. - [WithdrawProviderReward](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/withdrawproviderreward.md): WithdrawProviderReward is called by the provider to withdraw their accumulated rewards from the bidder registry contract. - [WithdrawStake](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider/withdrawstake.md): WithdrawStake is called by the provider to withdraw its stake from the provider registry. - [SendBid](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/sendbid.md): 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… - [ClaimSlashedFunds](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/claimslashedfunds.md): ClaimSlashedFunds is called by the bidder to claim slashed funds from the provider. The response will show the amount claimed if any in wei. - [Deposit](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/deposit.md): Deposit is called by the bidder node to add deposit in the bidder registry, specific to a provider. - [DepositEvenly](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/depositevenly.md): DepositEvenly is called by the bidder node to deposit a total amount evenly across multiple providers. - [DepositManagerStatus](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/depositmanagerstatus.md): DepositManagerStatus is called by the bidder node to query whether the bidder has enabled the deposit manager via eip 7702. - [DisableDepositManager](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/disabledepositmanager.md): DisableDepositManager is called by the bidder node to disable the deposit manager by setting the bidder EOA's code to zero address. - [EnableDepositManager](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/enabledepositmanager.md): EnableDepositManager is called by the bidder node to enable the deposit manager via eip 7702. - [GetAllDeposits](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/getalldeposits.md): GetAllDeposits is called by the bidder to get all its deposits in the bidder registry, and the balance of the bidder EOA itself. - [GetBidInfo](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/getbidinfo.md): GetBidInfo is called by the bidder to get the bid information. If block number is not specified, all known block numbers are returned in the ascending order. - [GetDeposit](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/getdeposit.md): GetDeposit is called by the bidder to get its deposit specific to a provider in the bidder registry. - [GetValidProviders](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/getvalidproviders.md): GetValidProviders is called by the bidder node to get a list of all valid providers. Each provider returned by this RPC must: - Be "registered" in the provider registry - Have deposit >= minStake in provider registry - Have no pending withdrawal request with provider registry - Have at least one BLS… - [RequestWithdrawals](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/requestwithdrawals.md): RequestWithdrawals is called by the bidder node to request withdrawals from provider(s) - [SetTargetDeposits](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/settargetdeposits.md): SetTargetDeposits is called by the bidder node to set target deposits per provider within the deposit manager. During this call, the bidder node will also attempt to top-up deposits for each new target deposit. - [Withdraw](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder/withdraw.md): Withdraw is called by the bidder to withdraw their deposit to a provider. - [Subscribe](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/notifications/subscribe.md): Subscribe to notifications for given topics. The client will receive notifications for the topics it has subscribed to. The client can subscribe to multiple topics. - [CancelTransaction](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/debug/canceltransaction.md): CancelTransaction is called by the provider to cancel a transaction sent from this wallet. - [GetPendingTransactions](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/debug/getpendingtransactions.md): GetPendingTransactions is called by the provider to get the pending transactions for the wallet. - [GetTopology](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/debug/gettopology.md): GetTopology is called by the user to get the topology of the node. The topology includes connectivity information about the node. - [Introduction](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/introduction.md): A collection of answers to frequently asked questions. - [What is the Deposit Amount?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/what-is-deposit-amount.md): Learn about deposit amounts required for bidding and their significance. - [How do I fix the error: "failed to read msg: stream reset"?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/how-do-i-fix-the-error-failed-to-read-msg-stream-reset.md): Learn how to resolve the `failed to read msg: stream reset` error for provider nodes within the mev-commit network. - [What is Foundry?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/what-is-foundry.md): Discover what Foundry is and its role in smart contract development and interactions within the mev-commit ecosystem. - [Why is cast necessary for mev-commit chain interactions?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/why-is-cast-necessary-for-mev-commit-chain-interactions.md) - [Why do I receive the same commitment when resending a bid?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/why-do-i-receive-the-same-commitment-when-resending-a-bid.md): Understand why resending a bid in the mev-commit ecosystem results in receiving the same commitment. - [What is Execution Preconfirmations?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/what-is-execution-preconfirmations.md) - [How to Price A Bid](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/how-to-price-a-bid.md): Learn how to find the sweet spot for competitive bids. - [What Happens During An Execution Preconfirmation?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/what-happens-during-an-execution-preconf.md): Learn about what happens behind the scenes during an execution preconfirmation. - [How Do You Provide A Commitment for Execution?](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/how-do-preconfs-work.md): Learn what providers do during an execution preconfirmation. - [Eigenlayer Operator Registration](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/knowledge-base/eigenlayer-operator-registration.md): Instructions for registering as an Eigenlayer operator for the mev-commit AVS, enabling validator opt-in via restaking. ## OpenAPI Specs - [validator-openapi-spec](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/validator-openapi-spec.json) - [provider-openapi-spec](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/provider-openapi-spec.json) - [notifications-openapi-spec](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/notifications-openapi-spec.json) - [debug-openapi-spec](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/debug-openapi-spec.json) - [bidder-openapi-spec](https://primev-24-aloknerurkar-patch-7.mintlify.site/v1.2.x/api-reference/bidder-openapi-spec.json) - [openapi](https://primev-24-aloknerurkar-patch-7.mintlify.site/archived-versions/v1.0.0/api-reference/openapi.json)