Providers
Getting builder-boost Running In Production
Get builder-boost up and running in production using the below details
Running builder-boost
builder-boost is a software sidecar module that facilitates a provider’s participation in the Primev network. The diagram below outlines the module’s position within a provider's local environment.
builder-boost Diagram

Prerequisites
- golang version 1.20.4+
- Updated builder with Primev relay enabled
- Git
Setting Up builder-boost
Step 1. Ensure your builder is able to send payloads to builder-boost
Begin by reviewing the Builder Reference Implementation instructions provided here. After performing the necessary modifications, you can proceed to set up Builder Boost to receive block templates from your builder.
Step 2. Download builder-boost via GitHub
For now, simply do a Git clone:
Step 3. Build the builder-boost instance
You should now see two binaries built in the root folder:
Step 4. Run builder-boost
We highly recommend you use systemctl
to run builder-boost. The following is a recommended systemctl
file that can be used and placed in your /home/systemd/system/<filename>
folder.
Note that the BUILDER_AUTH_TOKEN
should be set to the same value set for --builder-auth-key
in your modified builder implementation. This token is used to authenticate your builders to Boost, ensuring no threat actor can send false payloads.
Running Builder and Searcher in Docker Compose
- Copy
.env.example
to.env
and set the required variables. - Run
docker-compose up --build
to run Builder and Searcher connected to Builder Boost.
More Links
Searcher Testing Guide - This guide walks you through the setup process for connecting searcher emulators to your Boost for end-to-end testing and monitoring.
Builder Modifications - A detailed walkthrough with example commits to modify a builder, add the Primev relay, and enable Boost.
FAQ
Where do I run this?
We recommend you run this on a standalone server. This means if you’re running it in a Cloud Environment, ensure you do not share CPU and other core resources with others.
How many instances of builder-boost should I run?
Currently you can only run a single instance of builder-boost. We will release an update that will allow builders to run multiple builder-boost instances in the future. The stateful nature of open connections between searchers and builders creates a restriction in the current version.
How secure and private is my block template when it’s sent to builder-boost?
Confidentiality
A key reason of builder-boost's architecture as a sidecar module in the builder’s own environment is to ensure the privacy of block templates and the underlying bundle & transaction data, and having the provider have ultimate control over what's being shared and how.
Integrity
To ensure the integrity of the payloads that are being constructed we’ve implemented a shared secret authentication between the builder and the builder-boost instance. As long as the the Builder constructs a secure password and keeps it secret, the setup gives strong assurances over the integrity of the payloads being published and the metadata being sent to searchers.

Availability Provisions
Staleness of the payloads is the key considerations when considering the payload being sent to searchers. We recommend setting up some forms of DDOS protection offered by Cloudflare to ensure you