Besu Deposit合约地址事后分析

对规范变更以及导致 Holesky 和 Sepolia 遗漏 DEPOSIT_CONTRACT_ADDRESS 的 Besu 代码库演变的分析。

这最终导致了 Holesky 上的超多数链分裂，因为 Geth 和 Nethermind 也有类似的错误：https://github.com/ethereum/pm/blob/master/Pectra/holesky-postmortem.md

本次事后分析的目的不是为了指责，而是为了帮助我们理解如何避免未来出现类似的问题。

潜在的影响因素

总体

• 与主网相比，测试网对 DEPOSIT_CONTRACT_ADDRESS 使用不同的值
• https://eips.ethereum.org/EIPS/eip-6110#configuration 不包括测试网合约地址
• 与 CL 不同，EL 配置文件因客户端而异
• 与 CL 不同，EL 配置不被视为规范的一部分
  • https://github.com/eth-clients/holesky 没有在任何 EL 配置中包含 depositContractAddress
  • https://github.com/eth-clients/sepolia 仅在 genesis.json 中包含 depositContractAddress；不包含在 besu.json 或 chainspec.json 中
• 无法验证客户端之间的合约配置

Besu 特有

• 如果配置中不存在，Besu 默认使用主网地址
• Besu 对自动化测试使用自定义 genesis 配置，而不是加载公共测试网配置
• 多个 PR 作者/审查者横跨近 3 年 - 没有单个 Besu 开发人员支持该功能

经验教训

• 不要依赖默认值，而应提前失败
  • https://github.com/hyperledger/besu/issues/8367
  • https://github.com/jflo/besu/tree/failFastOnUndefinedSystemContract
• 采用 eth_config https://hackmd.io/@shemnon/eth_config
  • https://github.com/hyperledger/besu/pull/8417
• 在 EL 之间使用共享配置 ( eth_config 无论如何都可以缓解这个问题)
  • https://github.com/hyperledger/besu/issues/7273
  • 共享配置可以用作 fork 规范的一部分

时间线

2020 年 10 月

https://eth2book.info/capella/part2/deposits-withdrawals/contract/

存款合约于 2020 年 10 月 14 日 UTC 时间 09:22:52 部署到以太坊地址

0x00000000219ab540356cbb839cbe05303d7705fa。

2021 年 10 月

https://github.com/eth-clients/sepolia/

Sepolia 启动（没有存款合约）

2022 年 6 月

Sepolia 存款合约于 Jun-09-2022 02:58:14 PM UTC 部署到 0x7f02C3E3c98b133055B8B348B2Ac625669Ed295D

2022 年 12 月

https://github.com/ethereum/EIPs/pull/6110

初始规范仅包含主网 DEPOSIT_CONTRACT_ADDRESS

此时 Sepolia 存款合约已存在，但 Holesky 网络不存在。

在撰写本文时（2025 年 3 月），规范仍仅包含主网 DEPOSIT_CONTRACT_ADDRESS

2023 年 6 月

https://github.com/hyperledger/besu/pull/5295 (EIP-6110：添加存款验证和 API)

• 添加了 DEFAULT_DEPOSIT_CONTRACT_ADDRESS：

  public static final Address DEFAULT_DEPOSIT_CONTRACT_ADDRESS =
      Address.fromHexString("0x00000000219ab540356cbb839cbe05303d7705fa");

• 为“实验性 EIP fork”连接，尚未为 Prague 连接：

final Address depositContractAddress =
        genesisConfigOptions.getDepositContractAddress().orElse(DEFAULT_DEPOSIT_CONTRACT_ADDRESS);

• 省略了主网的显式 genesis 配置 - 这不是错误，因为将使用默认值。
• 省略了 Sepolia 的显式 genesis 配置 - 如果 Sepolia 在 Holesky 之前通过 Pectra，这将是一个错误。
• 还没有 Holesky，无法添加配置！
• 显式 genesis 配置已作为自定义测试 genesis 文件的一部分添加。

2023 年 9 月

https://github.com/eth-clients/holesky

Holesky 启动，DEPOSIT_CONTRACT_ADDRESS 在 genesis 中预部署到

0x4242424242424242424242424242424242424242

Besu 没有将 depositContractAddress 添加到 EIP-6110 将使用的 Holesky 配置中（主网、Sepolia 或 Goerli 也没有）。

2024 年 3 月

http://github.com/hyperledger/besu/pull/6783 (添加 engine_getPayloadV4 和 engine_newPayloadV4)

• 为 Prague fork 连接了 DEFAULT_DEPOSIT_CONTRACT_ADDRESS

final Address depositContractAddress =
        genesisConfigOptions.getDepositContractAddress().orElse(DEFAULT_DEPOSIT_CONTRACT_ADDRESS);

2024 年 5 月 - 2024 年 10 月

各种人通过各种 PR（实现各种规范更改）重构了 DEFAULT_DEPOSIT_CONTRACT_ADDRESS 的位置和连接/加载代码。

这些重构对根本原因没有重大影响，但可能会削弱对系统的知识和理解。

https://github.com/hyperledger/besu/pull/7068 (EIP-7685 通用执行层请求)

https://github.com/hyperledger/besu/pull/7647 (在 jsonGenesisConfig 中添加 consolidationRequestContract)

https://github.com/hyperledger/besu/pull/7771 (更改请求以使用平面编码)

• 原文链接： hackmd.io/@siladu/H1qydm...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～