fix: pin frontend image digest, fix GAS_TRACKER_UNITS validation

- Pin frontend image to sha256 digest instead of :latest to prevent
  upstream breakage (caused 502 outage on doscan.io + test.doscan.io)
- Fix GAS_TRACKER_UNITS from ['nDOS'] to ['gwei'] (new Blockscout
  validation only accepts 'usd' or 'gwei')
- Fix beta compose: use archive node RPC, remove avalanchego dependency,
  fix caddy healthcheck
- Add env var documentation comments to common-blockscout and frontend envs
- Expand DOScan-ARCHITECTURE.md with microservices details and BENS docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: JOY

docker-compose/docker-compose-beta.yml

@@ -42,9 +42,6 @@ services:
     env_file:
       - ./envs/common-blockscout.env
       - ./envs/common-blockscout-beta.env
-    networks:
-      - default
-      - avalanchego
     ports:
       - "127.0.0.1:14000:4000"
     healthcheck:
@@ -62,7 +59,7 @@ services:
     depends_on:
       backend:
         condition: service_healthy
-    image: metados/blockscout-frontend:latest
+    image: metados/blockscout-frontend@sha256:3554f66094aaddc235bae3800a6766fb6c0c1826a0a527eeceba9133509b78df
     pull_policy: always
     restart: always
     environment:
@@ -127,7 +124,7 @@ services:
     extra_hosts:
       - "host.docker.internal:host-gateway"
     environment:
-      USER_OPS_INDEXER__INDEXER__RPC_URL: "http://host.docker.internal:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/rpc"
+      USER_OPS_INDEXER__INDEXER__RPC_URL: "http://20.195.24.239:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/rpc"
       USER_OPS_INDEXER__INDEXER__ENTRYPOINTS__V08: "true"
       USER_OPS_INDEXER__INDEXER__ENTRYPOINTS__V08_ENTRY_POINT: "0x433709009B8330FDa32311DF1C2AFA402eD8D009"
       USER_OPS_INDEXER__INDEXER__ENTRYPOINTS__V06: "false"
@@ -180,11 +177,11 @@ services:
       - "10080:80"
       - "10081:8080"
     healthcheck:
-      test: ["CMD", "wget", "--spider", "-q", "http://localhost:80/"]
+      test: ["CMD", "caddy", "version"]
       interval: 30s
       timeout: 5s
       retries: 3
-      start_period: 10s
+      start_period: 5s
 
 volumes:
   redis_data:
@@ -193,6 +190,3 @@ volumes:
 
 networks:
   default:
-  avalanchego:
-    name: avalanchego_default
-    external: true

docker-compose/docker-compose-mainnet.yml

@@ -91,7 +91,7 @@ services:
     depends_on:
       backend:
         condition: service_healthy
-    image: metados/blockscout-frontend:latest
+    image: metados/blockscout-frontend@sha256:3554f66094aaddc235bae3800a6766fb6c0c1826a0a527eeceba9133509b78df
     pull_policy: always
     restart: always
     container_name: frontend

docker-compose/docker-compose-testnet.yml

@@ -104,7 +104,7 @@ services:
   frontend:
     depends_on:
       - backend
-    image: metados/blockscout-frontend:latest
+    image: metados/blockscout-frontend@sha256:3554f66094aaddc235bae3800a6766fb6c0c1826a0a527eeceba9133509b78df
     pull_policy: always
     platform: linux/amd64
     restart: always

docker-compose/envs/common-blockscout-beta.env

@@ -5,10 +5,10 @@
 # Docker Compose loads base first, then this file overrides.
 # =============================================================================
 
-# RPC - local AvaGo-Mainnet container (avalanchego_default network)
-ETHEREUM_JSONRPC_HTTP_URL=http://AvaGo-Mainnet:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/rpc
-ETHEREUM_JSONRPC_TRACE_URL=http://AvaGo-Mainnet:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/rpc
-ETHEREUM_JSONRPC_WS_URL=ws://AvaGo-Mainnet:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/ws
+# RPC - archive node (20.195.24.239) — same node as mainnet doscan.io
+ETHEREUM_JSONRPC_HTTP_URL=http://20.195.24.239:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/rpc
+ETHEREUM_JSONRPC_TRACE_URL=http://20.195.24.239:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/rpc
+ETHEREUM_JSONRPC_WS_URL=ws://20.195.24.239:9650/ext/bc/22v7AG7h6qaVxd4bLvAsSsg2LZ4RCn5iVYgFn7a2Fj1LCuYwjv/ws
 ETHEREUM_JSONRPC_DISABLE_ARCHIVE_BALANCES=false
 
 # Database - local PostgreSQL

