Skip to content

Commit 611ee44

Browse files
authored
chore: add mainnet 17 (#1055)
1 parent f4c22f1 commit 611ee44

File tree

2 files changed

+46
-58
lines changed

2 files changed

+46
-58
lines changed

src/content/Docs/node-operators/network-upgrades/index.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,14 +15,14 @@ This section contains comprehensive upgrade guides for node operators and valida
1515

1616
## Current Network Upgrade
1717

18-
### [Mainnet 16 - Akash v1.2.0](/docs/node-operators/network-upgrades/mainnet-16)
18+
### [Mainnet 17 - Akash v2.0.0](/docs/node-operators/network-upgrades/mainnet-17/)
1919

2020
**Status:** Upcoming
21-
**Upgrade Height:** 25,789,395
22-
**Estimated Time:** Wednesday, March 4th, 2025 at 14:00 UTC
23-
**Binary Version:** v1.2.0
21+
**Upgrade Height:** 26,063,777
22+
**Binary Version:** v2.0.0
23+
**Binary Release:** Binaries will be released approximately 24 hours after the upgrade height.
2424

25-
Complete upgrade guide including Cosmovisor and manual upgrade instructions, build from source guide, and troubleshooting. This upgrade includes store migrations for the deployment and market modules; 128GB RAM with swap is recommended.
25+
Complete upgrade guide including Cosmovisor and manual upgrade instructions, build from source guide, and troubleshooting. Monitor block height and Discord for timing; prepare your node before the upgrade.
2626

2727
---
2828

src/content/Docs/node-operators/network-upgrades/mainnet-16/index.md renamed to src/content/Docs/node-operators/network-upgrades/mainnet-17/index.md

Lines changed: 41 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -2,39 +2,27 @@
22
categories: ["Node Operators", "Network Upgrades"]
33
tags: ["Mainnet", "Upgrade", "Cosmovisor"]
44
weight: 1
5-
title: "Mainnet 16 - Akash v1.2.0"
6-
linkTitle: "Mainnet 16"
7-
description: "Complete upgrade guide for Mainnet 16 (Akash v1.2.0)"
5+
title: "Mainnet 17 - Akash v2.0.0"
6+
linkTitle: "Mainnet 17"
7+
description: "Complete upgrade guide for Mainnet 17 (Akash v2.0.0)"
88
---
99

10-
**Upgrade guide for Akash Network Mainnet 16 upgrade to v1.2.0.**
10+
**Upgrade guide for Akash Network Mainnet 17 upgrade to v2.0.0.**
1111

12-
This guide provides step-by-step instructions for upgrading your node to Akash v1.2.0 using both Cosmovisor (recommended) and manual upgrade methods.
12+
This guide provides step-by-step instructions for upgrading your node to Akash v2.0.0 using both Cosmovisor (recommended) and manual upgrade methods.
1313

1414
---
1515

1616
## Upgrade Details
1717

1818
**Upgrade Information:**
19-
- **Upgrade Name:** Mainnet16
20-
- **Binary Version:** `v1.2.0`
21-
- **Block Height:** 25,789,395
22-
- **Estimated Time:** Wednesday, March 4th, 2025 at 14:00 UTC
23-
- **Expected Duration:** 10–15 minutes of network downtime (longer possible due to store migrations)
24-
- **Binary Release:** Available approximately 10 hours before the upgrade
25-
- **Binary Links:** [GitHub Releases](https://github.com/akash-network/node/releases/tag/v1.2.0)
19+
- **Upgrade Name:** Mainnet17
20+
- **Binary Version:** `v2.0.0`
21+
- **Block Height:** 26,063,777
22+
- **Binary Release:** Binaries will be released approximately **24 hours before** the upgrade height
23+
- **Binary Links:** [GitHub Releases](https://github.com/akash-network/node/releases/tag/v2.0.0) (once published)
2624

27-
> **Note:** Block times have high variance. Please monitor the chain or block explorer for more precise timing estimates.
28-
29-
---
30-
31-
## Upgrade Features
32-
33-
34-
- **CometBFT Tachyon advisory fix** – Public rollout of CSA-2026-001: Tachyon (previously distributed as binary-only to validators).
35-
- **Deployment and market module store migrations** – Migrate from manual KVStore key encoding to `cosmossdk.io/collections`. `IndexedMap` replaces hand-rolled prefix keys with type-safe, indexed collections.
36-
- **Secondary indexes** – State, Owner, and Provider indexes enable efficient filtered queries without full-store iteration.
37-
- **Lease closed reason**`MsgCloseBid` now records why a lease was closed (e.g. Unstable). The reason is persisted on the lease and returned in query responses.
25+
> **Note:** Block times have high variance. Monitor the chain or block explorer for the upgrade. Prepare your node to halt at the upgrade height; install the v2.0.0 binary once it is released (~24 hours after the chain halts).
3826
3927
---
4028

@@ -44,7 +32,8 @@ To ensure a network upgrade with minimal downtime, Akash Validators should be av
4432

4533
**Timeline:**
4634
- **One hour prior to upgrade** - Available and monitoring the Akash Discord server's `#validators` and `#validator-announcements` channels for any late-breaking guidance
47-
- **During upgrade window** – Available throughout the expected downtime (may be longer than usual due to store migrations)
35+
- **During upgrade window** – Available throughout the expected downtime
36+
- **After binary release** – Install v2.0.0 binary and restart once released (~24 hours after upgrade height)
4837
- **One hour post upgrade** - Available and monitoring Discord channels for any possible revised strategies or updates deemed necessary
4938

5039
### Emergency Coordination
@@ -57,12 +46,11 @@ In the event of issues during the upgrade, coordinate via the **#validators chan
5746

5847
## Hardware Requirements
5948

60-
This upgrade performs **store migrations** for the deployment and market modules, re-encoding all deployments, groups, orders, bids, and leases into the new collections format.
49+
**Recommended specifications for running a node for this upgrade:**
6150

62-
**Recommended Specifications:**
63-
- **OS:** Ubuntu 24.04 recommended
64-
- **RAM:** 128 GB minimum (with swap enabled)
65-
- **CPU:** 8+ cores recommended
51+
- **OS:** Ubuntu 24.04
52+
- **RAM:** 128 GB with 64 GB swap
53+
- **CPU:** 8+ cores minimum
6654
- **Storage:** Sufficient space for blockchain data (1 TB+ recommended)
6755

6856
---
@@ -83,7 +71,7 @@ The following instructions assume the `akash` and `cosmovisor` binaries are alre
8371

8472
> **Note:** Cosmovisor v1.5.0 or higher is required.
8573
86-
Validators and RPCs supervised by Cosmovisor with `DAEMON_ALLOW_DOWNLOAD_BINARIES=true` will automatically download upgrade binaries from the upgrade info file (info.json).
74+
Validators and RPCs supervised by Cosmovisor with `DAEMON_ALLOW_DOWNLOAD_BINARIES=true` will automatically download upgrade binaries from the upgrade info file (info.json) once available. Because binaries are released ~24 hours after the upgrade height, ensure your Cosmovisor setup can obtain the binary when released, or place the binary manually after download.
8775

8876
### Step 1: Configure Cosmovisor
8977

@@ -136,7 +124,7 @@ WantedBy=multi-user.target
136124

137125
**Important Environment Variables:**
138126

139-
- `DAEMON_ALLOW_DOWNLOAD_BINARIES=false` – It's recommended to manually place the binary (set to `true` for auto-download from upgrade info)
127+
- `DAEMON_ALLOW_DOWNLOAD_BINARIES=false` – It's recommended to manually place the binary (set to `true` for auto-download from upgrade info once available)
140128
- `UNSAFE_SKIP_BACKUP=true` - Set to `false` if you want automatic backup before upgrade
141129
- `DAEMON_SHUTDOWN_GRACE=15s` - Grace period for cleanup before shutdown
142130

@@ -160,7 +148,7 @@ sudo systemctl status akash
160148

161149
> **Note:** Skip this step if you have enabled `DAEMON_ALLOW_DOWNLOAD_BINARIES=true` in your Cosmovisor configuration.
162150
163-
This upgrade uses an info.json file that references the correct release with pre-built binaries. Download the Akash v1.2.0 binary for your platform from the [GitHub releases page](https://github.com/akash-network/node/releases/tag/v1.2.0).
151+
This upgrade uses an info.json file that references the correct release with pre-built binaries. **Binaries will be released approximately 24 hours after the upgrade height.** Once released, download the Akash v2.0.0 binary for your platform from the [GitHub releases page](https://github.com/akash-network/node/releases/tag/v2.0.0).
164152

165153
**Select your platform:**
166154
- Linux AMD64
@@ -176,25 +164,25 @@ Create the folder for the upgrade and copy the binary:
176164

177165
```bash
178166
# Create the upgrade directory
179-
mkdir -p $HOME/.akash/cosmovisor/upgrades/v1.2.0/bin
167+
mkdir -p $HOME/.akash/cosmovisor/upgrades/v2.0.0/bin
180168

181169
# Copy the downloaded binary (adjust path to your download location)
182-
cp /path/to/downloaded/akash $HOME/.akash/cosmovisor/upgrades/v1.2.0/bin/akash
170+
cp /path/to/downloaded/akash $HOME/.akash/cosmovisor/upgrades/v2.0.0/bin/akash
183171

184172
# Make it executable
185-
chmod +x $HOME/.akash/cosmovisor/upgrades/v1.2.0/bin/akash
173+
chmod +x $HOME/.akash/cosmovisor/upgrades/v2.0.0/bin/akash
186174

187175
# Verify the version
188-
$HOME/.akash/cosmovisor/upgrades/v1.2.0/bin/akash version
176+
$HOME/.akash/cosmovisor/upgrades/v2.0.0/bin/akash version
189177
```
190178

191-
**Expected output:** `v1.2.0`
179+
**Expected output:** `v2.0.0`
192180

193181
### Step 5: Wait for Upgrade
194182

195-
At the proposed block height (25,789,395), Cosmovisor will automatically:
183+
At the proposed block height (26,063,777), Cosmovisor will automatically:
196184
1. Stop the current binary
197-
2. Set the upgrade binary as the new current binary (v1.2.0)
185+
2. Set the upgrade binary as the new current binary (v2.0.0)
198186
3. Restart the node
199187

200188
**Monitor the upgrade:**
@@ -217,23 +205,23 @@ Using Cosmovisor to perform the upgrade is not mandatory. Node operators can man
217205
218206
### Manual Upgrade Steps
219207

220-
**1. Wait for the chain to halt** at block height 25,789,395
208+
**1. Wait for the chain to halt** at block height 26,063,777
221209

222210
**2. Stop your node** (if not already stopped):
223211

224212
```bash
225213
sudo systemctl stop akash
226214
```
227215

228-
**3. Install the new binary:**
216+
**3. Wait for the v2.0.0 binary release** (approximately 24 hours after the upgrade height), then install the new binary:
229217

230-
Either download the precompiled binary from [GitHub releases](https://github.com/akash-network/node/releases/tag/v1.2.0) or build from source (see [Build Binary From Source](#build-binary-from-source)).
218+
Either download the precompiled binary from [GitHub releases](https://github.com/akash-network/node/releases/tag/v2.0.0) or build from source (see [Build Binary From Source](#build-binary-from-source)).
231219

232220
**4. Verify the binary version:**
233221

234222
```bash
235223
akash version
236-
# Should output: v1.2.0
224+
# Should output: v2.0.0
237225
```
238226

239227
**5. Restart your node:**
@@ -295,7 +283,7 @@ git clone https://github.com/akash-network/node.git
295283
cd node
296284

297285
# Checkout the release tag
298-
git checkout v1.2.0
286+
git checkout v2.0.0
299287

300288
# Allow direnv to set up the environment
301289
direnv allow
@@ -327,17 +315,17 @@ The directory structure will look like:
327315

328316
```bash
329317
.cache/goreleaser/main/<YOUR_OS_ARCH>/akash version
330-
# Should output: v1.2.0
318+
# Should output: v2.0.0
331319
```
332320

333321
### Using the Built Binary
334322

335323
**For Cosmovisor:**
336324

337325
```bash
338-
mkdir -p $HOME/.akash/cosmovisor/upgrades/v1.2.0/bin
339-
cp .cache/goreleaser/main/<YOUR_OS_ARCH>/akash $HOME/.akash/cosmovisor/upgrades/v1.2.0/bin/akash
340-
chmod +x $HOME/.akash/cosmovisor/upgrades/v1.2.0/bin/akash
326+
mkdir -p $HOME/.akash/cosmovisor/upgrades/v2.0.0/bin
327+
cp .cache/goreleaser/main/<YOUR_OS_ARCH>/akash $HOME/.akash/cosmovisor/upgrades/v2.0.0/bin/akash
328+
chmod +x $HOME/.akash/cosmovisor/upgrades/v2.0.0/bin/akash
341329
```
342330

343331
**For manual upgrade:**
@@ -356,15 +344,15 @@ akash status | jq '.sync_info'
356344

357345
**Important fields:**
358346
- `catching_up: false` - Node is synced
359-
- `latest_block_height` – Current block (should be > 25,789,395)
347+
- `latest_block_height` – Current block (should be > 26,063,777)
360348

361349
### Check Binary Version
362350

363351
```bash
364352
akash version
365353
```
366354

367-
**Expected output:** `v1.2.0`
355+
**Expected output:** `v2.0.0`
368356

369357
### Check Validator Status
370358

@@ -392,7 +380,7 @@ sudo journalctl -u akash -n 100 --no-pager
392380
- Binary not executable: `chmod +x /path/to/akash`
393381
- Wrong binary version: Verify with `akash version`
394382
- Permission issues: Check user/group settings in systemd service
395-
- Store migration taking longer: Ensure 128GB RAM and swap; monitor memory and disk
383+
- Binary not yet released: v2.0.0 is expected ~24 hours after the upgrade height
396384

397385
### Node Out of Sync
398386

@@ -411,7 +399,7 @@ If low peer count, add peers from:
411399
**Verify upgrade binary exists:**
412400

413401
```bash
414-
ls -la $HOME/.akash/cosmovisor/upgrades/v1.2.0/bin/akash
402+
ls -la $HOME/.akash/cosmovisor/upgrades/v2.0.0/bin/akash
415403
```
416404

417405
**Check Cosmovisor logs:**
@@ -421,7 +409,7 @@ sudo journalctl -u akash -f
421409
```
422410

423411
**Common issues:**
424-
- Upgrade binary not in correct location
412+
- Upgrade binary not in correct location (ensure v2.0.0 is placed after it is released)
425413
- Binary not executable
426414
- `DAEMON_ALLOW_DOWNLOAD_BINARIES` set incorrectly
427415

0 commit comments

Comments
 (0)