> ## 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.16.2 升级说明

<Warning>
  这些说明仅适用于**测试网**。**主网**可忽略。
</Warning>

## 升级说明

`v0.16.2` 未对 `node.toml` 配置引入破坏性变更。

### MONAD\_TEN 已激活

MONAD\_TEN(MIP-8,页编码存储)在主网上已随 v0.16.1 于时间戳 `1788359400`(2026-09-02 14:30 UTC)激活。v0.16.2 沿用相同激活。

<Warning>
  **切勿从携带分叉的版本回退。** 早于 v0.16.1 的版本在激活时间戳之后仍会应用 MONAD\_NINE 规则,并会与网络产生分歧。
</Warning>

### 仍需要页编码时间线

与 v0.16.1 一致,主网或测试网节点必须提供页编码的主时间线(阶段 C)或活跃的次时间线(阶段 A/B 双数据库),否则将在启动时中止,并出现:

```
live monad requires a page-encoded timeline (as primary or secondary) on monad_mainnet; primary_is_page=0 secondary_active=0
```

如果您从 v0.16.1 升级,这一条件已满足。如果您从 v0.16.0 或更早版本升级,请先完成[阶段 A 迁移](/zh/node-ops/upgrade-instructions/page-storage-mip-8-migration#phase-a-page-activation)。

### 从源代码构建

v0.16.2 在构建时需要系统包 `libsecp256k1-dev`。已发布的 Docker 镜像已经包含它。此项只影响在这些镜像之外自行构建的运维者。

## 1. 以 `root` 用户 SSH 登录节点

## 2. 停止服务

```bash theme={null}
sudo systemctl stop monad-bft monad-execution monad-rpc
```

## 3. 升级 monad 包

<Warning>
  如果您在 GPG 签名上遇到问题(例如签名无效),请使用以下命令更新密钥。
</Warning>

```bash theme={null}
curl -fsSL https://pkg.category.xyz/keys/public-key.asc \
  | gpg --dearmor --yes -o /etc/apt/keyrings/category-labs.gpg
```

```bash theme={null}
sudo apt update && sudo apt install --reinstall monad=0.16.2 -y --allow-downgrades --allow-change-held-packages
sudo apt-mark hold monad
```

<Warning>
  `apt-mark hold monad` 命令会阻止 `apt-get upgrade` 自动升级 monad 包。若不加此命令,无人值守的系统升级可能会为您的网络安装未经批准的新版本 monad,导致版本不匹配问题。
</Warning>

## 4. 启动服务并验证

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

所有服务都应显示 `Active: active (running)`。确认节点重新加入并推进区块。

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

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

预期输出:

```json theme={null}
monad-rpc {"commit":"4374d389edca834764cf42c43ae822813e183a65","tag":"v0.16.2","branch":"","modified":false}
```