feat: Centralize network and deployment capability configuration (#254)

apps/web/e2e/fixtures.ts

@@ -79,12 +79,12 @@ export async function installCreationFixtures(
   scenario: "success" | "wallet-rejection" | "simulation-failure" = "success",
 ) {
   await page.addInitScript(
-    ({ scenario, passphrase, wallet, expectedRecord }) => {
+    ({ scenario, networkPassphrase, wallet, expectedRecord }) => {
       const hash = "ab".repeat(32);
       window.__STOLLA_E2E__ = {
         wallet: {
           address: wallet,
-          networkPassphrase: passphrase,
+          networkPassphrase: networkPassphrase,
           rejected: scenario === "wallet-rejection",
         },
         communities: [],
@@ -140,7 +140,7 @@ export async function installCreationFixtures(
     },
     {
       scenario,
-      passphrase: TESTNET_PASSPHRASE,
+      networkPassphrase: TESTNET_PASSPHRASE,
       wallet: WALLET_ADDRESS,
       expectedRecord: community(
         "cc".repeat(32),

apps/web/src/__tests__/CommunityPage.loading.test.tsx

@@ -18,7 +18,7 @@ vi.mock("@/lib/contracts", () => ({
 }));
 
 vi.mock("@/lib/stellar", () => ({
-  contractIds: { nft: "CNFT", governor: "CGOV" },
+  capabilities: { legacyContracts: { available: true, nft: "CNFT", governor: "CGOV" }, activeNetwork: { explorerSegment: "testnet" } },
 }));
 
 vi.mock("@/app/(app)/community/community-data.mjs", async (importOriginal) => {

apps/web/src/__tests__/api.health.test.ts

@@ -48,7 +48,7 @@ describe("GET /api/health", () => {
     expect(response.headers.get("cache-control")).toContain("no-store");
     expect(body).toEqual({
       status: "ok",
-      network: { selected: "testnet", passphraseConfigured: true },
+      network: { selected: "testnet", networkPassphraseConfigured: true },
       rpc: { configured: true },
       contracts: {
         nftConfigured: true,
@@ -70,7 +70,7 @@ describe("GET /api/health", () => {
     expect(body.status).toBe("degraded");
     expect(body.contracts).toEqual({
       nftConfigured: false,
-      governorConfigured: true,
+      governorConfigured: false,
       allConfigured: false,
     });
   });

apps/web/src/app/(app)/communities/[id]/proposals/page.tsx

@@ -45,7 +45,7 @@ function ScopedProposalHistory({ community }: { community: CommunityView }) {
       try {
         const client = createReadOnlyGovernorClient(governorContract);
         const transaction = await client.proposal_state({
-          proposal_id: Uint8Array.from(Buffer.from(proposalId, "hex")),
+          proposal_id: Buffer.from(proposalId, "hex"),
         });
         setStates((current) => ({
           ...current,

apps/web/src/app/api/health/route.ts

@@ -1,5 +1,5 @@
 import { NextResponse } from "next/server";
-import { config, contractIds, stellarConfig } from "@/lib/stellar";
+import { config, contractIds } from "@/lib/stellar";
 
 export const dynamic = "force-dynamic";
 
@@ -9,7 +9,7 @@ type HealthResponse = {
   status: HealthStatus;
   network: {
     selected: "testnet" | "mainnet";
-    passphraseConfigured: boolean;
+    networkPassphraseConfigured: boolean;
   };
   rpc: {
     configured: boolean;
@@ -40,17 +40,15 @@ function buildResponse(): { response: HealthResponse; statusCode: number } {
   const passphraseConfigured = Boolean(config.networkPassphrase);
 
   const rpcOk =
-    selected === "mainnet"
-      ? rpcConfigured
-      : rpcConfigured || Boolean(stellarConfig.testnet.rpcUrl);
+    rpcConfigured;
 
   const isReady = rpcOk && allContractsConfigured && passphraseConfigured;
 
   const response: HealthResponse = {
     status: isReady ? "ok" : "degraded",
     network: {
       selected,
-      passphraseConfigured,
+      networkPassphraseConfigured: passphraseConfigured,
     },
     rpc: {
       configured: rpcConfigured,

apps/web/src/components/community/CreateCommunityWizard.test.tsx

@@ -15,13 +15,15 @@ import { describeNetwork } from "@/lib/network";
 
 const wallet = vi.hoisted(() => ({
   address: "GADMIN" as string | null,
-  walletNetwork: null as ReturnType<typeof describeNetwork> | null,
+  walletNetwork: null as string | null,
+  walletNetworkPassphrase: null as string | null,
 }));
 
 vi.mock("@/context/WalletProvider", () => ({
   useWallet: () => ({
     address: wallet.address,
     walletNetwork: wallet.walletNetwork,
+    walletNetworkPassphrase: wallet.walletNetworkPassphrase,
     signTransaction: vi.fn(),
   }),
 }));
@@ -43,9 +45,10 @@ function createPort(): CommunityDeploymentPort {
   };
 }
 
-function connectOn(passphrase: string) {
+function connectOn(networkPassphrase: string) {
   wallet.address = "GADMIN";
-  wallet.walletNetwork = describeNetwork(passphrase);
+  wallet.walletNetworkPassphrase = networkPassphrase;
+  wallet.walletNetwork = networkPassphrase === Networks.PUBLIC ? "mainnet" : "testnet";
 }
 
 function renderWizard(port: CommunityDeploymentPort) {
@@ -193,6 +196,7 @@ describe("initial mismatch", () => {
 
   it("locks deployment while the wallet network is still unreadable", () => {
     wallet.walletNetwork = null;
+    wallet.walletNetworkPassphrase = null;
     renderWizard(createPort());
 
     fillMetadata();

apps/web/src/components/community/CreateCommunityWizard.tsx

@@ -127,10 +127,10 @@ export function CreateCommunityWizard({
   const hydratedRef = useRef(false);
   const firstFieldRef = useRef<HTMLInputElement>(null);
 
-  const detectedPassphrase = comparison.detected?.passphrase ?? null;
+  const detectedPassphrase = comparison.detected?.networkPassphrase ?? null;
 
   useEffect(() => {
-    dispatch({ type: "network-detected", passphrase: detectedPassphrase });
+    dispatch({ type: "network-detected", networkPassphrase: detectedPassphrase });
   }, [detectedPassphrase]);
 
   useEffect(() => {

apps/web/src/hooks/useNetworkGuard.ts

@@ -2,7 +2,7 @@
 
 import { useMemo } from "react";
 import { useWallet } from "@/context/WalletProvider";
-import { compareNetworks, type NetworkComparison } from "@/lib/network";
+import { compareNetworks, describeNetwork, type NetworkComparison } from "@/lib/network";
 import { activeNetwork } from "@/lib/stellar";
 
 /**
@@ -11,9 +11,9 @@ import { activeNetwork } from "@/lib/stellar";
  * network directly, so mismatch handling stays in one place.
  */
 export function useNetworkGuard(): NetworkComparison {
-  const { walletNetwork } = useWallet();
-  return useMemo(
-    () => compareNetworks(activeNetwork, walletNetwork),
-    [walletNetwork],
-  );
+  const { walletNetwork, walletNetworkPassphrase } = useWallet();
+  return useMemo(() => {
+    const detected = walletNetworkPassphrase ? describeNetwork(walletNetworkPassphrase, walletNetwork ?? undefined) : null;
+    return compareNetworks(activeNetwork, detected);
+  }, [walletNetwork, walletNetworkPassphrase]);
 }

apps/web/src/lib/capabilities.ts

@@ -0,0 +1,22 @@
+import { Networks } from "@stellar/stellar-sdk";
+import type { NetworkId, StellarNetwork } from "./network";
+
+export type CapabilityAvailable<T> = { available: true } & T;
+export type CapabilityUnavailable = { available: false; reason: string };
+export type Capability<T> = CapabilityAvailable<T> | CapabilityUnavailable;
+
+export type NetworkCapabilities = {
+  activeNetwork: StellarNetwork;
+  rpc: Capability<{ url: string; friendbotUrl: string | null }>;
+  explorer: Capability<{ segment: string }>;
+  communityFactory: Capability<{ contractId: string }>;
+  legacyContracts: Capability<{ nft: string; governor: string }>;
+  proposalDiscovery: Capability<{ startLedger: number }>;
+};
+
+export class CapabilityError extends Error {
+  constructor(capabilityName: string, reason: string) {
+    super(`Capability '${capabilityName}' is unavailable: ${reason}`);
+    this.name = "CapabilityError";
+  }
+}

apps/web/src/lib/community-creation.test.ts

@@ -24,9 +24,9 @@ const DRAFT: CommunityDraft = {
   quorum: "1",
 };
 
-function simulationOn(passphrase: string): CommunitySimulation {
+function simulationOn(networkPassphrase: string): CommunitySimulation {
   return {
-    networkPassphrase: passphrase,
+    networkPassphrase: networkPassphrase,
     factoryAddress: "CFACTORY",
     transactionXdr: "AAAA",
     minResourceFee: "1000",
@@ -57,7 +57,7 @@ beforeEach(() => {
   onTestnet = apply(
     INITIAL_CREATION_STATE,
     { type: "draft-changed", changes: DRAFT },
-    { type: "network-detected", passphrase: Networks.TESTNET },
+    { type: "network-detected", networkPassphrase: Networks.TESTNET },
     { type: "simulation-succeeded", simulation: simulationOn(Networks.TESTNET) },
   );
 });
@@ -96,7 +96,7 @@ describe("mid-flow network switch", () => {
   it("discards the simulation and keeps draft values", () => {
     const switched = creationReducer(onTestnet, {
       type: "network-detected",
-      passphrase: Networks.PUBLIC,
+      networkPassphrase: Networks.PUBLIC,
     });
 
     expect(switched.simulation).toBeNull();
@@ -107,7 +107,7 @@ describe("mid-flow network switch", () => {
     const signing = creationReducer(onTestnet, { type: "signing-started" });
     const switched = creationReducer(signing, {
       type: "network-detected",
-      passphrase: Networks.PUBLIC,
+      networkPassphrase: Networks.PUBLIC,
     });
 
     expect(switched.signing).toBe(false);
@@ -116,7 +116,7 @@ describe("mid-flow network switch", () => {
   it("blocks deployment once the wallet has moved", () => {
     const switched = creationReducer(onTestnet, {
       type: "network-detected",
-      passphrase: Networks.PUBLIC,
+      networkPassphrase: Networks.PUBLIC,
     });
 
     expect(deploymentBlocker(switched, contextFor(Networks.PUBLIC))).toBe(
@@ -127,7 +127,7 @@ describe("mid-flow network switch", () => {
   it("ignores a repeated report of the same network", () => {
     const same = creationReducer(onTestnet, {
       type: "network-detected",
-      passphrase: Networks.TESTNET,
+      networkPassphrase: Networks.TESTNET,
     });
 
     expect(same).toBe(onTestnet);
@@ -137,7 +137,7 @@ describe("mid-flow network switch", () => {
   it("drops a simulation that resolves after the wallet moved", () => {
     const switched = creationReducer(onTestnet, {
       type: "network-detected",
-      passphrase: Networks.PUBLIC,
+      networkPassphrase: Networks.PUBLIC,
     });
     const late = creationReducer(switched, {
       type: "simulation-succeeded",
@@ -152,8 +152,8 @@ describe("recovery to the expected network", () => {
   it("requires a fresh simulation and preserves governance values", () => {
     const recovered = apply(
       onTestnet,
-      { type: "network-detected", passphrase: Networks.PUBLIC },
-      { type: "network-detected", passphrase: Networks.TESTNET },
+      { type: "network-detected", networkPassphrase: Networks.PUBLIC },
+      { type: "network-detected", networkPassphrase: Networks.TESTNET },
     );
     const context = contextFor(Networks.TESTNET);
 
@@ -166,8 +166,8 @@ describe("recovery to the expected network", () => {
   it("allows deployment again once a new simulation exists", () => {
     const resimulated = apply(
       onTestnet,
-      { type: "network-detected", passphrase: Networks.PUBLIC },
-      { type: "network-detected", passphrase: Networks.TESTNET },
+      { type: "network-detected", networkPassphrase: Networks.PUBLIC },
+      { type: "network-detected", networkPassphrase: Networks.TESTNET },
       {
         type: "simulation-succeeded",
         simulation: simulationOn(Networks.TESTNET),
@@ -208,7 +208,7 @@ describe("post-submission network changes", () => {
   it("keeps the transaction and the network it was submitted to", () => {
     const switched = creationReducer(submitted(), {
       type: "network-detected",
-      passphrase: Networks.PUBLIC,
+      networkPassphrase: Networks.PUBLIC,
     });
 
     expect(switched.submission).toEqual({
@@ -222,8 +222,8 @@ describe("post-submission network changes", () => {
   it("does not allow a second submission after switching back", () => {
     const returned = apply(
       submitted(),
-      { type: "network-detected", passphrase: Networks.PUBLIC },
-      { type: "network-detected", passphrase: Networks.TESTNET },
+      { type: "network-detected", networkPassphrase: Networks.PUBLIC },
+      { type: "network-detected", networkPassphrase: Networks.TESTNET },
     );
 
     expect(deploymentBlocker(returned, contextFor(Networks.TESTNET))).toBe(
@@ -237,7 +237,7 @@ describe("post-submission network changes", () => {
   it("still records confirmation after a switch", () => {
     const confirmed = apply(
       submitted(),
-      { type: "network-detected", passphrase: Networks.PUBLIC },
+      { type: "network-detected", networkPassphrase: Networks.PUBLIC },
       { type: "submission-settled", status: "confirmed" },
     );
 
@@ -309,7 +309,7 @@ describe("blocker precedence", () => {
     };
     const empty = apply(INITIAL_CREATION_STATE, {
       type: "network-detected",
-      passphrase: Networks.PUBLIC,
+      networkPassphrase: Networks.PUBLIC,
     });
 
     expect(simulationBlocker(empty, context)).toBe("network-mismatch");

apps/web/src/lib/community-creation.ts

@@ -92,7 +92,7 @@ export type CreationAction =
       submission: CommunitySubmission | null;
     }
   | { type: "draft-discarded" }
-  | { type: "network-detected"; passphrase: string | null }
+  | { type: "network-detected"; networkPassphrase: string | null }
   | { type: "simulation-succeeded"; simulation: CommunitySimulation }
   | { type: "signing-started" }
   | { type: "signing-ended" }
@@ -134,10 +134,10 @@ export function creationReducer(
      * requires a fresh one.
      */
     case "network-detected": {
-      if (state.detectedPassphrase === action.passphrase) return state;
+      if (state.detectedPassphrase === action.networkPassphrase) return state;
       return {
         ...state,
-        detectedPassphrase: action.passphrase,
+        detectedPassphrase: action.networkPassphrase,
         simulation: null,
         signing: false,
       };
@@ -294,7 +294,7 @@ function isSimulationStale(
 ): boolean {
   return (
     state.simulation !== null &&
-    state.simulation.networkPassphrase !== context.comparison.expected.passphrase
+    state.simulation.networkPassphrase !== context.comparison.expected.networkPassphrase
   );
 }
 

apps/web/src/lib/community-factory.test.ts

@@ -18,9 +18,9 @@ const DRAFT: CommunityDraft = {
   quorum: "1",
 };
 
-function simulationOn(passphrase: string): CommunitySimulation {
+function simulationOn(networkPassphrase: string): CommunitySimulation {
   return {
-    networkPassphrase: passphrase,
+    networkPassphrase: networkPassphrase,
     factoryAddress: "CFACTORY",
     transactionXdr: "not-a-real-xdr",
     minResourceFee: "1000",