{"id":13685594,"url":"https://github.com/ralexstokes/mev-rs","last_synced_at":"2026-01-20T00:39:05.121Z","repository":{"id":38339783,"uuid":"489400079","full_name":"ralexstokes/mev-rs","owner":"ralexstokes","description":"a gateway to a network of block builders","archived":false,"fork":false,"pushed_at":"2024-10-24T22:02:49.000Z","size":1664,"stargazers_count":436,"open_issues_count":39,"forks_count":76,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-03-31T22:23:26.300Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ralexstokes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-06T15:12:39.000Z","updated_at":"2025-03-30T23:52:14.000Z","dependencies_parsed_at":"2023-02-15T09:30:53.835Z","dependency_job_id":"4f6e78e9-bc4d-41af-a5ca-dcb329381300","html_url":"https://github.com/ralexstokes/mev-rs","commit_stats":{"total_commits":536,"total_committers":14,"mean_commits":"38.285714285714285","dds":"0.16417910447761197","last_synced_commit":"d18e896e4646ee6dc18b5f886d33899b36361f65"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralexstokes%2Fmev-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralexstokes%2Fmev-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralexstokes%2Fmev-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralexstokes%2Fmev-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ralexstokes","download_url":"https://codeload.github.com/ralexstokes/mev-rs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247744335,"owners_count":20988783,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T14:00:54.290Z","updated_at":"2026-01-20T00:39:05.081Z","avatar_url":"https://github.com/ralexstokes.png","language":"Rust","funding_links":[],"categories":["Uncategorized","Building Blockspace"],"sub_categories":["Uncategorized","Various Repositories"],"readme":"# mev-rs\n\n[![build](https://github.com/ralexstokes/mev-rs/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/ralexstokes/mev-rs/actions/workflows/ci.yml)\n\n(experimental) utilities for block space.\n\n# About\n\n`mev-rs` bundles a series of utilities for interacting with an external builder network.\n\n# 🚧 WARNING 🚧\n\nThis project is currently experimental and subject to frequent changes as we are still working on stabilizing the builder specs.\n\nIt has not been audited for security purposes and should not be used in production yet.\n\n# Status\n\nImplements `v0.3.0` of the [`builder-specs`](https://github.com/ethereum/builder-specs) for the `boost` component.\n\n# Requirements\n\nYou need a recent Rust toolchain to get started.\n\nIf you don't have one already, check out: https://www.rust-lang.org/tools/install\n\nOnce you do that, you can just use `cargo` as specified below.\n\n# How to use\n\n`mev-rs` builds a command line utility with a series of subcommands.\n\n## Subcommands\n\n### 🚀 `boost`\n\nruns a builder multiplexer, a gateway for validators to connect to a network of block builders.\n\nthe binary takes a path to a configuration file as a command line argument.\n\nthis argument can also be provided as an environment variable `CONFIG_FILE=$FILE`.\n\nan example configuration file is provided at `example.config.toml`.\n\n#### how to run\n\nto run the multiplexer, you have the following options:\n\n##### run natively\n\njust run with `cargo`:\n\n`$ cargo run boost example.config.toml`\n\n##### run with docker\n\nyou can build the image defined in the `Dockerfile`:\n\n`$ docker build -t mev-rs .`\n\nand then run as usual.\n\nto supply the config, mount your local file into the container (e.g. at `/config.toml`) and either use the environment\nvariable setting or provide the path in the container as a trailing argument:\n\n`$ docker \u003cother options\u003e --env CONFIG_FILE=/path/to/config.toml mev-rs boost`\n\nor\n\n`$ docker \u003cother options\u003e mev-rs boost /config.toml`\n\n### 🏗 `relay`\n\nruns a builder relay.\n\nthe configuration works the same way as with `boost`.\n\nthere is an option to run a \"mock\" relay:\n\n`$ cargo run relay mock example.config.toml`\n\n# Testing\n\n`cargo test` to run the tests.\n\n# Contributing\n\nContributions are welcome!\n\nPlease submit a PR to this repo to contribute.\n\nYou can run the CI locally to see what is required to pass.\n\nFor convenience, the flow is defined in the top-level `justfile`.\n\nTo run, `just run-ci`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralexstokes%2Fmev-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fralexstokes%2Fmev-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralexstokes%2Fmev-rs/lists"}