MEV-Boost 中继

用于以太坊提议者/构建者分离（PBS）的 MEV-Boost 中继。

目前在以下地址运行：

boost-relay.flashbots.net（也在 Goerli、Sepolia 和 Holesky 上运行）
relay.ultrasound.money、agnostic-relay.net、bloXroute 中继（轻量分叉）
mainnet.aestus.live、relay.edennetwork.io/info、mainnet-relay.securerpc.com

替代方案（未经审核或认可）：blocknative/dreamboat、manifold/mev-freelay

另请参阅

组件

中继由三个主要组件组成，这些组件设计为独立运行和扩展，并尽可能简单：

API：为 (a) 提议者、(b) 区块构建者、(c) 数据提供 API 服务。
网站：处理网站请求（信息从 Redis 和数据库中获取）。
管理员：在后台更新已知验证者、提议者职责等。此组件应只运行一个实例。

依赖项

Redis
PostgreSQL
一个或多个信标节点
区块提交验证节点
[可选] Memcached

信标节点 / CL 客户端

中继服务需要访问一个或多个信标节点以订阅事件（特别是 head 和 payload_attributes 主题）。
您可以通过提供以逗号分隔的信标节点 URI 列表来指定多个信标节点。
信标节点需要支持 payload_attributes SSE 事件。
自 8 月 2 日起，当前主分支支持 v2 CL 发布区块端点。这仍是实验性的，可能无法完全正常工作。它至少需要以下 CL 客户端之一：
- Lighthouse+ v4.3.0 或更高版本。这里有一个快速设置指南。
- Prysm v4.0.6 或更高版本。
最新发布版本（v0.26）仍使用旧的 V1 广播端点，使用带有自定义验证前广播补丁的 CL 客户端（详见发布版本的 README）

强烈建议中继运行多个信标节点！

原因是在 getPayload 时，区块必须在返回给提议者之前由本地信标节点验证和广播。
如果本地信标节点不接受它（例如因为节点宕机），区块将不会返回给提议者，导致提议者错过该时隙。
中继同时向所有信标节点发出验证+广播请求，并在第一个请求成功后立即返回。

安全性

2022 年 8 月 22 日，lotusbumi 对中继进行了安全评估。更多信息可以在本仓库的 Security 部分找到。

如果您在此项目或任何与 Flashbots 相关的倡议中发现安全漏洞，请发送电子邮件至 security@flashbots.net 告知我们。

背景

MEV 是以太坊上的一种中心化力量。如果不加以处理，对 MEV 机会的竞争会导致共识安全不稳定，以及交易者和区块生产者之间的许可通信基础设施。这会侵蚀中立性、透明度、去中心化和无许可性。

Flashbots 是一个致力于缓解 MEV 负面外部性的研究和开发组织。Flashbots 最初是一个专门从事工作量证明以太坊 MEV 提取的构建者，目的是使所有矿工都能获得 MEV 并提供最有利可图的区块。如今，超过 90% 的矿工将部分区块构建外包给 Flashbots。

mev-boost 中继是区块生产者和区块构建者之间的可信中介。它使所有以太坊权益证明验证者能够将其区块空间提供给 Flashbots 以及其他构建者。这为更多构建者打开了市场，并在它们之间创造了竞争，从而为验证者带来更多收入和选择，并为以太坊提供更好的抗审查能力。

未来，提议者/构建者分离将被纳入以太坊协议本身，以进一步加强其信任模型。

在为什么要运行 mev-boost？和常见问题中阅读更多信息。

使用方法

运行 Postgres、Redis 和 Memcached

# 单独启动 PostgreSQL 和 Redis：
docker run -d -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=postgres postgres
docker run -d -p 6379:6379 redis

# [可选] 启动 Memcached
docker run -d -p 11211:11211 memcached

# 或使用 docker-compose：
docker-compose up

注意：docker-compose 还在 http://localhost:8093/?username=postgres 上运行 Adminer（Postgres 的 Web 前端）（数据库：postgres，用户名：postgres，密码：postgres）

现在启动服务：

# 管理员设置验证者，并执行各种管理任务
go run . housekeeper --network sepolia --db postgres://postgres:postgres@localhost:5432/postgres?sslmode=disable

