From c72c7b2dbe42f8fc06f5b41c83eec3b71811cac1 Mon Sep 17 00:00:00 2001
From: Morty <yiweichi1@gmail.com>
Date: Wed, 14 Jan 2026 06:20:48 +0800
Subject: [PATCH 1/3] docs: mdbook add snapshot

---
 book/src/docker-operations.md | 40 +++++++++++++++++++++++++++++++++--
 book/src/running-a-node.md    | 32 ++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+), 2 deletions(-)

diff --git a/book/src/docker-operations.md b/book/src/docker-operations.md
index 4bd3649e..53f4cfab 100644
--- a/book/src/docker-operations.md
+++ b/book/src/docker-operations.md
@@ -42,7 +42,43 @@ Key environment variables:
 
 **Note**: You must provide your own RPC endpoints. Configure these in your `.env` file before starting the stack.
 
-### 3. Start the Stack
+### 3. Download Snapshot (Optional)
+
+For faster initial sync, you can optionally download a snapshot of the blockchain data before starting the stack.
+
+**This step is recommended but not required.** Without a snapshot, the node will sync from genesis, which can take considerably longer.
+
+**Step 1:** Create the volume directory if it doesn't exist:
+
+```bash
+mkdir -p volumes/l2reth
+```
+
+**Step 2:** Download the snapshot for your target network:
+
+**For Scroll Mainnet:**
+```bash
+wget https://scroll-geth-snapshot.s3.us-west-2.amazonaws.com/reth/latest.tar
+```
+
+**For Scroll Sepolia:**
+```bash
+wget https://scroll-sepolia-l2geth-snapshots.s3.us-west-2.amazonaws.com/reth/latest.tar
+```
+
+**Step 3:** Extract the snapshot to the volume directory (`volumes/l2reth`):
+
+```bash
+tar -xvf latest.tar -C volumes/l2reth
+```
+
+**Step 4:** Clean up the downloaded archive:
+
+```bash
+rm latest.tar
+```
+
+### 4. Start the Stack
 
 For standard operation (following public networks):
 
@@ -56,7 +92,7 @@ For shadow-fork mode:
 docker compose --profile shadow-fork up -d
 ```
 
-### 4. Access the Services
+### 5. Access the Services
 
 Once running, the following endpoints are available:
 
diff --git a/book/src/running-a-node.md b/book/src/running-a-node.md
index b72c8a12..5baaf9ab 100644
--- a/book/src/running-a-node.md
+++ b/book/src/running-a-node.md
@@ -37,6 +37,38 @@ For development builds (faster compilation, slower runtime):
 cargo build --bin rollup-node
 ```
 
+## Quick Start with Snapshot (Optional)
+
+For faster initial sync, you can optionally download a snapshot of the blockchain data instead of syncing from genesis.
+
+**This step is recommended but not required.** Without a snapshot, the node will sync from genesis, which can take considerably longer.
+
+**Step 1:** Download the snapshot for your target network:
+
+**For Scroll Mainnet:**
+```bash
+wget https://scroll-geth-snapshot.s3.us-west-2.amazonaws.com/reth/latest.tar
+```
+
+**For Scroll Sepolia:**
+```bash
+wget https://scroll-sepolia-l2geth-snapshots.s3.us-west-2.amazonaws.com/reth/latest.tar
+```
+
+**Step 2:** Extract the snapshot to your data directory:
+
+```bash
+tar -xvf latest.tar -C <DATADIR_PATH>
+```
+
+Replace `<DATADIR_PATH>` with your node's data directory path. This should match the `--datadir` flag you'll use when running the node (see configuration section below).
+
+**Step 3:** Clean up the downloaded archive:
+
+```bash
+rm latest.tar
+```
+
 ## Running the Node
 
 ### Basic Command

From b7312f0aa3a80c726f06e67d27285b62393e5fa2 Mon Sep 17 00:00:00 2001
From: Morty <yiweichi1@gmail.com>
Date: Wed, 14 Jan 2026 06:32:08 +0800
Subject: [PATCH 2/3] fmt

---
 book/src/docker-operations.md | 4 ++--
 book/src/running-a-node.md    | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/book/src/docker-operations.md b/book/src/docker-operations.md
index 53f4cfab..eacc30c9 100644
--- a/book/src/docker-operations.md
+++ b/book/src/docker-operations.md
@@ -56,12 +56,12 @@ mkdir -p volumes/l2reth
 
 **Step 2:** Download the snapshot for your target network:
 
-**For Scroll Mainnet:**
+For Scroll Mainnet:
 ```bash
 wget https://scroll-geth-snapshot.s3.us-west-2.amazonaws.com/reth/latest.tar
 ```
 
-**For Scroll Sepolia:**
+For Scroll Sepolia:
 ```bash
 wget https://scroll-sepolia-l2geth-snapshots.s3.us-west-2.amazonaws.com/reth/latest.tar
 ```
diff --git a/book/src/running-a-node.md b/book/src/running-a-node.md
index 5baaf9ab..acaf5961 100644
--- a/book/src/running-a-node.md
+++ b/book/src/running-a-node.md
@@ -45,12 +45,12 @@ For faster initial sync, you can optionally download a snapshot of the blockchai
 
 **Step 1:** Download the snapshot for your target network:
 
-**For Scroll Mainnet:**
+For Scroll Mainnet:
 ```bash
 wget https://scroll-geth-snapshot.s3.us-west-2.amazonaws.com/reth/latest.tar
 ```
 
-**For Scroll Sepolia:**
+For Scroll Sepolia:
 ```bash
 wget https://scroll-sepolia-l2geth-snapshots.s3.us-west-2.amazonaws.com/reth/latest.tar
 ```

From a2a031533b5b55f93adc1a39f49c7a752d4f1071 Mon Sep 17 00:00:00 2001
From: Morty <yiweichi1@gmail.com>
Date: Wed, 14 Jan 2026 06:45:44 +0800
Subject: [PATCH 3/3] fix comment

---
 book/src/running-a-node.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/book/src/running-a-node.md b/book/src/running-a-node.md
index acaf5961..53a7075f 100644
--- a/book/src/running-a-node.md
+++ b/book/src/running-a-node.md
@@ -37,7 +37,7 @@ For development builds (faster compilation, slower runtime):
 cargo build --bin rollup-node
 ```
 
-## Quick Start with Snapshot (Optional)
+## Download Snapshot (Optional)
 
 For faster initial sync, you can optionally download a snapshot of the blockchain data instead of syncing from genesis.