{"id":13786832,"url":"https://github.com/flashbots/boost-geth-builder","last_synced_at":"2025-05-12T00:30:42.851Z","repository":{"id":38081920,"uuid":"495346350","full_name":"flashbots/boost-geth-builder","owner":"flashbots","description":"Example builder","archived":true,"fork":false,"pushed_at":"2022-10-17T18:39:58.000Z","size":173348,"stargazers_count":92,"open_issues_count":1,"forks_count":25,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-11-18T00:37:16.024Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flashbots.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null}},"created_at":"2022-05-23T09:42:44.000Z","updated_at":"2024-10-24T06:02:26.000Z","dependencies_parsed_at":"2023-01-19T15:03:51.642Z","dependency_job_id":null,"html_url":"https://github.com/flashbots/boost-geth-builder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fboost-geth-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fboost-geth-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fboost-geth-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fboost-geth-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flashbots","download_url":"https://codeload.github.com/flashbots/boost-geth-builder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253655755,"owners_count":21943068,"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-03T20:00:19.397Z","updated_at":"2025-05-12T00:30:37.836Z","avatar_url":"https://github.com/flashbots.png","language":"Go","funding_links":[],"categories":["Building Blockspace"],"sub_categories":["Various Repositories"],"readme":"[geth readme](README.original.md)\n\n# Builder API\n\nBuilder API implementing [builder spec](https://github.com/ethereum/builder-specs), making geth into a standalone block builder. \n\nRun on your favorite network.\n\nRequires `builder_payloadAttributes` update to be sent for block building, run [our Prysm fork](https://github.com/flashbots/prysm)\n\nTest with [mev-boost](https://github.com/flashbots/mev-boost) and [mev-boost test cli](https://github.com/flashbots/mev-boost/tree/main/cmd/test-cli).\n\nProvides summary page at the listening address' root (http://localhost:28545 by default).\n\n## How it works\n\n* Builder polls relay for the proposer registrations for the next epoch\n\nBuilder has two hooks into geth:\n* On forkchoice update, changing the payload attributes feeRecipient to the one registered for next slot's validator\n* On new sealed block, consuming the block as the next slot's proposed payload and submits it to the relay\n\nLocal relay is enabled by `--local_relay` and overwrites remote relay data. This is only meant for the testnets!  \n\nTo connect to a remote relay use `--builder.remote_relay_endpoint`.  \n\n## Limitations\n\n* Blocks are only built on a specialized call `builder_payloadAttributes`, see [our Prysm fork](https://github.com/flashbots/prysm)\n* Does not accept external blocks\n* Does not have payload cache, only the latest block is available\n\n## Usage\n\nConfigure geth for your network, it will become the block builder.\n\nBuilder API options:\n```\n$ geth --help\n    --builder                      (default: false)\n          Enable the builder\n   \n    --builder.beacon_endpoint value (default: \"http://127.0.0.1:5052\")\n          Beacon endpoint to connect to for beacon chain data [$BUILDER_BEACON_ENDPOINT]\n   \n    --builder.bellatrix_fork_version value (default: \"0x02000000\")\n          Bellatrix fork version. For goerli use 0x02001020\n          [$BUILDER_BELLATRIX_FORK_VERSION]\n   \n    --builder.genesis_fork_version value (default: \"0x00000000\")\n          Gensis fork version. For goerli use 0x00001020 [$BUILDER_GENESIS_FORK_VERSION]\n   \n    --builder.genesis_validators_root value (default: \"0x0000000000000000000000000000000000000000000000000000000000000000\")\n          Genesis validators root of the network. For goerli use\n          0x043db0d9a83813551ee2f33450d23797757d430911a9320530ad8a0eabc43efb\n          [$BUILDER_GENESIS_VALIDATORS_ROOT]\n   \n    --builder.listen_addr value    (default: \":28545\")\n          Listening address for builder endpoint [$BUILDER_LISTEN_ADDR]\n   \n    --builder.local_relay          (default: false)\n          Enable the local relay\n   \n    --builder.relay_secret_key value (default: \"0x2fc12ae741f29701f8e30f5de6350766c020cb80768a0ff01e6838ffd2431e11\")\n          Builder local relay API key used for signing headers [$BUILDER_RELAY_SECRET_KEY]\n   \n    --builder.remote_relay_endpoint value\n          Relay endpoint to connect to for validator registration data, if not provided\n          will expose validator registration locally [$BUILDER_REMOTE_RELAY_ENDPOINT]\n   \n    --builder.secret_key value     (default: \"0x2fc12ae741f29701f8e30f5de6350766c020cb80768a0ff01e6838ffd2431e11\")\n          Builder key used for signing blocks [$BUILDER_SECRET_KEY]\n   \n    --builder.validator_checks     (default: false)\n          Enable the validator checks\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fboost-geth-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflashbots%2Fboost-geth-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fboost-geth-builder/lists"}