# 为 sepolia 运行 API（使用虚拟 BLS 密钥）
go run . api --network sepolia --secret-key 0x607a11b45a7219cc61a3d9c5fd08c7eebd602a6a19a977f8d3771d5711a550f2 --db postgres://postgres:postgres@localhost:5432/postgres?sslmode=disable

# 为 sepolia 运行网站
go run . website --network sepolia --db postgres://postgres:postgres@localhost:5432/postgres?sslmode=disable

查询状态

curl localhost:9062/eth/v1/builder/status

发送测试验证者注册

curl -X POST -H'Content-Encoding: gzip' localhost:9062/eth/v1/builder/validators --data-binary @testdata/valreg2.json.gz

删除之前的注册

redis-cli DEL boost-relay/sepolia:validators-registration boost-relay/sepolia:validators-registration-timestamp


## 环境变量

#### 通用

* `ACTIVE_VALIDATOR_HOURS` - 在Redis中追踪活跃提议者的小时数（默认：`3`）
* `API_MAX_HEADER_BYTES` - HTTP最大头部字节数（默认：`60_000`）
* `API_TIMEOUT_READ_MS` - HTTP读取超时时间（毫秒）（默认：`1_500`）
* `API_TIMEOUT_READHEADER_MS` - HTTP读取头部超时时间（毫秒）（默认：`600`）
* `API_TIMEOUT_WRITE_MS` - HTTP写入超时时间（毫秒）（默认：`10_000`）
* `API_TIMEOUT_IDLE_MS` - HTTP空闲超时时间（毫秒）（默认：`3_000`）
* `API_SHUTDOWN_WAIT_SEC` - 关闭时等待多长时间以允许请求耗尽（默认：`30`）
* `API_SHUTDOWN_STOP_SENDING_BIDS` - API是否在关闭期间停止发送出价（仅在单实例/测试网设置中有用，默认：`false`）
* `BLOCKSIM_MAX_CONCURRENT` - 最大并发区块模拟请求数（0表示无限制，默认：`4`）
* `BLOCKSIM_TIMEOUT_MS` - 构建者区块提交验证请求超时时间（默认：`3000`）
* `BROADCAST_MODE` - 用于区块发布的广播模式（默认：`consensus_and_equivocation`）
* `DB_DONT_APPLY_SCHEMA` - 禁用启动时应用数据库架构（对连接到只读副本的数据API有用）
* `DB_TABLE_PREFIX` - 用于数据库表的前缀（默认使用`dev`）
* `GETPAYLOAD_RETRY_TIMEOUT_MS` - 如果第一次尝试失败，getPayload重试获取有效载荷的超时时间（默认：`100`）
* `MEMCACHED_URIS` - 可选的memcached端点列表，通常用作Redis的二级存储
* `MEMCACHED_EXPIRY_SECONDS` - 使用memcache时的项目过期超时（默认：`45`）
* `MEMCACHED_CLIENT_TIMEOUT_MS` - 客户端超时时间（毫秒）（默认：`250`）
* `MEMCACHED_MAX_IDLE_CONNS` - 客户端最大空闲连接数（默认：`10`）
* `NUM_ACTIVE_VALIDATOR_PROCESSORS` - 提议者API - 监听活跃验证者通道的goroutine数量
* `NUM_VALIDATOR_REG_PROCESSORS` - 提议者API - 监听验证者注册通道的goroutine数量
* `NO_HEADER_USERAGENTS` - 提议者API - 不应返回出价的用户代理列表（逗号分隔）
* `ENABLE_BUILDER_CANCELLATIONS` - 是否启用区块构建者取消功能
* `REDIS_URI` - 主Redis URI（默认：`localhost:6379`）
* `REDIS_READONLY_URI` - 可选，用于重度读取操作的二级Redis实例

#### 功能标志

* `DISABLE_PAYLOAD_DATABASE_STORAGE` - 构建者API - 禁用在数据库中存储执行有效载荷（例如，当使用memcached作为数据可用性冗余时）
* `DISABLE_LOWPRIO_BUILDERS` - 拒绝低优先级构建者的区块提交
* `FORCE_GET_HEADER_204` - 强制使用204作为getHeader响应
* `ENABLE_IGNORABLE_VALIDATION_ERRORS` - 启用可忽略的验证错误
* `USE_V1_PUBLISH_BLOCK_ENDPOINT` - 在信标节点上使用v1发布区块端点
* `USE_SSZ_ENCODING_PUBLISH_BLOCK` - 对发布区块端点使用SSZ编码

