From 49d9f31182325288f23f753b7215aae06edf7c39 Mon Sep 17 00:00:00 2001
From: NextJS <next@playpoolstudios.com>
Date: Mon, 11 May 2026 06:34:15 +0000
Subject: [PATCH] ledger revanced

---
 package.json                                  |   4 +-
 src/app/actions/update-user-cc-rc.ts          |  38 +-
 src/app/page.tsx                              | 113 +-
 src/components/admin-dashboard.tsx            |  41 +-
 src/components/admin-ledger.tsx               | 986 +++++++++++++-----
 src/components/edit-user-cc-rc-overlay.tsx    |  37 +
 .../ledger-range-cumulative-chart.tsx         | 194 ++++
 src/lib/dashboard-search-url.ts               |  29 +
 src/lib/ledger-global-summary-server.ts       |  48 +
 src/lib/ledger-integrity.ts                   | 210 ++++
 src/lib/ledger-scoped-daily-series.ts         |  78 ++
 src/lib/ledger-table-view.ts                  | 176 ++++
 src/lib/ledger-utc-date-range.ts              |  67 ++
 13 files changed, 1719 insertions(+), 302 deletions(-)
 create mode 100644 src/components/ledger-range-cumulative-chart.tsx
 create mode 100644 src/lib/ledger-global-summary-server.ts
 create mode 100644 src/lib/ledger-integrity.ts
 create mode 100644 src/lib/ledger-scoped-daily-series.ts
 create mode 100644 src/lib/ledger-table-view.ts
 create mode 100644 src/lib/ledger-utc-date-range.ts

