fix(scan): honour ?network=mainnet|testnet on home + list pages (#57)

Audit on 2026-05-11 caught 22 client-side pages calling useNetwork()
without the matching useNetworkFromQuery() — meaning a deeplink like
https://scan.sentrixchain.com/?network=testnet rendered MAINNET data
because the cookie never flipped.

Detail pages already had the call (blocks/[height], tx/[hash],
address/[addr], tokens/[addr]). Home + every list page + every
leaderboard subpage was missing it. This PR adds the one-line call
across all 22 sites with a consistent comment so future pages
follow the pattern.

Verified live before fix:
  GET /?network=testnet → page rendered height ~1,681,800 (mainnet)
                          instead of ~3,172,785 (testnet)

After fix the cookie flips on first render and the page swaps to
the correct network's data.

Typecheck clean.

Author: satyakwok

apps/scan/app/[locale]/HomeContent.tsx

@@ -20,7 +20,7 @@ import { LiveTicker } from "@/components/home/LiveTicker";
 import { StickyStatsBar } from "@/components/home/StickyStatsBar";
 import { TxChart14d } from "@/components/home/TxChart14d";
 import { FreshnessChip } from "@/components/common/FreshnessChip";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useStats, useBlocks, useTransactions, useChainPerformance, useMempool, useCurrentEpoch, useChainStatus } from "@/lib/hooks";
 import { useLatestBlock, useLatestFinalized } from "@/lib/ws";
 import { formatNumber, formatSRX, toMillis } from "@/lib/format";
@@ -77,6 +77,10 @@ function estimateTotalTransactions(
 export function HomeContent({ initial }: { initial: HomeBundle }) {
   const t = useTranslations("home");
   const { network } = useNetwork();
+  // Honour `?network=mainnet|testnet` deeplinks on the home page too —
+  // without this, https://scan.sentrixchain.com/?network=testnet would
+  // render mainnet because the cookie never flips.
+  useNetworkFromQuery();
   const router = useRouter();
   const [query, setQuery] = useState("");
   const [perfRange, setPerfRange] = useState<"1m" | "5m" | "15m" | "1h" | "24h">("1h");

apps/scan/app/[locale]/accounts/page.tsx

@@ -9,7 +9,7 @@ import { Address } from "@/components/common/Address";
 import { PageHeader } from "@/components/common/PageHeader";
 import { Pagination } from "@/components/common/Pagination";
 import { EmptyState } from "@/components/common/EmptyState";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useAccountsTop } from "@/lib/hooks";
 import { formatNumber, formatSRX } from "@/lib/format";
 
@@ -21,6 +21,7 @@ const PAGE_SIZE = 25;
 // SentrixSafe surface their human names automatically.
 export default function AccountsPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const searchParams = useSearchParams();
   const router = useRouter();
   const pathname = usePathname();

apps/scan/app/[locale]/analytics/page.tsx

@@ -8,7 +8,7 @@ import { Skeleton } from "@/components/ui/skeleton";
 import { PageHeader } from "@/components/common/PageHeader";
 import { StatCard } from "@/components/common/StatCard";
 import { EmptyState } from "@/components/common/EmptyState";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useStats, useChainPerformance, useValidators } from "@/lib/hooks";
 import { formatNumber, formatSRX } from "@/lib/format";
 import { fetchDailyStats } from "@/lib/api";