#### 开发环境变量

* `RUN_DB_TESTS` - 设置为"1"时启用与Postgres的集成测试，使用环境变量`TEST_DB_DSN`指定的端点
* `RUN_INTEGRATION_TESTS` - 设置为"1"时启用集成测试，目前用于测试Memcached，使用`MEMCACHED_URIS`指定的逗号分隔端点列表
* `TEST_DB_DSN` - 使用数据源名称（DSN）指定Postgres的连接字符串（默认：postgres://postgres:postgres@localhost:5432/postgres?sslmode=disable）

#### Redis调优

* `REDIS_CONNECTION_POOL_SIZE`, `REDIS_MIN_IDLE_CONNECTIONS`, `REDIS_READ_TIMEOUT_SEC`, `REDIS_POOL_TIMEOUT_SEC`, `REDIS_WRITE_TIMEOUT_SEC`（另见[此处的代码](https://github.com/flashbots/mev-boost-relay/blob/e39cd38010de26bf9a51d1a3e77fc235ea87b12f/datastore/redis.go#L35-L41)）

#### 网站

* `LINK_BEACONCHAIN` - beaconcha.in的URL（默认：`https://beaconcha.in`）
* `LINK_DATA_API` - 数据API的源URL（https://domain:port）
* `LINK_ETHERSCAN` - etherscan的URL（默认：`https://etherscan.io`）
* `LISTEN_ADDR` - Web服务器的监听地址（默认：`localhost:9060`）
* `RELAY_URL` - 中继的完整URL（https://pubkey@host）
* `SHOW_CONFIG_DETAILS` - 设置为"1"时，记录配置详情

## 更新网站

* 编辑`services/website/website.html`中的HTML
* 编辑`testdata/website-htmldata.json`中的模板值
* 使用`go run scripts/website-staticgen/main.go`生成网站的静态版本

这将构建模板的本地副本并将其保存在`website-index.html`中

网站使用：
* [PureCSS](https://purecss.io/)
* [HeroIcons](https://heroicons.com/)

---

# 技术说明

有关更多技术细节，请参阅[ARCHITECTURE.md](ARCHITECTURE.md)和[大规模运行MEV-Boost-Relay](https://flashbots.notion.site/Draft-Running-a-relay-4040ccd5186c425d9a860cbb29bbfe09)！

## 存储执行有效载荷和冗余数据可用性

默认情况下，所有区块提交的执行有效载荷都存储在Redis和Postgres数据库中，以为getPayload响应提供冗余数据可用性。但数据库表不会自动清理，因为重建索引需要大量资源（更好的选择是使用`TRUNCATE`）。

将所有有效载荷存储在数据库中可能会导致该特定表中的数据量达到数TB。现在也可以使用memcached作为第二个数据可用性层。使用memcached是可选的，默认情况下是禁用的。

要启用memcached，只需通过环境变量（例如`MEMCACHED_URIS=localhost:11211`）或命令行标志（`--memcached-uris`）提供memcached URI即可。

您可以使用此环境变量禁用在数据库中存储执行有效载荷：`DISABLE_PAYLOAD_DATABASE_STORAGE=1`。

## 构建者提交验证节点

您可以使用[构建者项目](https://github.com/flashbots/builder)来验证区块构建者提交：https://github.com/flashbots/builder

以下是一个systemd配置示例：

<details>
<summary><code>/etc/systemd/system/geth.service</code></summary>

```ini
[Unit]
Description=mev-boost
Wants=network-online.target
After=network-online.target

[Service]
User=ubuntu
Group=ubuntu
Environment=HOME=/home/ubuntu
Type=simple
KillMode=mixed
KillSignal=SIGINT
TimeoutStopSec=90
Restart=on-failure
RestartSec=10s
ExecStart=/home/ubuntu/builder/build/bin/geth \
    --syncmode=snap \
    --datadir /var/lib/goethereum \
    --metrics \
    --metrics.expensive \
    --http \
    --http.api="engine,eth,web3,net,debug,flashbots" \
    --http.corsdomain "*" \
    --http.addr "0.0.0.0" \
    --http.port 8545 \
    --http.vhosts '*' \
    --ws \
    --ws.api="engine,eth,web3,net,debug" \
    --ws.addr 0.0.0.0 \
    --ws.port 8546 \
    --ws.api engine,eth,net,web3 \
    --ws.origins '*' \
    --graphql \
    --graphql.corsdomain '*' \
    --graphql.vhosts '*' \
    --authrpc.addr="0.0.0.0" \
    --authrpc.jwtsecret=/var/lib/goethereum/jwtsecret \
    --authrpc.vhosts '*' \
    --cache=8192

[Install]
WantedBy=multi-user.target

</details>

向验证节点发送区块：

内置的 blocksim-ratelimiter 是一个简单的队列实现示例。
默认情况下，BLOCKSIM_MAX_CONCURRENT 设置为 4，允许每个 API 节点同时进行 4 个区块模拟。
对于生产环境使用，请使用 prio-load-balancer 项目来实现单一优先级队列，并禁用内部并发限制（将 BLOCKSIM_MAX_CONCURRENT 设置为 0）。

信标节点设置

Lighthouse

带有广播前验证和等价性检查的 Lighthouse：https://github.com/sigp/lighthouse/pull/4168
使用 --always-prepare-payload 和 --prepare-payload-lookahead 12000 标志，以及一些无用的 feeRecipient

这里有一个快速指南用于设置 Lighthouse。

以下是一个 Lighthouse systemd 配置示例：

<details> <summary><code>/etc/systemd/system/lighthouse.service</code></summary>

[Unit]
Description=Lighthouse
After=network.target
Wants=network.target

[Service]
User=ubuntu
Group=ubuntu
Type=simple
Restart=always
RestartSec=5
TimeoutStopSec=180
ExecStart=/home/ubuntu/.cargo/bin/lighthouse bn \
        --network mainnet \
        --checkpoint-sync-url=https://mainnet-checkpoint-sync.attestant.io \
        --eth1 \
        --http \
        --http-address "0.0.0.0" \
        --http-port 3500 \
        --datadir=/mnt/data/lighthouse \
        --http-allow-sync-stalled \
        --execution-endpoints=http://localhost:8551 \
        --jwt-secrets=/var/lib/goethereum/jwtsecret \
        --disable-deposit-contract-sync \
        --always-prepare-payload \
        --prepare-payload-lookahead 12000

[Install]
WantedBy=default.target

</details>

Prysm

带有广播前验证和等价性检查的 Prysm：https://github.com/prysmaticlabs/prysm/pull/12335
使用 --grpc-max-msg-size 104857600，因为默认情况下 getAllValidators 响应过大而失败

以下是一个 Prysm systemd 配置示例：

<details> <summary><code>/etc/systemd/system/prysm.service</code></summary>

[Unit]
Description=Prysm
After=network.target
Wants=network.target

[Service]
User=ubuntu
Group=ubuntu
Type=simple
Restart=always
RestartSec=5
TimeoutStopSec=180
ExecStart=/home/ubuntu/prysm/bazel-bin/cmd/beacon-chain/beacon-chain_/beacon-chain \
        --accept-terms-of-use \
        --enable-debug-rpc-endpoints \
        --checkpoint-sync-url=https://mainnet-checkpoint-sync.attestant.io \
        --genesis-beacon-api-url=https://mainnet-checkpoint-sync.attestant.io \
        --grpc-gateway-host "0.0.0.0" \
        --datadir=/mnt/data/prysm \
        --p2p-max-peers 100 \
        --execution-endpoint=http://localhost:8551 \
        --jwt-secret=/var/lib/goethereum/jwtsecret \
        --min-sync-peers=1 \
        --grpc-max-msg-size 104857600 \
        --prepare-all-payloads \
        --disable-reorg-late-blocks

[Install]
WantedBy=default.target

</details>

出价取消

区块构建者可以通过向 /relay/v1/builder/blocks?cancellations=1 提交区块来选择取消功能。这可能会导致性能损失（即提交验证耗时显著增加）。更多信息请参见 https://github.com/flashbots/mev-boost-relay/issues/348