refactor: merge comptroller and admin tables

- combine comptroller address and admin address into a single per-chain table
- delete the now-obsolete ComptrollersTable component

Author: PaulRBerg

docs/concepts/13-governance.mdx

@@ -4,36 +4,22 @@ sidebar_position: 13
 title: "Governance"
 ---
 
-import { AdminsTable, OldAdminsTable } from "@site/src/components/organisms/AdminsTable";
-import ComptrollersTable from "@site/src/components/organisms/ComptrollersTable";
+import { ComptrollerAdminsTable, OldAdminsTable } from "@site/src/components/organisms/AdminsTable";
 
-## Comptroller
+## Comptroller and Admins
 
 The Sablier Comptroller is a smart contract that acts as an intermediary between the protocols and the Sablier admin
 addresses. It has exclusive access to specific protocol functions. This design provides a more flexible approach to
 access control across all protocols while maintaining security.
 
-Admin addresses that control the Comptroller are listed below in the [Admin Addresses](#admin-addresses) section.
+### Current
 
-<ComptrollersTable />
+Used in Lockup v2.0, v3.0 and v4.0, Flow v1.1, v2.0 and v3.0, and Airdrops v1.3, v2.0 and v3.0. The table below lists
+the deployed Comptroller and the admin that controls it on each chain.
 
-## Admin Addresses
+<ComptrollerAdminsTable />
 
-The Comptroller was introduced in Lockup v3.0, Airdrops v2.0, and Flow v2.0. Prior to these, we used a direct admin role
-for governance.
-
-These admin accounts have the same authority as the current Comptroller contract, with direct access to specific
-protocol functions. More concretely, the admins are a collection of multisig wallets and EOAs currently in control of
-Sablier Labs.
-
-### Current Admins
-
-Used in Lockup v2.0, v3.0 and v4.0, Flow v1.1, v2.0 and v3.0, and Airdrops v1.3, v2.0 and v3.0. These addresses control
-the Comptroller on each chain.
-
-<AdminsTable />
-
-### Old Admins
+### Old
 
 Used in all previous versions: Lockup v1.0, v1.1 and v1.2; Flow v1.0; and Airdrops v1.1 and v1.2. Each of these
 addresses had direct admin authority over the corresponding protocol contracts before the Comptroller was introduced.

src/components/organisms/AdminsTable.tsx

@@ -143,8 +143,45 @@ function renderTable(rows: ReadonlyArray<readonly [Chain, Address]>): string {
   return content;
 }
 
-export function AdminsTable() {
-  const content = useMemo(() => renderTable(CURRENT_CHAIN_ADMINS), []);
+const CURRENT_ADMIN_BY_CHAIN_ID: ReadonlyMap<number, Address> = new Map(
+  CURRENT_CHAIN_ADMINS.map(([chain, admin]) => [chain.id, admin])
+);
+
+function renderComptrollerAdminsTable(): string {
+  // Iterating the comptroller catalog (rather than CURRENT_CHAIN_ADMINS) keeps
+  // the table in sync with deployments automatically; the admin lookup throws
+  // at module load if the hand-maintained map falls out of step.
+  const rows = sablier.comptroller
+    .getAll()
+    .flatMap((comptroller) => {
+      const chain = sablier.chains.get(comptroller.chainId);
+      if (!chain || chain.isTestnet || !chain.isSupportedByUI) {
+        return [];
+      }
+      const admin = CURRENT_ADMIN_BY_CHAIN_ID.get(chain.id);
+      if (!admin) {
+        throw new Error(
+          `AdminsTable: missing current admin for chain ${chain.name} (${chain.id}). ` +
+            "Add it to CURRENT_CHAIN_ADMINS in src/components/organisms/AdminsTable.tsx."
+        );
+      }
+      return [{ admin, chain, comptroller: comptroller.address }];
+    })
+    .sort((a, b) => a.chain.name.localeCompare(b.chain.name));
+
+  let content = "| Chain | Comptroller | Comptroller Admin |\n";
+  content += "| :---- | :---------- | :---- |\n";
+  for (const { admin, chain, comptroller } of rows) {
+    const explorerBaseUrl = chain.blockExplorers.default.url;
+    const comptrollerLink = `[${comptroller}](${explorerBaseUrl}/address/${comptroller})`;
+    const adminLink = `[${admin}](${explorerBaseUrl}/address/${admin})`;
+    content += `| ${chain.name} | ${comptrollerLink} | ${adminLink} |\n`;
+  }
+  return content;
+}
+
+export function ComptrollerAdminsTable() {
+  const content = useMemo(() => renderComptrollerAdminsTable(), []);
   return <GFMContent content={content} />;
 }
 
@@ -153,4 +190,4 @@ export function OldAdminsTable() {
   return <GFMContent content={content} />;
 }
 
-export default AdminsTable;
+export default ComptrollerAdminsTable;