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

# 升级到 v1.19.0

2026 年 4 月 28 日（周二）

根据 [IIP-632](https://injhub.com/proposal/632/)，升级流程应在区块高度 **164394000** 执行。

* [概览](#summary)
* [回滚](#recovery)
* [升级流程](#upgrade-procedure)
* [验证者须知](#notes-for-validators)

## 概览

Injective 链将于 **2026 年 4 月 28 日（周二）美东时间上午 10:00 / UTC 14:00** 进行一次计划内的功能升级。

以下是升级步骤的简要总结：

1. 投票，并等待节点在区块高度 **164394000** 触发 panic。
2. 备份运行 Injective 链所用的配置、数据和密钥。
3. 安装 [v1.19.0](https://github.com/InjectiveFoundation/injective-core/releases/tag/v1.19.0) 二进制文件。
4. 使用新的 injectived 二进制文件启动节点以完成升级。

针对验证者的升级协调与支持将在 [Injective Discord](https://discord.gg/injective) 的 `#validators` 私有频道中进行。

网络升级可能会经历以下几种路径：

1. **顺利路径（Happy path）**：\
   验证者顺利完成升级，无需清理链上历史，所有验证者在升级后 5-10 分钟内恢复。
2. **不太顺利的路径（Not-so-happy path）**：\
   验证者在升级到最新的规范链时遇到问题。
3. **中止路径（Abort path）**：\
   在极少数情况下，如果团队发现此前未察觉的严重问题，Injective 团队将尝试修复所有破坏性状态，并在 36 小时内提供另一个官方二进制文件。\
   如果链未能在 36 小时内成功恢复，将在 [Injective Discord](https://discord.gg/injective) 的 `#validators` 频道公告本次升级中止，验证者需要继续运行原链而不进行任何升级或改动。

## 回滚

在导出链状态之前，建议验证者先在导出高度处对完整数据进行快照。快照方式在很大程度上取决于基础设施，但通常可以通过备份 `.injectived` 目录来完成。

在停止 injectived 进程之后，务必备份 `.injectived/data/priv_validator_state.json` 文件。该文件在验证者参与每一轮共识时都会更新，是防止在升级失败、需要重启旧链时出现双签的关键文件。

如果升级未能成功，验证者和运维方必须恢复快照，并回退到 Injective 链的 [v1.18.3](https://github.com/InjectiveFoundation/injective-core/releases/tag/v1.18.3-1774990852) 版本，继续运行原来的链，直到下一次升级公告。

## 升级流程

### 验证者须知

<Callout icon="warning" color="#FFA500" iconType="regular">
  **源码构建需要 Go v1.26.2**

  v1.19.0 源码已经发布，最低 Go 版本被提高到 `go1.26.2`。从源码构建 `injectived` 或 `peggo` 的验证者应在链停机之前升级其 Go 环境，避免构建时出现意外。使用已发布的二进制文件或 Docker 镜像部署的团队则无需额外调整环境。
</Callout>

升级到新版本之前，必须清除 wasm 缓存：

```shell theme={null}
rm -rf .injectived/wasm/wasm/cache/
```

### 步骤

1. 确认你当前运行的是正确版本（`v1.18.3`）的 `injectived`：

   ```bash theme={null}
   $ injectived version
   Version v1.18.3 (b18483b)
   Compiled at 20260331-2102 using Go go1.23.9 (amd64)
   ```

2. 备份你的 `.injectived` 目录：

   ```bash theme={null}
   cp -r ~/.injectived ./injectived-backup
   ```

3. 下载并安装 v1.19.0 的 `injective-chain` 发布版本：

   ```bash theme={null}
   wget https://github.com/InjectiveFoundation/injective-core/releases/download/v1.19.0/linux-amd64.zip
   unzip linux-amd64.zip
   sudo mv injectived peggo /usr/bin
   sudo mv libwasmvm.x86_64.so /usr/lib
   ```

4. 下载 v1.19.0 发布版本后，确认你当前运行的是正确版本（v1.19.0）的 `injectived`：

   ```bash theme={null}
   $ injectived version
   Version v1.19.0 (750b3fb)
   Compiled at 20260424-1643 using Go go1.26.2 (amd64)
   ```

5. 从 `injectived start` 命令或 systemd unit 文件中移除任何已废弃的 `statsd` 相关参数：

   <Warning>
     以下参数从 v1.19.0 起不再支持，会导致 `injectived` 启动失败：

     `statsdAgent`、`statsdEnabled`、`statsd-prefix`、`statsd-address`、`statsd-stuck-func`、`statsd-tracing-enabled`、`statsd-profiling-enabled`、`trace-recorder-threshold`

     这些参数在早期版本中受支持，但现已移除。测试网上曾有一位外部验证者由于这些参数仍存在而遇到启动失败。请检查你的启动脚本、systemd 服务文件或任何包装脚本，并在进入下一步之前将其**移除**。
   </Warning>

6. 启动 `injectived`：

   ```bash theme={null}
   injectived start
   ```

7. 下载 v1.19.0 发布版本后，确认你当前运行的是正确版本（v1.19.0）的 `peggo`：

   ```bash theme={null}
   $ peggo version
   Version v1.19.0 (750b3fb)
   Compiled at 20260424-1644 using Go go1.26.2 (amd64)
   ```

8. 启动 peggo：

   ```bash theme={null}
   peggo orchestrator
   ```