cosmos: document Polkachu FULL snapshot bootstrap for gaiad

cosmos/scripts/README.cometbft.md

@@ -0,0 +1,39 @@
+# Cosmos Hub (gaiad) — CometBFT bootstrap notes
+
+Operator guidance for fresh provisioning of the cosmos-hub gaiad node. See also the shared
+family-C reference at `rpc/scripts/README.cometbft.md`.
+
+## Fresh bootstrap: use a Polkachu FULL snapshot
+
+For a wasm chain like cosmos-hub, prefer seeding from a **Polkachu FULL snapshot** over
+state-sync. The full archive includes everything on disk — application state, `wasm/`, and
+`data/08-light-client/` (IBC 08-wasm bytecode) — so gaia does not panic with
+`wasmlckeeper failed initialize pinned codes / Error opening Wasm file` on first start.
+
+Snapshot URL pattern:
+
+```
+https://snapshots.polkachu.com/snapshots/cosmos/cosmos_<HEIGHT>.tar.lz4
+```
+
+Replace `<HEIGHT>` with the height published on the Polkachu cosmos snapshot page. Extract
+into the node data volume (`/root/.gaia`) before `docker compose up`.
+
+## CL_VERSION must match the live chain
+
+Cosmos chains upgrade via governance; an old binary halts at the upgrade height or panics
+`upgrade handler is missing for vX.Y.Z`. Before pinning `CL_VERSION` / `COSMOS_MAINNET_GAIAD_VERSION`,
+check the live app version on Polkachu RPC:
+
+```sh
+curl -s https://cosmos-rpc.polkachu.com/abci_info | jq .result.response.version
+```
+
+The Docker image tag must match that version (verify pullability with a manifest HEAD, not
+only the ghcr tags list — it can lag).
+
+## Traefik WebSocket routing
+
+The split-WS router uses `HeadersRegexp('Upgrade','(?i)websocket')` (case-insensitive). Clients
+sending `Upgrade: WebSocket` (e.g. python websocket-client) require this — a case-sensitive
+`Headers('Upgrade','websocket')` matcher falls through to the RPC router (400/200 instead of 101).

op/reth/ronin-mainnet-op-reth-archive-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ronin-mainnet:
-    image: ${RONIN_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${RONIN_MAINNET_RETH_VERSION:-v1.0.0-rc.1}
+    image: ${RONIN_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${RONIN_MAINNET_RETH_VERSION:-v2.1.1}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

op/reth/ronin-saigon-op-reth-archive-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ronin-saigon:
-    image: ${RONIN_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${RONIN_SAIGON_RETH_VERSION:-v1.0.0-rc.1}
+    image: ${RONIN_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${RONIN_SAIGON_RETH_VERSION:-v2.1.1}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

op/reth/ronin-saigon-op-reth-pruned-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ronin-saigon-pruned:
-    image: ${RONIN_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${RONIN_SAIGON_RETH_VERSION:-v1.0.0-rc.1}
+    image: ${RONIN_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${RONIN_SAIGON_RETH_VERSION:-v2.1.1}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

op/reth/superseed-sepolia-op-reth-pruned-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   superseed-sepolia-op-reth-pruned:
-    image: ${SUPERSEED_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${SUPERSEED_SEPOLIA_RETH_VERSION:-v2.1.0}
+    image: ${SUPERSEED_RETH_IMAGE:-ghcr.io/conduitxyz/conduit-op-reth}:${SUPERSEED_SEPOLIA_RETH_VERSION:-v2.1.1}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

scripts/worldchain-mainnet-snapshot-finish.sh

@@ -1,21 +0,0 @@
-#!/bin/bash
-set -eu
-
-# Bench helper: extract a downloaded worldchain-mainnet op-reth snapshot into the node volume.
-# Run after the background download to /slowdisk/worldchain-mainnet-snapshot/ completes.
-# For wipe+re-extract recovery, use worldchain-mainnet-snapshot-reseed.sh instead.
-
-DATADIR="${DATADIR:-/var/lib/docker/volumes/rpc_worldchain-mainnet-op-reth-pruned-trace/_data}"
-SNAP="${SNAP:-/slowdisk/worldchain-mainnet-snapshot/reth_full.tar.lz4}"
-
-if [ ! -f "$SNAP" ]; then
-  echo "worldchain-mainnet-snapshot-finish: snapshot not found: $SNAP" >&2
-  exit 1
-fi
-
-mkdir -p "$DATADIR"
-
-echo "worldchain-mainnet-snapshot-finish: extracting $SNAP -> $DATADIR (--strip-components=1)"
-tar --directory "$DATADIR" -I lz4 -xf "$SNAP" --strip-components=1
-
-echo "worldchain-mainnet-snapshot-finish: done"