Merge pull request 0xPolygon#457 from 0xPolygon/zkevm/state-sync

Update the state sync doc

Author: kmurphypolygon

docs/zkEVM/get-started/state-sync-snapshots.md

@@ -2,47 +2,76 @@
 comments: true
 ---
 
-Use snapshots for quick state syncing. 
+!!! important
+    New and streamlined state sync process coming online soon.
 
-Find the zkEVM mainnet snapshots at the below urls.
+Follow the instructions below to run a fast state sync on a node database using the relevant snapshot. Snapshot URLs are available in the [snapshots section](#snapshots).
 
-    ```bash
-    https://zkevm-mai.s3.eu-west-1.amazonaws.com/mainnet-bridgedb.sql.gz (315MB)
-    https://zkevm-mai.s3.eu-west-1.amazonaws.com/mainnet-statedb.sql.gz (6GB)
-    https://zkevm-mai.s3.eu-west-1.amazonaws.com/mainnet-hashdb.sql.gz (160GB)
-    ```
+## Sync a database
 
-Find the testnet snapshots at the below urls.
+1. Run the following command to download the snapshot with the correct `snapshot-url` and `db-name`:
 
-    ```bash
-    https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-bridgedb.sql.gz (312MB)
-    https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-statedb.sql.gz (1.9GB)
-    https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-hashdb.sql.gz (49GB)
+    ```sh
+    curl <snapshot-url> -o <db-name>.sql.gz
     ```
 
-Follow the next instructions to sync state. Be sure to 'curl' snapshots for the correct network, that is, mainnet or testnet.
+   For example: 
 
-```bash
-    # Retrieve backup file
-    curl https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-statedb.sql.gz -o statedb.sql.gz
+   ```sh
+   curl https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-statedb.sql.gz -o statedb.sql.gz
 
-    # Let only datatabase running
+2. Stop/start the database:
+    
+    ```sh
     docker compose stop
     docker compose start zkevm-state-db
+    ```
 
-    # Remove data from database, keeping schema (the backup is raw COPY)
+3. Remove data from the database, keeping the schema and a raw backup copy:
+
+    ```sh
     docker compose exec -it zkevm-state-db pg_dump -U state_user -v -Fc -s -f /tmp/statedb.schema state_db
     docker compose exec -it zkevm-state-db dropdb -U state_user state_db
     docker compose exec -it zkevm-state-db createdb -U state_user state_db
     docker compose exec -it zkevm-state-db pg_restore -U state_user -v -d state_db /tmp/statedb.schema
+    ```
 
-    # Import the backup file into database
+4. Import the backup file into the database:
+
+    ```sh
     gunzip -c statedb.sql.gz | docker compose exec -T zkevm-state-db psql -U state_user -d state_db
+    ```
+
+5. Clean up:
 
-    # Cleanup
+    ```sh
     docker compose exec zkevm-state-db rm /tmp/statedb.schema
     rm statedb.sql.gz
+    ```
+    
+6. Start everything again:
 
-    # Start everything
+    ```sh
     docker compose up -d
+    ```
+
+## Snapshots
+
+The snapshot for the bridge, state, and hash databases are given below for mainnet and testnet.
+
+### Mainnet
+
+```bash
+https://zkevm-mai.s3.eu-west-1.amazonaws.com/mainnet-bridgedb.sql.gz (315MB)
+https://zkevm-mai.s3.eu-west-1.amazonaws.com/mainnet-statedb.sql.gz (6GB)
+https://zkevm-mai.s3.eu-west-1.amazonaws.com/mainnet-hashdb.sql.gz (160GB)
 ```
+
+### Testnet
+
+```bash
+https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-bridgedb.sql.gz (312MB)
+https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-statedb.sql.gz (1.9GB)
+https://zkevm-pub.s3.eu-west-1.amazonaws.com/testnet-hashdb.sql.gz (49GB)
+```
+