docker-compose/envs/common-blockscout.env

@@ -26,6 +26,12 @@ ETHEREUM_JSONRPC_WS_URL=ws://host.docker.internal:9650/ext/bc/22v7AG7h6qaVxd4bLv
 # ETHEREUM_JSONRPC_HTTP_HEADERS=
 # ETHEREUM_JSONRPC_HTTP_GZIP_ENABLED=
 # ETHEREUM_JSONRPC_WAIT_PER_TIMEOUT=
+# ETHEREUM_JSONRPC_HTTP_INSECURE=            # Allow insecure HTTP connections
+# ETHEREUM_JSONRPC_USER=                     # Basic auth username for RPC
+# ETHEREUM_JSONRPC_PASSWORD=                 # Basic auth password for RPC
+# ETHEREUM_JSONRPC_PENDING_TRANSACTIONS_TYPE= # Pending tx fetch method (default)
+# ETHEREUM_JSONRPC_RECEIPTS_BY_BLOCK=false   # Fetch receipts by block instead of per tx
+# ETHEREUM_JSONRPC_MAX_RECEIPTS_BY_BLOCK=1000 # Max txs for block receipt fetching
 # ETHEREUM_JSONRPC_GETH_TRACE_BY_BLOCK=
 # ETHEREUM_JSONRPC_GETH_ALLOW_EMPTY_TRACES=
 # ETHEREUM_JSONRPC_DEBUG_TRACE_TRANSACTION_TIMEOUT=

docker-compose/envs/common-frontend.env

@@ -1,7 +1,7 @@
 # =============================================================================
 # DOS Chain Mainnet - Frontend Environment Variables
 # https://doscan.io
-# Last Updated: 2026-02-16
+# Last Updated: 2026-03-05
 # Blockscout Frontend latest
 # Docs: https://docs.blockscout.com/setup/env-variables/frontend-common-envs
 # =============================================================================
@@ -12,6 +12,8 @@
 NEXT_PUBLIC_APP_PROTOCOL=https
 NEXT_PUBLIC_APP_HOST=doscan.io
 NEXT_PUBLIC_APP_ENV=production
+# NEXT_PUBLIC_APP_INSTANCE_ID=             # Unique instance ID (multi-instance deployments)
+# NEXT_PUBLIC_MAINTENANCE_ALERT_MESSAGE=   # Custom maintenance banner text
 
 # =============================================================================
 # BLOCKCHAIN PARAMETERS
@@ -28,6 +30,8 @@ NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS=18
 NEXT_PUBLIC_NETWORK_VERIFICATION_TYPE=validation
 NEXT_PUBLIC_NETWORK_TOKEN_STANDARD_NAME=ERC
 NEXT_PUBLIC_IS_TESTNET=false
+# NEXT_PUBLIC_VALIDATORS_CHAIN_TYPE=poa    # Validator display type: aura, poa, stability
+# NEXT_PUBLIC_NETWORK_ALARMS=              # Network alarm notifications config
 
 # =============================================================================
 # API CONFIGURATION
@@ -37,6 +41,8 @@ NEXT_PUBLIC_API_HOST=doscan.io
 NEXT_PUBLIC_API_BASE_PATH=/
 NEXT_PUBLIC_API_WEBSOCKET_PROTOCOL=wss
 NEXT_PUBLIC_API_SPEC_URL=https://raw.githubusercontent.com/blockscout/blockscout-api-v2-swagger/main/swagger.yaml
+# NEXT_PUBLIC_API_TIMEOUT=10000            # API request timeout in ms (default: 10000)
+# NEXT_PUBLIC_SAFE_TX_SERVICE_URL=         # Safe (Gnosis Safe) transaction service API
 
 # =============================================================================
 # UI CONFIGURATION - HOMEPAGE
@@ -78,12 +84,15 @@ FAVICON_MASTER_URL=https://raw.githubusercontent.com/DOSLabs/DOScan-Frontend-Con
 NEXT_PUBLIC_PROMOTE_BLOCKSCOUT_IN_TITLE=false
 NEXT_PUBLIC_OG_DESCRIPTION=Blockchain explorer for DOS Chain. DOScan is an analytics tool for exploring DOS transactions, addresses, statistics, and other platform activities.
 NEXT_PUBLIC_OG_IMAGE_URL=https://raw.githubusercontent.com/DOSLabs/DOScan-Frontend-Configs/main/configs/og-images/doscan.png