diff --git a/package.json b/package.json
index cc0cd03..87d27ec 100644
--- a/package.json
+++ b/package.json
@@ -3,9 +3,9 @@
   "version": "0.1.0",
   "private": true,
   "scripts": {
-    "dev": "next dev -p 2613",
+    "dev": "next dev -p 2614",
     "build": "next build",
-    "start": "next start -p 2613",
+    "start": "next start -p 2614",
     "lint": "eslint"
   },
   "dependencies": {
diff --git a/src/app/actions/update-user-cc-rc.ts b/src/app/actions/update-user-cc-rc.ts
index 107aff0..e2150d5 100644
--- a/src/app/actions/update-user-cc-rc.ts
+++ b/src/app/actions/update-user-cc-rc.ts
@@ -8,6 +8,7 @@ import {
   type AdminDashboardTab,
 } from "@/lib/dashboard-search-url";
 import { createAdminSupabase } from "@/lib/supabase/admin";
+import { normalizeLedgerPageSize } from "@/lib/ledger-table-view";
 
 function parseScoreField(raw: FormDataEntryValue | null): number | null {
   if (raw == null) return null;
@@ -41,7 +42,42 @@ export async function updateUserCcRc(formData: FormData) {
   const participant =
     participantRaw === "" ? null : participantRaw;
 
-  const base = { tab, highlightId, participantRaw: participant };
+  const ledgerFromRaw = String(formData.get("ledgerFrom") ?? "").trim();
+  const ledgerToRaw = String(formData.get("ledgerTo") ?? "").trim();
+  const ledgerPageRaw = String(formData.get("ledgerPage") ?? "").trim();
+  const ledgerPageSizeRaw = String(
+    formData.get("ledgerPageSize") ?? "",
+  ).trim();
+  const ledgerSortRaw = String(formData.get("ledgerSort") ?? "").trim();
+  const ledgerOrderRaw = String(formData.get("ledgerOrder") ?? "").trim();
+  const ledgerPageNum =
+    ledgerPageRaw === "" ? NaN : Number.parseInt(ledgerPageRaw, 10);
+
+  const base = {
+    tab,
+    highlightId,
+    participantRaw: participant,
+    ...(tab === "ledger"
+      ? {
+          ledgerFrom: ledgerFromRaw || null,
+          ledgerTo: ledgerToRaw || null,
+          ledgerPage:
+            Number.isInteger(ledgerPageNum) && ledgerPageNum > 1
+              ? ledgerPageNum
+              : null,
+          ledgerSort: ledgerSortRaw || null,
+          ledgerOrder:
+            ledgerOrderRaw === "desc"
+              ? ("desc" as const)
+              : ledgerOrderRaw === "asc"
+                ? ("asc" as const)
+                : null,
+          ledgerPageSize: normalizeLedgerPageSize(
+            ledgerPageSizeRaw === "" ? null : ledgerPageSizeRaw,
+          ),
+        }
+      : {}),
+  };
 
   if (!Number.isInteger(userId) || userId < 1) {
     redirect(buildDashboardHref(base));
diff --git a/src/app/page.tsx b/src/app/page.tsx
index be518ba..a9d0b4e 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -2,6 +2,15 @@ import { AdminDashboard } from "@/components/admin-dashboard";
 import { AdminHeader } from "@/components/admin-header";
 import { EditUserCcRcOverlay } from "@/components/edit-user-cc-rc-overlay";
 import { loadDashboardStatsBundle } from "@/lib/dashboard-stats";
+import {
+  normalizeLedgerDateRange,
+  utcLast30DaysDateRange,
+} from "@/lib/ledger-utc-date-range";
+import { fetchLedgerGlobalSummary } from "@/lib/ledger-global-summary-server";
+import {
+  serializeLedgerGlobalSummary,
+  type SerializedLedgerGlobalSummary,
+} from "@/lib/ledger-integrity";
 import { createAdminSupabase } from "@/lib/supabase/admin";
 import type { AdminDashboardTab } from "@/lib/dashboard-search-url";
 import {
@@ -10,6 +19,16 @@ import {
 } from "@/lib/matchmaker-log-source";
 import { readMatchmakerLogFile } from "@/lib/matchmaker-logs-server";
 import type { DbMatch, DbTransaction, DbUser } from "@/types/database";
+import {
+  normalizeLedgerPage,
+  normalizeLedgerPageSize,
+  normalizeLedgerSortKey,
+  normalizeLedgerSortOrder,
+  sliceLedgerPage,
+  sortLedgerTransactions,
+  type LedgerSortKey,
+  type LedgerSortOrder,
+} from "@/lib/ledger-table-view";
 
 export const dynamic = "force-dynamic";
 
@@ -31,6 +50,12 @@ export default async function Home({
     edit?: string | string[];
     saveError?: string | string[];
     mklog?: string | string[];
+    lfrom?: string | string[];
+    lto?: string | string[];
+    lpage?: string | string[];
+    lsize?: string | string[];
+    lsort?: string | string[];
+    lorder?: string | string[];
   }>;
 }) {
   const sp = await searchParams;
@@ -58,8 +83,18 @@ export default async function Home({
   let configError: string | null = null;
   let usersError: string | null = null;
   let matchesError: string | null = null;
-  let transactions: DbTransaction[] = [];
   let transactionsError: string | null = null;
+  let ledgerGlobalSummary: SerializedLedgerGlobalSummary | null = null;
+  let ledgerTransactionsFiltered: DbTransaction[] = [];
+  let ledgerTableRows: DbTransaction[] = [];
+  let ledgerTotalRowsInRange = 0;
+  let ledgerPageView = 1;
+  let ledgerPageSizeView = normalizeLedgerPageSize(null);
+  let ledgerTotalPagesView = 1;
+  let ledgerSortKeyView: LedgerSortKey = "created_at";
+  let ledgerSortOrderView: LedgerSortOrder = "desc";
+  let ledgerFrom = utcLast30DaysDateRange().from;
+  let ledgerTo = utcLast30DaysDateRange().to;
   let statsBundle: Awaited<ReturnType<typeof loadDashboardStatsBundle>> | null =
     null;
 
@@ -108,15 +143,61 @@ export default async function Home({
     statsBundle = await loadDashboardStatsBundle(supabase);
 
     if (tab === "ledger") {
-      const txRes = await supabase
+      const lfromRaw = firstSearchParam(sp.lfrom);
+      const ltoRaw = firstSearchParam(sp.lto);
+      const range = normalizeLedgerDateRange(lfromRaw, ltoRaw);
+      ledgerFrom = range.from;
+      ledgerTo = range.to;
+      const rangeStartIso = `${ledgerFrom}T00:00:00.000Z`;
+      const rangeEndIso = `${ledgerTo}T23:59:59.999Z`;
+
+      const filteredQuery = supabase
         .from("transactions")
         .select("id, created_at, from, to, amount, remarks, match_id")
-        .order("id", { ascending: false })
-        .limit(5000);
-      if (txRes.error) {
-        transactionsError = txRes.error.message;
+        .gte("created_at", rangeStartIso)
+        .lte("created_at", rangeEndIso)
+        .order("created_at", { ascending: true })
+        .order("id", { ascending: true })
+        .limit(10000);
+
+      const [globalRes, filteredRes] = await Promise.all([
+        fetchLedgerGlobalSummary(supabase),
+        filteredQuery,
+      ]);
+
+      if (!globalRes.ok) {
+        transactionsError = globalRes.message;
       } else {
-        transactions = (txRes.data ?? []) as DbTransaction[];
+        ledgerGlobalSummary = serializeLedgerGlobalSummary(globalRes.data);
+      }
+      if (filteredRes.error) {
+        if (!transactionsError) {
+          transactionsError = filteredRes.error.message;
+        }
+      } else {
+        ledgerTransactionsFiltered = (filteredRes.data ??
+          []) as DbTransaction[];
+        const pageRaw = normalizeLedgerPage(firstSearchParam(sp.lpage));
+        ledgerPageSizeView = normalizeLedgerPageSize(
+          firstSearchParam(sp.lsize),
+        );
+        ledgerSortKeyView = normalizeLedgerSortKey(
+          firstSearchParam(sp.lsort),
+        );
+        ledgerSortOrderView = normalizeLedgerSortOrder(
+          firstSearchParam(sp.lorder),
+          ledgerSortKeyView,
+        );
+        const sorted = sortLedgerTransactions(
+          ledgerTransactionsFiltered,
+          ledgerSortKeyView,
+          ledgerSortOrderView,
+        );
+        const slice = sliceLedgerPage(sorted, pageRaw, ledgerPageSizeView);
+        ledgerTableRows = slice.rows;
+        ledgerTotalRowsInRange = slice.totalRows;
+        ledgerPageView = slice.page;
+        ledgerTotalPagesView = slice.totalPages;
       }
     }
   }
@@ -145,7 +226,6 @@ export default async function Home({
             matches={matches}
             usersError={usersError}
             matchesError={matchesError}
-            transactions={transactions}
             transactionsError={transactionsError}
             statsBundle={statsBundle}
             tab={tab}
@@ -154,6 +234,17 @@ export default async function Home({
             matchmakerSource={matchmakerSource}
             matchmakerContent={matchmakerContent}
             matchmakerError={matchmakerError}
+            ledgerGlobalSummary={ledgerGlobalSummary}
+            ledgerTransactionsFiltered={ledgerTransactionsFiltered}
+            ledgerTableRows={ledgerTableRows}
+            ledgerTotalRowsInRange={ledgerTotalRowsInRange}
+            ledgerPage={ledgerPageView}
+            ledgerPageSize={ledgerPageSizeView}
+            ledgerTotalPages={ledgerTotalPagesView}
+            ledgerSort={ledgerSortKeyView}
+            ledgerOrder={ledgerSortOrderView}
+            ledgerFrom={ledgerFrom}
+            ledgerTo={ledgerTo}
           />
           {editUser ? (
             <EditUserCcRcOverlay
@@ -162,6 +253,12 @@ export default async function Home({
               highlightId={highlightId}
               participantRaw={participantRaw}
               saveError={saveError}
+              ledgerFrom={ledgerFrom}
+              ledgerTo={ledgerTo}
+              ledgerPage={ledgerPageView}
+              ledgerPageSize={ledgerPageSizeView}
+              ledgerSort={ledgerSortKeyView}
+              ledgerOrder={ledgerSortOrderView}
             />
           ) : null}
         </>
diff --git a/src/components/admin-dashboard.tsx b/src/components/admin-dashboard.tsx
index a1bd353..e8d06c4 100644
--- a/src/components/admin-dashboard.tsx
+++ b/src/components/admin-dashboard.tsx
@@ -12,6 +12,8 @@ import {
 } from "@/lib/dashboard-search-url";
 import type { MatchmakerLogSource } from "@/lib/matchmaker-log-source";
 import type { DbMatch, DbTransaction, DbUser } from "@/types/database";
+import type { SerializedLedgerGlobalSummary } from "@/lib/ledger-integrity";
+import type { LedgerSortKey, LedgerSortOrder } from "@/lib/ledger-table-view";
 
 /** Bigint columns often arrive as strings from PostgREST / JSON. */
 function matchHasRecordedWinner(winnerId: DbMatch["winner_id"]): boolean {
@@ -59,8 +61,21 @@ type Props = {
   matches: DbMatch[];
   usersError: string | null;
   matchesError: string | null;
-  transactions: DbTransaction[];
   transactionsError: string | null;
+  /** Ledger tab: full-database totals + user nets (server scan). */
+  ledgerGlobalSummary: SerializedLedgerGlobalSummary | null;
+  /** Ledger tab: rows in the selected UTC date range (full set for audits). */
+  ledgerTransactionsFiltered: DbTransaction[];
+  /** Ledger tab: current page of the ledger table (sorted + paginated). */
+  ledgerTableRows: DbTransaction[];
+  ledgerTotalRowsInRange: number;
+  ledgerPage: number;
+  ledgerPageSize: number;
+  ledgerTotalPages: number;
+  ledgerSort: LedgerSortKey;
+  ledgerOrder: LedgerSortOrder;
+  ledgerFrom: string;
+  ledgerTo: string;
   statsBundle: DashboardStatsBundle | null;
   /** From server `searchParams` so SSR and client markup match (do not use `useSearchParams` here). */
   tab: AdminDashboardTab;
@@ -99,8 +114,18 @@ export function AdminDashboard({
   matches,
   usersError,
   matchesError,
-  transactions,
   transactionsError,
+  ledgerGlobalSummary,
+  ledgerTransactionsFiltered,
+  ledgerTableRows,
+  ledgerTotalRowsInRange,
+  ledgerPage,
+  ledgerPageSize,
+  ledgerTotalPages,
+  ledgerSort,
+  ledgerOrder,
+  ledgerFrom,
+  ledgerTo,
   statsBundle,
   tab,
   highlightId,
@@ -503,11 +528,21 @@ export function AdminDashboard({
           </section>
         ) : tab === "ledger" ? (
           <AdminLedger
-            transactions={transactions}
+            ledgerGlobalSummary={ledgerGlobalSummary}
+            transactionsScoped={ledgerTransactionsFiltered}
+            ledgerTableRows={ledgerTableRows}
+            ledgerTotalRowsInRange={ledgerTotalRowsInRange}
+            ledgerPage={ledgerPage}
+            ledgerPageSize={ledgerPageSize}
+            ledgerTotalPages={ledgerTotalPages}
+            ledgerSort={ledgerSort}
+            ledgerOrder={ledgerOrder}
             users={users}
             error={transactionsError}
             highlightId={highlightId}
             participantRaw={participantRaw}
+            ledgerFrom={ledgerFrom}
+            ledgerTo={ledgerTo}
           />
         ) : (
           <section className="space-y-3">
diff --git a/src/components/admin-ledger.tsx b/src/components/admin-ledger.tsx
index 7c1378b..caeeea3 100644
--- a/src/components/admin-ledger.tsx
+++ b/src/components/admin-ledger.tsx
@@ -5,8 +5,41 @@ import { useMemo } from "react";
 import { buildDashboardHref } from "@/lib/dashboard-search-url";
 import { formatRcLabelFromCoinsBigInt } from "@/lib/coins-rc";
 import { auditMatchEconomics } from "@/lib/ledger-match-audit";
+import {
+  computeLedgerIntegrity,
+  parseSerializedLedgerGlobalSummary,
+  txAmountToBigInt,
+  type LedgerIntegrity,
+  type SerializedLedgerGlobalSummary,
+} from "@/lib/ledger-integrity";
+import {
+  DEFAULT_LEDGER_PAGE_SIZE,
+  LEDGER_PAGE_SIZE_OPTIONS,
+  ledgerPaginationItems,
+  type LedgerSortKey,
+  type LedgerSortOrder,
+} from "@/lib/ledger-table-view";
+import { buildLedgerScopedDailyCumulativeSeries } from "@/lib/ledger-scoped-daily-series";
+import { LedgerRangeCumulativeChart } from "@/components/ledger-range-cumulative-chart";
 import type { DbTransaction, DbUser } from "@/types/database";
 
+function emptyIntegrity(): LedgerIntegrity {
+  const z = BigInt(0);
+  return {
+    mintTotal: z,
+    sinkTotal: z,
+    entryFeeCoinsTotal: z,
+    purchaseCoinsTotal: z,
+    entryHoldCoinsTotal: z,
+    rewardCoinsTotal: z,
+    sumUserNets: z,
+    balanced: true,
+    totalDebitVolume: z,
+    totalCreditVolume: z,
+    volumeBalanced: true,
+  };
+}
+
 function formatTsUtc(value: string | null): string {
   if (!value) return "—";
   try {
@@ -18,20 +51,6 @@ function formatTsUtc(value: string | null): string {
   }
 }
 
-function txAmountToBigInt(raw: number | string): bigint {
-  if (typeof raw === "number") {
-    if (!Number.isFinite(raw)) return BigInt(0);
-    return BigInt(Math.trunc(raw));
-  }
-  const t = String(raw).trim();
-  if (t === "" || !/^-?\d+$/.test(t)) return BigInt(0);
-  try {
-    return BigInt(t);
-  } catch {
-    return BigInt(0);
-  }
-}
-
 function formatBigAmount(n: bigint): string {
   return n.toLocaleString("en-US");
 }
@@ -50,102 +69,40 @@ function remarkClass(remarks: string | null): string {
   return "bg-zinc-100 text-zinc-700 dark:bg-zinc-800 dark:text-zinc-200";
 }
 
-function isEntryFeeRemark(remarks: string | null): boolean {
-  return (remarks ?? "").toLowerCase().trim() === "entry_fee";
-}
-
-export type LedgerIntegrity = {
-  mintTotal: bigint;
-  /** Outflows with no payee (kept for internal checks only). */
-  sinkTotal: bigint;
-  entryFeeCoinsTotal: bigint;
-  purchaseCoinsTotal: bigint;
-  entryHoldCoinsTotal: bigint;
-  rewardCoinsTotal: bigint;
-  sumUserNets: bigint;
-  balanced: boolean;
-  totalDebitVolume: bigint;
-  totalCreditVolume: bigint;
-  volumeBalanced: boolean;
-};
-
-function computeIntegrity(rows: DbTransaction[]): LedgerIntegrity {
-  let mintTotal = BigInt(0);
-  let sinkTotal = BigInt(0);
-  let entryFeeCoinsTotal = BigInt(0);
-  let purchaseCoinsTotal = BigInt(0);
-  let entryHoldCoinsTotal = BigInt(0);
-  let rewardCoinsTotal = BigInt(0);
-  const net = new Map<number, bigint>();
-  let totalDebitVolume = BigInt(0);
-  let totalCreditVolume = BigInt(0);
-
-  for (const row of rows) {
-    const a = txAmountToBigInt(row.amount);
-    if (a === BigInt(0)) continue;
-    if (isEntryFeeRemark(row.remarks)) {
-      entryFeeCoinsTotal += a;
-    }
-    const remark = (row.remarks ?? "").toLowerCase().trim();
-    if (remark === "purchase") purchaseCoinsTotal += a;
-    if (remark === "entry_hold") entryHoldCoinsTotal += a;
-    if (remark === "reward") rewardCoinsTotal += a;
-    if (row.from == null) {
-      mintTotal += a;
-    } else {
-      totalDebitVolume += a;
-      const prev = net.get(row.from) ?? BigInt(0);
-      net.set(row.from, prev - a);
-    }
-    if (row.to == null) {
-      sinkTotal += a;
-    } else {
-      totalCreditVolume += a;
-      const prev = net.get(row.to) ?? BigInt(0);
-      net.set(row.to, prev + a);
-    }
-  }
-
-  let sumUserNets = BigInt(0);
-  for (const v of net.values()) {
-    sumUserNets += v;
-  }
-
-  const netIssued = mintTotal - sinkTotal;
-  const balanced = sumUserNets === netIssued;
-
-  const volumeBalanced =
-    totalDebitVolume + mintTotal === totalCreditVolume + sinkTotal;
-
-  return {
-    mintTotal,
-    sinkTotal,
-    entryFeeCoinsTotal,
-    purchaseCoinsTotal,
-    entryHoldCoinsTotal,
-    rewardCoinsTotal,
-    sumUserNets,
-    balanced,
-    totalDebitVolume,
-    totalCreditVolume,
-    volumeBalanced,
-  };
-}
-
 type Props = {
-  transactions: DbTransaction[];
+  ledgerGlobalSummary: SerializedLedgerGlobalSummary | null;
+  transactionsScoped: DbTransaction[];
+  ledgerTableRows: DbTransaction[];
+  ledgerTotalRowsInRange: number;
+  ledgerPage: number;
+  ledgerPageSize: number;
+  ledgerTotalPages: number;
+  ledgerSort: LedgerSortKey;
+  ledgerOrder: LedgerSortOrder;
   users: DbUser[];
   error: string | null;
   highlightId: string | null;
   participantRaw: string | null;
+  ledgerFrom: string;
+  ledgerTo: string;
 };
 
 export function AdminLedger({
-  transactions,
+  ledgerGlobalSummary,
+  transactionsScoped,
+  ledgerTableRows,
+  ledgerTotalRowsInRange,
+  ledgerPage,
+  ledgerPageSize,
+  ledgerTotalPages,
+  ledgerSort,
+  ledgerOrder,
   users,
   error,
   highlightId,
   participantRaw,
+  ledgerFrom,
+  ledgerTo,
 }: Props) {
   const usernameById = useMemo(() => {
     const m = new Map<number, string | null>();
@@ -155,42 +112,81 @@ export function AdminLedger({
     return m;
   }, [users]);
 
-  const integrity = useMemo(
-    () => computeIntegrity(transactions),
-    [transactions],
+  const { integrityGlobal, userNets } = useMemo(() => {
+    if (ledgerGlobalSummary == null) {
+      return {
+        integrityGlobal: emptyIntegrity(),
+        userNets: [] as [number, bigint][],
+      };
+    }
+    const { integrity, userNets } =
+      parseSerializedLedgerGlobalSummary(ledgerGlobalSummary);
+    return { integrityGlobal: integrity, userNets };
+  }, [ledgerGlobalSummary]);
+
+  const integrityScoped = useMemo(
+    () => computeLedgerIntegrity(transactionsScoped),
+    [transactionsScoped],
+  );
+
+  const scopedDailyCumulative = useMemo(
+    () =>
+      buildLedgerScopedDailyCumulativeSeries(
+        transactionsScoped,
+        ledgerFrom,
+        ledgerTo,
+      ),
+    [transactionsScoped, ledgerFrom, ledgerTo],
   );
 
   const matchChecks = useMemo(
-    () => auditMatchEconomics(transactions),
-    [transactions],
+    () => auditMatchEconomics(transactionsScoped),
+    [transactionsScoped],
   );
 
-  const userNets = useMemo(() => {
-    const net = new Map<number, bigint>();
-    for (const row of transactions) {
-      const a = txAmountToBigInt(row.amount);
-      if (a === BigInt(0)) continue;
-      if (row.from != null) {
-        net.set(row.from, (net.get(row.from) ?? BigInt(0)) - a);
-      }
-      if (row.to != null) {
-        net.set(row.to, (net.get(row.to) ?? BigInt(0)) + a);
-      }
-    }
-    return [...net.entries()]
-      .filter(([, v]) => v !== BigInt(0))
-      .sort((a, b) => {
-        const da = a[1] < BigInt(0) ? -a[1] : a[1];
-        const db = b[1] < BigInt(0) ? -b[1] : b[1];
-        if (da === db) return a[0] - b[0];
-        return db > da ? 1 : -1;
-      });
-  }, [transactions]);
+  function ledgerHref(
+    override: Partial<{
+      ledgerPage: number;
+      ledgerSort: LedgerSortKey;
+      ledgerOrder: LedgerSortOrder;
+      ledgerPageSize: number;
+    }>,
+  ): string {
+    return buildDashboardHref({
+      tab: "ledger",
+      highlightId,
+      participantRaw,
+      ledgerFrom,
+      ledgerTo,
+      ledgerPage: override.ledgerPage ?? ledgerPage,
+      ledgerSort: override.ledgerSort ?? ledgerSort,
+      ledgerOrder: override.ledgerOrder ?? ledgerOrder,
+      ledgerPageSize: override.ledgerPageSize ?? ledgerPageSize,
+    });
+  }
 
-  const ledgerRowsChronological = useMemo(
-    () => [...transactions].sort((a, b) => a.id - b.id),
-    [transactions],
-  );
+  function sortToggleHref(column: LedgerSortKey): string {
+    const nextOrder: LedgerSortOrder =
+      ledgerSort === column
+        ? ledgerOrder === "asc"
+          ? "desc"
+          : "asc"
+        : "asc";
+    return ledgerHref({
+      ledgerSort: column,
+      ledgerOrder: nextOrder,
+      ledgerPage: 1,
+    });
+  }
+
+  function sortHeaderClass(column: LedgerSortKey): string {
+    return [
+      "whitespace-nowrap px-4 py-3 font-medium transition",
+      ledgerSort === column
+        ? "text-sky-800 dark:text-sky-200"
+        : "text-zinc-600 dark:text-zinc-400",
+    ].join(" ");
+  }
 
   function userCell(id: number | null, role: "from" | "to") {
     if (id == null) {
@@ -221,17 +217,41 @@ export function AdminLedger({
     );
   }
 
-  const feeRcLabel = formatRcLabelFromCoinsBigInt(
-    integrity.entryFeeCoinsTotal,
+  const feeRcLabelGlobal = formatRcLabelFromCoinsBigInt(
+    integrityGlobal.entryFeeCoinsTotal,
   );
-  const purchaseRcLabel = formatRcLabelFromCoinsBigInt(
-    integrity.purchaseCoinsTotal,
+  const purchaseRcLabelGlobal = formatRcLabelFromCoinsBigInt(
+    integrityGlobal.purchaseCoinsTotal,
   );
-  const entryHoldRcLabel = formatRcLabelFromCoinsBigInt(
-    integrity.entryHoldCoinsTotal,
+  const entryHoldRcLabelGlobal = formatRcLabelFromCoinsBigInt(
+    integrityGlobal.entryHoldCoinsTotal,
+  );
+  const feeRcLabelScoped = formatRcLabelFromCoinsBigInt(
+    integrityScoped.entryFeeCoinsTotal,
+  );
+  const purchaseRcLabelScoped = formatRcLabelFromCoinsBigInt(
+    integrityScoped.purchaseCoinsTotal,
+  );
+  const entryHoldRcLabelScoped = formatRcLabelFromCoinsBigInt(
+    integrityScoped.entryHoldCoinsTotal,
   );
   const holdRewardMismatch =
-    integrity.entryHoldCoinsTotal !== integrity.rewardCoinsTotal;
+    integrityScoped.entryHoldCoinsTotal !==
+    integrityScoped.rewardCoinsTotal;
+
+  const pageStart =
+    ledgerTotalRowsInRange === 0
+      ? 0
+      : (ledgerPage - 1) * ledgerPageSize + 1;
+  const pageEnd = Math.min(
+    ledgerPage * ledgerPageSize,
+    ledgerTotalRowsInRange,
+  );
+  const pageNavItems = ledgerPaginationItems(ledgerPage, ledgerTotalPages);
+
+  const navLinkClass =
+    "rounded px-2 py-1 font-medium text-sky-700 underline decoration-sky-400/50 underline-offset-2 hover:bg-sky-50 dark:text-sky-300 dark:hover:bg-sky-950/40";
+  const navMutedClass = "rounded px-2 py-1 text-zinc-400 dark:text-zinc-500";
 
   return (
     <section className="space-y-6">
@@ -243,121 +263,333 @@ export function AdminLedger({
           Ledger book
         </Link>
         {" — "}
-        double-entry view by date range (default last month UTC).
+        The ledger table and match checks use the selected UTC range (default
+        last 30 days). User nets, Σ issuance, and the three all-time fee /
+        purchase / hold cards are computed from{" "}
+        <span className="font-medium">every</span> transaction row. The same
+        metrics for the date range only appear under the filter.
       </p>
 
       {error ? (
         <p className="text-sm text-red-600 dark:text-red-400">{error}</p>
       ) : null}
 
-      <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-6">
-        <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
-          <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
-            Rows loaded
-          </p>
-          <p className="mt-1 text-2xl font-semibold tabular-nums text-zinc-900 dark:text-zinc-50">
-            {transactions.length.toLocaleString("en-US")}
-          </p>
-        </div>
-        <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
-          <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
-            Mint total (∅ from)
-          </p>
-          <p className="mt-1 text-2xl font-semibold tabular-nums text-emerald-800 dark:text-emerald-200">
-            {formatBigAmount(integrity.mintTotal)}
-          </p>
-        </div>
-        <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
-          <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
-            Fee collected (entry_fee)
-          </p>
-          <p
-            className="mt-1 text-2xl font-semibold tabular-nums text-violet-800 dark:text-violet-200"
-            title={`${formatBigAmount(integrity.entryFeeCoinsTotal)} coins`}
+      <div className="grid gap-4 lg:grid-cols-3">
+        <div className="flex flex-col gap-3 lg:col-span-1">
+          <div
+            className={[
+              "rounded-xl border p-4 shadow-sm",
+              integrityGlobal.balanced
+                ? "border-emerald-200 bg-emerald-50 dark:border-emerald-900 dark:bg-emerald-950/40"
+                : "border-amber-200 bg-amber-50 dark:border-amber-900 dark:bg-amber-950/40",
+            ].join(" ")}
           >
-            {feeRcLabel}
-          </p>
-          <p className="mt-0.5 text-xs tabular-nums text-zinc-500 dark:text-zinc-400">
-            {formatBigAmount(integrity.entryFeeCoinsTotal)} coins
-          </p>
-        </div>
-        <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
-          <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
-            Total purchase
-          </p>
-          <p
-            className="mt-1 text-2xl font-semibold tabular-nums text-sky-800 dark:text-sky-200"
-            title={`${formatBigAmount(integrity.purchaseCoinsTotal)} coins`}
-          >
-            {purchaseRcLabel}
-          </p>
-          <p className="mt-0.5 text-xs tabular-nums text-zinc-500 dark:text-zinc-400">
-            {formatBigAmount(integrity.purchaseCoinsTotal)} coins
-          </p>
-        </div>
-        <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
-          <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
-            Total entry_hold / reward
-          </p>
-          <p
-            className="mt-1 text-2xl font-semibold tabular-nums text-amber-800 dark:text-amber-200"
-            title={`${formatBigAmount(integrity.entryHoldCoinsTotal)} coins`}
-          >
-            {entryHoldRcLabel}
-          </p>
-          <p className="mt-0.5 text-xs tabular-nums text-zinc-500 dark:text-zinc-400">
-            {formatBigAmount(integrity.entryHoldCoinsTotal)} coins
-          </p>
-        </div>
-        <div
-          className={[
-            "rounded-xl border p-4 shadow-sm",
-            integrity.balanced
-              ? "border-emerald-200 bg-emerald-50 dark:border-emerald-900 dark:bg-emerald-950/40"
-              : "border-amber-200 bg-amber-50 dark:border-amber-900 dark:bg-amber-950/40",
-          ].join(" ")}
-        >
-          <p className="text-xs font-medium uppercase tracking-wide text-zinc-600 dark:text-zinc-400">
-            Σ user nets vs net issued
-          </p>
-          <div className="mt-1 text-sm tabular-nums text-zinc-900 dark:text-zinc-100">
-            <p className="font-mono">
-              {formatBigAmount(integrity.sumUserNets)}
+            <p className="text-xs font-medium uppercase tracking-wide text-zinc-600 dark:text-zinc-400">
+              Σ user nets vs net issued
             </p>
-            <p className="font-mono text-zinc-600 dark:text-zinc-400">
-              ={" "}
-              {formatBigAmount(
-                integrity.mintTotal - integrity.sinkTotal,
-              )}
+            <p className="mt-1 text-xs text-zinc-500 dark:text-zinc-400">
+              All transactions
+            </p>
+            <div className="mt-2 text-sm tabular-nums text-zinc-900 dark:text-zinc-100">
+              <p className="font-mono">
+                {formatBigAmount(integrityGlobal.sumUserNets)}
+              </p>
+              <p className="font-mono text-zinc-600 dark:text-zinc-400">
+                ={" "}
+                {formatBigAmount(
+                  integrityGlobal.mintTotal - integrityGlobal.sinkTotal,
+                )}
+              </p>
+            </div>
+            <p className="mt-2 text-xs font-medium text-zinc-700 dark:text-zinc-300">
+              {integrityGlobal.balanced
+                ? "Balanced ✓"
+                : "Mismatch — inspect data"}
             </p>
           </div>
-          <p className="mt-1 text-xs font-medium text-zinc-700 dark:text-zinc-300">
-            {integrity.balanced ? "Balanced ✓" : "Mismatch — inspect data"}
-          </p>
+
+          <div className="grid gap-2">
+            <div className="rounded-lg border border-zinc-200 bg-white p-3 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
+              <p className="text-[10px] font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+                Fee collected (entry_fee)
+              </p>
+              <p className="mt-0.5 text-xs text-zinc-500 dark:text-zinc-400">
+                All-time
+              </p>
+              <p
+                className="mt-1 text-lg font-semibold tabular-nums text-violet-800 dark:text-violet-200"
+                title={`${formatBigAmount(integrityGlobal.entryFeeCoinsTotal)} coins`}
+              >
+                {feeRcLabelGlobal}
+              </p>
+              <p className="mt-0.5 text-[11px] tabular-nums text-zinc-500 dark:text-zinc-400">
+                {formatBigAmount(integrityGlobal.entryFeeCoinsTotal)} coins
+              </p>
+            </div>
+            <div className="rounded-lg border border-zinc-200 bg-white p-3 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
+              <p className="text-[10px] font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+                Total purchase
+              </p>
+              <p className="mt-0.5 text-xs text-zinc-500 dark:text-zinc-400">
+                All-time
+              </p>
+              <p
+                className="mt-1 text-lg font-semibold tabular-nums text-sky-800 dark:text-sky-200"
+                title={`${formatBigAmount(integrityGlobal.purchaseCoinsTotal)} coins`}
+              >
+                {purchaseRcLabelGlobal}
+              </p>
+              <p className="mt-0.5 text-[11px] tabular-nums text-zinc-500 dark:text-zinc-400">
+                {formatBigAmount(integrityGlobal.purchaseCoinsTotal)} coins
+              </p>
+            </div>
+            <div className="rounded-lg border border-zinc-200 bg-white p-3 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
+              <p className="text-[10px] font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+                Total entry_hold / reward
+              </p>
+              <p className="mt-0.5 text-xs text-zinc-500 dark:text-zinc-400">
+                All-time
+              </p>
+              <p
+                className="mt-1 text-lg font-semibold tabular-nums text-amber-800 dark:text-amber-200"
+                title={`${formatBigAmount(integrityGlobal.entryHoldCoinsTotal)} coins`}
+              >
+                {entryHoldRcLabelGlobal}
+              </p>
+              <p className="mt-0.5 text-[11px] tabular-nums text-zinc-500 dark:text-zinc-400">
+                {formatBigAmount(integrityGlobal.entryHoldCoinsTotal)} coins
+              </p>
+            </div>
+          </div>
+        </div>
+
+        <div className="overflow-hidden rounded-xl border border-zinc-200 bg-white shadow-sm dark:border-zinc-800 dark:bg-zinc-900 lg:col-span-2">
+          <div className="border-b border-zinc-200 bg-zinc-50 px-4 py-2 dark:border-zinc-800 dark:bg-zinc-800/50">
+            <h2 className="text-sm font-semibold text-zinc-900 dark:text-zinc-50">
+              User net (credits − debits)
+            </h2>
+            <p className="text-xs text-zinc-500 dark:text-zinc-400">
+              All transactions
+            </p>
+          </div>
+          <div className="max-h-[min(24rem,50vh)] overflow-y-auto overflow-x-auto">
+            <table className="min-w-full text-left text-sm">
+              <thead className="sticky top-0 z-10 border-b border-zinc-200 bg-zinc-50 text-zinc-600 dark:border-zinc-800 dark:bg-zinc-800/95 dark:text-zinc-400">
+                <tr>
+                  <th className="px-4 py-3 font-medium">User</th>
+                  <th className="px-4 py-3 font-medium text-right">
+                    Net (coins)
+                  </th>
+                  <th className="px-4 py-3 font-medium text-right">Net (RC)</th>
+                </tr>
+              </thead>
+              <tbody className="divide-y divide-zinc-200 dark:divide-zinc-800">
+                {userNets.length === 0 ? (
+                  <tr>
+                    <td
+                      colSpan={3}
+                      className="px-4 py-6 text-center text-zinc-500"
+                    >
+                      No non-zero balances in loaded rows.
+                    </td>
+                  </tr>
+                ) : (
+                  userNets.map(([uid, bal]) => (
+                    <tr key={uid} className="text-zinc-800 dark:text-zinc-200">
+                      <td className="px-4 py-2 font-mono text-xs">
+                        {userCell(uid, "from")}
+                      </td>
+                      <td
+                        className={[
+                          "px-4 py-2 text-right font-mono tabular-nums",
+                          bal > BigInt(0)
+                            ? "text-emerald-700 dark:text-emerald-300"
+                            : bal < BigInt(0)
+                              ? "text-rose-700 dark:text-rose-300"
+                              : "",
+                        ].join(" ")}
+                      >
+                        {bal > BigInt(0) ? "+" : ""}
+                        {formatBigAmount(bal)}
+                      </td>
+                      <td className="px-4 py-2 text-right font-mono text-xs tabular-nums text-zinc-600 dark:text-zinc-400">
+                        {bal < BigInt(0)
+                          ? `−${formatRcLabelFromCoinsBigInt(-bal)}`
+                          : formatRcLabelFromCoinsBigInt(bal)}
+                      </td>
+                    </tr>
+                  ))
+                )}
+              </tbody>
+            </table>
+          </div>
         </div>
       </div>
+
+      <form
+        method="get"
+        action="/"
+        className="flex flex-wrap items-end gap-3 rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900"
+      >
+        <input type="hidden" name="tab" value="ledger" />
+        {highlightId ? (
+          <input type="hidden" name="highlight" value={highlightId} />
+        ) : null}
+        {participantRaw ? (
+          <input type="hidden" name="participant" value={participantRaw} />
+        ) : null}
+        <input type="hidden" name="lsort" value={ledgerSort} />
+        <input type="hidden" name="lorder" value={ledgerOrder} />
+        {ledgerPageSize !== DEFAULT_LEDGER_PAGE_SIZE ? (
+          <input type="hidden" name="lsize" value={String(ledgerPageSize)} />
+        ) : null}
+        <div className="flex min-w-[10rem] flex-col gap-1">
+          <label
+            htmlFor="ledger-lfrom"
+            className="text-xs font-medium text-zinc-500 dark:text-zinc-400"
+          >
+            From (UTC)
+          </label>
+          <input
+            id="ledger-lfrom"
+            name="lfrom"
+            type="date"
+            defaultValue={ledgerFrom}
+            className="rounded-md border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 shadow-sm focus:border-sky-500 focus:outline-none focus:ring-1 focus:ring-sky-500 dark:border-zinc-600 dark:bg-zinc-950 dark:text-zinc-100"
+          />
+        </div>
+        <div className="flex min-w-[10rem] flex-col gap-1">
+          <label
+            htmlFor="ledger-lto"
+            className="text-xs font-medium text-zinc-500 dark:text-zinc-400"
+          >
+            To (UTC)
+          </label>
+          <input
+            id="ledger-lto"
+            name="lto"
+            type="date"
+            defaultValue={ledgerTo}
+            className="rounded-md border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 shadow-sm focus:border-sky-500 focus:outline-none focus:ring-1 focus:ring-sky-500 dark:border-zinc-600 dark:bg-zinc-950 dark:text-zinc-100"
+          />
+        </div>
+        <button
+          type="submit"
+          className="rounded-md bg-zinc-900 px-4 py-2 text-sm font-medium text-white shadow-sm hover:bg-zinc-800 dark:bg-zinc-100 dark:text-zinc-900 dark:hover:bg-zinc-200"
+        >
+          Apply
+        </button>
+        <Link
+          href={buildDashboardHref({
+            tab: "ledger",
+            highlightId,
+            participantRaw,
+            ledgerPageSize,
+          })}
+          scroll={false}
+          className="rounded-md border border-zinc-300 bg-white px-4 py-2 text-sm font-medium text-zinc-800 shadow-sm hover:bg-zinc-50 dark:border-zinc-600 dark:bg-zinc-950 dark:text-zinc-100 dark:hover:bg-zinc-800"
+        >
+          Reset range
+        </Link>
+      </form>
+
+      <div>
+        <h3 className="mb-2 text-xs font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+          In selected range (
+          <span className="font-mono normal-case">
+            {ledgerFrom}–{ledgerTo}
+          </span>{" "}
+          UTC)
+        </h3>
+        <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
+          <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
+            <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+              Fee collected (entry_fee)
+            </p>
+            <p
+              className="mt-1 text-2xl font-semibold tabular-nums text-violet-800 dark:text-violet-200"
+              title={`${formatBigAmount(integrityScoped.entryFeeCoinsTotal)} coins`}
+            >
+              {feeRcLabelScoped}
+            </p>
+            <p className="mt-0.5 text-xs tabular-nums text-zinc-500 dark:text-zinc-400">
+              {formatBigAmount(integrityScoped.entryFeeCoinsTotal)} coins
+            </p>
+            <LedgerRangeCumulativeChart
+              dates={scopedDailyCumulative.dates}
+              cumulativeCoins={scopedDailyCumulative.entryFeeCumulative}
+              ariaLabel="Cumulative entry fee coins by UTC day in the selected range"
+              className="text-violet-600 dark:text-violet-300"
+            />
+          </div>
+          <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
+            <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+              Total purchase
+            </p>
+            <p
+              className="mt-1 text-2xl font-semibold tabular-nums text-sky-800 dark:text-sky-200"
+              title={`${formatBigAmount(integrityScoped.purchaseCoinsTotal)} coins`}
+            >
+              {purchaseRcLabelScoped}
+            </p>
+            <p className="mt-0.5 text-xs tabular-nums text-zinc-500 dark:text-zinc-400">
+              {formatBigAmount(integrityScoped.purchaseCoinsTotal)} coins
+            </p>
+            <LedgerRangeCumulativeChart
+              dates={scopedDailyCumulative.dates}
+              cumulativeCoins={scopedDailyCumulative.purchaseCumulative}
+              ariaLabel="Cumulative purchase coins by UTC day in the selected range"
+              className="text-sky-600 dark:text-sky-300"
+            />
+          </div>
+          <div className="rounded-xl border border-zinc-200 bg-white p-4 shadow-sm dark:border-zinc-800 dark:bg-zinc-900 sm:col-span-2 lg:col-span-1">
+            <p className="text-xs font-medium uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
+              Total entry_hold / reward
+            </p>
+            <p
+              className="mt-1 text-2xl font-semibold tabular-nums text-amber-800 dark:text-amber-200"
+              title={`${formatBigAmount(integrityScoped.entryHoldCoinsTotal)} coins`}
+            >
+              {entryHoldRcLabelScoped}
+            </p>
+            <p className="mt-0.5 text-xs tabular-nums text-zinc-500 dark:text-zinc-400">
+              {formatBigAmount(integrityScoped.entryHoldCoinsTotal)} coins
+            </p>
+            <LedgerRangeCumulativeChart
+              dates={scopedDailyCumulative.dates}
+              cumulativeCoins={scopedDailyCumulative.entryHoldCumulative}
+              ariaLabel="Cumulative entry hold coins by UTC day in the selected range"
+              className="text-amber-600 dark:text-amber-300"
+            />
+          </div>
+        </div>
+      </div>
+
       {holdRewardMismatch ? (
         <div
           className="rounded-lg border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-900 dark:border-red-900 dark:bg-red-950/40 dark:text-red-100"
           role="alert"
         >
           Data mismatch: <span className="font-mono">entry_hold</span> total (
-          {formatBigAmount(integrity.entryHoldCoinsTotal)} coins) does not equal{" "}
+          {formatBigAmount(integrityScoped.entryHoldCoinsTotal)} coins) does not
+          equal{" "}
           <span className="font-mono">reward</span> total (
-          {formatBigAmount(integrity.rewardCoinsTotal)} coins).
+          {formatBigAmount(integrityScoped.rewardCoinsTotal)} coins).
         </div>
       ) : null}
 
-      {!integrity.volumeBalanced ? (
+      {!integrityScoped.volumeBalanced ? (
         <div
           className="rounded-lg border border-amber-200 bg-amber-50 px-4 py-3 text-sm text-amber-950 dark:border-amber-900 dark:bg-amber-950/40 dark:text-amber-100"
           role="status"
         >
           Debit / credit volume: debits + mint (
-          {formatBigAmount(integrity.totalDebitVolume + integrity.mintTotal)})
-          ≠ credits + null-{`to`} outflows (
           {formatBigAmount(
-            integrity.totalCreditVolume + integrity.sinkTotal,
+            integrityScoped.totalDebitVolume + integrityScoped.mintTotal,
+          )}
+          ) ≠ credits + null-{`to`} outflows (
+          {formatBigAmount(
+            integrityScoped.totalCreditVolume + integrityScoped.sinkTotal,
           )}
           ). This usually means inconsistent rows (e.g. both {`from`} and{" "}
           {`to`} null with non-zero amount).
@@ -369,25 +601,165 @@ export function AdminLedger({
           Ledger
         </h2>
         <p className="mb-3 text-xs text-zinc-500 dark:text-zinc-400">
-          All {ledgerRowsChronological.length.toLocaleString("en-US")} rows ·
-          oldest first
+          {ledgerTotalRowsInRange.toLocaleString("en-US")} rows in range{" "}
+          <span className="font-mono">
+            {ledgerFrom}–{ledgerTo}
+          </span>{" "}
+          UTC (cap 10,000) · default sort newest first; click a column header to
+          sort
+        </p>
+        <p className="mb-2 flex flex-wrap items-center gap-x-2 gap-y-1 text-xs text-zinc-600 dark:text-zinc-400">
+          <span className="font-medium text-zinc-700 dark:text-zinc-300">
+            Rows per page
+          </span>
+          {LEDGER_PAGE_SIZE_OPTIONS.map((n) =>
+            n === ledgerPageSize ? (
+              <span
+                key={n}
+                className="rounded px-2 py-0.5 font-semibold tabular-nums text-zinc-900 dark:text-zinc-100"
+              >
+                {n}
+              </span>
+            ) : (
+              <Link
+                key={n}
+                href={ledgerHref({ ledgerPage: 1, ledgerPageSize: n })}
+                scroll={false}
+                className="rounded px-2 py-0.5 font-medium tabular-nums text-sky-700 underline decoration-sky-400/50 underline-offset-2 hover:bg-sky-50 dark:text-sky-300 dark:hover:bg-sky-950/40"
+              >
+                {n}
+              </Link>
+            ),
+          )}
         </p>
         <div className="overflow-x-auto rounded-xl border border-zinc-200 bg-white shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
           <table className="min-w-full text-left text-sm">
             <thead className="sticky top-0 z-10 border-b border-zinc-200 bg-zinc-50 text-zinc-600 dark:border-zinc-800 dark:bg-zinc-800/95 dark:text-zinc-400">
               <tr>
-                <th className="px-4 py-3 font-medium">ID</th>
-                <th className="px-4 py-3 font-medium">Created</th>
-                <th className="px-4 py-3 font-medium">From</th>
-                <th className="px-4 py-3 font-medium">To</th>
-                <th className="px-4 py-3 font-medium text-right">Amount</th>
-                <th className="px-4 py-3 font-medium text-right">RC</th>
-                <th className="px-4 py-3 font-medium">Remarks</th>
-                <th className="px-4 py-3 font-medium">Match</th>
+                <th className={`text-left px-4 py-3 ${sortHeaderClass("id")}`}>
+                  <Link
+                    href={sortToggleHref("id")}
+                    scroll={false}
+                    className="inline-flex items-baseline gap-1 hover:underline"
+                  >
+                    ID
+                    {ledgerSort === "id" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
+                <th
+                  className={`text-left px-4 py-3 ${sortHeaderClass("created_at")}`}
+                >
+                  <Link
+                    href={sortToggleHref("created_at")}
+                    scroll={false}
+                    className="inline-flex items-baseline gap-1 hover:underline"
+                  >
+                    Created
+                    {ledgerSort === "created_at" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
+                <th className={`text-left px-4 py-3 ${sortHeaderClass("from")}`}>
+                  <Link
+                    href={sortToggleHref("from")}
+                    scroll={false}
+                    className="inline-flex items-baseline gap-1 hover:underline"
+                  >
+                    From
+                    {ledgerSort === "from" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
+                <th className={`text-left px-4 py-3 ${sortHeaderClass("to")}`}>
+                  <Link
+                    href={sortToggleHref("to")}
+                    scroll={false}
+                    className="inline-flex items-baseline gap-1 hover:underline"
+                  >
+                    To
+                    {ledgerSort === "to" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
+                <th
+                  className={`text-right px-4 py-3 ${sortHeaderClass("amount")}`}
+                >
+                  <Link
+                    href={sortToggleHref("amount")}
+                    scroll={false}
+                    className="inline-flex w-full items-baseline justify-end gap-1 hover:underline"
+                  >
+                    Amount
+                    {ledgerSort === "amount" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
+                <th className={`text-right px-4 py-3 ${sortHeaderClass("rc")}`}>
+                  <Link
+                    href={sortToggleHref("rc")}
+                    scroll={false}
+                    className="inline-flex w-full items-baseline justify-end gap-1 hover:underline"
+                  >
+                    RC
+                    {ledgerSort === "rc" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
+                <th
+                  className={`text-left px-4 py-3 ${sortHeaderClass("remarks")}`}
+                >
+                  <Link
+                    href={sortToggleHref("remarks")}
+                    scroll={false}
+                    className="inline-flex items-baseline gap-1 hover:underline"
+                  >
+                    Remarks
+                    {ledgerSort === "remarks" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
+                <th
+                  className={`text-left px-4 py-3 ${sortHeaderClass("match_id")}`}
+                >
+                  <Link
+                    href={sortToggleHref("match_id")}
+                    scroll={false}
+                    className="inline-flex items-baseline gap-1 hover:underline"
+                  >
+                    Match
+                    {ledgerSort === "match_id" ? (
+                      <span className="text-xs font-normal" aria-hidden>
+                        {ledgerOrder === "asc" ? "▲" : "▼"}
+                      </span>
+                    ) : null}
+                  </Link>
+                </th>
               </tr>
             </thead>
             <tbody className="divide-y divide-zinc-200 dark:divide-zinc-800">
-              {ledgerRowsChronological.length === 0 ? (
+              {ledgerTotalRowsInRange === 0 ? (
                 <tr>
                   <td
                     colSpan={8}
@@ -397,7 +769,7 @@ export function AdminLedger({
                   </td>
                 </tr>
               ) : (
-                ledgerRowsChronological.map((row) => {
+                ledgerTableRows.map((row) => {
                   const amt = txAmountToBigInt(row.amount);
                   return (
                     <tr
@@ -451,6 +823,98 @@ export function AdminLedger({
             </tbody>
           </table>
         </div>
+        {ledgerTotalRowsInRange > 0 ? (
+          <div className="mt-3 space-y-2 text-xs text-zinc-600 dark:text-zinc-400">
+            <p>
+              Rows {pageStart.toLocaleString("en-US")}–
+              {pageEnd.toLocaleString("en-US")} of{" "}
+              {ledgerTotalRowsInRange.toLocaleString("en-US")} · Page{" "}
+              {ledgerPage.toLocaleString("en-US")} /{" "}
+              {ledgerTotalPages.toLocaleString("en-US")}
+            </p>
+            <nav
+              className="flex flex-wrap items-center gap-x-1 gap-y-1 font-mono tabular-nums"
+              aria-label="Ledger pages"
+            >
+              {ledgerPage > 1 ? (
+                <Link
+                  href={ledgerHref({ ledgerPage: 1 })}
+                  scroll={false}
+                  className={navLinkClass}
+                >
+                  First
+                </Link>
+              ) : (
+                <span className={navMutedClass}>First</span>
+              )}
+              {ledgerPage > 1 ? (
+                <Link
+                  href={ledgerHref({ ledgerPage: ledgerPage - 1 })}
+                  scroll={false}
+                  className={navLinkClass}
+                  aria-label="Previous page"
+                >
+                  {"<"}
+                </Link>
+              ) : (
+                <span className={navMutedClass} aria-hidden>
+                  {"<"}
+                </span>
+              )}
+              {pageNavItems.map((item, idx) =>
+                item === "ellipsis" ? (
+                  <span
+                    key={`e-${idx}`}
+                    className="px-1 select-none text-zinc-400 dark:text-zinc-500"
+                  >
+                    ...
+                  </span>
+                ) : ledgerPage === item ? (
+                  <span
+                    key={item}
+                    className="rounded px-2 py-1 font-semibold text-zinc-900 dark:text-zinc-100"
+                  >
+                    {item}
+                  </span>
+                ) : (
+                  <Link
+                    key={item}
+                    href={ledgerHref({ ledgerPage: item })}
+                    scroll={false}
+                    className={navLinkClass}
+                  >
+                    {item}
+                  </Link>
+                ),
+              )}
+              {ledgerPage < ledgerTotalPages ? (
+                <Link
+                  href={ledgerHref({ ledgerPage: ledgerPage + 1 })}
+                  scroll={false}
+                  className={navLinkClass}
+                  aria-label="Next page"
+                >
+                  {">"}
+                </Link>
+              ) : (
+                <span className={navMutedClass} aria-hidden>
+                  {">"}
+                </span>
+              )}
+              {ledgerPage < ledgerTotalPages ? (
+                <Link
+                  href={ledgerHref({ ledgerPage: ledgerTotalPages })}
+                  scroll={false}
+                  className={navLinkClass}
+                >
+                  Last
+                </Link>
+              ) : (
+                <span className={navMutedClass}>Last</span>
+              )}
+            </nav>
+          </div>
+        ) : null}
       </div>
 
       {matchChecks.length > 0 ? (
@@ -501,60 +965,6 @@ export function AdminLedger({
         </div>
       ) : null}
 
-      <div>
-        <h2 className="mb-2 text-sm font-semibold uppercase tracking-wide text-zinc-500 dark:text-zinc-400">
-          User net (credits − debits)
-        </h2>
-        <div className="overflow-x-auto rounded-xl border border-zinc-200 bg-white shadow-sm dark:border-zinc-800 dark:bg-zinc-900">
-          <table className="min-w-full text-left text-sm">
-            <thead className="border-b border-zinc-200 bg-zinc-50 text-zinc-600 dark:border-zinc-800 dark:bg-zinc-800/50 dark:text-zinc-400">
-              <tr>
-                <th className="px-4 py-3 font-medium">User</th>
-                <th className="px-4 py-3 font-medium text-right">Net (coins)</th>
-                <th className="px-4 py-3 font-medium text-right">Net (RC)</th>
-              </tr>
-            </thead>
-            <tbody className="divide-y divide-zinc-200 dark:divide-zinc-800">
-              {userNets.length === 0 ? (
-                <tr>
-                  <td
-                    colSpan={3}
-                    className="px-4 py-6 text-center text-zinc-500"
-                  >
-                    No non-zero balances in loaded rows.
-                  </td>
-                </tr>
-              ) : (
-                userNets.map(([uid, bal]) => (
-                  <tr key={uid} className="text-zinc-800 dark:text-zinc-200">
-                    <td className="px-4 py-2 font-mono text-xs">
-                      {userCell(uid, "from")}
-                    </td>
-                    <td
-                      className={[
-                        "px-4 py-2 text-right font-mono tabular-nums",
-                        bal > BigInt(0)
-                          ? "text-emerald-700 dark:text-emerald-300"
-                          : bal < BigInt(0)
-                            ? "text-rose-700 dark:text-rose-300"
-                            : "",
-                      ].join(" ")}
-                    >
-                      {bal > BigInt(0) ? "+" : ""}
-                      {formatBigAmount(bal)}
-                    </td>
-                    <td className="px-4 py-2 text-right font-mono text-xs tabular-nums text-zinc-600 dark:text-zinc-400">
-                      {bal < BigInt(0)
-                        ? `−${formatRcLabelFromCoinsBigInt(-bal)}`
-                        : formatRcLabelFromCoinsBigInt(bal)}
-                    </td>
-                  </tr>
-                ))
-              )}
-            </tbody>
-          </table>
-        </div>
-      </div>
     </section>
   );
 }
diff --git a/src/components/edit-user-cc-rc-overlay.tsx b/src/components/edit-user-cc-rc-overlay.tsx
index f974907..1dba805 100644
--- a/src/components/edit-user-cc-rc-overlay.tsx
+++ b/src/components/edit-user-cc-rc-overlay.tsx
@@ -4,6 +4,7 @@ import {
   buildDashboardHref,
   type AdminDashboardTab,
 } from "@/lib/dashboard-search-url";
+import type { LedgerSortKey, LedgerSortOrder } from "@/lib/ledger-table-view";
 import type { DbUser } from "@/types/database";
 
 type Props = {
@@ -12,6 +13,12 @@ type Props = {
   highlightId: string | null;
   participantRaw: string | null;
   saveError: boolean;
+  ledgerFrom: string;
+  ledgerTo: string;
+  ledgerPage: number;
+  ledgerPageSize: number;
+  ledgerSort: LedgerSortKey;
+  ledgerOrder: LedgerSortOrder;
 };
 
 export function EditUserCcRcOverlay({
@@ -20,11 +27,27 @@ export function EditUserCcRcOverlay({
   highlightId,
   participantRaw,
   saveError,
+  ledgerFrom,
+  ledgerTo,
+  ledgerPage,
+  ledgerPageSize,
+  ledgerSort,
+  ledgerOrder,
 }: Props) {
   const cancelHref = buildDashboardHref({
     tab,
     highlightId,
     participantRaw,
+    ...(tab === "ledger"
+      ? {
+          ledgerFrom,
+          ledgerTo,
+          ledgerPage,
+          ledgerPageSize,
+          ledgerSort,
+          ledgerOrder,
+        }
+      : {}),
   });
 
   return (
@@ -80,6 +103,20 @@ export function EditUserCcRcOverlay({
             name="participantRaw"
             value={participantRaw ?? ""}
           />
+          {tab === "ledger" ? (
+            <>
+              <input type="hidden" name="ledgerFrom" value={ledgerFrom} />
+              <input type="hidden" name="ledgerTo" value={ledgerTo} />
+              <input type="hidden" name="ledgerPage" value={String(ledgerPage)} />
+              <input
+                type="hidden"
+                name="ledgerPageSize"
+                value={String(ledgerPageSize)}
+              />
+              <input type="hidden" name="ledgerSort" value={ledgerSort} />
+              <input type="hidden" name="ledgerOrder" value={ledgerOrder} />
+            </>
+          ) : null}
           <div>
             <label
               htmlFor={`edit-cc-${user.id}`}
diff --git a/src/components/ledger-range-cumulative-chart.tsx b/src/components/ledger-range-cumulative-chart.tsx
new file mode 100644
index 0000000..3440162
--- /dev/null
+++ b/src/components/ledger-range-cumulative-chart.tsx
@@ -0,0 +1,194 @@
+import { useMemo, useState } from "react";
+
+const VB_W = 320;
+const VB_H = 52;
+const PAD_L = 2;
+const PAD_R = 2;
+const PAD_T = 4;
+const PAD_B = 2;
+
+function maxBigint(values: bigint[]): bigint {
+  let m = BigInt(0);
+  for (const v of values) if (v > m) m = v;
+  return m;
+}
+
+function buildChartGeometry(
+  cumulativeCoins: bigint[],
+  vbW: number,
+  vbH: number,
+): {
+  lineD: string;
+  areaD: string;
+  xs: number[];
+  ys: number[];
+} {
+  const n = cumulativeCoins.length;
+  if (n === 0) return { lineD: "", areaD: "", xs: [], ys: [] };
+  const max = maxBigint(cumulativeCoins);
+  const innerW = vbW - PAD_L - PAD_R;
+  const innerH = vbH - PAD_T - PAD_B;
+  const maxN = max === BigInt(0) ? 1 : Number(max);
+  const xs: number[] = [];
+  const ys: number[] = [];
+  for (let i = 0; i < n; i++) {
+    const x =
+      PAD_L + (n <= 1 ? innerW / 2 : (i / (n - 1)) * innerW);
+    const num = Number(cumulativeCoins[i]);
+    const yRatio = max === BigInt(0) ? 0 : num / maxN;
+    const y = PAD_T + innerH - yRatio * innerH;
+    xs.push(x);
+    ys.push(y);
+  }
+  const pts = xs.map((x, i) => `${x.toFixed(1)},${ys[i]!.toFixed(1)}`);
+  const lineD = `M ${pts.join(" L ")}`;
+  const x0 = xs[0]!;
+  const x1 = xs[xs.length - 1]!;
+  const yB = vbH - PAD_B;
+  const areaD = `${lineD} L ${x1.toFixed(1)},${yB.toFixed(1)} L ${x0.toFixed(1)},${yB.toFixed(1)} Z`;
+  return { lineD, areaD, xs, ys };
+}
+
+function indexFromPointerX(
+  relX: number,
+  width: number,
+  n: number,
+): number {
+  if (n <= 0) return 0;
+  if (width <= 0) return 0;
+  const t = Math.min(1, Math.max(0, relX / width));
+  const maxI = Math.max(0, n - 1);
+  return maxI === 0 ? 0 : Math.round(t * maxI);
+}
+
+type Props = {
+  dates: string[];
+  cumulativeCoins: bigint[];
+  /** Short description for screen readers, e.g. "Entry fee cumulative in range". */
+  ariaLabel: string;
+  /** Sets `currentColor` for stroke and tinted fill (Tailwind text-* on wrapper). */
+  className: string;
+};
+
+/**
+ * Minimal area + line chart: cumulative metric vs UTC day index in range.
+ * Y uses numeric ratio (safe for typical coin totals in admin ranges).
+ */
+export function LedgerRangeCumulativeChart({
+  dates,
+  cumulativeCoins,
+  ariaLabel,
+  className,
+}: Props) {
+  const { lineD, areaD, xs, ys } = useMemo(
+    () => buildChartGeometry(cumulativeCoins, VB_W, VB_H),
+    [cumulativeCoins],
+  );
+
+  const [hover, setHover] = useState<{
+    idx: number;
+    clientX: number;
+    clientY: number;
+  } | null>(null);
+
+  const n = cumulativeCoins.length;
+
+  if (dates.length === 0 || n === 0) {
+    return (
+      <p className="mt-2 text-[10px] text-zinc-400 dark:text-zinc-500">
+        No days in range for chart.
+      </p>
+    );
+  }
+
+  const first = dates[0]!;
+  const last = dates[dates.length - 1]!;
+
+  return (
+    <figure className={`mt-3 ${className}`} aria-label={ariaLabel}>
+      <div
+        className="relative cursor-crosshair touch-none"
+        style={{ touchAction: "none" }}
+        onPointerMove={(e) => {
+          const rect = e.currentTarget.getBoundingClientRect();
+          const idx = indexFromPointerX(
+            e.clientX - rect.left,
+            rect.width,
+            n,
+          );
+          setHover({ idx, clientX: e.clientX, clientY: e.clientY });
+        }}
+        onPointerLeave={() => setHover(null)}
+        onPointerCancel={() => setHover(null)}
+      >
+        <svg
+          viewBox={`0 0 ${VB_W} ${VB_H}`}
+          className="h-12 w-full overflow-visible"
+          preserveAspectRatio="none"
+        >
+          {areaD ? (
+            <path d={areaD} className="fill-current opacity-[0.12]" />
+          ) : null}
+          {lineD ? (
+            <path
+              d={lineD}
+              fill="none"
+              className="stroke-current"
+              strokeWidth={1.75}
+              vectorEffect="non-scaling-stroke"
+            />
+          ) : null}
+          {hover != null &&
+          xs[hover.idx] != null &&
+          ys[hover.idx] != null ? (
+            <g className="pointer-events-none">
+              <line
+                x1={xs[hover.idx]}
+                y1={PAD_T}
+                x2={xs[hover.idx]}
+                y2={VB_H - PAD_B}
+                className="stroke-current opacity-35"
+                strokeWidth={1}
+                vectorEffect="non-scaling-stroke"
+              />
+              <circle
+                cx={xs[hover.idx]}
+                cy={ys[hover.idx]}
+                r={4}
+                className="fill-current stroke-white dark:stroke-zinc-950"
+                strokeWidth={1.25}
+              />
+            </g>
+          ) : null}
+        </svg>
+        {hover != null ? (
+          <div
+            role="tooltip"
+            className="pointer-events-none fixed z-[100] max-w-[min(18rem,calc(100vw-1rem))] rounded-md border border-zinc-200 bg-white px-2.5 py-1.5 text-left text-xs shadow-lg dark:border-zinc-600 dark:bg-zinc-900"
+            style={{
+              left: hover.clientX,
+              top: hover.clientY,
+              transform: "translate(-50%, calc(-100% - 10px))",
+            }}
+          >
+            <p className="font-mono text-[10px] text-zinc-500 dark:text-zinc-400">
+              {dates[hover.idx]}{" "}
+              <span className="text-zinc-400 dark:text-zinc-500">UTC</span>
+            </p>
+            <p className="mt-0.5 tabular-nums font-semibold text-zinc-900 dark:text-zinc-50">
+              {cumulativeCoins[hover.idx]!.toLocaleString("en-US")}{" "}
+              <span className="font-normal font-sans text-zinc-500 dark:text-zinc-400">
+                coins
+              </span>
+            </p>
+          </div>
+        ) : null}
+      </div>
+      <figcaption className="mt-0.5 flex justify-between gap-2 font-mono text-[10px] text-zinc-500 tabular-nums dark:text-zinc-400">
+        <span>{first}</span>
+        <span className="text-zinc-400 dark:text-zinc-500">UTC</span>
+        <span>{last}</span>
+      </figcaption>
+    </figure>
+  );
+}
diff --git a/src/lib/dashboard-search-url.ts b/src/lib/dashboard-search-url.ts
index 4c3f8fc..ba86019 100644
--- a/src/lib/dashboard-search-url.ts
+++ b/src/lib/dashboard-search-url.ts
@@ -1,4 +1,5 @@
 import type { MatchmakerLogSource } from "@/lib/matchmaker-log-source";
+import { DEFAULT_LEDGER_PAGE_SIZE } from "@/lib/ledger-table-view";
 
 export type AdminDashboardTab =
   | "dashboard"
@@ -15,6 +16,14 @@ export type DashboardUrlQuery = {
   saveError?: boolean;
   /** When tab is matchmaker: `raw` selects matchmaker.log; omit or processed → history.log */
   matchmakerSource?: MatchmakerLogSource | null;
+  /** Ledger tab: UTC date-only bounds (`lfrom` / `lto` query params). */
+  ledgerFrom?: string | null;
+  ledgerTo?: string | null;
+  ledgerPage?: number | null;
+  /** Ledger rows per page (`lsize`); omitted from URL when equal to default. */
+  ledgerPageSize?: number | null;
+  ledgerSort?: string | null;
+  ledgerOrder?: "asc" | "desc" | null;
 };
 
 /** Build `/?…` for dashboard tabs, filters, and optional edit / error flags. */
@@ -29,6 +38,26 @@ export function buildDashboardHref(q: DashboardUrlQuery): string {
   if (q.tab === "matchmaker" && q.matchmakerSource === "raw") {
     p.set("mklog", "raw");
   }
+  if (q.tab === "ledger") {
+    if (q.ledgerFrom) p.set("lfrom", q.ledgerFrom);
+    if (q.ledgerTo) p.set("lto", q.ledgerTo);
+    if (
+      q.ledgerPage != null &&
+      Number.isFinite(q.ledgerPage) &&
+      Math.trunc(q.ledgerPage) > 1
+    ) {
+      p.set("lpage", String(Math.trunc(q.ledgerPage)));
+    }
+    if (q.ledgerSort) p.set("lsort", q.ledgerSort);
+    if (q.ledgerOrder) p.set("lorder", q.ledgerOrder);
+    if (
+      q.ledgerPageSize != null &&
+      Number.isFinite(q.ledgerPageSize) &&
+      Math.trunc(q.ledgerPageSize) !== DEFAULT_LEDGER_PAGE_SIZE
+    ) {
+      p.set("lsize", String(Math.trunc(q.ledgerPageSize)));
+    }
+  }
   if (q.editId != null && Number.isFinite(q.editId)) {
     p.set("edit", String(q.editId));
   }
diff --git a/src/lib/ledger-global-summary-server.ts b/src/lib/ledger-global-summary-server.ts
new file mode 100644
index 0000000..c194f88
--- /dev/null
+++ b/src/lib/ledger-global-summary-server.ts
@@ -0,0 +1,48 @@
+import type { SupabaseClient } from "@supabase/supabase-js";
+import type { DbTransaction } from "@/types/database";
+import {
+  applyTransactionToMutableAccumulator,
+  createMutableLedgerAccumulator,
+  mutableAccumulatorToIntegrity,
+  sortedNonZeroUserNetPairs,
+  type LedgerGlobalSummary,
+} from "@/lib/ledger-integrity";
+
+const PAGE_SIZE = 5000;
+
+/**
+ * Scans every transaction row (paginated) and builds full integrity + user nets.
+ * Server-only — call from Server Components / Route Handlers, not from client components.
+ */
+export async function fetchLedgerGlobalSummary(
+  supabase: SupabaseClient,
+): Promise<{ ok: true; data: LedgerGlobalSummary } | { ok: false; message: string }> {
+  const acc = createMutableLedgerAccumulator();
+  let offset = 0;
+  for (;;) {
+    const { data, error } = await supabase
+      .from("transactions")
+      .select("id, created_at, from, to, amount, remarks, match_id")
+      .order("id", { ascending: true })
+      .range(offset, offset + PAGE_SIZE - 1);
+
+    if (error) {
+      return { ok: false, message: error.message };
+    }
+    const rows = (data ?? []) as DbTransaction[];
+    if (rows.length === 0) {
+      break;
+    }
+    for (const row of rows) {
+      applyTransactionToMutableAccumulator(acc, row);
+    }
+    offset += rows.length;
+    if (rows.length < PAGE_SIZE) {
+      break;
+    }
+  }
+
+  const integrity = mutableAccumulatorToIntegrity(acc);
+  const userNetEntries = sortedNonZeroUserNetPairs(acc.net);
+  return { ok: true, data: { integrity, userNetEntries } };
+}
diff --git a/src/lib/ledger-integrity.ts b/src/lib/ledger-integrity.ts
new file mode 100644
index 0000000..41a57dc
--- /dev/null
+++ b/src/lib/ledger-integrity.ts
@@ -0,0 +1,210 @@
+import type { DbTransaction } from "@/types/database";
+
+export function txAmountToBigInt(raw: number | string): bigint {
+  if (typeof raw === "number") {
+    if (!Number.isFinite(raw)) return BigInt(0);
+    return BigInt(Math.trunc(raw));
+  }
+  const t = String(raw).trim();
+  if (t === "" || !/^-?\d+$/.test(t)) return BigInt(0);
+  try {
+    return BigInt(t);
+  } catch {
+    return BigInt(0);
+  }
+}
+
+function isEntryFeeRemark(remarks: string | null): boolean {
+  return (remarks ?? "").toLowerCase().trim() === "entry_fee";
+}
+
+export type LedgerIntegrity = {
+  mintTotal: bigint;
+  sinkTotal: bigint;
+  entryFeeCoinsTotal: bigint;
+  purchaseCoinsTotal: bigint;
+  entryHoldCoinsTotal: bigint;
+  rewardCoinsTotal: bigint;
+  sumUserNets: bigint;
+  balanced: boolean;
+  totalDebitVolume: bigint;
+  totalCreditVolume: bigint;
+  volumeBalanced: boolean;
+};
+
+export type MutableLedgerAccumulator = {
+  mintTotal: bigint;
+  sinkTotal: bigint;
+  entryFeeCoinsTotal: bigint;
+  purchaseCoinsTotal: bigint;
+  entryHoldCoinsTotal: bigint;
+  rewardCoinsTotal: bigint;
+  net: Map<number, bigint>;
+  totalDebitVolume: bigint;
+  totalCreditVolume: bigint;
+};
+
+export function createMutableLedgerAccumulator(): MutableLedgerAccumulator {
+  return {
+    mintTotal: BigInt(0),
+    sinkTotal: BigInt(0),
+    entryFeeCoinsTotal: BigInt(0),
+    purchaseCoinsTotal: BigInt(0),
+    entryHoldCoinsTotal: BigInt(0),
+    rewardCoinsTotal: BigInt(0),
+    net: new Map(),
+    totalDebitVolume: BigInt(0),
+    totalCreditVolume: BigInt(0),
+  };
+}
+
+export function applyTransactionToMutableAccumulator(
+  acc: MutableLedgerAccumulator,
+  row: DbTransaction,
+): void {
+  const a = txAmountToBigInt(row.amount);
+  if (a === BigInt(0)) return;
+  if (isEntryFeeRemark(row.remarks)) {
+    acc.entryFeeCoinsTotal += a;
+  }
+  const remark = (row.remarks ?? "").toLowerCase().trim();
+  if (remark === "purchase") acc.purchaseCoinsTotal += a;
+  if (remark === "entry_hold") acc.entryHoldCoinsTotal += a;
+  if (remark === "reward") acc.rewardCoinsTotal += a;
+  if (row.from == null) {
+    acc.mintTotal += a;
+  } else {
+    acc.totalDebitVolume += a;
+    const prev = acc.net.get(row.from) ?? BigInt(0);
+    acc.net.set(row.from, prev - a);
+  }
+  if (row.to == null) {
+    acc.sinkTotal += a;
+  } else {
+    acc.totalCreditVolume += a;
+    const prev = acc.net.get(row.to) ?? BigInt(0);
+    acc.net.set(row.to, prev + a);
+  }
+}
+
+export function mutableAccumulatorToIntegrity(
+  acc: MutableLedgerAccumulator,
+): LedgerIntegrity {
+  let sumUserNets = BigInt(0);
+  for (const v of acc.net.values()) {
+    sumUserNets += v;
+  }
+  const netIssued = acc.mintTotal - acc.sinkTotal;
+  const balanced = sumUserNets === netIssued;
+  const volumeBalanced =
+    acc.totalDebitVolume + acc.mintTotal ===
+    acc.totalCreditVolume + acc.sinkTotal;
+  return {
+    mintTotal: acc.mintTotal,
+    sinkTotal: acc.sinkTotal,
+    entryFeeCoinsTotal: acc.entryFeeCoinsTotal,
+    purchaseCoinsTotal: acc.purchaseCoinsTotal,
+    entryHoldCoinsTotal: acc.entryHoldCoinsTotal,
+    rewardCoinsTotal: acc.rewardCoinsTotal,
+    sumUserNets,
+    balanced,
+    totalDebitVolume: acc.totalDebitVolume,
+    totalCreditVolume: acc.totalCreditVolume,
+    volumeBalanced,
+  };
+}
+
+export function computeLedgerIntegrity(rows: DbTransaction[]): LedgerIntegrity {
+  const acc = createMutableLedgerAccumulator();
+  for (const row of rows) {
+    applyTransactionToMutableAccumulator(acc, row);
+  }
+  return mutableAccumulatorToIntegrity(acc);
+}
+
+/** Same ordering as the admin ledger user-net table. */
+export function sortedNonZeroUserNetPairs(
+  net: Map<number, bigint>,
+): [number, bigint][] {
+  return [...net.entries()]
+    .filter(([, v]) => v !== BigInt(0))
+    .sort((a, b) => {
+      const da = a[1] < BigInt(0) ? -a[1] : a[1];
+      const db = b[1] < BigInt(0) ? -b[1] : b[1];
+      if (da === db) return a[0] - b[0];
+      return db > da ? 1 : -1;
+    });
+}
+
+export type LedgerGlobalSummary = {
+  integrity: LedgerIntegrity;
+  userNetEntries: [number, bigint][];
+};
+
+export type SerializedLedgerIntegrity = {
+  mintTotal: string;
+  sinkTotal: string;
+  entryFeeCoinsTotal: string;
+  purchaseCoinsTotal: string;
+  entryHoldCoinsTotal: string;
+  rewardCoinsTotal: string;
+  sumUserNets: string;
+  balanced: boolean;
+  totalDebitVolume: string;
+  totalCreditVolume: string;
+  volumeBalanced: boolean;
+};
+
+export type SerializedLedgerGlobalSummary = {
+  integrity: SerializedLedgerIntegrity;
+  userNetEntries: { userId: number; net: string }[];
+};
+
+export function serializeLedgerGlobalSummary(
+  summary: LedgerGlobalSummary,
+): SerializedLedgerGlobalSummary {
+  const i = summary.integrity;
+  return {
+    integrity: {
+      mintTotal: i.mintTotal.toString(),
+      sinkTotal: i.sinkTotal.toString(),
+      entryFeeCoinsTotal: i.entryFeeCoinsTotal.toString(),
+      purchaseCoinsTotal: i.purchaseCoinsTotal.toString(),
+      entryHoldCoinsTotal: i.entryHoldCoinsTotal.toString(),
+      rewardCoinsTotal: i.rewardCoinsTotal.toString(),
+      sumUserNets: i.sumUserNets.toString(),
+      balanced: i.balanced,
+      totalDebitVolume: i.totalDebitVolume.toString(),
+      totalCreditVolume: i.totalCreditVolume.toString(),
+      volumeBalanced: i.volumeBalanced,
+    },
+    userNetEntries: summary.userNetEntries.map(([userId, net]) => ({
+      userId,
+      net: net.toString(),
+    })),
+  };
+}
+
+export function parseSerializedLedgerGlobalSummary(
+  s: SerializedLedgerGlobalSummary,
+): { integrity: LedgerIntegrity; userNets: [number, bigint][] } {
+  const i = s.integrity;
+  return {
+    integrity: {
+      mintTotal: BigInt(i.mintTotal),
+      sinkTotal: BigInt(i.sinkTotal),
+      entryFeeCoinsTotal: BigInt(i.entryFeeCoinsTotal),
+      purchaseCoinsTotal: BigInt(i.purchaseCoinsTotal),
+      entryHoldCoinsTotal: BigInt(i.entryHoldCoinsTotal),
+      rewardCoinsTotal: BigInt(i.rewardCoinsTotal),
+      sumUserNets: BigInt(i.sumUserNets),
+      balanced: i.balanced,
+      totalDebitVolume: BigInt(i.totalDebitVolume),
+      totalCreditVolume: BigInt(i.totalCreditVolume),
+      volumeBalanced: i.volumeBalanced,
+    },
+    userNets: s.userNetEntries.map(
+      (e) => [e.userId, BigInt(e.net)] as [number, bigint],
+    ),
+  };
+}
diff --git a/src/lib/ledger-scoped-daily-series.ts b/src/lib/ledger-scoped-daily-series.ts
new file mode 100644
index 0000000..811b5a5
--- /dev/null
+++ b/src/lib/ledger-scoped-daily-series.ts
@@ -0,0 +1,78 @@
+import { txAmountToBigInt } from "@/lib/ledger-integrity";
+import { enumerateUtcDatesInclusive } from "@/lib/ledger-utc-date-range";
+import type { DbTransaction } from "@/types/database";
+
+type DayInc = { entryFee: bigint; purchase: bigint; entryHold: bigint };
+
+function bucketForRemark(remarks: string | null): keyof DayInc | null {
+  const r = (remarks ?? "").toLowerCase().trim();
+  if (r === "entry_fee") return "entryFee";
+  if (r === "purchase") return "purchase";
+  if (r === "entry_hold") return "entryHold";
+  return null;
+}
+
+/**
+ * Per UTC day in the inclusive range, cumulative coin totals for scoped rows
+ * (same remark rules as {@link computeLedgerIntegrity} for these metrics).
+ */
+export function buildLedgerScopedDailyCumulativeSeries(
+  rows: DbTransaction[],
+  rangeFrom: string,
+  rangeTo: string,
+): {
+  dates: string[];
+  entryFeeCumulative: bigint[];
+  purchaseCumulative: bigint[];
+  entryHoldCumulative: bigint[];
+} {
+  const dates = enumerateUtcDatesInclusive(rangeFrom, rangeTo);
+  if (dates.length === 0) {
+    return {
+      dates: [],
+      entryFeeCumulative: [],
+      purchaseCumulative: [],
+      entryHoldCumulative: [],
+    };
+  }
+  const daySet = new Set(dates);
+  const inc = new Map<string, DayInc>();
+  for (const d of dates) {
+    inc.set(d, {
+      entryFee: BigInt(0),
+      purchase: BigInt(0),
+      entryHold: BigInt(0),
+    });
+  }
+  for (const row of rows) {
+    const day = row.created_at.slice(0, 10);
+    if (!daySet.has(day)) continue;
+    const key = bucketForRemark(row.remarks);
+    if (key == null) continue;
+    const a = txAmountToBigInt(row.amount);
+    const z = inc.get(day);
+    if (!z) continue;
+    z[key] += a;
+  }
+  let cFee = BigInt(0);
+  let cPur = BigInt(0);
+  let cHold = BigInt(0);
+  const entryFeeCumulative: bigint[] = [];
+  const purchaseCumulative: bigint[] = [];
+  const entryHoldCumulative: bigint[] = [];
+  for (const d of dates) {
+    const z = inc.get(d)!;
+    cFee += z.entryFee;
+    cPur += z.purchase;
+    cHold += z.entryHold;
+    entryFeeCumulative.push(cFee);
+    purchaseCumulative.push(cPur);
+    entryHoldCumulative.push(cHold);
+  }
+  return {
+    dates,
+    entryFeeCumulative,
+    purchaseCumulative,
+    entryHoldCumulative,
+  };
+}
diff --git a/src/lib/ledger-table-view.ts b/src/lib/ledger-table-view.ts
new file mode 100644
index 0000000..8a04dc1
--- /dev/null
+++ b/src/lib/ledger-table-view.ts
@@ -0,0 +1,176 @@
+import { txAmountToBigInt } from "@/lib/ledger-integrity";
+import type { DbTransaction } from "@/types/database";
+
+export const LEDGER_PAGE_SIZE_OPTIONS = [10, 30, 60, 100, 250] as const;
+
+export type LedgerPageSizeOption = (typeof LEDGER_PAGE_SIZE_OPTIONS)[number];
+
+export const DEFAULT_LEDGER_PAGE_SIZE = 30;
+
+export function normalizeLedgerPageSize(raw: string | null): number {
+  const n = Number((raw ?? "").trim());
+  if (
+    Number.isInteger(n) &&
+    (LEDGER_PAGE_SIZE_OPTIONS as readonly number[]).includes(n)
+  ) {
+    return n;
+  }
+  return DEFAULT_LEDGER_PAGE_SIZE;
+}
+
+export type LedgerSortKey =
+  | "id"
+  | "created_at"
+  | "from"
+  | "to"
+  | "amount"
+  | "rc"
+  | "remarks"
+  | "match_id";
+
+export type LedgerSortOrder = "asc" | "desc";
+
+export function normalizeLedgerSortKey(raw: string | null): LedgerSortKey {
+  const t = (raw ?? "").trim().toLowerCase();
+  if (t === "id") return "id";
+  if (t === "created_at" || t === "created") return "created_at";
+  if (t === "from") return "from";
+  if (t === "to") return "to";
+  if (t === "amount") return "amount";
+  if (t === "rc") return "rc";
+  if (t === "remarks" || t === "remark") return "remarks";
+  if (t === "match_id" || t === "match") return "match_id";
+  return "created_at";
+}
+
+/** When `lorder` is omitted: newest-first for Created; other columns default to ascending. */
+export function normalizeLedgerSortOrder(
+  raw: string | null,
+  sortKey: LedgerSortKey,
+): LedgerSortOrder {
+  const t = (raw ?? "").trim().toLowerCase();
+  if (t === "desc") return "desc";
+  if (t === "asc") return "asc";
+  return sortKey === "created_at" ? "desc" : "asc";
+}
+
+export function normalizeLedgerPage(raw: string | null): number {
+  const n = Number((raw ?? "").trim());
+  if (!Number.isInteger(n) || n < 1) return 1;
+  return n;
+}
+
+function nullFromKey(v: number | null): number {
+  return v == null ? -9_999_999_999 : v;
+}
+
+function nullToKey(v: number | null): number {
+  return v == null ? 9_999_999_999 : v;
+}
+
+function nullMatchKey(v: number | null): number {
+  return v == null ? 9_999_999_999 : v;
+}
+
+function comparePrimary(
+  a: DbTransaction,
+  b: DbTransaction,
+  sort: LedgerSortKey,
+): number {
+  switch (sort) {
+    case "id":
+      return a.id - b.id;
+    case "created_at": {
+      const sa = a.created_at ?? "";
+      const sb = b.created_at ?? "";
+      return sa < sb ? -1 : sa > sb ? 1 : 0;
+    }
+    case "from":
+      return nullFromKey(a.from) - nullFromKey(b.from);
+    case "to":
+      return nullToKey(a.to) - nullToKey(b.to);
+    case "amount":
+    case "rc": {
+      const ba = txAmountToBigInt(a.amount);
+      const bb = txAmountToBigInt(b.amount);
+      return ba < bb ? -1 : ba > bb ? 1 : 0;
+    }
+    case "remarks": {
+      const ra = (a.remarks ?? "").toLowerCase();
+      const rb = (b.remarks ?? "").toLowerCase();
+      return ra < rb ? -1 : ra > rb ? 1 : 0;
+    }
+    case "match_id":
+      return nullMatchKey(a.match_id) - nullMatchKey(b.match_id);
+    default:
+      return 0;
+  }
+}
+
+/** Stable sort: primary column + tie-breaker `id` ascending. */
+export function sortLedgerTransactions(
+  rows: DbTransaction[],
+  sort: LedgerSortKey,
+  order: LedgerSortOrder,
+): DbTransaction[] {
+  const dir = order === "asc" ? 1 : -1;
+  const copy = [...rows];
+  copy.sort((a, b) => {
+    const c = comparePrimary(a, b, sort);
+    if (c !== 0) return c * dir;
+    return (a.id - b.id) * dir;
+  });
+  return copy;
+}
+
+export type LedgerPageSlice = {
+  rows: DbTransaction[];
+  totalRows: number;
+  page: number;
+  totalPages: number;
+};
+
+export function sliceLedgerPage(
+  sortedRows: DbTransaction[],
+  page: number,
+  pageSize: number = DEFAULT_LEDGER_PAGE_SIZE,
+): LedgerPageSlice {
+  const totalRows = sortedRows.length;
+  const totalPages = Math.max(1, Math.ceil(totalRows / pageSize) || 1);
+  const pageClamped = Math.min(Math.max(1, page), totalPages);
+  const start = (pageClamped - 1) * pageSize;
+  return {
+    rows: sortedRows.slice(start, start + pageSize),
+    totalRows,
+    page: pageClamped,
+    totalPages,
+  };
+}
+
+/** Page numbers with ellipses for gaps (e.g. 1 2 3 … 10). */
+export function ledgerPaginationItems(
+  current: number,
+  totalPages: number,
+): (number | "ellipsis")[] {
+  if (totalPages < 1) return [];
+  if (totalPages === 1) return [1];
+  if (totalPages <= 7) {
+    return Array.from({ length: totalPages }, (_, i) => i + 1);
+  }
+  const set = new Set<number>();
+  set.add(1);
+  set.add(totalPages);
+  for (let d = -2; d <= 2; d++) {
+    const p = current + d;
+    if (p >= 1 && p <= totalPages) set.add(p);
+  }
+  const sorted = [...set].sort((a, b) => a - b);
+  const out: (number | "ellipsis")[] = [];
+  for (let i = 0; i < sorted.length; i++) {
+    if (i > 0 && sorted[i]! - sorted[i - 1]! > 1) {
+      out.push("ellipsis");
+    }
+    out.push(sorted[i]!);
+  }
+  return out;
+}
diff --git a/src/lib/ledger-utc-date-range.ts b/src/lib/ledger-utc-date-range.ts
new file mode 100644
index 0000000..66a3aa5
--- /dev/null
+++ b/src/lib/ledger-utc-date-range.ts
@@ -0,0 +1,67 @@
+/** Rolling last 30 UTC calendar days inclusive (today and the 29 prior days). */
+export function utcLast30DaysDateRange(): { from: string; to: string } {
+  const now = new Date();
+  const to = new Date(
+    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()),
+  );
+  const from = new Date(to);
+  from.setUTCDate(from.getUTCDate() - 29);
+  return {
+    from: from.toISOString().slice(0, 10),
+    to: to.toISOString().slice(0, 10),
+  };
+}
+
+/** Previous calendar month in UTC, as inclusive YYYY-MM-DD bounds. */
+export function utcLastMonthDateRange(): { from: string; to: string } {
+  const now = new Date();
+  const y = now.getUTCFullYear();
+  const m = now.getUTCMonth();
+  const yearLast = m === 0 ? y - 1 : y;
+  const monthLast = m === 0 ? 11 : m - 1;
+  const fromDate = new Date(Date.UTC(yearLast, monthLast, 1));
+  const toDate = new Date(Date.UTC(yearLast, monthLast + 1, 0));
+  const from = fromDate.toISOString().slice(0, 10);
+  const to = toDate.toISOString().slice(0, 10);
+  return { from, to };
+}
+
+export function parseIsoDateOnly(s: string): Date | null {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(s)) return null;
+  const d = new Date(`${s}T00:00:00.000Z`);
+  return Number.isNaN(d.getTime()) ? null : d;
+}
+
+/** Every UTC calendar day from `from` through `to` inclusive (YYYY-MM-DD). */
+export function enumerateUtcDatesInclusive(from: string, to: string): string[] {
+  const a = parseIsoDateOnly(from);
+  const b = parseIsoDateOnly(to);
+  if (!a || !b || from > to) return [];
+  const out: string[] = [];
+  const cur = new Date(a.getTime());
+  const endMs = b.getTime();
+  while (cur.getTime() <= endMs) {
+    out.push(cur.toISOString().slice(0, 10));
+    cur.setUTCDate(cur.getUTCDate() + 1);
+  }
+  return out;
+}
+
+/** Normalize YYYY-MM-DD bounds; invalid inputs fall back to last 30 UTC days. */
+export function normalizeLedgerDateRange(
+  fromRaw: string | null,
+  toRaw: string | null,
+): { from: string; to: string } {
+  const fallback = utcLast30DaysDateRange();
+  let from = (fromRaw ?? "").trim();
+  let to = (toRaw ?? "").trim();
+  if (!parseIsoDateOnly(from) || !parseIsoDateOnly(to)) {
+    return fallback;
+  }
+  if (from > to) {
+    const t = from;
+    from = to;
+    to = t;
+  }
+  return { from, to };
+}