feat(frontend): enhance interactive loading states in Fiat Onramp Integration Interface

frontend/src/app/(authenticated)/dashboard/page.tsx

@@ -12,9 +12,11 @@ import FirstApiKeyModal from "@/components/FirstApiKeyModal";
 import FirstPaymentCelebration from "@/components/FirstPaymentCelebration";
 import PaymentMetrics from "@/components/PaymentMetrics";
 import PaymentsTabs from "@/components/PaymentsTabs";
+import FiatOnrampModal from "@/components/FiatOnrampModal";
 
 export default function DashboardPage() {
   const [isFirstKeyModalOpen, setIsFirstKeyModalOpen] = useState(false);
+  const [isOnrampModalOpen, setIsOnrampModalOpen] = useState(false);
   const hydrated = useMerchantHydrated();
   const apiKey = useMerchantApiKey();
   const [loading, setLoading] = useState(true);
@@ -71,6 +73,27 @@ export default function DashboardPage() {
             <div className="absolute inset-0 -z-10 bg-white/20 opacity-0 transition-opacity group-hover:opacity-100" />
           </Link>
 
+          <button
+            type="button"
+            onClick={() => setIsOnrampModalOpen(true)}
+            className="flex items-center gap-2.5 rounded-xl border border-white/10 bg-white/5 px-5 py-3 text-sm font-medium text-slate-300 transition-all hover:bg-white/10 hover:text-white"
+          >
+            <svg
+              className="h-5 w-5"
+              fill="none"
+              stroke="currentColor"
+              viewBox="0 0 24 24"
+            >
+              <path
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                strokeWidth={2}
+                d="M12 9v3m0 0v3m0-3h3m-3 0H9m12 0a9 9 0 11-18 0 9 9 0 0118 0z"
+              />
+            </svg>
+            Buy / Deposit
+          </button>
+
           <Link
             href="/docs"
             className="flex items-center gap-2.5 rounded-xl border border-white/10 bg-white/5 px-5 py-3 text-sm font-medium text-slate-300 transition-all hover:bg-white/10 hover:text-white"
@@ -193,6 +216,10 @@ export default function DashboardPage() {
         isOpen={isFirstKeyModalOpen}
         onClose={() => setIsFirstKeyModalOpen(false)}
       />
+      <FiatOnrampModal
+        isOpen={isOnrampModalOpen}
+        onClose={() => setIsOnrampModalOpen(false)}
+      />
       <FirstPaymentCelebration />
     </div>
   );

frontend/src/components/FiatOnrampModal.test.tsx

@@ -0,0 +1,153 @@
+import React from "react";
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { render, screen, fireEvent, waitFor } from "@testing-library/react";
+import "@testing-library/jest-dom/vitest";
+
+import FiatOnrampModal from "./FiatOnrampModal";
+
+// ─── framer-motion mock ───────────────────────────────────────────────────────
+// jsdom has no layout engine so framer-motion's measurement APIs fail; strip
+// animation-only props and render plain HTML so the DOM stays inspectable.
+vi.mock("framer-motion", () => {
+  const strip = (props: Record<string, unknown>) => {
+    const { initial: _i, animate: _a, exit: _e, transition: _t, ...rest } = props;
+    return rest;
+  };
+  return {
+    motion: {
+      div: ({ children, ...p }: any) => <div {...strip(p)}>{children}</div>,
+    },
+    AnimatePresence: ({ children }: any) => <>{children}</>,
+  };
+});
+
+vi.mock("sonner", () => ({
+  toast: { success: vi.fn(), error: vi.fn() },
+}));
+
+const mockGetFreighterPublicKey = vi.fn();
+const mockSignWithFreighter = vi.fn();
+vi.mock("@/lib/freighter", () => ({
+  getFreighterPublicKey: (...args: unknown[]) => mockGetFreighterPublicKey(...args),
+  signWithFreighter: (...args: unknown[]) => mockSignWithFreighter(...args),
+}));
+
+const mockGetAnchorServices = vi.fn();
+const mockAuthenticateWithAnchor = vi.fn();
+const mockInitiateDeposit = vi.fn();
+vi.mock("@/lib/stellar", () => ({
+  getAnchorServices: (...args: unknown[]) => mockGetAnchorServices(...args),
+  authenticateWithAnchor: (...args: unknown[]) => mockAuthenticateWithAnchor(...args),
+  initiateDeposit: (...args: unknown[]) => mockInitiateDeposit(...args),
+}));
+
+describe("FiatOnrampModal", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockGetFreighterPublicKey.mockResolvedValue("GABC123PUBLICKEY");
+    mockGetAnchorServices.mockResolvedValue({
+      transferServer: "https://anchor.example/sep24",
+      webAuthEndpoint: "https://anchor.example/auth",
+      signingKey: "GSIGNINGKEY",
+    });
+    mockSignWithFreighter.mockResolvedValue({ signedXDR: "signed-xdr" });
+    mockAuthenticateWithAnchor.mockResolvedValue("jwt-token");
+    mockInitiateDeposit.mockResolvedValue("https://anchor.example/interactive/abc");
+  });
+
+  it("does not render when closed", () => {
+    render(<FiatOnrampModal isOpen={false} onClose={vi.fn()} />);
+    expect(screen.queryByText("Buy / Deposit Funds")).not.toBeInTheDocument();
+  });
+
+  it("renders the asset selection form when open", () => {
+    render(<FiatOnrampModal isOpen onClose={vi.fn()} />);
+    expect(screen.getByText("Buy / Deposit Funds")).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: /USDC/ })).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: /SRT/ })).toBeInTheDocument();
+    expect(screen.getByRole("button", { name: "Continue to Anchor" })).toBeInTheDocument();
+  });
+
+  it("lets the user switch the selected asset", () => {
+    render(<FiatOnrampModal isOpen onClose={vi.fn()} />);
+    const usdcButton = screen.getByRole("button", { name: /USDC/ });
+    const srtButton = screen.getByRole("button", { name: /SRT/ });
+
+    expect(usdcButton).toHaveAttribute("aria-pressed", "true");
+    expect(srtButton).toHaveAttribute("aria-pressed", "false");
+
+    fireEvent.click(srtButton);
+
+    expect(srtButton).toHaveAttribute("aria-pressed", "true");
+    expect(usdcButton).toHaveAttribute("aria-pressed", "false");
+  });
+
+  it("walks through connecting, auth, and generating loading states before showing the interactive iframe", async () => {
+    render(<FiatOnrampModal isOpen onClose={vi.fn()} />);
+
+    fireEvent.click(screen.getByRole("button", { name: "Continue to Anchor" }));
+
+    await waitFor(() => {
+      expect(mockGetFreighterPublicKey).toHaveBeenCalled();
+      expect(mockGetAnchorServices).toHaveBeenCalledWith("testanchor.stellar.org");
+    });
+
+    await waitFor(() => {
+      expect(mockAuthenticateWithAnchor).toHaveBeenCalled();
+    });
+
+    await waitFor(() => {
+      expect(mockInitiateDeposit).toHaveBeenCalledWith(
+        "https://anchor.example/sep24",
+        "jwt-token",
+        "USDC",
+        "GABC123PUBLICKEY",
+        undefined,
+      );
+    });
+
+    await waitFor(() => {
+      expect(screen.getByTitle("Anchor deposit form")).toBeInTheDocument();
+    });
+  });
+
+  it("passes the entered amount through to initiateDeposit", async () => {
+    render(<FiatOnrampModal isOpen onClose={vi.fn()} />);
+
+    fireEvent.change(screen.getByLabelText(/Amount/), { target: { value: "250" } });
+    fireEvent.click(screen.getByRole("button", { name: "Continue to Anchor" }));
+
+    await waitFor(() => {
+      expect(mockInitiateDeposit).toHaveBeenCalledWith(
+        expect.any(String),
+        expect.any(String),
+        "USDC",
+        "GABC123PUBLICKEY",
+        "250",
+      );
+    });
+  });
+
+  it("shows an inline error and returns to the select step when the wallet is unavailable", async () => {
+    mockGetFreighterPublicKey.mockRejectedValue(new Error("Freighter is not installed"));
+
+    render(<FiatOnrampModal isOpen onClose={vi.fn()} />);
+    fireEvent.click(screen.getByRole("button", { name: "Continue to Anchor" }));
+
+    await waitFor(() => {
+      expect(screen.getByRole("alert")).toHaveTextContent("Freighter is not installed");
+    });
+
+    expect(screen.getByRole("button", { name: "Continue to Anchor" })).toBeInTheDocument();
+    expect(mockGetAnchorServices).not.toHaveBeenCalled();
+  });
+
+  it("resets state and calls onClose when closed", () => {
+    const onClose = vi.fn();
+    render(<FiatOnrampModal isOpen onClose={onClose} />);
+
+    fireEvent.click(screen.getByTestId("modal-close"));
+
+    expect(onClose).toHaveBeenCalled();
+  });
+});