+# NEXT_PUBLIC_META_KEYWORDS=               # Meta keywords for SEO
 
 # =============================================================================
 # UI CONFIGURATION - ADDRESS & CONTRACT VIEWS
 # =============================================================================
 NEXT_PUBLIC_VIEWS_CONTRACT_SOLIDITYSCAN_ENABLED=true
 NEXT_PUBLIC_VIEWS_TOKEN_SCAM_TOGGLE_ENABLED=true
+# NEXT_PUBLIC_VIEWS_ADDRESS_IDENTICON_TYPE=jazzicon  # Address icon: default, jazzicon, gradient
+# NEXT_PUBLIC_VIEWS_TOKEN_HOLDER_DISTRIBUTION_ENABLED=true  # Token holder distribution chart
 
 # =============================================================================
 # UI CONFIGURATION - NFT VIEWS
@@ -110,7 +119,7 @@ NEXT_PUBLIC_IS_ACCOUNT_SUPPORTED=true
 # FEATURE: GAS TRACKER
 # =============================================================================
 NEXT_PUBLIC_GAS_TRACKER_ENABLED=true
-NEXT_PUBLIC_GAS_TRACKER_UNITS=['nDOS']
+NEXT_PUBLIC_GAS_TRACKER_UNITS=['gwei']
 
 # =============================================================================
 # FEATURE: ADVANCED FILTER
@@ -127,6 +136,7 @@ NEXT_PUBLIC_ADMIN_SERVICE_API_HOST=https://admin-rs.services.blockscout.com
 # FEATURE: BLOCKCHAIN INTERACTION (WALLET CONNECT)
 # =============================================================================
 NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=4b6b77d337588564379b0ef8f3a5c479
+# NEXT_PUBLIC_WALLET_CONNECT_RELAY_URL=    # Custom WalletConnect relay server
 
 # =============================================================================
 # FEATURE: ADS
@@ -138,6 +148,9 @@ NEXT_PUBLIC_AD_TEXT_PROVIDER=none
 # FEATURE: GOOGLE ANALYTICS
 # =============================================================================
 NEXT_PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID=G-HHJGT5F2WK
+# NEXT_PUBLIC_GOOGLE_TAGMANAGER_ID=        # Google Tag Manager container ID
+# NEXT_PUBLIC_MIXPANEL_ID=                 # Mixpanel analytics project ID
+# NEXT_PUBLIC_PLAUSIBLE_ANALYTICS_DOMAIN=  # Plausible Analytics domain
 
 # =============================================================================
 # FEATURE: API DOCUMENTATION
