From 60839d356109d0a47b37e16eb0eb1a5657c0c74c Mon Sep 17 00:00:00 2001 From: Derek Cofausper <256792747+decofe@users.noreply.github.com> Date: Thu, 9 Apr 2026 09:20:53 +0000 Subject: [PATCH 1/4] docs: update snapshot download commands to use new modular flags - RPC: replace `tempo download -u $SNAPSHOT_URL` with `tempo download --full` - RPC: remove 'Manually downloading snapshots' section - Validator: replace `tempo download -u ` with `tempo download --minimal` Co-authored-by: Alexey Shekhirin <5773434+shekhirin@users.noreply.github.com> Amp-Thread-ID: https://ampcode.com/threads/T-019d718a-832c-720b-85ad-9e700d9adb9f --- src/pages/guide/node/rpc.mdx | 9 +-------- src/pages/guide/node/validator.mdx | 2 +- 2 files changed, 2 insertions(+), 9 deletions(-) diff --git a/src/pages/guide/node/rpc.mdx b/src/pages/guide/node/rpc.mdx index b349ee2a..253da18c 100644 --- a/src/pages/guide/node/rpc.mdx +++ b/src/pages/guide/node/rpc.mdx @@ -12,9 +12,7 @@ RPC nodes provide API access to the Tempo network without participating in conse ```bash /dev/null/quickstart.sh#L1-15 # Download snapshot (this will help you sync much faster) -# -# See https://snapshots.tempoxyz.dev/ for snapshots. -tempo download -u $SNAPSHOT_URL +tempo download --full # Run node tempo node \ @@ -27,11 +25,6 @@ An RPC node running in follow mode is a **full node**. It fetches blocks from a By default, RPC nodes run in archive mode, meaning they do not prune historical state. -## Manually downloading snapshots - -Daily snapshots for the persistent testnet can be found at [https://snapshots.tempoxyz.dev](https://snapshots.tempoxyz.dev). You can extract them either using -`tempo download --url ` or downloading them manually and extracting them using `curl | lz4 -d | tar -xzf -`. - ## Example Systemd Service ```bash /dev/null/systemd.sh#L1-55 diff --git a/src/pages/guide/node/validator.mdx b/src/pages/guide/node/validator.mdx index 777d7872..02d7ae32 100644 --- a/src/pages/guide/node/validator.mdx +++ b/src/pages/guide/node/validator.mdx @@ -22,7 +22,7 @@ The signing key is static. Pre-T2, it can only be rotated by removing and re-cre The process for running a validator node is very similar to [running a full node](/guide/node/rpc). -You should start by downloading the latest snapshot using `tempo download -u `. Downloading the snapshot allows your validator to start participating in consensus much faster. +You should start by downloading the latest snapshot using `tempo download --minimal`. Downloading the snapshot allows your validator to start participating in consensus much faster. Once you've downloaded the snapshot and have been whitelisted on-chain, you can proceed to run the validator node as such: ```bash From c9d4a9479a0f3823a4c429bc63d11ae67bf7bbf7 Mon Sep 17 00:00:00 2001 From: Derek Cofausper <256792747+decofe@users.noreply.github.com> Date: Thu, 9 Apr 2026 09:23:28 +0000 Subject: [PATCH 2/4] docs: use --archive flag for RPC node snapshot download Co-authored-by: Alexey Shekhirin <5773434+shekhirin@users.noreply.github.com> Amp-Thread-ID: https://ampcode.com/threads/T-019d718a-832c-720b-85ad-9e700d9adb9f --- src/pages/guide/node/rpc.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/guide/node/rpc.mdx b/src/pages/guide/node/rpc.mdx index 253da18c..95c6e1c1 100644 --- a/src/pages/guide/node/rpc.mdx +++ b/src/pages/guide/node/rpc.mdx @@ -12,7 +12,7 @@ RPC nodes provide API access to the Tempo network without participating in conse ```bash /dev/null/quickstart.sh#L1-15 # Download snapshot (this will help you sync much faster) -tempo download --full +tempo download --archive # Run node tempo node \ From 50f71dcb23c4a9ca8dd49616b87c6cfbf97bb90d Mon Sep 17 00:00:00 2001 From: Derek Cofausper <256792747+decofe@users.noreply.github.com> Date: Thu, 9 Apr 2026 11:46:38 +0000 Subject: [PATCH 3/4] docs: update download page for storage v2 flags Remove deprecated -u/--url flag, add --list flag, add --chain examples, fix --minimal/--archive descriptions. Co-Authored-By: onbjerg <8862627+onbjerg@users.noreply.github.com> Amp-Thread-ID: https://ampcode.com/threads/T-019d720f-8e8e-7164-bb08-e00a70fc5cac --- src/pages/cli/download.mdx | 36 ++++++++++++++++++++++++++++++------ 1 file changed, 30 insertions(+), 6 deletions(-) diff --git a/src/pages/cli/download.mdx b/src/pages/cli/download.mdx index 7b46657c..cee60d81 100644 --- a/src/pages/cli/download.mdx +++ b/src/pages/cli/download.mdx @@ -19,23 +19,47 @@ tempo download [flags] | --- | --- | | `--chain ` | Target network (`mainnet`, `moderato`) | | `--datadir ` | Data directory for downloaded state | -| `-u, --url ` | Download a specific snapshot URL instead of the latest | +| `--list` | List available snapshots | | `--resumable` | Resume an interrupted download | -| `--minimal` | Download minimal snapshot (pruned state only). Do not use if running a validator. | -| `--archive` | Download full archive snapshot. Do not use if running a validator. | +| `--minimal` | Download minimal snapshot (pruned state, suitable for validators) | +| `--archive` | Download full archive snapshot (suitable for RPC nodes) | ## Examples -Download a snapshot from https://snapshots.tempoxyz.dev: +Download the latest archive snapshot (for RPC nodes): ```bash -tempo download -u $SNAPSHOT_URL +tempo download --archive +``` + +Download the latest minimal snapshot (for validators): + +```bash +tempo download --minimal +``` + +Download a snapshot for a specific chain: + +```bash +tempo download --archive --chain moderato +``` + +List available snapshots: + +```bash +tempo download --list +``` + +List available snapshots for a specific chain: + +```bash +tempo download --list --chain moderato ``` Resume an interrupted download: ```bash -tempo download -u $SNAPSHOT_URL --resumable +tempo download --archive --resumable ``` Then start your node with [`tempo node`](/cli/node). From d625d14a704c89896b60b77dca1d56ebad062033 Mon Sep 17 00:00:00 2001 From: Derek Cofausper <256792747+decofe@users.noreply.github.com> Date: Thu, 9 Apr 2026 11:50:47 +0000 Subject: [PATCH 4/4] docs: restore -u/--url flag in reference table Co-authored-by: onbjerg <8862627+onbjerg@users.noreply.github.com> Amp-Thread-ID: https://ampcode.com/threads/T-019d720f-8e8e-7164-bb08-e00a70fc5cac --- src/pages/cli/download.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/src/pages/cli/download.mdx b/src/pages/cli/download.mdx index cee60d81..ef0bc727 100644 --- a/src/pages/cli/download.mdx +++ b/src/pages/cli/download.mdx @@ -19,6 +19,7 @@ tempo download [flags] | --- | --- | | `--chain ` | Target network (`mainnet`, `moderato`) | | `--datadir ` | Data directory for downloaded state | +| `-u, --url ` | Download a specific snapshot URL | | `--list` | List available snapshots | | `--resumable` | Resume an interrupted download | | `--minimal` | Download minimal snapshot (pruned state, suitable for validators) |