@@ -26,6 +26,7 @@ const AnalyticsCharts = dynamic(() => import("./charts").then((m) => m.Analytics
 // so no new API work is needed to light this up.
 export default function AnalyticsPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const { data: stats, loading: statsLoading } = useStats(network);
   const { data: perf } = useChainPerformance(network, "24h");
   const { data: validators } = useValidators(network);

apps/scan/app/[locale]/api-docs/page.tsx

@@ -4,7 +4,7 @@ import { useState } from "react";
 import { Code, Copy, ExternalLink, Check } from "lucide-react";
 import { PageHeader } from "@/components/common/PageHeader";
 import { DetailCard } from "@/components/common/DetailCard";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { cn } from "@/lib/utils";
 
 // DECISION: hand-curated API docs page rather than Mintlify or Swagger UI.
@@ -109,6 +109,7 @@ const WS_CHANNELS: Array<{ name: string; method: "eth_subscribe"; summary: strin
 
 export default function ApiDocsPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const restBase = network === "mainnet" ? "https://rpc.sentrixchain.com" : "https://testnet-rpc.sentrixchain.com";
   const wsBase = network === "mainnet" ? "wss://rpc.sentrixchain.com/ws" : "wss://testnet-rpc.sentrixchain.com/ws";
 

apps/scan/app/[locale]/blocks/page.tsx

@@ -11,7 +11,7 @@ import { Timestamp } from "@/components/common/Timestamp";
 import { Copyable } from "@/components/common/Copyable";
 import { Pagination } from "@/components/common/Pagination";
 import { PageHeader } from "@/components/common/PageHeader";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { fetchBlocksPage, type BlockData } from "@/lib/api";
 import { shortenHash } from "@/lib/format";
 
@@ -20,6 +20,8 @@ const PAGE_SIZE = 50; // server cap is 100; 50 is comfortable on a phone
 export default function BlocksPage() {
   const t = useTranslations("blocks");
   const { network } = useNetwork();
+  // Deeplink network switch — same pattern as detail pages.
+  useNetworkFromQuery();
   // Server-paginated against `/chain/blocks?page=N&limit=M`. Each page hits
   // the backend fresh so we get accurate "page N of M" semantics across the
   // full in-memory window (CHAIN_WINDOW_SIZE = 1000) — much deeper than the

apps/scan/app/[locale]/contracts/page.tsx

@@ -6,7 +6,7 @@ import { useEffect, useState } from "react";
 import { PageHeader } from "@/components/common/PageHeader";
 import { DetailCard } from "@/components/common/DetailCard";
 import { Address } from "@/components/common/Address";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useSourcifyStatus } from "@/lib/sourcify";
 import { fetchRecentContracts, type RecentContract } from "@/lib/api";
 
@@ -73,6 +73,7 @@ const CANONICAL: CanonicalEntry[] = [
 
 export default function ContractsPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const [lookup, setLookup] = useState("");
   const [submitted, setSubmitted] = useState<string | null>(null);
 

apps/scan/app/[locale]/epochs/page.tsx

@@ -7,7 +7,7 @@ import { PageHeader } from "@/components/common/PageHeader";
 import { DetailCard } from "@/components/common/DetailCard";
 import { InfoRow } from "@/components/common/InfoRow";
 import { StatCard } from "@/components/common/StatCard";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useStats, useCurrentEpoch, useValidators } from "@/lib/hooks";
 import { formatNumber, formatSRX } from "@/lib/format";
 
@@ -34,6 +34,7 @@ const PAST_TO_SHOW = 12;
 
 export default function EpochsPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const { data: stats } = useStats(network);
   const { data: epoch } = useCurrentEpoch(network);
   const { data: validators } = useValidators(network);

apps/scan/app/[locale]/forks/page.tsx

@@ -3,7 +3,7 @@
 import { GitFork, CheckCircle2, AlertTriangle, Clock } from "lucide-react";
 import { PageHeader } from "@/components/common/PageHeader";
 import { DetailCard } from "@/components/common/DetailCard";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useStats } from "@/lib/hooks";
 import { FORKS, forkStateAt, type ForkEntry } from "@/lib/forks/registry";
 import { formatNumber } from "@/lib/format";
@@ -23,6 +23,7 @@ import { cn } from "@/lib/utils";
 
 export default function ForksPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const { data: stats } = useStats(network);
   const height = stats?.height ?? 0;
 

apps/scan/app/[locale]/gas/page.tsx

@@ -5,7 +5,7 @@ import { Flame, Zap, Gauge, Turtle, Rabbit, Rocket } from "lucide-react";
 import { PageHeader } from "@/components/common/PageHeader";
 import { DetailCard } from "@/components/common/DetailCard";
 import { StatCard } from "@/components/common/StatCard";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useStats, useMempool } from "@/lib/hooks";
 import { formatNumber } from "@/lib/format";
 import { fetchBlocksPage, type BlockData } from "@/lib/api";
@@ -30,6 +30,7 @@ const SENTRI_PER_SRX = 100_000_000;
 
 export default function GasPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const { data: stats } = useStats(network);
   const { data: mempool } = useMempool(network);
 

apps/scan/app/[locale]/leaderboard/account/active/page.tsx

@@ -7,14 +7,15 @@ import { Skeleton } from "@/components/ui/skeleton";
 import { Address } from "@/components/common/Address";
 import { Pagination } from "@/components/common/Pagination";
 import { RankBadge } from "@/components/common/RankBadge";
-import { useNetwork } from "@/lib/network-context";
+import { useNetwork, useNetworkFromQuery } from "@/lib/network-context";
 import { useActiveAccounts } from "@/lib/hooks";
 import { formatNumber } from "@/lib/format";
 
 const PAGE_SIZE = 25;
 
 export default function MostActiveAccountsPage() {
   const { network } = useNetwork();
+  useNetworkFromQuery();
   const { data: accounts, loading } = useActiveAccounts(network, 100);
   const [page, setPage] = useState(1);