@@ -194,6 +207,7 @@ NEXT_PUBLIC_GAS_REFUEL_PROVIDER_CONFIG={'name':'DOS Faucet','url_template':'http
 # FEATURE: USER OPERATIONS (ERC-4337)
 # =============================================================================
 NEXT_PUBLIC_HAS_USER_OPS=true
+# NEXT_PUBLIC_USER_OPS_INDEXER_API_HOST=   # User ops indexer API (set in testnet override)
 
 # =============================================================================
 # FEATURE: STATS SERVICE
@@ -215,9 +229,31 @@ NEXT_PUBLIC_METADATA_ADDRESS_TAGS_UPDATE_ENABLED=true
 # FEATURE: METASUITES
 # =============================================================================
 NEXT_PUBLIC_METASUITES_ENABLED=true
+# NEXT_PUBLIC_METASUITES_API_HOST=         # Custom Metasuites API endpoint
 
 # =============================================================================
 # FEATURE: WEB3 WALLETS
 # =============================================================================
 NEXT_PUBLIC_WEB3_WALLETS=["metamask","rabby","coinbase","token_pocket"]
 NEXT_PUBLIC_WEB3_DISABLE_ADD_TOKEN_TO_WALLET=false
+
+# =============================================================================
+# FEATURE: STAKING & VALIDATORS (NOT YET CONFIGURED)
+# =============================================================================
+# NEXT_PUBLIC_STAKING_ENABLED=false        # Enable staking info display
+# NEXT_PUBLIC_VALIDATORS_SORTING_ENABLED=true  # Enable validator list sorting
+
+# =============================================================================
+# FEATURE: ROLLUP-SPECIFIC (NOT APPLICABLE - DOS Chain is L1)
+# =============================================================================
+# NEXT_PUBLIC_IS_L2_NETWORK=false
+# NEXT_PUBLIC_L1_BASE_URL=
+# NEXT_PUBLIC_OP_STACK_ENABLED=false
+# NEXT_PUBLIC_ARBITRUM_ENABLED=false
+# NEXT_PUBLIC_ZKEVM_ENABLED=false
+
+# =============================================================================
+# FEATURE: SWAP (NOT YET CONFIGURED)
+# =============================================================================
+# NEXT_PUBLIC_SWAP_ENABLED=false
+# NEXT_PUBLIC_SUPPORTED_SWAP_CHAINS=

docs/DOScan-ARCHITECTURE.md

@@ -431,15 +431,46 @@ az vm run-command invoke --resource-group METADOS --name dev \
 | Database | `db` | 7432 | `postgres:15` (mainnet/testnet) / external PostgreSQL 17 (beta) |
 | Redis | `redis-db` | 6379 | `redis:alpine` |
 
-### Microservices
+### Microservices (from [blockscout-rs](https://github.com/blockscout/blockscout-rs))
+
+All microservices run as official Docker images from `ghcr.io/blockscout/`. No fork needed — pull image, configure via env vars.
+
+#### In Use (6/12)
 
 | Service | Container | Port | Image | Purpose |
 |---------|-----------|------|-------|---------|
 | Smart Contract Verifier | `smart-contract-verifier` | 8043 | `ghcr.io/blockscout/smart-contract-verifier:latest` | Verify Solidity/Vyper contracts |
-| Visualizer | `visualizer` | 8044 (mainnet) / 8051 (testnet) | `ghcr.io/blockscout/visualizer:latest` | Sol2UML diagrams |
-| Sig Provider | `sig-provider` | 8045 | `ghcr.io/blockscout/sig-provider:latest` | Method signatures |
-| User Ops Indexer | `user-ops-indexer` | 8090 | `ghcr.io/blockscout/user-ops-indexer:latest` | ERC-4337 indexing (testnet only) |
-| Stats | `stats` | 8052 | `ghcr.io/blockscout/stats:latest` | Blockchain statistics (mainnet + testnet) |
+| Visualizer | `visualizer` | 8044 (mainnet) / 8051 (testnet) | `ghcr.io/blockscout/visualizer:latest` | Sol2UML contract diagrams |
+| Sig Provider | `sig-provider` | 8045 | `ghcr.io/blockscout/sig-provider:latest` | Function/event signature aggregator |
+| User Ops Indexer | `user-ops-indexer` | 8090 | `ghcr.io/blockscout/user-ops-indexer:latest` | ERC-4337 user operations indexing |
+| Stats | `stats` | 8052 | `ghcr.io/blockscout/stats:latest` | Blockchain statistics & charts |
+| BENS (blockscout-ens) | `dos-names-bens` | 18050 | `ghcr.io/blockscout/bens:latest` | DOS Name Service indexing (on dev VM, see below) |
+
+#### Not In Use (6/12)
+
+| Service | Why Not Used |
+|---------|-------------|
+| **eth-bytecode-db** | Cross-chain bytecode DB for auto-verification — single chain, not needed yet |
+| **interchain-indexer** | Universal Bridge Indexer — could use for ICM/ICTT bridge indexing (future) |
+| **proxy-verifier** | Multi-chain verification backend — already have smart-contract-verifier |
+| **da-indexer** | Celestia/EigenDA blob collection — DOS Chain doesn't use DA layers |
+| **tac-operation-lifecycle** | TON Application Chain specific — not applicable |
+| **multichain-aggregator** | Aggregate multiple Blockscout instances + interop — mainnet/testnet run separately |
+
+#### BENS (blockscout-ens) — DOS Name Service
+
+Runs on dev VM (`20.198.249.62`), separate from the main DOScan stack:
+
+| Container | Image | Purpose |
+|-----------|-------|---------|
+| `dos-names-bens` | `ghcr.io/blockscout/bens:latest` | BENS API server |
+| `dos-names-graph-node` | `graphprotocol/graph-node` | Subgraph indexer |
+| `dos-names-postgres` | `postgres` | Graph Node database |
+| `dos-names-ipfs` | `ipfs/kubo` | IPFS for subgraph data |
+
+- **Config:** `~/services/dos-names/`
+- **Port:** 18050
+- **Purpose:** Index DOS Name Service (ENSv2 fork) deployed on DOS Chain testnet
 
 ---