> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monad.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# v0.12.3

<Warning>
  在 Monad 基金会发出通知之前，请不要执行此操作。
</Warning>

## 节点运营者操作说明

### 1. 以 `monad` 用户身份 SSH 登录节点

### 2. 升级 monad 软件包

<Tabs>
  <Tab title="Mainnet">
    ```bash theme={null}
    sudo apt update && sudo apt install --reinstall monad=0.12.3 -y --allow-downgrades --allow-change-held-packages
    ```
  </Tab>

  <Tab title="Testnet">
    ```bash theme={null}
    sudo apt update && sudo apt install --reinstall monad=0.12.3~rc.2 -y --allow-downgrades --allow-change-held-packages
    ```
  </Tab>
</Tabs>

### 3. 重启服务并验证

```bash theme={null}
sudo systemctl restart monad-bft monad-execution monad-rpc
sudo systemctl status monad-bft monad-execution monad-rpc --no-pager -l
```

预期输出：所有服务应显示 `Active: active (running)`

### 4. 验证运行的版本正确

```bash theme={null}
monad-rpc --version
```

预期输出：

<Tabs>
  <Tab title="Mainnet">
    ```json theme={null}
    monad-rpc {"commit":"6323f3fcaf067c18884e3ffe72a22fb1a8d0216a","tag":"v0.12.3","branch":"","modified":true}
    ```
  </Tab>

  <Tab title="Testnet">
    ```json theme={null}
    monad-rpc {"commit":"6323f3fcaf067c18884e3ffe72a22fb1a8d0216a","tag":"","branch":"","modified":true}
    ```
  </Tab>
</Tabs>

## 补丁说明

请参考 [`v0.12.3`](/zh/developer-essentials/changelog/releases#v0-12-3) 的公开变更日志。

### 面向节点运营者的重要更新

* **\[Node ops]** 为 `monad-mpt` 添加 `--root-offsets-chunk-count` 标志，用于配置为根偏移量分配的块数
  * 每个块可容纳约 1650 万个区块。以前，所有节点都硬编码使用 2 个块（TrieDB 最大容量约 3300 万个区块）
  * 新默认值：16，**必须是 2 的幂**
  * 请注意，默认值 16 转换为大约 2.68 亿个区块 \~ 1240 天。在大多数情况下，限制因素是磁盘容量，当填充到 80% 时将自动压缩
  * 参考：[monad PR #1937](https://github.com/category-labs/monad/pull/1937)
* **\[RPC / Node ops]** 允许 RPC 在没有 `monad-bft` 的情况下运行
  * 支持独立的 RPC 操作，提高部署灵活性
  * 参考：[monad-bft PR #2613](https://github.com/category-labs/monad-bft/pull/2613)
* **\[RPC]** [EIP-7966](https://eips.ethereum.org/EIPS/eip-7966) (`eth_sendRawTransactionSync`) 支持
  * 参考：[monad-bft PR #2542](https://github.com/category-labs/monad-bft/pull/2542)
* **\[Node ops / Archive]** 归档基础设施改进
  * 重构 `monad-block-writer` 以通过 `--max-blocks-per-iter` 配置提高可靠性
  * 使用仅追踪归档支持的异步回填
  * 添加 `require-traces` 归档器标志和索引器回退源
  * 支持使用通用目录归档的历史执行事件归档
  * **潜在破坏性变更：从 `monad-archiver` systemd 服务中删除 `--start-block`；运营者必须使用命令式 CLI 设置起始区块**
    * 示例：`monad-archiver set-start-block --block 1000000 --archive-sink s3://bucket-name/path`
    * 使用 `--async-backfill` 标志设置异步回填标记，而不是主标记
  * 参考：[monad-bft PR #2610](https://github.com/category-labs/monad-bft/pull/2610), [monad-bft PR #2606](https://github.com/category-labs/monad-bft/pull/2606), [monad-bft PR #2598](https://github.com/category-labs/monad-bft/pull/2598), [monad-bft PR #2514](https://github.com/category-labs/monad-bft/pull/2514), [monad-bft PR #2612](https://github.com/category-labs/monad-bft/pull/2612), [monad-bft PR #2569](https://github.com/category-labs/monad-bft/pull/2569), [monad-bft PR #2623](https://github.com/category-labs/monad-bft/pull/2623)
* **\[Node ops]** 网络配置更新
  * 使用默认 MTU 1500
  * 在 `monad-executor` 和 `monad-raptorcast` 中添加用于广播延迟跟踪的 HDR 直方图
  * 参考：[monad-bft PR #2576](https://github.com/category-labs/monad-bft/pull/2576), [monad-bft PR #2602](https://github.com/category-labs/monad-bft/pull/2602)
* **\[Consensus]** *可选加入* UDP 的线路认证协议
  * 节点运营者的操作说明将在未来提供
  * 包括为提高可靠性的重放窗口调整
  * 参考：[monad-bft PR #2417](https://github.com/category-labs/monad-bft/pull/2417), [monad-bft PR #2544](https://github.com/category-labs/monad-bft/pull/2544), [monad-bft PR #2626](https://github.com/category-labs/monad-bft/pull/2626), [monad-bft PR #2091](https://github.com/category-labs/monad-bft/pull/2091)