About

This repository provides a user friendly CLI interface for making preconfirmation bids from mev-commit for ETH transfers or blob transactions and aims to support different types of transactions such as bridging in the future. Additionally a bidder can spin up the docker container and run directly with the example bidder node docker

Transactions are sent directly to the builder as transaction payloads. Currently a fixed priority fee is used alongside a preconf bid amount.

If you're an advanced user, you can still skip the interactive mode by specifying all configurations via environment variables, .env files, or command-line flags. The CLI is meant to work out of the box for Holesky. For Mainnet, add mainnet websocket.

Requirements

• funded L1 address
• funded mev-commit address
• mev-commit p2p bidder node
• a good websocket endpoint (a publicly available one is set as default for Holesky, but cannot handle high throughput)

Installation

git clone https://github.com/primev/preconf_bot_example.git
cd preconf_blob_bidder

Then go mod tiny to install dependencies.

.env variables

Ensure that the .env file is filled out with all of the variables.

RPC_ENDPOINT=rpc_endpoint                   # RPC endpoint when use-payload is false (optional)
WS_ENDPOINT=ws_endpoint                     # WebSocket endpoint for transactions (Default wss://ethereum-holesky-rpc.publicnode.com)
PRIVATE_KEY=private_key                     # Private key for signing transactions
USE_PAYLOAD=true                            # Use payload for transactions (Default true)
SERVER_ADDRESS=localhost:13524              # Address of the server (Default localhost:13524)
OFFSET=1                                    # Offset is how many blocks ahead to bid for the preconf transaction (Default 1)
NUM_BLOB=0                                  # Number of blobs to send (0 for ETH transfer) (Default 0)
BID_AMOUNT=0.001                            # Amount to bid in ETH (Default 0.001)
PRIORITY_FEE=1                              # Priority fee in wei (Default 1)
BID_AMOUNT_STD_DEV_PERCENTAGE=100           # Standard deviation percentage for bid amount (Default 100.0)
DEFAULT_TIMEOUT=15                          # Default timeout in seconds (Default 15)
RUN_DURATION_MINUTES=0                      # Duration to run the bidder in minutes (0 to run indefinitely) (Default 0)
APP_NAME=preconf_bidder                     # Application name, for logging purposes (Default preconf_bidder)
VERSION=0.8.0                              # mev-commit version, for logging purposes (Default 0.8.0)

Ensure Bidder Node is Running

Ensure that the mev-commit bidder node is running in the background and the autodeposit function deposited ETH into the bidder window. A quickstart can be found here, which will get the latest mev-commit version and start running it with an auto generated private key.

CLI

First build the CLI go build -o biddercli .

Then run the CLI ./biddercli. Flags can be passed to quickstart the process and override default variables, otherwise follow the prompts to get started.

Docker

Build the docker with sudo docker-compose up --build. Best run with the dockerized bidder node example

Linting

Run linting with golangci-lint run ./... inside the repository folder

Testing

Run go test -v ./... in the main folder directory to run all the tests.